globus_openssl_activation(3) [debian man page]

Activation(3)						       globus openssl module						     Activation(3)

NAME

       Activation -

   Defines
       #define GLOBUS_OPENSSL_MODULE

Detailed Description
       Globus OpenSSL uses standard Globus module activation and deactivation.

       Before any OpenSSL functions are called, the following function must be called:

	     globus_module_activate(GLOBUS_OPENSSL_MODULE)

       This function returns GLOBUS_SUCCESS if OpenSSL was successfully initialized, and you are therefore allowed to subsequently call OpenSSL
       functions. Otherwise, an error code is returned, and OpenSSL functions should not subsequently be called. This function may be called
       multiple times.

       To deactivate the OpenSSL module , the following function must be called:

	   globus_module_deactivate(GLOBUS_OPENSSL_MODULE)

       This function should be called once for each time OpenSSL was activated.

Define Documentation
   #define GLOBUS_OPENSSL_MODULE
       Module descriptor.

Author
       Generated automatically by Doxygen for globus openssl module from the source code.

Version 3.2							  Mon Apr 30 2012						     Activation(3)

Error Helper Functions(3)				     globus gsi openssl error					 Error Helper Functions(3)

NAME

       Error Helper Functions -

   OpenSSL Error Match
       globus_bool_t globus_error_match_openssl_error (globus_object_t *error, unsigned long library, unsigned long function, unsigned long
	   reason)

   Wrap OpenSSL Error
       globus_object_t * globus_error_wrap_openssl_error (globus_module_descriptor_t *base_source, int error_type, const char *source_file, const
	   char *source_func, int source_line, const char *format,...)

Detailed Description
       Utility functions that deal with Globus OpenSSL Error objects.

       This section defines utility function for Globus OpenSSL Error objects.

Function Documentation
   globus_bool_t globus_error_match_openssl_error (globus_object_t *error, unsigned longlibrary, unsigned longfunction, unsigned longreason)
       Check whether the error originated from a specific library, from a specific function and is of a specific type. This function checks
       whether the error or any of it's causative errors originated from a specific library, specific function and is of a specific type.

       Parameters:
	   error The error object for which to perform the check
	   library The library to check for
	   function The function to check for
	   reason The type to check for

       Returns:
	   GLOBUS_TRUE - the error matched GLOBUS_FALSE - the error failed to match

   globus_object_t* globus_error_wrap_openssl_error (globus_module_descriptor_t *base_source, interror_type, const char *source_file, const char
       *source_func, intsource_line, const char *format, ...)
       Wrap the OpenSSL error and create a wrapped globus error object from the error. This function gets all the openssl errors from the error
       list, and chains them using the globus error string object. The resulting globus error object is a wrapper to the openssl error at the end
       of the chain.

       Parameters:
	   base_source The module that the error was generated from
	   error_type The type of error encapsulating the openssl error
	   source_file Name of file. Use __FILE__
	   source_func Name of function. Use _globus_func_name and declare your func with GlobusFuncName(<name>)
	   source_line Line number. Use __LINE__
	   format format string for the description of the error entry point where the openssl error occurred, should be followed by parameters to
	   fill the format string (like in printf).

       Returns:
	   The globus error object. A globus_result_t object can be created using the globus_error_put function

       See also:
	   globus_error_put()

Author
       Generated automatically by Doxygen for globus gsi openssl error from the source code.

Version 2.1							  Wed Jan 25 2012					 Error Helper Functions(3)