hx509 error functions(3)					Heimdalx509library					  hx509 error functions(3)

NAME

       hx509 error functions -

   Functions
       void hx509_clear_error_string (hx509_context context)
       void hx509_set_error_stringv (hx509_context context, int flags, int code, const char *fmt, va_list ap)
       void hx509_set_error_string (hx509_context context, int flags, int code, const char *fmt,...)
       char * hx509_get_error_string (hx509_context context, int error_code)
       void hx509_free_error_string (char *str)
       void hx509_err (hx509_context context, int exit_code, int error_code, const char *fmt,...)

Detailed Description
       See the Hx509 error reporting functions for description and examples.

Function Documentation
   void hx509_clear_error_string (hx509_context context)
       Resets the error strings the hx509 context.

       Parameters:
	   context A hx509 context.

   void hx509_err (hx509_context context, int exit_code, int error_code, const char * fmt,  ...)
       Print error message and fatally exit from error code

       Parameters:
	   context A hx509 context.
	   exit_code exit() code from process.
	   error_code Error code for the reason to exit.
	   fmt format string with the exit message.
	   ... argument to format string.

   void hx509_free_error_string (char * str)
       Free error string returned by hx509_get_error_string().

       Parameters:
	   str error string to free.

   char* hx509_get_error_string (hx509_context context, int error_code)
       Get an error string from context associated with error_code.

       Parameters:
	   context A hx509 context.
	   error_code Get error message for this error code.

       Returns:
	   error string, free with hx509_free_error_string().

   void hx509_set_error_string (hx509_context context, int flags, int code, const char * fmt,  ...)
       See hx509_set_error_stringv().

       Parameters:
	   context A hx509 context.
	   flags

	   o HX509_ERROR_APPEND appends the error string to the old messages (code is updated).

	   code error code related to error message
	   fmt error message format
	   ... arguments to error message format

   void hx509_set_error_stringv (hx509_context context, int flags, int code, const char * fmt, va_list ap)
       Add an error message to the hx509 context.

       Parameters:
	   context A hx509 context.
	   flags

	   o HX509_ERROR_APPEND appends the error string to the old messages (code is updated).

	   code error code related to error message
	   fmt error message format
	   ap arguments to error message format

Version 1.5.2							    11 Jan 2012 					  hx509 error functions(3)