Next: , Up: Error Handling


5.17.1 Error Values

Errors are returned as an int. Except for the SHISHI_OK case, an application should always use the constants instead of their numeric value. Applications are encouraged to use the constants even for SHISHI_OK as it improves readability. Possible values are:

SHISHI_OK
This value indicates success. The value of this error is guaranteed to always be 0 so you may use it in boolean constructs.
SHISHI_ASN1_ERROR
Error in ASN.1 function (corrupt data?)
SHISHI_FOPEN_ERROR
Could not open file
SHISHI_IO_ERROR
File input/output error
SHISHI_MALLOC_ERROR
Memory allocation error in shishi library.
SHISHI_BASE64_ERROR
Base64 encoding or decoding failed. Data corrupt?
SHISHI_REALM_MISMATCH
Client realm value differ between request and reply.
SHISHI_CNAME_MISMATCH
Client name value differ between request and reply.
SHISHI_NONCE_MISMATCH
Replay protection value (nonce) differ between request and reply.
SHISHI_TICKET_BAD_KEYTYPE
Keytype used to encrypt ticket doesn't match provided key. This usually indicates an internal application error.
SHISHI_CRYPTO_INTERNAL_ERROR
Internal error in low-level crypto routines.
SHISHI_CRYPTO_ERROR
Low-level cryptographic primitive failed. This usually indicates bad password or data corruption.
SHISHI_KDC_TIMEOUT
Timedout talking to KDC. This usually indicates a network or KDC address problem.
SHISHI_KDC_NOT_KNOWN_FOR_REALM
No KDC for realm known.
SHISHI_SOCKET_ERROR
The system call socket() failed. This usually indicates that your system does not support the socket type.
SHISHI_BIND_ERROR
The system call bind() failed. This usually indicates insufficient permissions.
SHISHI_SENDTO_ERROR
The system call sendto() failed.
SHISHI_CLOSE_ERROR
The system call close() failed.
SHISHI_GOT_KRBERROR
Server replied with an error message to request.
SHISHI_INVALID_TKTS
Ticketset not initialized. This usually indicates an internal application error.
SHISHI_APREQ_DECRYPT_FAILED
Could not decrypt AP-REQ using provided key. This usually indicates an internal application error.
SHISHI_TICKET_DECRYPT_FAILED
Could not decrypt Ticket using provided key. This usually indicates an internal application error.
SHISHI_KEYTAB_ERROR
Failed to parse keytab file