Credential Handle Attributes

Create/Destroy/Modify GSI Credential Handle Attributes. More...

Credential Handle Attributes Initialization and Destruction

Copy Credential Handle Attributes

Seting and Getting the CA Cert Dir

Setting and Getting the Search Order

Typedefs


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:.

  • The search order is set to SERVICE, HOST, PROXY, USER
  • 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_t  handle_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_t  source,
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_t  handle_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_t  handle_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_t  handle_attrs,
globus_gsi_cred_type_t  search_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_t  handle_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


about globus | globus toolkit | dev.globus

Comments? webmaster@globus.org