![]() | ![]() | ![]() | GNetwork Library Manual | ![]() |
---|
Error Reporting — Error types, domains, and functions.
#define GNETWORK_DNS_ERROR enum GNetworkDnsError; G_CONST_RETURN gchar* gnetwork_dns_strerror (GNetworkDnsError error); #define GNETWORK_CONNECTION_ERROR enum GNetworkConnectionError; G_CONST_RETURN gchar* gnetwork_connection_strerror (GNetworkConnectionError error); #define GNETWORK_SERVER_ERROR enum GNetworkServerError; G_CONST_RETURN gchar* gnetwork_server_strerror (GNetworkServerError error); #define GNETWORK_TCP_PROXY_ERROR enum GNetworkTcpProxyError; #define GNETWORK_SSL_ERROR enum GNetworkSslError; #define GNETWORK_SSL_CERT_ERROR enum GNetworkSslCertErrorFlags;
These are the error domains, types, and strerror-like functions that the GNetwork library uses.
#define GNETWORK_DNS_ERROR (gnetwork_dns_error_get_quark ())
The GQuark error domain for GNetworkDnsError.
typedef enum /* <prefix=GNETWORK_DNS_ERROR> */ { /* <private> */ GNETWORK_DNS_ERROR_IN_PROGRESS = -1, /* <public> */ GNETWORK_DNS_ERROR_NONE = 0, GNETWORK_DNS_ERROR_NOT_FOUND, GNETWORK_DNS_ERROR_NO_RECOVERY, GNETWORK_DNS_ERROR_TRY_AGAIN, GNETWORK_DNS_ERROR_IPV4_IPV6_MISMATCH, /* <private> */ GNETWORK_DNS_ERROR_INTERNAL } GNetworkDnsError;
An enumeration of the possible DNS lookup errors.
GNETWORK_DNS_ERROR_IN_PROGRESS | the lookup is in progress |
GNETWORK_DNS_ERROR_NONE | there was no error. |
GNETWORK_DNS_ERROR_NOT_FOUND | the host record was not found. |
GNETWORK_DNS_ERROR_NO_RECOVERY | the DNS server is down. |
GNETWORK_DNS_ERROR_TRY_AGAIN | the DNS server is busy. |
GNETWORK_DNS_ERROR_IPV4_IPV6_MISMATCH | the network is misconfigured. |
GNETWORK_DNS_ERROR_INTERNAL | there was an error in the GNetwork library. |
G_CONST_RETURN gchar* gnetwork_dns_strerror (GNetworkDnsError error);
Retrieves a string message corresponding to error. The returned data should not be modified or freed.
error : | the DNS error code to use. |
Returns : | a string message. |
Since 1.0
#define GNETWORK_CONNECTION_ERROR (gnetwork_connection_error_get_quark ())
The GQuark error domain for GNetworkConnectionError.
typedef enum /* <prefix=GNETWORK_CONNECTION_ERROR> */ { GNETWORK_CONNECTION_ERROR_INTERNAL, GNETWORK_CONNECTION_ERROR_CONNECTION_REFUSED, GNETWORK_CONNECTION_ERROR_TIMEOUT, GNETWORK_CONNECTION_ERROR_NETWORK_UNREACHABLE, GNETWORK_CONNECTION_ERROR_BAD_BROADCAST_OR_FIREWALL } GNetworkConnectionError;
Possible errors for GNetworkConnection implementations.
GNETWORK_CONNECTION_ERROR_INTERNAL | there was a (bizarre) error inside GNetwork. |
GNETWORK_CONNECTION_ERROR_CONNECTION_REFUSED | the server refused to allow the connection. |
GNETWORK_CONNECTION_ERROR_TIMEOUT | the connection timed out. |
GNETWORK_CONNECTION_ERROR_NETWORK_UNREACHABLE | the host or host's network is unreachable (the interface may be down). |
GNETWORK_CONNECTION_ERROR_BAD_BROADCAST_OR_FIREWALL | the connection wants to use a protected broadcast address, or there is a firewall rule which prevents the connection. |
G_CONST_RETURN gchar* gnetwork_connection_strerror (GNetworkConnectionError error);
Retrieves a string message describing error. The returned data should not be modified or freed.
error : | the connection error code to use. |
Returns : | the string message describing error. |
Since 1.0
#define GNETWORK_SERVER_ERROR (gnetwork_server_error_get_quark ())
The GQuark error domain for GNetworkServerError.
typedef enum /* <prefix=GNETWORK_SERVER_ERROR> */ { GNETWORK_SERVER_ERROR_INTERNAL, GNETWORK_SERVER_ERROR_TOO_MANY_CONNECTIONS, GNETWORK_SERVER_ERROR_NO_MEMORY, GNETWORK_SERVER_ERROR_SERVER_TYPE_PERMISSIONS, GNETWORK_SERVER_ERROR_TOO_MANY_PROCESSES, GNETWORK_SERVER_ERROR_ALREADY_BOUND } GNetworkServerError;
Possible errors for GNetworkServer implementations
GNETWORK_SERVER_ERROR_INTERNAL | there was a (bizarre) eror inside GNetwork. |
GNETWORK_SERVER_ERROR_TOO_MANY_CONNECTIONS | there are too many connections open to accept the new incoming connection. |
GNETWORK_SERVER_ERROR_NO_MEMORY | there is not enough memory to open a server. |
GNETWORK_SERVER_ERROR_SERVER_TYPE_PERMISSIONS | |
GNETWORK_SERVER_ERROR_TOO_MANY_PROCESSES | there are too many running applications to open a server. |
GNETWORK_SERVER_ERROR_ALREADY_BOUND | the requested port number is already in use. |
G_CONST_RETURN gchar* gnetwork_server_strerror (GNetworkServerError error);
Retrieves an error message string for error. The returned value should not be modified or freed.
error : | the server error code to use. |
Returns : | the error message for error. |
Since 1.0
#define GNETWORK_TCP_PROXY_ERROR (gnetwork_tcp_proxy_error_get_quark ())
The GQuark error domain for GNetworkTcpProxyError.
typedef enum /* < prefix=GNETWORK_TCP_PROXY_ERROR > */ { GNETWORK_TCP_PROXY_ERROR_UNKNOWN, GNETWORK_TCP_PROXY_ERROR_CONNECTION_REFUSED, GNETWORK_TCP_PROXY_ERROR_TIMEOUT, GNETWORK_TCP_PROXY_ERROR_NETWORK_UNREACHABLE, GNETWORK_TCP_PROXY_ERROR_FIREWALL, GNETWORK_TCP_PROXY_ERROR_ABORTED, GNETWORK_TCP_PROXY_ERROR_AUTHENTICATION_FAILED, GNETWORK_TCP_PROXY_ERROR_SERVER_FAILED } GNetworkTcpProxyError;
Possible errors while traversing a proxy.
GNETWORK_TCP_PROXY_ERROR_UNKNOWN | there was an error inside GNetwork. |
GNETWORK_TCP_PROXY_ERROR_CONNECTION_REFUSED | the proxy server refused to allow us to connect. |
GNETWORK_TCP_PROXY_ERROR_TIMEOUT | the connection to the proxy server timed out. |
GNETWORK_TCP_PROXY_ERROR_NETWORK_UNREACHABLE | the network the proxy server is on is unreachable. |
GNETWORK_TCP_PROXY_ERROR_FIREWALL | the proxy server is blocked by a firewall rule. |
GNETWORK_TCP_PROXY_ERROR_ABORTED | the proxy server closed the connection before we could finish connecting. |
GNETWORK_TCP_PROXY_ERROR_AUTHENTICATION_FAILED | the proxy server could not verify our identity (bad password, username, etc.) |
GNETWORK_TCP_PROXY_ERROR_SERVER_FAILED | the proxy server is throwing a fit :-). |
#define GNETWORK_SSL_ERROR (gnetwork_ssl_error_get_quark ())
The GQuark error domain for GNetworkSslError.
typedef enum /* <prefix=GNETWORK_SSL_ERROR> */ { GNETWORK_SSL_ERROR_INTERNAL, GNETWORK_SSL_ERROR_TRY_AGAIN, GNETWORK_SSL_ERROR_INTERRUPTED, GNETWORK_SSL_ERROR_UNSUPPORTED_PROTOCOL, GNETWORK_SSL_ERROR_PROTOCOL_ALERT, GNETWORK_SSL_ERROR_HANDSHAKE_FAILED, GNETWORK_SSL_ERROR_AUTHENTICATION_FAILED } GNetworkSslError;
An enumeration of possible SSL errors.
GNETWORK_SSL_ERROR_INTERNAL | an internal error in the GNetwork library. |
GNETWORK_SSL_ERROR_TRY_AGAIN | the last action should be tried again. |
GNETWORK_SSL_ERROR_INTERRUPTED | the last action could not be completed. |
GNETWORK_SSL_ERROR_UNSUPPORTED_PROTOCOL | the requested SSL protocol version is not supported by the destination. |
GNETWORK_SSL_ERROR_PROTOCOL_ALERT | |
GNETWORK_SSL_ERROR_HANDSHAKE_FAILED | the handshake could not be completed. |
GNETWORK_SSL_ERROR_AUTHENTICATION_FAILED |
#define GNETWORK_SSL_CERT_ERROR (gnetwork_ssl_cert_error_get_quark ())
The GQuark error domain for GNetworkSslCertErrorFlags.
typedef enum /* <flags,prefix=GNETWORK_SSL_CERT_ERROR> */ { GNETWORK_SSL_CERT_ERROR_UNKNOWN = 0, GNETWORK_SSL_CERT_ERROR_NO_CERTIFICATE = (1 << 0), GNETWORK_SSL_CERT_ERROR_INVALID = (1 << 1), GNETWORK_SSL_CERT_ERROR_UNSIGNED = (1 << 2), GNETWORK_SSL_CERT_ERROR_NOT_TRUSTED = (1 << 3), GNETWORK_SSL_CERT_ERROR_REVOKED = (1 << 4), GNETWORK_SSL_CERT_ERROR_CORRUPTED = (1 << 5), GNETWORK_SSL_CERT_ERROR_UNSUPPORTED_TYPE = (1 << 6), GNETWORK_SSL_CERT_ERROR_EXPIRED = (1 << 7), GNETWORK_SSL_CERT_ERROR_NOT_ACTIVATED = (1 << 8), GNETWORK_SSL_CERT_ERROR_HOSTNAME_MISMATCH = (1 << 9), GNETWORK_SSL_CERT_ERROR_CANNOT_PARSE = (1 << 10) } GNetworkSslCertErrorFlags;
A bitwise flag for possible problems with a certificate.
GNETWORK_SSL_CERT_ERROR_UNKNOWN | there is an unknown problem. |
GNETWORK_SSL_CERT_ERROR_NO_CERTIFICATE | a certificate was expected but none was received. |
GNETWORK_SSL_CERT_ERROR_INVALID | the certificate is invalid. |
GNETWORK_SSL_CERT_ERROR_UNSIGNED | the certificate was not signed by anyone else. |
GNETWORK_SSL_CERT_ERROR_NOT_TRUSTED | the certificate's signer is not trusted. |
GNETWORK_SSL_CERT_ERROR_REVOKED | the certificate has been revoked by one or more of the authorities which signed it. |
GNETWORK_SSL_CERT_ERROR_CORRUPTED | the certificate is broken. |
GNETWORK_SSL_CERT_ERROR_UNSUPPORTED_TYPE | the certificate is not in X.509 format. |
GNETWORK_SSL_CERT_ERROR_EXPIRED | the certificate has expired. |
GNETWORK_SSL_CERT_ERROR_NOT_ACTIVATED | the certificate does not become active until a later date. |
GNETWORK_SSL_CERT_ERROR_HOSTNAME_MISMATCH | the hostname of the certificate and the hostname set on the authentication scheme are not the same. |
GNETWORK_SSL_CERT_ERROR_CANNOT_PARSE | the certificate could not be parsed. |
<< GNetworkTcpServer | SSL Certificates >> |