Functions
Proxy Server
Block Size
File Mode
Connection Reuse
Socket Send Buffer Size
Receive Socket Buffer
TCP Nodelay
Authorization
Detailed Description
The GASS Transfer library uses Globus objects to provide an extensible way of creating protocol-specific attributes.
Function Documentation
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 successfully 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. |
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 successfully destroyed. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |
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 successfully updated. |
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | The attr was GLOBUS_NULL. |