9.6 Error Codes and Descriptions

The error codes used throughout the library are described below. The return code GNUTLS_E_SUCCESS indicate successful operation, and is guaranteed to have the value 0, so you can use it in logical expressions.

GNUTLS_E_AGAIN:

Resource temporarily unavailable, try again.

GNUTLS_E_ASN1_DER_ERROR:

ASN1 parser: Error in DER parsing.

GNUTLS_E_ASN1_DER_OVERFLOW:

ASN1 parser: Overflow in DER parsing.

GNUTLS_E_ASN1_ELEMENT_NOT_FOUND:

ASN1 parser: Element was not found.

GNUTLS_E_ASN1_GENERIC_ERROR:

ASN1 parser: Generic parsing error.

GNUTLS_E_ASN1_IDENTIFIER_NOT_FOUND:

ASN1 parser: Identifier was not found

GNUTLS_E_ASN1_SYNTAX_ERROR:

ASN1 parser: Syntax error.

GNUTLS_E_ASN1_TAG_ERROR:

ASN1 parser: Error in TAG.

GNUTLS_E_ASN1_TAG_IMPLICIT:

ASN1 parser: error in implicit tag

GNUTLS_E_ASN1_TYPE_ANY_ERROR:

ASN1 parser: Error in type ’ANY’.

GNUTLS_E_ASN1_VALUE_NOT_FOUND:

ASN1 parser: Value was not found.

GNUTLS_E_ASN1_VALUE_NOT_VALID:

ASN1 parser: Value is not valid.

GNUTLS_E_BASE64_DECODING_ERROR:

Base64 decoding error.

GNUTLS_E_BASE64_ENCODING_ERROR:

Base64 encoding error.

GNUTLS_E_BASE64_UNEXPECTED_HEADER_ERROR:

Base64 unexpected header error.

GNUTLS_E_CERTIFICATE_ERROR:

Error in the certificate.

GNUTLS_E_CERTIFICATE_KEY_MISMATCH:

The certificate and the given key do not match.

GNUTLS_E_COMPRESSION_FAILED:

Compression of the TLS record packet has failed.

GNUTLS_E_CONSTRAINT_ERROR:

Some constraint limits were reached.

GNUTLS_E_CRYPTODEV_DEVICE_ERROR:

Error opening /dev/crypto

GNUTLS_E_CRYPTODEV_IOCTL_ERROR:

Error interfacing with /dev/crypto

GNUTLS_E_CRYPTO_ALREADY_REGISTERED:

There is already a crypto algorithm with lower priority.

GNUTLS_E_DB_ERROR:

Error in Database backend.

GNUTLS_E_DECOMPRESSION_FAILED:

Decompression of the TLS record packet has failed.

GNUTLS_E_DECRYPTION_FAILED:

Decryption has failed.

GNUTLS_E_DH_PRIME_UNACCEPTABLE:

The Diffie-Hellman prime sent by the server is not acceptable (not long enough).

GNUTLS_E_ENCRYPTION_FAILED:

Encryption has failed.

GNUTLS_E_ERROR_IN_FINISHED_PACKET:

An error was encountered at the TLS Finished packet calculation.

GNUTLS_E_EXPIRED:

The requested session has expired.

GNUTLS_E_FATAL_ALERT_RECEIVED:

A TLS fatal alert has been received.

GNUTLS_E_FILE_ERROR:

Error while reading file.

GNUTLS_E_GOT_APPLICATION_DATA:

TLS Application data were received, while expecting handshake data.

GNUTLS_E_HANDSHAKE_TOO_LARGE:

The handshake data size is too large (DoS?), check gnutls_handshake_set_max_packet_length().

GNUTLS_E_HASH_FAILED:

Hashing has failed.

GNUTLS_E_IA_VERIFY_FAILED:

Verifying TLS/IA phase checksum failed

GNUTLS_E_ILLEGAL_SRP_USERNAME:

The SRP username supplied is illegal.

GNUTLS_E_INCOMPATIBLE_GCRYPT_LIBRARY:

The gcrypt library version is too old.

GNUTLS_E_INCOMPATIBLE_LIBTASN1_LIBRARY:

The tasn1 library version is too old.

GNUTLS_E_INIT_LIBEXTRA:

The initialization of GnuTLS-extra has failed.

GNUTLS_E_INSUFFICIENT_CREDENTIALS:

Insufficient credentials for that request.

GNUTLS_E_INTERNAL_ERROR:

GnuTLS internal error.

GNUTLS_E_INTERRUPTED:

Function was interrupted.

GNUTLS_E_INVALID_PASSWORD:

The given password contains invalid characters.

GNUTLS_E_INVALID_REQUEST:

The request is invalid.

GNUTLS_E_INVALID_SESSION:

The specified session has been invalidated for some reason.

GNUTLS_E_KEY_USAGE_VIOLATION:

Key usage violation in certificate has been detected.

GNUTLS_E_LARGE_PACKET:

A large TLS record packet was received.

GNUTLS_E_LIBRARY_VERSION_MISMATCH:

The GnuTLS library version does not match the GnuTLS-extra library version.

GNUTLS_E_LZO_INIT_FAILED:

The initialization of LZO has failed.

GNUTLS_E_MAC_VERIFY_FAILED:

The Message Authentication Code verification failed.

GNUTLS_E_MEMORY_ERROR:

Internal error in memory allocation.

GNUTLS_E_MPI_PRINT_FAILED:

Could not export a large integer.

GNUTLS_E_MPI_SCAN_FAILED:

The scanning of a large integer has failed.

GNUTLS_E_NO_CERTIFICATE_FOUND:

The peer did not send any certificate.

GNUTLS_E_NO_CIPHER_SUITES:

No supported cipher suites have been found.

GNUTLS_E_NO_COMPRESSION_ALGORITHMS:

No supported compression algorithms have been found.

GNUTLS_E_NO_TEMPORARY_DH_PARAMS:

No temporary DH parameters were found.

GNUTLS_E_NO_TEMPORARY_RSA_PARAMS:

No temporary RSA parameters were found.

GNUTLS_E_OPENPGP_FINGERPRINT_UNSUPPORTED:

The OpenPGP fingerprint is not supported.

GNUTLS_E_OPENPGP_GETKEY_FAILED:

Could not get OpenPGP key.

GNUTLS_E_OPENPGP_KEYRING_ERROR:

Error loading the keyring.

GNUTLS_E_OPENPGP_SUBKEY_ERROR:

Could not find OpenPGP subkey.

GNUTLS_E_OPENPGP_UID_REVOKED:

The OpenPGP User ID is revoked.

GNUTLS_E_PKCS1_WRONG_PAD:

Wrong padding in PKCS1 packet.

GNUTLS_E_PK_DECRYPTION_FAILED:

Public key decryption has failed.

GNUTLS_E_PK_ENCRYPTION_FAILED:

Public key encryption has failed.

GNUTLS_E_PK_SIGN_FAILED:

Public key signing has failed.

GNUTLS_E_PK_SIG_VERIFY_FAILED:

Public key signature verification has failed.

GNUTLS_E_PULL_ERROR:

Error in the pull function.

GNUTLS_E_PUSH_ERROR:

Error in the push function.

GNUTLS_E_RANDOM_FAILED:

Failed to acquire random data.

GNUTLS_E_RECEIVED_ILLEGAL_EXTENSION:

An illegal TLS extension was received.

GNUTLS_E_RECEIVED_ILLEGAL_PARAMETER:

An illegal parameter has been received.

GNUTLS_E_RECORD_LIMIT_REACHED:

The upper limit of record packet sequence numbers has been reached. Wow!

GNUTLS_E_REHANDSHAKE:

Rehandshake was requested by the peer.

GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE:

The requested data were not available.

GNUTLS_E_SAFE_RENEGOTIATION_FAILED:

Safe renegotiation failed.

GNUTLS_E_SHORT_MEMORY_BUFFER:

The given memory buffer is too short to hold parameters.

GNUTLS_E_SRP_PWD_ERROR:

Error in password file.

GNUTLS_E_SRP_PWD_PARSING_ERROR:

Parsing error in password file.

GNUTLS_E_SUCCESS:

Success.

GNUTLS_E_TOO_MANY_EMPTY_PACKETS:

Too many empty record packets have been received.

GNUTLS_E_UNEXPECTED_HANDSHAKE_PACKET:

An unexpected TLS handshake packet was received.

GNUTLS_E_UNEXPECTED_PACKET:

An unexpected TLS packet was received.

GNUTLS_E_UNEXPECTED_PACKET_LENGTH:

A TLS packet with unexpected length was received.

GNUTLS_E_UNKNOWN_ALGORITHM:

The specified algorithm or protocol is unknown.

GNUTLS_E_UNKNOWN_CIPHER_SUITE:

Could not negotiate a supported cipher suite.

GNUTLS_E_UNKNOWN_CIPHER_TYPE:

The cipher type is unsupported.

GNUTLS_E_UNKNOWN_COMPRESSION_ALGORITHM:

Could not negotiate a supported compression method.

GNUTLS_E_UNKNOWN_HASH_ALGORITHM:

The hash algorithm is unknown.

GNUTLS_E_UNKNOWN_PKCS_BAG_TYPE:

The PKCS structure’s bag type is unknown.

GNUTLS_E_UNKNOWN_PKCS_CONTENT_TYPE:

The PKCS structure’s content type is unknown.

GNUTLS_E_UNKNOWN_PK_ALGORITHM:

An unknown public key algorithm was encountered.

GNUTLS_E_UNKNOWN_SRP_USERNAME:

The SRP username supplied is unknown.

GNUTLS_E_UNSAFE_RENEGOTIATION_DENIED:

Unsafe renegotiation denied.

GNUTLS_E_UNSUPPORTED_CERTIFICATE_TYPE:

The certificate type is not supported.

GNUTLS_E_UNSUPPORTED_SIGNATURE_ALGORITHM:

The signature algorithm is not supported.

GNUTLS_E_UNSUPPORTED_VERSION_PACKET:

A record packet with illegal version was received.

GNUTLS_E_UNWANTED_ALGORITHM:

An algorithm that is not enabled was negotiated.

GNUTLS_E_WARNING_ALERT_RECEIVED:

A TLS warning alert has been received.

GNUTLS_E_WARNING_IA_FPHF_RECEIVED:

Received a TLS/IA Final Phase Finished message

GNUTLS_E_WARNING_IA_IPHF_RECEIVED:

Received a TLS/IA Intermediate Phase Finished message

GNUTLS_E_X509_UNKNOWN_SAN:

Unknown Subject Alternative name in X.509 certificate.

GNUTLS_E_X509_UNSUPPORTED_ATTRIBUTE:

The certificate has unsupported attributes.

GNUTLS_E_X509_UNSUPPORTED_CRITICAL_EXTENSION:

Unsupported critical extension in X.509 certificate.

GNUTLS_E_X509_UNSUPPORTED_OID:

The OID is not supported.