krb5_eai_to_heim_errno(3) [netbsd man page]

KRB5_EAI_TO_HEIM_ERRNO(3)				   BSD Library Functions Manual 				 KRB5_EAI_TO_HEIM_ERRNO(3)

NAME

     krb5_eai_to_heim_errno, krb5_h_errno_to_heim_errno -- convert resolver error code to com_err error codes

LIBRARY

     Kerberos 5 Library (libkrb5, -lkrb5)

SYNOPSIS

     #include <krb5/krb5.h>

     krb5_error_code
     krb5_eai_to_heim_errno(int eai_errno, int system_error);

     krb5_error_code
     krb5_h_errno_to_heim_errno(int eai_errno);

DESCRIPTION

     krb5_eai_to_heim_errno() and krb5_h_errno_to_heim_errno() convert getaddrinfo(3), getnameinfo(3), and h_errno(3) to com_err error code that
     are used by Heimdal, this is useful for for function returning kerberos errors and needs to communicate failures from resolver function.

SEE ALSO

     krb5(3), kerberos(8)

BSD
								  April 13, 2004							       BSD

Heimdal Kerberos 5 error reporting functions(3) 	      HeimdalKerberos5library		   Heimdal Kerberos 5 error reporting functions(3)

NAME

       Heimdal Kerberos 5 error reporting functions -

   Functions
       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 krb5_error_code KRB5_LIB_CALL krb5_vwarn (krb5_context context, krb5_error_code code, const char *fmt, va_list ap)
	   __attribute__((format(printf

Detailed Description
Function Documentation
   KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_clear_error_message (krb5_context context)
       Clears the error message from the Kerberos 5 context.

       Parameters:
	   context The Kerberos 5 context to clear

   KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_eai_to_heim_errno (int eai_errno, int system_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_h_errno_to_heim_errno (int eai_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_set_error_message (krb5_context context, krb5_error_code ret, 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_vwarn (krb5_context context, krb5_error_code code, const char * fmt, va_list ap)
       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

Version 1.5.2							    11 Jan 2012 		   Heimdal Kerberos 5 error reporting functions(3)