globus_gsi_cert_utils_activation(3) [debian man page]

Activation(3)						       globus gsi cert utils						     Activation(3)

NAME

       Activation -

   Defines
       #define GLOBUS_GSI_CERT_UTILS_MODULE

Detailed Description
       Globus GSI Cert Utils uses standard Globus module activation and deactivation.

       Before any Globus GSI Cert Utils functions are called, the following function must be called:

	     globus_module_activate(GLOBUS_GSI_CERT_UTILS_MODULE)

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

       To deactivate Globus GSI Cert Utils, the following function must be called:

	   globus_module_deactivate(GLOBUS_GSI_CERT_UTILS_MODULE)

       This function should be called once for each time Globus GSI Cert Utils was activated.

Define Documentation
   #define GLOBUS_GSI_CERT_UTILS_MODULE
       Module descriptor.

Author
       Generated automatically by Doxygen for globus gsi cert utils from the source code.

Version 8.3							  Mon Apr 30 2012						     Activation(3)

Credential Handle Attributes(3) 			       globus gsi credential				   Credential Handle Attributes(3)

NAME

       Credential Handle Attributes -

   Typedefs
       typedef struct
	   globus_l_gsi_cred_handle_attrs_s * globus_gsi_cred_handle_attrs_t"

   Credential Handle Attributes Initialization and Destruction
       globus_result_t globus_gsi_cred_handle_attrs_init (globus_gsi_cred_handle_attrs_t *handle_attrs)
       globus_result_t globus_gsi_cred_handle_attrs_destroy (globus_gsi_cred_handle_attrs_t handle_attrs)

   Copy Credential Handle Attributes
       globus_result_t globus_gsi_cred_handle_attrs_copy (globus_gsi_cred_handle_attrs_t source, globus_gsi_cred_handle_attrs_t *dest)

   Seting and Getting the CA Cert Dir
       globus_result_t globus_gsi_cred_handle_attrs_set_ca_cert_dir (globus_gsi_cred_handle_attrs_t handle_attrs, char *ca_cert_dir)
       globus_result_t globus_gsi_cred_handle_attrs_get_ca_cert_dir (globus_gsi_cred_handle_attrs_t handle_attrs, char **ca_cert_dir)

   Setting and Getting the Search Order
       globus_result_t globus_gsi_cred_handle_attrs_set_search_order (globus_gsi_cred_handle_attrs_t handle_attrs, globus_gsi_cred_type_t
	   search_order[])
       globus_result_t globus_gsi_cred_handle_attrs_get_search_order (globus_gsi_cred_handle_attrs_t handle_attrs, globus_gsi_cred_type_t
	   **search_order)

Detailed Description
       Create/Destroy/Modify GSI Credential Handle Attributes.

       Within the Globus GSI Credential Library, all credential handles contain a attribute structure, which in turn contains handle instance
       independent attributes.

       This section defines operations to create, modify and destroy GSI Credential handle attributes.

Typedef Documentation
   typedef struct globus_l_gsi_cred_handle_attrs_s* globus_gsi_cred_handle_attrs_t
       Credential Handle Attributes. Credential handle attributes provide a set of immutable parameters for a credential handle

       See also:
	   globus_gsi_cred_handle_init

Function Documentation
   globus_result_t globus_gsi_cred_handle_attrs_init (globus_gsi_cred_handle_attrs_t *handle_attrs)
       Initializes the immutable Credential Handle Attributes The handle attributes are initialized as follows: .IP "o" 2 The search order is set
       to SERVICE, HOST, PROXY, USER

       o All other attributes are set to 0/NULL

       Parameters:
	   handle_attrs the attributes to be initialized

       Returns:
	   GLOBUS_SUCESS if initialization was successful, otherwise an error is returned

   globus_result_t globus_gsi_cred_handle_attrs_destroy (globus_gsi_cred_handle_attrs_thandle_attrs)
       Destroy the Credential Handle Attributes. This function does some cleanup and deallocation of the handle attributes.

       Parameters:
	   handle_attrs The handle attributes to destroy

       Returns:
	   GLOBUS_SUCCESS

   globus_result_t globus_gsi_cred_handle_attrs_copy (globus_gsi_cred_handle_attrs_tsource, globus_gsi_cred_handle_attrs_t *dest)
       Copy the Credential Handle Attributes. Parameters:
	   source The handle attribute to be copied
	   dest The copy

       Returns:
	   GLOBUS_SUCESS unless there was an error, in which case an error object is returned.

   globus_result_t globus_gsi_cred_handle_attrs_set_ca_cert_dir (globus_gsi_cred_handle_attrs_thandle_attrs, char *ca_cert_dir)
       Set the Trusted CA Certificate Directory Location. Parameters:
	   handle_attrs the credential handle attributes to set
	   ca_cert_dir the trusted ca certificates directory

       Returns:
	   GLOBUS_SUCCESS if no errors occurred. In case of a null handle_attrs, an error object id is returned

   globus_result_t globus_gsi_cred_handle_attrs_get_ca_cert_dir (globus_gsi_cred_handle_attrs_thandle_attrs, char **ca_cert_dir)
       Get the trusted ca cert directory. Parameters:
	   handle_attrs the credential handle attributes to get the trusted ca cert directory from
	   ca_cert_dir the trusted ca certificates directory

       Returns:
	   GLOBUS_SUCCESS if no errors occurred. In case of a null handle_attrs or pointer to ca_cert_dir, an error object id is returned

   globus_result_t globus_gsi_cred_handle_attrs_set_search_order (globus_gsi_cred_handle_attrs_thandle_attrs,
       globus_gsi_cred_type_tsearch_order[])
       Set the search order for finding a user certificate. The default value is {SERVICE, HOST, PROXY, USER}

       Parameters:
	   handle_attrs The handle attributes to set the search order of
	   search_order The search order. Should be a three element array containing in some order PROXY, USER, HOST, SERVICE. The array should be
	   terminated by the value GLOBUS_SO_END.

       Returns:
	   GLOBUS_SUCCESS unless handle_attrs is null

   globus_result_t globus_gsi_cred_handle_attrs_get_search_order (globus_gsi_cred_handle_attrs_thandle_attrs, globus_gsi_cred_type_t
       **search_order)
       Get the search order of the handle attributes. Parameters:
	   handle_attrs The handle attributes to get the search order from
	   search_order The search_order of the handle attributes

       Returns:
	   GLOBUS_SUCCESS unless handle_attrs is null

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

Version 5.3							  Mon Apr 30 2012				   Credential Handle Attributes(3)