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