Main Page   Modules   Data Structures   Data Fields  

Request Attributes

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

Proxy Server

Block Size

File Mode

Connection Reuse

Socket Send Buffer Size

Receive Socket Buffer

TCP Nodelay

Authorization

Functions


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.


about globus | globus toolkit | dev.globus

Comments? webmaster@globus.org