GRAM Client Attribute Functions

Functions

• int globus_gram_client_attr_init (globus_gram_client_attr_t *attr)
• int globus_gram_client_attr_destroy (globus_gram_client_attr_t *attr)
• int globus_gram_client_attr_set_credential (globus_gram_client_attr_t attr, gss_cred_id_t credential)
• int globus_gram_client_attr_get_credential (globus_gram_client_attr_t attr, gss_cred_id_t *credential)
• int globus_gram_client_attr_set_delegation_mode (globus_gram_client_attr_t attr, globus_io_secure_delegation_mode_t mode)
• int globus_gram_client_attr_get_delegation_mode (globus_gram_client_attr_t attr, globus_io_secure_delegation_mode_t *mode)

---

Function Documentation

int globus_gram_client_attr_init

(

globus_gram_client_attr_t *

attr

)

Initialize a GRAM client attribute.

Parameters:

attr

Pointer to attribute to initialize.

Return values:

	GLOBUS_SUCCESS	Attribute was initialized successfully.
	GLOBUS_GRAM_PROTOCOL_ERROR_INVALID_ATTR	Null value was passed in for attribute.
	GLOBUS_GRAM_PROTOCOL_ERROR_MALLOC_FAILED	Unable to allocate memory to initialize attribute.

See also:

globus_gram_client_attr_destroy()

int globus_gram_client_attr_destroy

(

globus_gram_client_attr_t *

attr

)

Destroy a GRAM client attribute.

Parameters:

attr

Pointer to attribute to destroy.

Return values:

	GLOBUS_SUCCESS	Attribute was initialized successfully.
	GLOBUS_GRAM_PROTOCOL_ERROR_INVALID_ATTR	Null value was passed in for attribute.

See also:

globus_gram_client_attr_init()

int globus_gram_client_attr_set_credential	(	globus_gram_client_attr_t	attr,
		gss_cred_id_t	credential
	)

Associate a credential with an attribute set.

Parameters:

	attr	The attribute set to associate the credential with.
	credential	The credential to use.

Return values:

GLOBUS_GRAM_PROTOCOL_ERROR_INVALID_ATTR

An invalid attribute set was passed to this function.

See also:

globus_gram_client_attr_get_credential()

int globus_gram_client_attr_get_credential	(	globus_gram_client_attr_t	attr,
		gss_cred_id_t *	credential
	)

Get the credential associated with an attribute set.

Parameters:

	attr	The attribute set associated with the credential.
	credential	A pointer to a GSSAPI credential handle which will be set to the value of the credential currently associated with the attribute set.

Return values:

	GLOBUS_GRAM_PROTOCOL_ERROR_INVALID_ATTR	An invalid attribute set was passed to this function.
	GLOBUS_GRAM_PROTOCOL_ERROR_NULL_PARAMETER	A null credential pointer was passed to this function.

See also:

globus_gram_client_attr_set_credential()

int globus_gram_client_attr_set_delegation_mode	(	globus_gram_client_attr_t	attr,
		globus_io_secure_delegation_mode_t	mode
	)

Set the delegation mode associated with an attribute set.

Parameters:

	attr	The attribute set to update.
	mode	The new value of the delegation mode.

Return values:

GLOBUS_GRAM_PROTOCOL_ERROR_INVALID_ATTR

An invalid attribute set was passed to this function.

See also:

globus_gram_client_attr_get_delegation_mode()

int globus_gram_client_attr_get_delegation_mode	(	globus_gram_client_attr_t	attr,
		globus_io_secure_delegation_mode_t *	mode
	)

Get the delegation mode associated with an attribute set.

Parameters:

	attr	The attribute set to query.
	mode	Pointer to a location to set to the value of the delegation mode.

Return values:

	GLOBUS_GRAM_PROTOCOL_ERROR_INVALID_ATTR	An invalid attribute set was passed to this function.
	GLOBUS_GRAM_PROTOCOL_ERROR_NULL_PARAMETER	An null mode pointer was passed to this function.

See also:

globus_gram_client_attr_get_delegation_mode()