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
       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 er-
       ror 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 re-
       turned 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_error_from_rd_error&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help