Globus XIO API(3) | globus_xio | Globus XIO API(3) |
NAME¶
Globus XIO API -Typedefs¶
typedef void(* globus_xio_accept_callback_t )(globus_xio_server_t server, globus_xio_handle_t handle, globus_result_t result, void *user_arg)
Enumerations¶
enum globus_i_xio_op_type_e
Functions¶
globus_result_t globus_xio_attr_init (globus_xio_attr_t *attr)
Detailed Description¶
Typedef Documentation¶
typedef void(* globus_xio_accept_callback_t)(globus_xio_server_t server, globus_xio_handle_t handle, globus_result_t result, void *user_arg)¶
Callback signature for accept. When a registered accept operation completes the users function of this signature is called. Parameters:server The server object on which the accept was
registered.
handle The newly created handle that was created by the accept operation.
result A result code indicating the success of the accept operation.
GLOBUS_SUCCESS indicates a successful accept.
user_arg A user argument that is threaded from the registration to the
callback.
typedef void(* globus_xio_callback_t)(globus_xio_handle_t handle, globus_result_t result, void *user_arg)¶
globus_xio_callback_t This callback is used for the open and close asynchronous operations.typedef void(* globus_xio_data_callback_t)(globus_xio_handle_t handle, globus_result_t result, globus_byte_t *buffer, globus_size_t len, globus_size_t nbytes, globus_xio_data_descriptor_t data_desc, void *user_arg)¶
globus_xio_data_callback_t This callback is used for asynchronous operations that send or receive data. On EOF, result_t will be of type GLOBUS_XIO_ERROR_EOFtypedef void(* globus_xio_iovec_callback_t)(globus_xio_handle_t handle, globus_result_t result, globus_xio_iovec_t *iovec, int count, globus_size_t nbytes, globus_xio_data_descriptor_t data_desc, void *user_arg)¶
globus_xio_iovec_callback_t This callback is used for asynchronous operations that send or receive data with an iovec structure. On EOF, result_t will be of type GLOBUS_XIO_ERROR_EOFtypedef enum globus_i_xio_op_type_e globus_xio_operation_type_t¶
Operation types An enumeration of operation types. Used in the timeout callback to indicate what operation typed timedout.typedef void(* globus_xio_server_callback_t)(globus_xio_server_t server, void *user_arg)¶
Server callback signature. This is the generic server callback signature. It is currently only used for the register close operation.typedef globus_bool_t(* globus_xio_timeout_callback_t)(globus_xio_handle_t handle, globus_xio_operation_type_t type, void *user_arg)¶
The timeout callback function signature. Parameters:handle The handle the handle on which the timeout
operation was requested.
type The type of operation that timed out: GLOBUS_XIO_OPERATION_OPEN
GLOBUS_XIO_OPERATION_CLOSE GLOBUS_XIO_OPERATION_READ
GLOBUS_XIO_OPERATION_WRITE
arg A user arg threaded through to the callback.
Enumeration Type Documentation¶
enum globus_i_xio_op_type_e¶
Operation types An enumeration of operation types. Used in the timeout callback to indicate what operation typed timedout.enum globus_xio_handle_cmd_t¶
doxygen varargs filter stuff Common driver handle cntls. Enumerator- GLOBUS_XIO_GET_LOCAL_CONTACT
- See usage for: globus_xio_handle_cntl
- GLOBUS_XIO_GET_LOCAL_NUMERIC_CONTACT
- See usage for: globus_xio_handle_cntl
- GLOBUS_XIO_GET_REMOTE_CONTACT
- See usage for: globus_xio_handle_cntl
- GLOBUS_XIO_GET_REMOTE_NUMERIC_CONTACT
- See usage for: globus_xio_handle_cntl
- GLOBUS_XIO_SEEK
- See usage for: globus_xio_handle_cntl
- GLOBUS_XIO_SET_STRING_OPTIONS
- See usage for: globus_xio_handle_cntl
Function Documentation¶
globus_result_t globus_xio_attr_cntl (globus_xio_attr_tattr, globus_xio_driver_tdriver, intcmd, ...)¶
Manipulate the values associated in the attr. This function provides a means to access the attr structure. What exactly this function does is determined by the value in the parameter cmd and the value of the parameter driver. When the driver parameter is NULL it indicates that this function applies to general Globus XIO values. If it is not NULL it indicates that the function will effect driver specific values. Each driver is responsible for defining its own enumeration of values for cmd and the var args associated with that command. Parameters:attr the attribute structure to be manipulated.
driver This parameter indicates which driver the user would like to
perform the requested operation. If this parameter is NULL this request will
be scoped to general attribute functions.
cmd an enum that determines what specific operation the user is
requesting. Each driver will determine the value for this enumeration.
globus_result_t globus_xio_attr_copy (globus_xio_attr_t *dst, globus_xio_attr_tsrc)¶
Copy an attribute structure.globus_result_t globus_xio_attr_destroy (globus_xio_attr_tattr)¶
Clean up resources associated with an attribute. Parameters:attr Upon completion of this function all
resources associated with this structure will returned to the system and the
attr will no longer be valid.
globus_result_t globus_xio_attr_init (globus_xio_attr_t *attr)¶
Initialize a Globus XIO attribute. Parameters:attr upon return from this function this out
parameter will be initialized. Once the user is finished with the attribute
they should make sure they destroy it in order to free resources associated
with it.
globus_result_t globus_xio_close (globus_xio_handle_thandle, globus_xio_attr_tattr)¶
Blocking closeglobus_result_t globus_xio_data_descriptor_cntl (globus_xio_data_descriptor_tdata_desc, globus_xio_driver_tdriver, intcmd, ...)¶
Touch driver specific data in data descriptors This function allows the user to communicate directly with a driver in association with a data descriptors. The driver defines what operations can be preformed.globus_result_t globus_xio_data_descriptor_destroy (globus_xio_data_descriptor_tdata_desc)¶
clean up a data descriptor.globus_result_t globus_xio_data_descriptor_init (globus_xio_data_descriptor_t *data_desc, globus_xio_handle_thandle)¶
Initialize a data descriptor Parameters:data_desc An out parameter. The data descriptor to
be initialized.
handle The handle this data descriptor will be used with. This parameter
is require in order to optimize the code handling the data descriptors
use.
globus_result_t globus_xio_handle_cntl (handle, driver, GLOBUS_XIO_GET_LOCAL_CONTACT, char **contact_string_out)¶
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Get local connection info.@param contact_string_out A pointer to a contact string for the local end of a connected handle. Where possible, it will be in symbolic form (FQDN). The user must free the returned string. @see globus_xio_server_get_contact_string().fi
globus_result_t globus_xio_handle_cntl (handle, driver, GLOBUS_XIO_GET_LOCAL_NUMERIC_CONTACT, char **contact_string_out)¶
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Get local connection info.@param contact_string_out A pointer to a contact string for the local end of a connected handle. Where possible, it will be in numeric form. (IP) The user must free the returned string..fi
globus_result_t globus_xio_handle_cntl (handle, driver, GLOBUS_XIO_GET_REMOTE_CONTACT, char **contact_string_out)¶
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Get remote connection info.@param contact_string_out A pointer to a contact string for the remote end of a connected handle. Where possible, it will be in symbolic form (FQDN). The user must free the returned string..fi
globus_result_t globus_xio_handle_cntl (handle, driver, GLOBUS_XIO_GET_REMOTE_NUMERIC_CONTACT, char **contact_string_out)¶
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Get remote connection info.@param contact_string_out A pointer to a contact string for the remote end of a connected handle. Where possible, it will be in numeric form. (IP) The user must free the returned string..fi
globus_result_t globus_xio_handle_cntl (handle, driver, GLOBUS_XIO_SEEK, globus_off_toffset)¶
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Reposition read/write offset. Parameters:offset Specify the desired offset.
globus_result_t globus_xio_handle_cntl (handle, driver, GLOBUS_XIO_SET_STRING_OPTIONS, char *config_string)¶
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Set the driver specific configuration string. The format of the string is defined by the driver. It is typically a set of key=value pairs Parameters:config_string The driver specific parameter
string.
globus_result_t globus_xio_handle_cntl (globus_xio_handle_thandle, globus_xio_driver_tdriver, intcmd, ...)¶
Touch driver specific information in a handle object. This function allows the user to communicate directly with a driver in association with a handle object. The driver defines what operations can be preformed. pass the driver to control a specific driver pass NULL for driver for XIO specific cntls pass GLOBUS_XIO_QUERY for driver to try each driver in order until successglobus_result_t globus_xio_handle_create (globus_xio_handle_t *handle, globus_xio_stack_tstack)¶
Initialize a handle for client opens This function will initialize a handle for active opens (client side connections).globus_result_t globus_xio_handle_create_from_url (globus_xio_handle_t *out_h, const char *scheme, globus_xio_attr_tattr, char *param_string)¶
Initializes a handle based on the scheme given. Parameters:out_h An uninitialized handle that will be
initialized in the function to correspond to the scheme given. This handle
should be used for any I/O operations.
scheme A string containing the protocol which the handle should be
initialized to. The string can either be a protocol by itself, for example,
'http', or a complete scheme such as 'http://www.example.com'.
attr Attribute to be used for setting parameter string. It is initialized
by the function. Can be NULL if attributes are not being used.
param_string A string containing attributes to be set for the drivers
associated with the scheme. This should be in the form
'protocol1:option1=value1;option2=value2,protocol2:option1=value1;
option2=value2' Can be NULL if attributes are not being used.
option2=value2' Can be NULL if attributes are not being used.
globus_result_t globus_xio_open (globus_xio_handle_thandle, const char *contact_string, globus_xio_attr_tattr)¶
blocking openglobus_result_t globus_xio_read (globus_xio_handle_thandle, globus_byte_t *buffer, globus_size_tbuffer_length, globus_size_twaitforbytes, globus_size_t *nbytes, globus_xio_data_descriptor_tdata_desc)¶
Read data from a handleglobus_result_t globus_xio_readv (globus_xio_handle_thandle, globus_xio_iovec_t *iovec, intiovec_count, globus_size_twaitforbytes, globus_size_t *nbytes, globus_xio_data_descriptor_tdata_desc)¶
Read data from a handle into a globus_xio_iovec_t (struct iovec)globus_result_t globus_xio_register_close (globus_xio_handle_thandle, globus_xio_attr_tattr, globus_xio_callback_tcb, void *user_arg)¶
Close a handle This functions servers as a destroy for the handle. As soon as the operations completes (the callback is called). The handle is destroyed. Parameters:handle the handle to be closed.
attr how to close attribute
cb The function to be called when the close operation completes.
user_arg A user pointer that will be threaded through to the
callback.
globus_result_t globus_xio_register_open (globus_xio_handle_thandle, const char *contact_string, globus_xio_attr_tattr, globus_xio_callback_tcb, void *user_arg)¶
Open a handle Creates an open handle based on the state contained in the given stack. No operation can be preformed on a handle until it is initialized and then opened. If an already open handle used the information contained in that handle will be destroyed. Parameters:handle The handle created with
globus_xio_handle_create() or
globus_xio_server_register_accept() that is to be opened.
attr how to open attribute. can be NULL
cb The function to be called when the open operation completes.
user_arg A user pointer that will be threaded through to the callback.
contact_string An url describing the resource. NULL is allowed. Drivers
interpret the various parts of this url as described in their documentation.
An alternative form is also supported: if contact_string does not specify a
scheme (e.g. http://) and it contains a ':', it will be parsed as a host:port
pair. if it does not contain a ':', it will be parsed as the path
the following are examples of valid formats:
<path to file> host-name ':' <service or port> 'file:' <path to file> <scheme> '://' [ '/' [ <path to resource> ] ] <scheme> '://' location [ '/' [ <path to resource> ] ] location: [ auth-part ] host-part auth-part: <user> [ ':' <password> ] '@' host-part: [ '<' <subject> '>' ] host-name [ ':' <port or service> ] host-name: <hostname> | <dotted quad> | '[' <ipv6 address> ']'Except for use as the above delimiters, the following special characters MUST be encoded with the %HH format where H == hex char.
'/' and '@' in location except subject '<' and '>' in location ':' everywhere except ipv6 address and subject '%' everywhere (can be encoded with %HH or %%)
globus_result_t globus_xio_register_read (globus_xio_handle_thandle, globus_byte_t *buffer, globus_size_tbuffer_length, globus_size_twaitforbytes, globus_xio_data_descriptor_tdata_desc, globus_xio_data_callback_tcb, void *user_arg)¶
Read data from a handleglobus_result_t globus_xio_register_readv (globus_xio_handle_thandle, globus_xio_iovec_t *iovec, intiovec_count, globus_size_twaitforbytes, globus_xio_data_descriptor_tdata_desc, globus_xio_iovec_callback_tcb, void *user_arg)¶
Read data from a handle into a globus_xio_iovec_t (struct iovec)globus_result_t globus_xio_register_write (globus_xio_handle_thandle, globus_byte_t *buffer, globus_size_tbuffer_length, globus_size_twaitforbytes, globus_xio_data_descriptor_tdata_desc, globus_xio_data_callback_tcb, void *user_arg)¶
Write data to a handleglobus_result_t globus_xio_register_writev (globus_xio_handle_thandle, globus_xio_iovec_t *iovec, intiovec_count, globus_size_twaitforbytes, globus_xio_data_descriptor_tdata_desc, globus_xio_iovec_callback_tcb, void *user_arg)¶
Write data to a handle from a globus_xio_iovec_t (struct iovec)globus_result_t globus_xio_server_accept (globus_xio_handle_t *out_handle, globus_xio_server_tserver)¶
Accept a connection This function will accept a connection on the given server object and the parameter out_handle will be valid if the function returns successfully.globus_result_t globus_xio_server_close (globus_xio_server_tserver)¶
A blocking server closeglobus_result_t globus_xio_server_cntl (globus_xio_server_tserver, globus_xio_driver_tdriver, intcmd, ...)¶
Touch driver specific information in a server object. This function allows the user to communicate directly with a driver in association with a server object. The driver defines what operations can be preformed.globus_result_t globus_xio_server_create (globus_xio_server_t *server, globus_xio_attr_tserver_attr, globus_xio_stack_tstack)¶
Create a server object. This function allows the user to create a server object which can then be used to accept connections. Parameters:server An out parameter. Once the function
successfully returns this will point to a valid server object.
server_attr an attribute structure used to alter the default server
initialization. This will mostly be used in a driver specific manner. can be
NULL.
stack
globus_result_t globus_xio_server_get_contact_string (globus_xio_server_tserver, char **contact_string)¶
get contact string This function allows the user to get the contact string for a server. this string could be used as the contact string for the client side. Parameters:server An initialized server handle created with
globus_xio_server_create()
contact_string an out variable. Will point to a newly allocated string on
success. must be freed by the caller.
globus_result_t globus_xio_server_register_accept (globus_xio_server_tserver, globus_xio_accept_callback_tcb, void *user_arg)¶
Asynchronous accept. This function posts an nonblocking accept. Once the operation has completed the user function pointed to by the parameter cb is called.globus_result_t globus_xio_server_register_close (globus_xio_server_tserver, globus_xio_server_callback_tcb, void *user_arg)¶
post a close on a server object This function registers a close operation on a server. When the user function pointed to by parameter cb is called the server object is closed.globus_result_t globus_xio_stack_copy (globus_xio_stack_t *dst, globus_xio_stack_tsrc)¶
Copy a stack objectglobus_result_t globus_xio_stack_destroy (globus_xio_stack_tstack)¶
Destroy a stack object.globus_result_t globus_xio_stack_init (globus_xio_stack_t *stack, globus_xio_attr_tstack_attr)¶
Initialize a stack objectglobus_result_t globus_xio_stack_push_driver (globus_xio_stack_tstack, globus_xio_driver_tdriver)¶
Push a driver onto a stack. No attrs are associated with a driver. The stack represents the ordered lists of transform drivers and 1 transport driver. The transport driver must be pushed on first.globus_result_t globus_xio_write (globus_xio_handle_thandle, globus_byte_t *buffer, globus_size_tbuffer_length, globus_size_twaitforbytes, globus_size_t *nbytes, globus_xio_data_descriptor_tdata_desc)¶
Write data to a handleglobus_result_t globus_xio_writev (globus_xio_handle_thandle, globus_xio_iovec_t *iovec, intiovec_count, globus_size_twaitforbytes, globus_size_t *nbytes, globus_xio_data_descriptor_tdata_desc)¶
Write data to a handle from a globus_xio_iovec_t (struct iovec)Author¶
Generated automatically by Doxygen for globus_xio from the source code.Sun Nov 9 2014 | Version 4.15 |