Loading...
Searching...
No Matches
GASS Transfer API

GASS Transfer API. More...

## Topics

| Activation
| Activation.
| Client-Initiated Operations
| GASS Transfer Client Operations.
| Implementing Servers
| GASS Server Implementation.
| Sending and Receiving Data
| Sending and Receiving Data.
| Referrals
| GASS Referrals.
| Request Handles
| Request Handles.
| Request Attributes
| Request Attributes.
| Listener attributes
| Listener attributes.
| Implementing Request Attributes
| Implementing Request Attributes.
| Protocol Modules
| Protocol Implementation API.

## Macros

#define | GLOBUS_GASS_TRANSFER_LENGTH_UNKNOWN
#define | GLOBUS_GASS_TRANSFER_TIMESTAMP_UNKNOWN

## Enumerations

enum

{
GLOBUS_GASS_TRANSFER_ERROR_BAD_PORT = 2 , GLOBUS_GASS_TRANSFER_ERROR_INTERNAL_ERROR , GLOBUS_GASS_TRANSFER_ERROR_BAD_URL , GLOBUS_GASS_TRANSFER_ERROR_NOT_SUPPORTED ,
GLOBUS_GASS_TRANSFER_ERROR_NOT_IMPLEMENTED , GLOBUS_GASS_TRANSFER_ERROR_MALLOC_FAILED , GLOBUS_GASS_TRANSFER_ERROR_NOT_INITIALIZED , GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER ,
GLOBUS_GASS_TRANSFER_ERROR_NOT_REGISTERED , GLOBUS_GASS_TRANSFER_ERROR_NOT_FOUND , GLOBUS_GASS_TRANSFER_ERROR_INVALID_USE , GLOBUS_GASS_TRANSFER_ERROR_TOO_LARGE ,
GLOBUS_GASS_TRANSFER_ERROR_REQUEST_FAILED , GLOBUS_GASS_TRANSFER_ERROR_DONE , GLOBUS_GASS_TRANSFER_ERROR_ALREADY_REGISTERED , GLOBUS_GASS_TRANSFER_ERROR_OPEN_FAILED ,
GLOBUS_GASS_TRANSFER_ERROR_TRANSFER_FAILED
}

enum |

## Detailed Description

GASS Transfer API.

The GASS Transfer API is the core part of the GASS (Global Access to Secondary Storage) component of the Grid Community Toolkit. The purpose of GASS is to provide a simple way to enable grid applications to securely stage and access data to and from remote file servers using a simple protocol-independent API.

The GASS Transfer API provides a way to implement both client and server components. These share common data block and request management functionality. Client-specific functions are provided to implement file "get", "put", and "append" operations. Server-specific functions are provided to implement servers which service such requests. Client and server functionality can be included in a single application, so one could implement proxies or cross-protocol bridges.

The GASS Transfer API is easily extensible to support different remote data access protocols. The standard Globus distribution includes client-side support for the http, and https protocols, as well as server-side support for the http and https protocols. An application which requires additional protocol support may add this through the protocol module interface.

The GASS Transfer API is defined in the header file "globus_gass_transfer.h"

The GLOBUS_GASS_TRANSFER_MODULE must be activated before calling any functions in this API.

## Macro Definition Documentation

## GLOBUS_GASS_TRANSFER_LENGTH_UNKNOWN

#define GLOBUS_GASS_TRANSFER_LENGTH_UNKNOWN

Value for files we don't know the length of.

## GLOBUS_GASS_TRANSFER_TIMESTAMP_UNKNOWN

#define GLOBUS_GASS_TRANSFER_TIMESTAMP_UNKNOWN

Value for timestamps we don't know the value of.

## Enumeration Type Documentation

## anonymous enum

anonymous enum

GASS error codes

Enumerator
GLOBUS_GASS_TRANSFER_ERROR_BAD_PORT | Invalid port in URL
GLOBUS_GASS_TRANSFER_ERROR_INTERNAL_ERROR | Something bad occurred while processing the request
GLOBUS_GASS_TRANSFER_ERROR_BAD_URL | Unparsable URL
GLOBUS_GASS_TRANSFER_ERROR_NOT_SUPPORTED | Invalid file open mode in the GASS File library
GLOBUS_GASS_TRANSFER_ERROR_NOT_IMPLEMENTED | Operation not supported by GASS for this type of URL
GLOBUS_GASS_TRANSFER_ERROR_MALLOC_FAILED | Out of memory
GLOBUS_GASS_TRANSFER_ERROR_NOT_INITIALIZED | Uninitialized or invalid handle
GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER | NULL pointer passed as parameter
GLOBUS_GASS_TRANSFER_ERROR_NOT_REGISTERED | GASS Server not yet registered
GLOBUS_GASS_TRANSFER_ERROR_NOT_FOUND | URL not in cache
GLOBUS_GASS_TRANSFER_ERROR_INVALID_USE | Invalid use of a GASS handle
GLOBUS_GASS_TRANSFER_ERROR_TOO_LARGE | Bytes array exceeds GASS request size
GLOBUS_GASS_TRANSFER_ERROR_REQUEST_FAILED | GASS Transfer request did not complete successfully
GLOBUS_GASS_TRANSFER_ERROR_DONE | GASS handle already closed before this operation began
GLOBUS_GASS_TRANSFER_ERROR_ALREADY_REGISTERED | GASS handle already registered for processing
GLOBUS_GASS_TRANSFER_ERROR_OPEN_FAILED | Could not open local file
GLOBUS_GASS_TRANSFER_ERROR_TRANSFER_FAILED | A protocol error or client-initiated failure has occurred

## anonymous enum

anonymous enum

Default buffer length for the globus_gass_transfer_assist library.