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