Detailed Description

Functions that deal with the data structure that contains state associated with the path validation callback.

Typedef Documentation

typedef struct globus_l_gsi_callback_data_s* \fBglobus_gsi_callback_data_t\fP

Callback data typedef

Function Documentation

globus_result_t globus_gsi_callback_data_copy (\fBglobus_gsi_callback_data_t\fPsource, \fBglobus_gsi_callback_data_t\fP *dest)

Copy a callback data structure. This function copies a globus_gsi_callback_data_t.

Parameters:

source The structure to be copied

dest The destination of the copy

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_data_destroy (\fBglobus_gsi_callback_data_t\fPcallback_data)

Initialize a callback data structure. This function destroys a globus_gsi_callback_data_t.

Parameters:

callback_data The structure to be destroyed

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_data_init (\fBglobus_gsi_callback_data_t\fP *callback_data)

Initialize a callback data structure. This function initializes a globus_gsi_callback_data_t.

Parameters:

callback_data Reference to the structure to be initialized

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_get_allow_missing_signing_policy (\fBglobus_gsi_callback_data_t\fPcallback_data, globus_bool_t *allow)

Get the 'allow missing signing policy' flag. This function gets the value of the 'allow missing signing policy' flag in the callback data. If this is TRUE then the CA signing policy need not be present.

Parameters:

callback_data The globus_gsi_callback_data_t to get the error from

allow Contains the value of the flag upon successful return.

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

Since:

Globus Toolkit 5.2.0

globus_result_t globus_gsi_callback_get_cert_chain (\fBglobus_gsi_callback_data_t\fPcallback_data, STACK_OF(X509)**cert_chain)

Get the certificate chain. This function returns the certificate chain associated with the callback data.

Parameters:

callback_data The globus_gsi_callback_data_t to retrieve the certificate chain from.

cert_chain Contains the certificate chain upon successful return

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_get_cert_depth (\fBglobus_gsi_callback_data_t\fPcallback_data, int *cert_depth)

Getting the certificate chain depth. This function returns the certificate chain depth.

Parameters:

callback_data The globus_gsi_callback_data_t to retrieve the depth from

cert_depth The returned certificate chain depth

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_get_cert_dir (\fBglobus_gsi_callback_data_t\fPcallback_data, char **cert_dir)

Get the trusted certificate directory. This function gets the trusted certificate directory from the callback data.

Parameters:

callback_data The globus_gsi_callback_data_t to get the trusted certificates directory from.

cert_dir Contains the path to the trusted certificate directory upon successful return.

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_get_cert_type (\fBglobus_gsi_callback_data_t\fPcallback_data, globus_gsi_cert_utils_cert_type_t *cert_type)

Get the certificate type. This function returns the certificate type of the certificate currently being processed

Parameters:

callback_data The globus_gsi_callback_data_t to retrieve the certificate type from

cert_type Variable containing the certificate type on return

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_get_check_policy_for_self_signed_certs (\fBglobus_gsi_callback_data_t\fPcallback_data, globus_bool_t *check)

Get the self-signed policy checking flag. This function gets the value of the 'check policy for self-signed certificates flag' in the callback data. If this is set than the CA signing policy for a self-signed certificate must include a policy line that allows it to sign itself.

Parameters:

callback_data The globus_gsi_callback_data_t to get the error from

check Contains the value of the flag upon successful return.

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

Since:

Globus Toolkit 4.2.1

globus_result_t globus_gsi_callback_get_error (\fBglobus_gsi_callback_data_t\fPcallback_data, globus_result_t *error)

Get error status. This function gets the error status stored in the callback data.

Parameters:

callback_data The globus_gsi_callback_data_t to get the error from

error Contains the error upon successful return.

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_get_extension_cb (\fBglobus_gsi_callback_data_t\fPcallback_data, \fBglobus_gsi_extension_callback_t\fP *extension_cb)

Get the unknown X.509 extension callback. This function gets the callback that is called for unknown X.509 extensions

Parameters:

callback_data The globus_gsi_callback_data_t to get the callback information from

extension_cb Contains the extension callback upon successful return.

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_get_extension_oids (\fBglobus_gsi_callback_data_t\fPcallback_data, void **extension_oids)

Get X.509 extension OIDs. This function gets a list of X.509 extension OIDs that may be used by the extensions callback to allow or disallow certain extensions.

Parameters:

callback_data The globus_gsi_callback_data_t to get the array of extension OIDs from.

extension_oids Contains the list of extension OIDs upon successful return.

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_get_multiple_limited_proxy_ok (\fBglobus_gsi_callback_data_t\fPcallback_data, int *multiple_limited_proxy_ok)

Get the limited proxy handling setting. This function gets the value of the limited proxy handling setting. This setting determines whether path validation will accept limited proxies that have been further delegated, i.e. certificate chains with a limited proxy followed by further proxies.

Parameters:

callback_data The globus_gsi_callback_data_t to get the limited proxy setting from

multiple_limited_proxy_ok Contains the value of the setting upon successful return.

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_get_proxy_depth (\fBglobus_gsi_callback_data_t\fPcallback_data, int *proxy_depth)

Get the 'proxy chain' depth. This function returns the number of proxies in the certificate chain.

Parameters:

callback_data The globus_gsi_callback_data_t to retrieve the depth from

proxy_depth The returned 'proxy chain' depth

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_set_allow_missing_signing_policy (\fBglobus_gsi_callback_data_t\fPcallback_data, globus_bool_tallow)

Set the 'allow missing signing policy' flag. This function sets the value of the 'allow missing signing policy' flag in the callback data. If this is TRUE then the CA signing policy need not be present.

Parameters:

callback_data The globus_gsi_callback_data_t to set the error on

allow New value of the flag

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

Since:

Globus Toolkit 5.2.0

globus_result_t globus_gsi_callback_set_cert_chain (\fBglobus_gsi_callback_data_t\fPcallback_data, STACK_OF(X509)*cert_chain)

Set the certificate chain. This function sets the certificate chain associated with the callback data.

Parameters:

callback_data The globus_gsi_callback_data_t to set the certificate chain on

cert_chain The certificate chain

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_set_cert_depth (\fBglobus_gsi_callback_data_t\fPcallback_data, intcert_depth)

Set the certificate chain depth. This function sets the certificate chain depth

Parameters:

callback_data The globus_gsi_callback_data_t to retrieve the depth from

cert_depth The certificate chain depth

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_set_cert_dir (\fBglobus_gsi_callback_data_t\fPcallback_data, char *cert_dir)

Set the trusted certificate directory. This function sets the trusted certificate directory on the callback data.

Parameters:

callback_data The globus_gsi_callback_data_t to set the trusted certificates directory on.

cert_dir The path to the trusted certificate directory

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_set_cert_type (\fBglobus_gsi_callback_data_t\fPcallback_data, globus_gsi_cert_utils_cert_type_tcert_type)

Set the certificate type. This function sets the certificate type of the certificate currently being processed

Parameters:

callback_data The globus_gsi_callback_data_t to set the certificate type on

cert_type The certificate type

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_set_check_policy_for_self_signed_certs (\fBglobus_gsi_callback_data_t\fPcallback_data, globus_bool_tcheck)

Set the self-signed policy checking flag. This function sets the value of the 'check policy for self-signed certificates flag' in the callback data. If this is set than the CA signing policy for a self-signed certificate must include a policy line that allows it to sign itself.

Parameters:

callback_data The globus_gsi_callback_data_t to set the error on

check New value of the flag

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

Since:

Globus Toolkit 4.2.1

globus_result_t globus_gsi_callback_set_error (\fBglobus_gsi_callback_data_t\fPcallback_data, globus_result_terror)

Set error status. This function sets the error status stored in the callback data.

Parameters:

callback_data The globus_gsi_callback_data_t to set the error on

error The error

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_set_extension_cb (\fBglobus_gsi_callback_data_t\fPcallback_data, \fBglobus_gsi_extension_callback_t\fPextension_cb)

Set the unknown X.509 extension callback

This function sets the callback that is called for unknown X.509 extensions.

Parameters:

callback_data The globus_gsi_callback_data_t to set the callback information on

extension_cb The extension callback

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_set_extension_oids (\fBglobus_gsi_callback_data_t\fPcallback_data, void *extension_oids)

Set X.509 extension OIDs. This function sets a list of X.509 extension OIDs that may be used by the extensions callback to allow or disallow certain extensions.

Parameters:

callback_data The globus_gsi_callback_data_t to get the array of extension OIDs from.

extension_oids The list of extension OIDs

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_set_multiple_limited_proxy_ok (\fBglobus_gsi_callback_data_t\fPcallback_data, intmultiple_limited_proxy_ok)

Set the limited proxy handling setting. This function sets the value of the limited proxy handling setting. This setting determines whether path validation will accept limited proxies that have been further delegated, i.e. certificate chains with a limited proxy followed by further proxies.

Parameters:

callback_data The globus_gsi_callback_data_t to set the limited proxy setting on

multiple_limited_proxy_ok The value of the setting

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

globus_result_t globus_gsi_callback_set_proxy_depth (\fBglobus_gsi_callback_data_t\fPcallback_data, intproxy_depth)

Set the 'proxy chain' depth. This function sets the number of proxies in the certificate chain.

Parameters:

callback_data The globus_gsi_callback_data_t to retrieve the depth from

proxy_depth The 'proxy chain' depth

Returns:

GLOBUS_SUCCESS unless an error occurred, in which case, a globus error object ID is returned

Author

Generated automatically by Doxygen for globus_gsi_callback from the source code.