debian man page for krb5_free_error

Query: krb5_free_error

OS: debian

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

KRB5_RD_ERROR(3)					   BSD Library Functions Manual 					  KRB5_RD_ERROR(3)

NAME
krb5_rd_error, krb5_free_error, krb5_free_error_contents, krb5_error_from_rd_error -- parse, free and read error from KRB-ERROR message
LIBRARY
Kerberos 5 Library (libkrb5, -lkrb5)
SYNOPSIS
#include <krb5.h> krb5_error_code krb5_rd_error(krb5_context context, const krb5_data *msg, KRB_ERROR *result); void krb5_free_error(krb5_context context, krb5_error *error); void krb5_free_error_contents(krb5_context context, krb5_error *error); krb5_error_code krb5_error_from_rd_error(krb5_context context, const krb5_error *error, const krb5_creds *creds);
DESCRIPTION
Usually applications never needs to parse and understand Kerberos error messages since higher level functions will parse and push up the error in the krb5_context. These functions are described for completeness. krb5_rd_error() parses and returns the kerboeros error message, the structure should be freed with krb5_free_error_contents() when the caller is done with the structure. krb5_free_error() frees the content and the memory region holding the structure iself. krb5_free_error_contents() free the content of the KRB-ERROR message. krb5_error_from_rd_error() will parse the error message and set the error buffer in krb5_context to the error string passed back or the matching error code in the KRB-ERROR message. Caller should pick up the message with krb5_get_error_string(3) (don't forget to free the returned string with krb5_free_error_string()).
SEE ALSO
krb5(3), krb5_set_error_string(3), krb5_get_error_string(3), krb5.conf(5)
HEIMDAL
July 26, 2004 HEIMDAL
Related Man Pages
krb5_error_from_rd_error(3) - debian
krb5_free_error(3) - debian
krb5_rc_default_type(3) - debian
krb5_rc_get_name(3) - debian
krb5_rd_error(3) - freebsd
Similar Topics in the Unix Linux Community
Adapter Errors and Link Errors
Need to capture ERROR msg and stack trace
Script help needed
Grep to find single instances of each ERROR type
Error line number