Heimdal Kerberos 5 error reporting functions(3) HeimdalKerberos5library Heimdal Kerberos 5 error reporting functions(3)NAME
Heimdal Kerberos 5 error reporting functions -
Functions
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_eai_to_heim_errno (int eai_errno, int system_error)
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_h_errno_to_heim_errno (int eai_errno)
KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_clear_error_message (krb5_context context)
KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_set_error_message (krb5_context context, krb5_error_code ret, const char *fmt,...)
__attribute__((format(printf
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_vwarn (krb5_context context, krb5_error_code code, const char *fmt, va_list ap)
__attribute__((format(printf
Detailed DescriptionFunction Documentation
KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_clear_error_message (krb5_context context)
Clears the error message from the Kerberos 5 context.
Parameters:
context The Kerberos 5 context to clear
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_eai_to_heim_errno (int eai_errno, int system_error)
Convert the getaddrinfo() error code to a Kerberos et error code.
Parameters:
eai_errno contains the error code from getaddrinfo().
system_error should have the value of errno after the failed getaddrinfo().
Returns:
Kerberos error code representing the EAI errors.
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_h_errno_to_heim_errno (int eai_errno)
Convert the gethostname() error code (h_error) to a Kerberos et error code.
Parameters:
eai_errno contains the error code from gethostname().
Returns:
Kerberos error code representing the gethostname errors.
KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_set_error_message (krb5_context context, krb5_error_code ret, const char * fmt, ...)
Set the context full error string for a specific error code. The error that is stored should be internationalized.
The if context is NULL, no error string is stored.
Parameters:
context Kerberos 5 context
ret The error code
fmt Error string for the error code
... printf(3) style parameters.
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_vwarn (krb5_context context, krb5_error_code code, const char * fmt, va_list ap)
Log a warning to the log, default stderr, include the error from the last failure.
Parameters:
context A Kerberos 5 context.
code error code of the last error
fmt message to print
ap arguments
Version 1.5.2 11 Jan 2012 Heimdal Kerberos 5 error reporting functions(3)
Check Out this Related Man Page
Heimdal Kerberos 5 authentication functions(3) HeimdalKerberos5library Heimdal Kerberos 5 authentication functions(3)NAME
Heimdal Kerberos 5 authentication functions -
Functions
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_in_ctx_alloc (krb5_context context, krb5_rd_req_in_ctx *ctx)
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_in_set_keytab (krb5_context context, krb5_rd_req_in_ctx in, krb5_keytab keytab)
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_in_set_pac_check (krb5_context context, krb5_rd_req_in_ctx in, krb5_boolean
flag)
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_out_get_server (krb5_context context, krb5_rd_req_out_ctx out, krb5_principal
*principal)
KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_rd_req_out_ctx_free (krb5_context context, krb5_rd_req_out_ctx ctx)
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_ctx (krb5_context context, krb5_auth_context *auth_context, const krb5_data
*inbuf, krb5_const_principal server, krb5_rd_req_in_ctx inctx, krb5_rd_req_out_ctx *outctx)
Detailed DescriptionFunction Documentation
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_ctx (krb5_context context, krb5_auth_context * auth_context, const krb5_data *
inbuf, krb5_const_principal server, krb5_rd_req_in_ctx inctx, krb5_rd_req_out_ctx * outctx)
The core server function that verify application authentication requests from clients.
Parameters:
context Keberos 5 context.
auth_context the authentication context, can be NULL, then default values for the authentication context will used.
inbuf the (AP-REQ) authentication buffer
server the server with authenticate as, if NULL the function will try to find any available credential in the keytab that will verify
the reply. The function will prefer the server the server client specified in the AP-REQ, but if there is no mach, it will try all
keytab entries for a match. This have serious performance issues for larger keytabs.
inctx control the behavior of the function, if NULL, the default behavior is used.
outctx the return outctx, free with krb5_rd_req_out_ctx_free().
Returns:
Kerberos 5 error code, see krb5_get_error_message().
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_in_ctx_alloc (krb5_context context, krb5_rd_req_in_ctx * ctx)
Allocate a krb5_rd_req_in_ctx as an input parameter to krb5_rd_req_ctx(). The caller should free the context with krb5_rd_req_in_ctx_free()
when done with the context.
Parameters:
context Keberos 5 context.
ctx in ctx to krb5_rd_req_ctx().
Returns:
Kerberos 5 error code, see krb5_get_error_message().
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_in_set_keytab (krb5_context context, krb5_rd_req_in_ctx in, krb5_keytab keytab)
Set the keytab that krb5_rd_req_ctx() will use.
Parameters:
context Keberos 5 context.
in in ctx to krb5_rd_req_ctx().
keytab keytab that krb5_rd_req_ctx() will use, only copy the pointer, so the caller must free they keytab after
krb5_rd_req_in_ctx_free() is called.
Returns:
Kerberos 5 error code, see krb5_get_error_message().
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_in_set_pac_check (krb5_context context, krb5_rd_req_in_ctx in, krb5_boolean flag)
Set if krb5_rq_red() is going to check the Windows PAC or not
Parameters:
context Keberos 5 context.
in krb5_rd_req_in_ctx to check the option on.
flag flag to select if to check the pac (TRUE) or not (FALSE).
Returns:
Kerberos 5 error code, see krb5_get_error_message().
KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_rd_req_out_ctx_free (krb5_context context, krb5_rd_req_out_ctx ctx)
Free the krb5_rd_req_out_ctx.
Parameters:
context Keberos 5 context.
ctx krb5_rd_req_out_ctx context to free.
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_out_get_server (krb5_context context, krb5_rd_req_out_ctx out, krb5_principal *
principal)
Get the principal that was used in the request from the client. Might not match whats in the ticket if krb5_rd_req_ctx() searched in the
keytab for a matching key.
Parameters:
context a Kerberos 5 context.
out a krb5_rd_req_out_ctx from krb5_rd_req_ctx().
principal return principal, free with krb5_free_principal().
Version 1.5.2 11 Jan 2012 Heimdal Kerberos 5 authentication functions(3)