Cafe SSL Error Codes

Error Codes

NSSL_RVAL_OK Success.
NSSL_RVAL_INVALID_NSSL_CTX Invalid context.
NSSL_RVAL_INVALID_NSSL_CONNECTION Invalid connection.
NSSL_RVAL_INVALID_CERT Invalid certificate or private key.
NSSL_RVAL_ZERO_RETURN The SSL connection has been closed.
NSSL_RVAL_WANT_READ/NSSL_RVAL_WANT_WRITE (Only applicable for non-blocking connections) The operation did not complete; the same NSSL I/O function should be called again later. If, by then, the underlying socket has data available for reading (if the result code is NSSL_RVAL_WANT_READ) or allows writing data (NSSL_RVAL_WANT_WRITE), then some TLS/SSL protocol progress will take place, i.e., at least part of a TLS/SSL record will be read or written. The retry may again lead to an NSSL_RVAL_WANT_READ or NSSL_RVAL_WANT_WRITE condition. There is no fixed upper limit for the number of iterations that may be necessary until progress becomes visible at the application protocol level.
NSSL_RVAL_IO_ERROR Some IO error occurred on the underlying socket.
NSSL_RVAL_NSSLLIB_ERROR A failure in the SSL library occurred.
NSSL_RVAL_UNKNOWN Unknown error.
NSSL_RVAL_OUT_OF_MEMORY Out of memory.
NSSL_RVAL_INVALID_STATE Invalid state.
NSSL_RVAL_HANDSHAKE_ERROR SSL Handshake failed.
NSSL_RVAL_NO_CERT No certificate is available.
NSSL_RVAL_INVALID_FD Invalid socket descriptor.
NSSL_RVAL_LIB_NOT_READY SSL library is not yet initialized.
NSSL_RVAL_IPC_ERROR IPC error.
NSSL_RVAL_RESOURCE_LIMIT Resource limit exceeded.
NSSL_RVAL_INVALID_HANDLE Invalid SSL RM handle.
NSSL_RVAL_INVALID_CERT_TYPE Invalid certificate type.
NSSL_RVAL_INVALID_KEY_TYPE Invalid key type.
NSSL_RVAL_INVALID_SIZE Invalid size.
NSSL_RVAL_NO_PEER_CERT No peer certificate is available.
NSSL_RVAL_INSUFFICIENT_SIZE Buffer provided is of insufficient size.
NSSL_RVAL_NO_CIPHER No cipher is available.
NSSL_RVAL_INVALID_ARG Invalid argument.
NSSL_RVAL_INVALID_NSSL_SESSION Invalid SSL session (session either does not exist in the cache or is not from the same context).
NSSL_RVAL_NO_SESSION No SSL session available for the connection.
NSSL_RVAL_SSL_SHUTDOWN_ERROR SSL shutdown failed.
NSSL_RVAL_CERT_SIZE_LIMIT Provided certificate's size exceeds limit.
NSSL_RVAL_CERT_NO_ACCESS Application/process does not have access to the certificate.
NSSL_RVAL_INVALID_CERT_ID Invalid certificate ID.
NSSL_RVAL_CERT_READ_ERROR Error while reading the certificate.
NSSL_RVAL_CERTSTORE_INIT_FAILURE Certificate initialization failed.
NSSL_RVAL_INVALID_CERT_ENCODING The certificate encoding is not supported.
NSSL_RVAL_CERTSTORE_ERR Certificate store error.
NSSL_RVAL_PVTKEY_READ_ERROR Error while reading the private key.
NSSL_RVAL_INVALID_PVTKEY The private key is not valid.
NSSL_RVAL_NOT_READY NSSL is not yet ready.
NSSL_RVAL_NO_CERTSTORE The certificate store is not accessible.
NSSL_RVAL_PVTKEY_SIZE_LIMIT Provided private key's size exceeds limit.
NSSL_RVAL_PROC_MAX_EXT_CERTS Maximum limit of external certificate for the process is reached.
NSSL_RVAL_PROC_MAX_CONTEXTS Maximum limit of NSSL contexts for the process is reached.
NSSL_RVAL_PROC_MAX_CONNECTIONS Maximum limit of NSSL connections for the process is reached.
NSSL_RVAL_CERT_NOT_EXPORTALE The certificate is not exportable.
NSSL_RVAL_INVALID_CERT_SIZE Invalid certificate size.
NSSL_RVAL_INVALID_KEY_SIZE Invalid key size.
NSSL_RVAL_CRL_SIZE_LIMIT CRL cannot be added because the process will go over the maximum limit of the total size of all CRLs it is allowed.
NSSL_RVAL_INVALID_CRL The CRL is invalid.
NSSL_RVAL_INVALID_CRL_TYPE The specified CRL type is invalid.

Revision History

2014/06/02 Added error codes related to CRL.
2012/08/16 Cleanup pass.
2012/04/06 Initial version.


CONFIDENTIAL