Enumeration

PurpleConnectionError

Declaration

enum Purple.ConnectionError

Description [src]

Possible errors that can cause a connection to be closed.

Members

PURPLE_CONNECTION_ERROR_NETWORK_ERROR

There was an error sending or receiving on the network socket, or there was some protocol error (such as the server sending malformed data).

  • Value: 0
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_INVALID_USERNAME

The username supplied was not valid.

  • Value: 1
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_AUTHENTICATION_FAILED

The username, password or some other credential was incorrect. Use #PURPLE_CONNECTION_ERROR_INVALID_USERNAME instead if the username is known to be invalid.

  • Value: 2
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_AUTHENTICATION_IMPOSSIBLE

Libpurple doesn’t speak any of the authentication methods the server offered.

  • Value: 3
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_NO_SSL_SUPPORT

Libpurple was built without SSL support, and the connection needs SSL.

  • Value: 4
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_ENCRYPTION_ERROR

There was an error negotiating SSL on this connection, or the server does not support encryption but an account option was set to require it.

  • Value: 5
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_NAME_IN_USE

Someone is already connected to the server using the name you are trying to connect with.

  • Value: 6
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_INVALID_SETTINGS

The username/server/other preference for the account isn’t valid. For instance, on IRC the username cannot contain white space. This reason should not be used for incorrect passwords etc: use #PURPLE_CONNECTION_ERROR_AUTHENTICATION_FAILED for that.

  • Value: 7
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_CERT_NOT_PROVIDED

The server did not provide a SSL certificate.

  • Value: 8
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_CERT_UNTRUSTED

The server’s SSL certificate could not be trusted.

  • Value: 9
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_CERT_EXPIRED

The server’s SSL certificate has expired.

  • Value: 10
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_CERT_NOT_ACTIVATED

The server’s SSL certificate is not yet valid.

  • Value: 11
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_CERT_HOSTNAME_MISMATCH

The server’s SSL certificate did not match its hostname.

  • Value: 12
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_CERT_FINGERPRINT_MISMATCH

The server’s SSL certificate does not have the expected fingerprint.

  • Value: 13
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_CERT_SELF_SIGNED

The server’s SSL certificate is self-signed.

  • Value: 14
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_CERT_OTHER_ERROR

There was some other error validating the server’s SSL certificate.

  • Value: 15
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_CUSTOM_TEMPORARY

A custom error that is temporary.

  • Value: 16
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_CUSTOM_FATAL

A custom error that is fatal.

  • Value: 17
  • Available since: 3.0
PURPLE_CONNECTION_ERROR_OTHER_ERROR

Some other error occurred which fits into none of the other categories.

  • Value: 18
  • Available since: 3.0

Type functions

purple_connection_error_is_fatal

Reports whether a disconnection reason is fatal (in which case the account should probably not be automatically reconnected) or transient (so auto-reconnection is a good idea).

since: 2.0