KRB5_WARN(3) OpenBSD Programmer's Manual KRB5_WARN(3)NAME
krb5_abort, krb5_abortx, krb5_clear_error_string, krb5_err, krb5_errx,
krb5_free_error_string, krb5_get_err_text, krb5_get_error_string,
krb5_have_error_string, krb5_set_error_string, krb5_set_warn_dest,
krb5_vabort, krb5_vabortx, krb5_verr, krb5_verrx, krb5_vset_error_string,
krb5_vwarn, krb5_vwarnx, krb5_warn, krb5_warnx - Heimdal warning and
error functions
LIBRARY
Kerberos 5 Library (libkrb5, -lkrb5)
SYNOPSIS
#include <krb5.h>
krb5_error_code
krb5_abort(krb5_context context, krb5_error_code code, const char
*fmt, ...);
krb5_error_code
krb5_abortx(krb5_context context, krb5_error_code code, const char
*fmt, ...);
void
krb5_clear_error_string(krb5_context context);
krb5_error_code
krb5_err(krb5_context context, int eval, krb5_error_code code, const char
*format, ...);
krb5_error_code
krb5_errx(krb5_context context, int eval, const char *format, ...);
void
krb5_free_error_string(krb5_context context, char *str);
krb5_error_code
krb5_verr(krb5_context context, int eval, krb5_error_code code, const
char *format, va_list ap);
krb5_error_code
krb5_verrx(krb5_context context, int eval, const char *format, va_list
ap);
krb5_error_code
krb5_vset_error_string(krb5_context context, const char *fmt, va_list
args);
krb5_error_code
krb5_vwarn(krb5_context context, krb5_error_code code, const char
*format, va_list ap);
krb5_error_code
krb5_vwarnx(krb5_context context, const char *format, va_list ap);
krb5_error_code
krb5_warn(krb5_context context, krb5_error_code code, const char
*format, ...);
krb5_error_code
krb5_warnx(krb5_context context, const char *format, ...);
krb5_error_code
krb5_set_error_string(krb5_context context, const char *fmt, ...);
krb5_error_code
krb5_set_warn_dest(krb5_context context, krb5_log_facility *facility);
char *
krb5_get_err_text(krb5_context context, krb5_error_code code);
char*
krb5_get_error_string(krb5_context context);
krb5_boolean
krb5_have_error_string(krb5_context context);
krb5_error_code
krb5_vabortx(krb5_context context, const char *fmt, va_list ap);
krb5_error_code
krb5_vabort(krb5_context context, const char *fmt, va_list ap);
DESCRIPTION
These functions print a warning message to some destination. format is a
printf style format specifying the message to print. The forms not ending
in an ``x'' print the error string associated with code along with the
message. The ``err'' functions exit with exit status eval after printing
the message.
The krb5_set_warn_func() function sets the destination for warning
messages to the specified facility. Messages logged with the ``warn''
functions have a log level of 1, while the ``err'' functions log with
level 0.
krb5_get_err_text() fetches the human readable strings describing the
error-code.
krb5_abort() and krb5_abortx behaves like krb5_err and krb5_errx but
instead of exiting using the exit(3) call, abort(3) is used.
krb5_free_error_string() frees the error string str returned by
krb5_get_error_string().
krb5_clear_error_string() clears the error string from the context.
krb5_set_error_string() and krb5_vset_error_string() sets an verbose
error string in context.
krb5_get_error_string() fetches the error string from context. The error
message in the context is consumed and must be freed using
krb5_free_error_string() by the caller.
krb5_have_error_string() returns TRUE if there is a verbose error message
in the context.
SEE ALSOkrb5(3), krb5_openlog(3)HEIMDAL March 20, 2004 HEIMDAL