Main Page   Modules   Data Structures   File List   Data Fields   Globals   Related Pages  

globus_xio_http.h File Reference

Globus XIO HTTP Driver Header. More...

Data Structures

Enumerations

Functions


Detailed Description

Globus XIO HTTP Driver Header.


Function Documentation

globus_result_t globus_xio_attr_cntl attr   ,
driver   ,
GLOBUS_XIO_HTTP_ATTR_DELAY_WRITE_HEADER   
 

Delay writing HTTP request until first data write.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

If this attribute is present when opening an HTTP handle, the HTTP request will not be sent immediately upon opening the handle. Instead, it will be delayed until the first data write is done. This allows other HTTP headers to be sent after the handle is opened.

This attribute cntl takes no arguments.

globus_result_t globus_xio_data_descriptor_cntl dd   ,
driver   ,
GLOBUS_XIO_HTTP_GET_REQUEST   ,
char **    method,
char **    uri,
globus_xio_http_version_t   http_version,
globus_hashtable_t *    headers
 

Get HTTP Request Information.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Returns in the passed parameters values concerning the HTTP request. Any of the parameters may be NULL if the application is not interested in that part of the information.

Parameters:
method  Pointer to be set to the HTTP request method (typically GET, PUT, or POST). The caller must not access this value outside of the lifetime of the data descriptor nor free it.
uri  Pointer to be set to the requested HTTP path. The caller must not access this value outside of the lifetime of the data descriptor nor free it.
http_version  Pointer to be set to the HTTP version used for this request.
headers  Pointer to be set to point to a hashtable of globus_xio_http_header_t values, keyed by the HTTP header names. The caller must not access this value outside of the lifetime of the data descriptor nor free it or any values in it.

globus_result_t globus_xio_data_descriptor_cntl dd   ,
driver   ,
GLOBUS_XIO_HTTP_GET_RESPONSE   ,
int *    status_code,
char **    reason_phrase,
globus_xio_http_version_t   http_version,
globus_hashtable_t *    headers
 

Get HTTP Response Information.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Returns in the passed parameters values concerning the HTTP response. Any of the parameters may be NULL if the application is not interested in that part of the information.

Parameters:
status_code  Pointer to be set to the HTTP response status code (such as 404), as per RFC 2616. The caller must not access this value outside of the lifetime of the data descriptor nor free it or any values in it.
reason_phrase  Pointer to be set to the HTTP response reason phrase (such as Not Found). The caller must not access this value outside of the lifetime of the data descriptor nor free it or any values in it.
http_version  Pointer to be set to the HTTP version used for this request.
headers  Pointer to be set to point to a hashtable of globus_xio_http_header_t values, keyed by the HTTP header names. The caller must not access this value outside of the lifetime of the data descriptor nor free it or any values in it.


about globus | globus toolkit | dev.globus

Comments? webmaster@globus.org