Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
KRB5_RD_ERROR(3)	     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  mes-
     sage

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 struc-
     ture 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 er-
     ror 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 		KRB5_RD_ERROR(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=krb5_rd_error&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help