Request Attributes

The GASS Transfer library uses Globus objects to provide an extensible way of creating protocol-specific attributes. More...

Functions

• int globus_gass_transfer_requestattr_init (globus_gass_transfer_requestattr_t *attr, char *url_scheme)
• int globus_gass_transfer_requestattr_destroy (globus_gass_transfer_requestattr_t *attr)

---

Detailed Description

The GASS Transfer library uses Globus objects to provide an extensible way of creating protocol-specific attributes.

---

Function Documentation

int globus_gass_transfer_requestattr_init	(	globus_gass_transfer_requestattr_t *	attr,
		char *	url_scheme
	)

Initialize a request attribute.

This function initializes the attr to contain a new protocol-specific request attribute.

Parameters:

	attr	The attribute set to be initialized.
	url_scheme	The scheme which which the attribute will be used for.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully initialized.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	Either attr or url_scheme was GLOBUS_NULL.
	GLOBUS_GASS_TRANSFER_ERROR_NOT_IMPLEMENTED	No protocol module currently registered with GASS Transfer Library handles URLs with the specified url_scheme.

int globus_gass_transfer_requestattr_destroy

(

globus_gass_transfer_requestattr_t *

attr

)

Destroy a request attribute.

This function destroys the attribute set specified in attr.

Parameters:

attr

The attribute set to be destroyed.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully destroyed.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_requestattr_set_proxy_url	(	globus_gass_transfer_requestattr_t *	attr,
		char *	proxy_url
	)

Set/Get the proxy server attribute for a GASS transfer attribute set.

This attribute allows the user to use a proxy server to handle a URL request.

Parameters:

	attr	The attribute set to be modified
	proxy_url	The new value of the proxy_url attribute. This may be GLOBUS_NULL if no proxy is to be used to access URLs with this attribute set.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_requestattr_set_block_size	(	globus_gass_transfer_requestattr_t *	attr,
		globus_size_t	block_size
	)

Set/Get the block size attribute for a GASS transfer attribute set.

This attribute allows the user to suggest a preferred block size of a server to handle a URL request.

Parameters:

	attr	The attribute set to query or modify.
	block_size	The data block size that should be used to process requests with this attribute set.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_requestattr_set_file_mode	(	globus_gass_transfer_requestattr_t *	attr,
		globus_gass_transfer_file_mode_t	file_mode
	)

Set/Get the file mode attribute for a GASS transfer attribute set.

This attribute allows the user to control whether the file will be transferred in ASCII or binary file mode.

Parameters:

	attr	The attribute set to query or modify.
	file_mode	The value of the file mode attribute.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_requestattr_set_connection_reuse	(	globus_gass_transfer_requestattr_t *	attr,
		globus_bool_t	connection_reuse
	)

Set/Get the connection reuse attribute for a GASS transfer attribute set.

This attribute allows the user to control whether the connection associated with a GASS Transfer request should be reused after the file transfer has completed.

Parameters:

	attr	The attribute set to query or modify.
	connection_reuse	The value of the connection reuse attribute.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_requestattr_set_socket_sndbuf	(	globus_gass_transfer_requestattr_t *	attr,
		int	sndbuf
	)

Set/Get the send buffer size attribute for a GASS transfer attribute set.

This attribute allows the user to control the socket send buffer associated with a GASS Transfer request should be reused after the file transfer has completed.

Parameters:

	attr	The attribute set to query or modify.
	sndbuf	The value of the socket buffer.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_requestattr_set_socket_rcvbuf	(	globus_gass_transfer_requestattr_t *	attr,
		int	rcvbuf
	)

Set/Get the receive buffer size attribute for a GASS transfer attribute set.

This attribute allows the user to control the socket receive buffer associated with a GASS Transfer request should be reused after the file transfer has completed.

Parameters:

	attr	The attribute set to query or modify.
	rcvbuf	The value of the socket buffer.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_requestattr_set_socket_nodelay	(	globus_gass_transfer_requestattr_t *	attr,
		globus_bool_t	nodelay
	)

Set/Get the TCP nodelay attribute for a GASS transfer attribute set.

This attribute allows the user to control the socket receive buffer associated with a GASS Transfer request should be reused after the file transfer has completed.

Parameters:

	attr	The attribute set to query or modify.
	nodelay	The value of the nodelay attribute.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_secure_requestattr_set_authorization	(	globus_gass_transfer_requestattr_t *	attr,
		globus_gass_transfer_authorization_t	mode,
		char *	subject
	)

Set/Get the authorization attribute for a GASS transfer attribute set.

This attribute allows the user to control what type of authorization should be done when GASS Transfer requests are processed.

Parameters:

	attr	The attribute set to query or modify.
	mode	The authorization mode to use.
	subject	The subject name of the authorized subject, if mode is GLOBUS_GASS_TRANSFER_AUTHORIZE_SUBJECT

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_requestattr_get_proxy_url	(	globus_gass_transfer_requestattr_t *	attr,
		char **	proxy_url
	)

Set/Get the proxy server attribute for a GASS transfer attribute set.

This attribute allows the user to use a proxy server to handle a URL request.

Parameters:

	attr	The attribute set to be modified
	proxy_url	The new value of the proxy_url attribute. This may be GLOBUS_NULL if no proxy is to be used to access URLs with this attribute set.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_requestattr_get_block_size	(	globus_gass_transfer_requestattr_t *	attr,
		globus_size_t *	block_size
	)

Set/Get the block size attribute for a GASS transfer attribute set.

This attribute allows the user to suggest a preferred block size of a server to handle a URL request.

Parameters:

	attr	The attribute set to query or modify.
	block_size	The data block size that should be used to process requests with this attribute set.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_requestattr_get_file_mode	(	globus_gass_transfer_requestattr_t *	attr,
		globus_gass_transfer_file_mode_t *	file_mode
	)

Set/Get the file mode attribute for a GASS transfer attribute set.

This attribute allows the user to control whether the file will be transferred in ASCII or binary file mode.

Parameters:

	attr	The attribute set to query or modify.
	file_mode	The value of the file mode attribute.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_requestattr_get_connection_reuse	(	globus_gass_transfer_requestattr_t *	attr,
		globus_bool_t *	connection_reuse
	)

Set/Get the connection reuse attribute for a GASS transfer attribute set.

This attribute allows the user to control whether the connection associated with a GASS Transfer request should be reused after the file transfer has completed.

Parameters:

	attr	The attribute set to query or modify.
	connection_reuse	The value of the connection reuse attribute.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_requestattr_get_socket_sndbuf	(	globus_gass_transfer_requestattr_t *	attr,
		int *	sndbuf
	)

Set/Get the send buffer size attribute for a GASS transfer attribute set.

This attribute allows the user to control the socket send buffer associated with a GASS Transfer request should be reused after the file transfer has completed.

Parameters:

	attr	The attribute set to query or modify.
	sndbuf	The value of the socket buffer.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_requestattr_get_socket_rcvbuf	(	globus_gass_transfer_requestattr_t *	attr,
		int *	rcvbuf
	)

Set/Get the receive buffer size attribute for a GASS transfer attribute set.

This attribute allows the user to control the socket receive buffer associated with a GASS Transfer request should be reused after the file transfer has completed.

Parameters:

	attr	The attribute set to query or modify.
	rcvbuf	The value of the socket buffer.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_requestattr_get_socket_nodelay	(	globus_gass_transfer_requestattr_t *	attr,
		globus_bool_t *	nodelay
	)

Set/Get the TCP nodelay attribute for a GASS transfer attribute set.

This attribute allows the user to control the socket receive buffer associated with a GASS Transfer request should be reused after the file transfer has completed.

Parameters:

	attr	The attribute set to query or modify.
	nodelay	The value of the nodelay attribute.

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.

int globus_gass_transfer_secure_requestattr_get_authorization	(	globus_gass_transfer_requestattr_t *	attr,
		globus_gass_transfer_authorization_t *	mode,
		char **	subject
	)

Set/Get the authorization attribute for a GASS transfer attribute set.

This attribute allows the user to control what type of authorization should be done when GASS Transfer requests are processed.

Parameters:

	attr	The attribute set to query or modify.
	mode	The authorization mode to use.
	subject	The subject name of the authorized subject, if mode is GLOBUS_GASS_TRANSFER_AUTHORIZE_SUBJECT

Return values:

	GLOBUS_SUCCESS	The attribute was succesfully updated.
	GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER	The attr was GLOBUS_NULL.