krb5_get_error_message (3) - Linux Manuals

NAME

Heimdal Kerberos 5 error reporting functions -

Functions

KRB5_LIB_FUNCTION char
*KRB5_LIB_CALL KRB5_DEPRECATED_FUNCTION ('Use krb5_get_error_message instead')"

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 void
KRB5_LIB_CALL krb5_vset_error_message (krb5_context context, krb5_error_code ret, const char *fmt, va_list args) __attribute__((format(printf"

KRB5_LIB_FUNCTION void
KRB5_LIB_CALL krb5_prepend_error_message (krb5_context context, krb5_error_code ret, const char *fmt,...) __attribute__((format(printf"

KRB5_LIB_FUNCTION void
KRB5_LIB_CALL krb5_vprepend_error_message (krb5_context context, krb5_error_code ret, const char *fmt, va_list args) __attribute__((format(printf"

KRB5_LIB_FUNCTION const char
*KRB5_LIB_CALL krb5_get_error_message (krb5_context context, krb5_error_code code)"

KRB5_LIB_FUNCTION void
KRB5_LIB_CALL krb5_free_error_message (krb5_context context, const char *msg)"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL krb5_abort (krb5_context, krb5_error_code, const char *,...) __attribute__((noreturn"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL krb5_abortx (krb5_context, const char *,...) __attribute__((noreturn"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL krb5_err (krb5_context, int, krb5_error_code, const char *,...) __attribute__((noreturn"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL krb5_errx (krb5_context, int, const char *,...) __attribute__((noreturn"

KRB5_LIB_FUNCTION
krb5_log_facility
*KRB5_LIB_CALL krb5_get_warn_dest (krb5_context)"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL krb5_set_warn_dest (krb5_context, krb5_log_facility *)"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL krb5_vabort (krb5_context, krb5_error_code, const char *, va_list) __attribute__((noreturn"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL krb5_verr (krb5_context, int, krb5_error_code, const char *, va_list) __attribute__((noreturn"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL krb5_verrx (krb5_context, int, const char *, va_list) __attribute__((noreturn"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL krb5_vwarn (krb5_context, krb5_error_code, const char *, va_list) __attribute__((format(printf"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL
KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL krb5_vwarnx (krb5_context, const char *, va_list) __attribute__((format(printf"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL
KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL
KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL krb5_warn (krb5_context, krb5_error_code, const char *,...) __attribute__((format(printf"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL
KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL
KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL
KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL krb5_warnx (krb5_context, const char *,...) __attribute__((format(printf"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL
KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL __attribute__ ((format(printf, 3, 4)))"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL __attribute__ ((format(printf, 2, 0)))"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL __attribute__ ((format(printf, 2, 3)))"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL __attribute__ ((noreturn, format(printf, 3, 0)))"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL __attribute__ ((noreturn, format(printf, 3, 4)))"

KRB5_LIB_FUNCTION
krb5_error_code KRB5_LIB_CALL __attribute__ ((noreturn, format(printf, 2, 3)))"

Detailed Description

Function Documentation

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL __attribute__ ((format(printf, 3, 4)))

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

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL __attribute__ ((format(printf, 2, 0)))

Log a warning to the log, default stderr.

Parameters:

context A Kerberos 5 context.
fmt message to print
ap arguments

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL __attribute__ ((format(printf, 2, 3)))

Log a warning to the log, default stderr.

Parameters:

context A Kerberos 5 context.
fmt message to print

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL __attribute__ ((noreturn, format(printf, 3, 0)))

Log a warning to the log, default stderr, and then exit.

Parameters:

context A Kerberos 5 context
eval the exit code to exit with
fmt message to print
ap arguments

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL __attribute__ ((noreturn, format(printf, 3, 4)))

Log a warning to the log, default stderr, and then exit.

Parameters:

context A Kerberos 5 context
eval the exit code to exit with
fmt message to print

Log a warning to the log, default stderr, include the error from the last failure and then abort.

Parameters:

context A Kerberos 5 context
code error code of the last error
fmt message to print

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL __attribute__ ((noreturn, format(printf, 2, 3)))

Log a warning to the log, default stderr, and then abort.

Parameters:

context A Kerberos 5 context
code error code of the last error
fmt message to print

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_abort (krb5_context, krb5_error_code, const char *, ...)

Log a warning to the log, default stderr, include the error from the last failure and then abort.

Parameters:

context A Kerberos 5 context
code error code of the last error
fmt message to print

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_abortx (krb5_context, const char *, ...)

Log a warning to the log, default stderr, and then abort.

Parameters:

context A Kerberos 5 context
code error code of the last error
fmt message to print

KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_clear_error_message (krb5_contextcontext)

Clears the error message from the Kerberos 5 context.

Parameters:

context The Kerberos 5 context to clear

KRB5_LIB_FUNCTION char *KRB5_LIB_CALL KRB5_DEPRECATED_FUNCTION ('Use krb5_get_error_message instead')

Return the error message in context. On error or no error string, the function returns NULL.

Parameters:

context Kerberos 5 context

Returns:

an error string, needs to be freed with krb5_free_error_message(). The functions return NULL on error.

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_eai_to_heim_errno (inteai_errno, intsystem_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_err (krb5_contextcontext, inteval, krb5_error_codecode, const char *fmt, ...)

Log a warning to the log, default stderr, include bthe error from the last failure and then exit.

Parameters:

context A Kerberos 5 context
eval the exit code to exit with
code error code of the last error
fmt message to print

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_errx (krb5_context, int, const char *, ...)

Log a warning to the log, default stderr, and then exit.

Parameters:

context A Kerberos 5 context
eval the exit code to exit with
fmt message to print

KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_free_error_message (krb5_contextcontext, const char *msg)

Free the error message returned by krb5_get_error_message().

Parameters:

context Kerberos context
msg error message to free, returned byg krb5_get_error_message().

KRB5_LIB_FUNCTION const char *KRB5_LIB_CALL krb5_get_error_message (krb5_contextcontext, krb5_error_codecode)

Return the error message for `code' in context. On memory allocation error the function returns NULL.

Parameters:

context Kerberos 5 context
code Error code related to the error

Returns:

an error string, needs to be freed with krb5_free_error_message(). The functions return NULL on error.

KRB5_LIB_FUNCTION krb5_log_facility *KRB5_LIB_CALL krb5_get_warn_dest (krb5_contextcontext)

Get the default logging facility.

Parameters:

context A Kerberos 5 context

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_h_errno_to_heim_errno (inteai_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_prepend_error_message (krb5_contextcontext, krb5_error_coderet, const char *fmt, ...)

Prepend 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 void KRB5_LIB_CALL krb5_set_error_message (krb5_contextcontext, krb5_error_coderet, 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_set_warn_dest (krb5_contextcontext, krb5_log_facility *fac)

Set the default logging facility.

Parameters:

context A Kerberos 5 context
fac Facility to use for logging.

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_vabort (krb5_contextcontext, krb5_error_codecode, const char *fmt, va_listap)

Log a warning to the log, default stderr, include bthe error from the last failure and then abort.

Parameters:

context A Kerberos 5 context
code error code of the last error
fmt message to print
ap arguments

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_verr (krb5_contextcontext, inteval, krb5_error_codecode, const char *fmt, va_listap)

Log a warning to the log, default stderr, include bthe error from the last failure and then exit.

Parameters:

context A Kerberos 5 context
eval the exit code to exit with
code error code of the last error
fmt message to print
ap arguments

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_verrx (krb5_context, int, const char *, va_list)

Log a warning to the log, default stderr, and then exit.

Parameters:

context A Kerberos 5 context
eval the exit code to exit with
fmt message to print
ap arguments

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_vprepend_error_message (krb5_contextcontext, krb5_error_coderet, const char *fmt, va_listargs)

Prepend the contexts's full error string for a specific error code.

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
args printf(3) style parameters.

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL KRB5_LIB_FUNCTION void KRB5_LIB_CALL KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_vset_error_message (krb5_contextcontext, krb5_error_coderet, const char *fmt, va_listargs)

Set the context full error string for a specific error code.

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
args printf(3) style parameters.

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_vwarn (krb5_contextcontext, krb5_error_codecode, const char *fmt, va_listap)

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

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_vwarnx (krb5_context, const char *, va_list)

Log a warning to the log, default stderr.

Parameters:

context A Kerberos 5 context.
fmt message to print
ap arguments

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_warn (krb5_context, krb5_error_code, const char *, ...)

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

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_warnx (krb5_context, const char *, ...)

Log a warning to the log, default stderr.

Parameters:

context A Kerberos 5 context.
fmt message to print

Author

Generated automatically by Doxygen for HeimdalKerberos5library from the source code.