| Home · All Classes · All Namespaces · Modules · Functions · Files

# Error string constants
[Types and constants]

Collaboration diagram for Error string constants:

## Defines

- #define TELEPATHY_ERROR_NETWORK_ERROR
- #define TELEPATHY_ERROR_NOT_IMPLEMENTED
- #define TELEPATHY_ERROR_INVALID_ARGUMENT
- #define TELEPATHY_ERROR_NOT_AVAILABLE
- #define TELEPATHY_ERROR_PERMISSION_DENIED
- #define TELEPATHY_ERROR_DISCONNECTED
- #define TELEPATHY_ERROR_INVALID_HANDLE
- #define TELEPATHY_ERROR_CHANNEL_BANNED
- #define TELEPATHY_ERROR_CHANNEL_FULL
- #define TELEPATHY_ERROR_CHANNEL_INVITE_ONLY
- #define TELEPATHY_ERROR_NOT_YOURS
- #define TELEPATHY_ERROR_CANCELLED
- #define TELEPATHY_ERROR_AUTHENTICATION_FAILED
- #define TELEPATHY_ERROR_ENCRYPTION_NOT_AVAILABLE
- #define TELEPATHY_ERROR_ENCRYPTION_ERROR
- #define TELEPATHY_ERROR_CERT_NOT_PROVIDED
- #define TELEPATHY_ERROR_CERT_UNTRUSTED
- #define TELEPATHY_ERROR_CERT_EXPIRED
- #define TELEPATHY_ERROR_CERT_NOT_ACTIVATED
- #define TELEPATHY_ERROR_CERT_FINGERPRINT_MISMATCH
- #define TELEPATHY_ERROR_CERT_HOSTNAME_MISMATCH
- #define TELEPATHY_ERROR_CERT_SELF_SIGNED
- #define TELEPATHY_ERROR_CERT_INVALID
- #define TELEPATHY_ERROR_NOT_CAPABLE
- #define TELEPATHY_ERROR_OFFLINE
- #define TELEPATHY_ERROR_CHANNEL_KICKED
- #define TELEPATHY_ERROR_BUSY
- #define TELEPATHY_ERROR_NO_ANSWER
- #define TELEPATHY_ERROR_DOES_NOT_EXIST
- #define TELEPATHY_ERROR_TERMINATED
- #define TELEPATHY_ERROR_CONNECTION_REFUSED
- #define TELEPATHY_ERROR_CONNECTION_FAILED
- #define TELEPATHY_ERROR_CONNECTION_LOST
- #define TELEPATHY_ERROR_ALREADY_CONNECTED
- #define TELEPATHY_ERROR_CONNECTION_REPLACED
- #define TELEPATHY_ERROR_REGISTRATION_EXISTS
- #define TELEPATHY_ERROR_SERVICE_BUSY
- #define TELEPATHY_ERROR_RESOURCE_UNAVAILABLE
- #define TELEPATHY_DBUS_ERROR_NAME_HAS_NO_OWNER
- #define TELEPATHY_DBUS_ERROR_UNKNOWN_METHOD
- #define TELEPATHY_QT4_ERROR_OBJECT_REMOVED
- #define TELEPATHY_QT4_ERROR_INCONSISTENT

## Detailed Description

Names of the D-Bus errors in the specification.

## Define Documentation

#define TELEPATHY_ERROR_NETWORK_ERROR

The error name "org.freedesktop.Telepathy.Error.NetworkError".

Raised when there is an error reading from or writing to the network.

#define TELEPATHY_ERROR_NOT_IMPLEMENTED

The error name "org.freedesktop.Telepathy.Error.NotImplemented".

Raised when the requested method, channel, etc is not available on this connection.

#define TELEPATHY_ERROR_INVALID_ARGUMENT

The error name "org.freedesktop.Telepathy.Error.InvalidArgument".

Raised when one of the provided arguments is invalid.

#define TELEPATHY_ERROR_NOT_AVAILABLE

The error name "org.freedesktop.Telepathy.Error.NotAvailable".

Raised when the requested functionality is temporarily unavailable.

#define TELEPATHY_ERROR_PERMISSION_DENIED

The error name "org.freedesktop.Telepathy.Error.PermissionDenied".

The user is not permitted to perform the requested operation.

#define TELEPATHY_ERROR_DISCONNECTED

The error name "org.freedesktop.Telepathy.Error.Disconnected".

The connection is not currently connected and cannot be used. This error may also be raised when operations are performed on a Connection for which StatusChanged has signalled status Disconnected for reason None. The second usage corresponds to None in the Connection_Status_Reason enum; if a better reason is available, the corresponding error should be used instead.

#define TELEPATHY_ERROR_INVALID_HANDLE

The error name "org.freedesktop.Telepathy.Error.InvalidHandle".

The handle specified is unknown on this channel or connection.

#define TELEPATHY_ERROR_CHANNEL_BANNED

The error name "org.freedesktop.Telepathy.Error.Channel.Banned".

You are banned from the channel.

#define TELEPATHY_ERROR_CHANNEL_FULL

The error name "org.freedesktop.Telepathy.Error.Channel.Full".

The channel is full.

#define TELEPATHY_ERROR_CHANNEL_INVITE_ONLY

The error name "org.freedesktop.Telepathy.Error.Channel.InviteOnly".

The requested channel is invite-only.

#define TELEPATHY_ERROR_NOT_YOURS

The error name "org.freedesktop.Telepathy.Error.NotYours".

The requested channel or other resource already exists, and another user interface in this session is responsible for it.

User interfaces SHOULD handle this error unobtrusively, since it indicates that some other user interface is already processing the channel.

#define TELEPATHY_ERROR_CANCELLED

The error name "org.freedesktop.Telepathy.Error.Cancelled".

Raised by an ongoing request if it is cancelled by user request before it has completed, or when operations are performed on an object which the user has asked to close (for instance, a Connection where the user has called Disconnect, or a Channel where the user has called Close). The second form can be used to correspond to the Requested member in the Connection_Status_Reason enum, or to to represent the situation where disconnecting a Connection, closing a Channel, etc. has been requested by the user but this request has not yet been acted on, for instance because the service will only act on the request when it has finished processing an event queue.

#define TELEPATHY_ERROR_AUTHENTICATION_FAILED

The error name "org.freedesktop.Telepathy.Error.AuthenticationFailed".

Raised when authentication with a service was unsuccessful. This corresponds to Authentication_Failed in the Connection_Status_Reason enum.

#define TELEPATHY_ERROR_ENCRYPTION_NOT_AVAILABLE

The error name "org.freedesktop.Telepathy.Error.EncryptionNotAvailable".

Raised if a user request insisted that encryption should be used, but encryption was not actually available. This corresponds to part of Encryption_Error in the Connection_Status_Reason enum. It's been separated into a distinct error here because the two concepts that were part of EncryptionError seem to be things that could reasonably appear differently in the UI.

#define TELEPATHY_ERROR_ENCRYPTION_ERROR

The error name "org.freedesktop.Telepathy.Error.EncryptionError".

Raised if encryption appears to be available, but could not actually be used (for instance if SSL/TLS negotiation fails). This corresponds to part of Encryption_Error in the Connection_Status_Reason enum.

#define TELEPATHY_ERROR_CERT_NOT_PROVIDED

The error name "org.freedesktop.Telepathy.Error.Cert.NotProvided".

Raised if the server did not provide a SSL/TLS certificate. This error MUST NOT be used to represent the absence of a client certificate provided by the Telepathy connection manager. This corresponds to Cert_Not_Provided in the Connection_Status_Reason enum. That error explicitly applied only to server SSL certificates, so this one is similarly limited; having the CM present a client certificate is a possible future feature, but it should have its own error handling.

#define TELEPATHY_ERROR_CERT_UNTRUSTED

The error name "org.freedesktop.Telepathy.Error.Cert.Untrusted".

Raised if the server provided a SSL/TLS certificate signed by an untrusted certifying authority. This error SHOULD NOT be used to represent a self-signed certificate: see the Self Signed error for that. This corresponds to Cert_Untrusted in the Connection_Status_Reason enum, with a clarification to avoid ambiguity.

#define TELEPATHY_ERROR_CERT_EXPIRED

The error name "org.freedesktop.Telepathy.Error.Cert.Expired".

Raised if the server provided an expired SSL/TLS certificate. This corresponds to Cert_Expired in the Connection_Status_Reason enum.

#define TELEPATHY_ERROR_CERT_NOT_ACTIVATED

The error name "org.freedesktop.Telepathy.Error.Cert.NotActivated".

Raised if the server provided an SSL/TLS certificate that will become valid at some point in the future. This corresponds to Cert_Not_Activated in the Connection_Status_Reason enum.

#define TELEPATHY_ERROR_CERT_FINGERPRINT_MISMATCH

The error name "org.freedesktop.Telepathy.Error.Cert.FingerprintMismatch".

Raised if the server provided an SSL/TLS certificate that did not have the expected fingerprint. This corresponds to Cert_Fingerprint_Mismatch in the Connection_Status_Reason enum.

#define TELEPATHY_ERROR_CERT_HOSTNAME_MISMATCH

The error name "org.freedesktop.Telepathy.Error.Cert.HostnameMismatch".

Raised if the server provided an SSL/TLS certificate that did not match its hostname. This corresponds to Cert_Hostname_Mismatch in the Connection_Status_Reason enum.

#define TELEPATHY_ERROR_CERT_SELF_SIGNED

The error name "org.freedesktop.Telepathy.Error.Cert.SelfSigned".

Raised if the server provided an SSL/TLS certificate that is self-signed and untrusted. This corresponds to Cert_Hostname_Mismatch in the Connection_Status_Reason enum.

#define TELEPATHY_ERROR_CERT_INVALID

The error name "org.freedesktop.Telepathy.Error.Cert.Invalid".

Raised if the server provided an SSL/TLS certificate that is unacceptable in some way that does not have a more specific error. This corresponds to Cert_Other_Error in the Connection_Status_Reason enum.

#define TELEPATHY_ERROR_NOT_CAPABLE

The error name "org.freedesktop.Telepathy.Error.NotCapable".

Raised when requested functionality is unavailable due to contact not having required capabilities.

#define TELEPATHY_ERROR_OFFLINE

The error name "org.freedesktop.Telepathy.Error.Offline".

Raised when requested functionality is unavailable because a contact is offline. This corresponds to Offline in the Channel_Group_Change_Reason enum.

#define TELEPATHY_ERROR_CHANNEL_KICKED

The error name "org.freedesktop.Telepathy.Error.Channel.Kicked".

Used to represent a user being ejected from a channel by another user, for instance being kicked from a chatroom. This corresponds to Kicked in the Channel_Group_Change_Reason enum.

#define TELEPATHY_ERROR_BUSY

The error name "org.freedesktop.Telepathy.Error.Busy".

Used to represent a user being removed from a channel because of a "busy" indication. This error SHOULD NOT be used to represent a server or other infrastructure being too busy to process a request - for that, see ServerBusy. This corresponds to Busy in the Channel_Group_Change_Reason enum.

#define TELEPATHY_ERROR_NO_ANSWER

The error name "org.freedesktop.Telepathy.Error.NoAnswer".

Used to represent a user being removed from a channel because they did not respond, e.g. to a StreamedMedia call. This corresponds to No_Answer in the Channel_Group_Change_Reason enum.

#define TELEPATHY_ERROR_DOES_NOT_EXIST

The error name "org.freedesktop.Telepathy.Error.DoesNotExist".

Raised when the requested user does not, in fact, exist. This corresponds to Invalid_Contact in the Channel_Group_Change_Reason enum, but can also be used to represent other things not existing (like chatrooms, perhaps).

#define TELEPATHY_ERROR_TERMINATED

The error name "org.freedesktop.Telepathy.Error.Terminated".

Raised when a channel is terminated for an unspecified reason. In particular, this error SHOULD be used whenever normal termination of a 1-1 StreamedMedia call by the remote user is represented as a D-Bus error name. This corresponds to None in the Channel_Group_Change_Reason enum.

#define TELEPATHY_ERROR_CONNECTION_REFUSED

The error name "org.freedesktop.Telepathy.Error.ConnectionRefused".

Raised when a connection is refused.

#define TELEPATHY_ERROR_CONNECTION_FAILED

The error name "org.freedesktop.Telepathy.Error.ConnectionFailed".

Raised when a connection can't be established.

#define TELEPATHY_ERROR_CONNECTION_LOST

The error name "org.freedesktop.Telepathy.Error.ConnectionLost".

Raised when a connection is broken.

#define TELEPATHY_ERROR_ALREADY_CONNECTED

The error name "org.freedesktop.Telepathy.Error.AlreadyConnected".

Raised when the user attempts to connect to an account but they are already connected (perhaps from another client or computer), and the protocol or account settings do not allow this. XMPP can have this behaviour if the user chooses the same resource in both clients (it is server-dependent whether the result is AlreadyConnected on the new connection, ConnectionReplaced on the old connection, or two successful connections).

#define TELEPATHY_ERROR_CONNECTION_REPLACED

The error name "org.freedesktop.Telepathy.Error.ConnectionReplaced".

Raised by an existing connection to an account if it is replaced by a new connection (perhaps from another client or computer). In MSNP, when connecting twice with the same Passport, the new connection "wins" and the old one is automatically disconnected. XMPP can also have this behaviour if the user chooses the same resource in two clients (it is server-dependent whether the result is AlreadyConnected on the new connection, ConnectionReplaced on the old connection, or two successful connections).

#define TELEPATHY_ERROR_REGISTRATION_EXISTS

The error name "org.freedesktop.Telepathy.Error.RegistrationExists".

Raised during in-band registration if the server indicates that the requested account already exists.

#define TELEPATHY_ERROR_SERVICE_BUSY

The error name "org.freedesktop.Telepathy.Error.ServiceBusy".

Raised if a server or some other piece of infrastructure cannot process the request, e.g. due to resource limitations. Clients MAY try again later.

<tp:rationale> This is not the same error as Busy, which indicates that a user is busy. </tp:rationale>

#define TELEPATHY_ERROR_RESOURCE_UNAVAILABLE

The error name "org.freedesktop.Telepathy.Error.ResourceUnavailable".

Raised if a request cannot be satisfied because a process local to the user has insufficient resources. Clients MAY try again later. For instance, the ChannelDispatcher might raise this error for some or all channel requests if it has detected that there is not enough free memory.

#define TELEPATHY_DBUS_ERROR_NAME_HAS_NO_OWNER

The error name "org.freedesktop.DBus.Error.NameHasNoOwner".

Raised by the D-Bus daemon when looking up the owner of a well-known name, if no process owns that name.

Also used by DBusProxy to indicate that the owner of a well-known name has disappeared (usually indicating that the process owning that name exited or crashed).

#define TELEPATHY_DBUS_ERROR_UNKNOWN_METHOD

The error name "org.freedesktop.DBus.Error.UnknownMethod".

Raised by the D-Bus daemon when the method name invoked isn't known by the object you invoked it on.

#define TELEPATHY_QT4_ERROR_OBJECT_REMOVED

The error name "org.freedesktop.Telepathy.Qt4.Error.ObjectRemoved".

#define TELEPATHY_QT4_ERROR_INCONSISTENT

The error name "org.freedesktop.Telepathy.Qt4.Error.Inconsistent".