Linux Manuals session 3

Types – AuthorGenerated automatically by Doxygen for globus_xio from the source code.

Reading/Writing – Ordering driver does not allow multiple globus_xio_register_read() to be outstanding. This limitation is there to enforce that the users get the read callback in order. There is a known issue in enforcing the order in which read callbacks are delivered with multiple outstanding reads. This limitation does not restrict the use of parallel…

Opening/Closing – Ordering driver is a transform driver and thus has to be used on top of a transport driver. An XIO handle with the ordering driver can be created with either globus_xio_handle_create() or globus_xio_server_register_accept(). When the XIO handle is closed, the ordering driver will destroy its internal resources. AuthorGenerated automatically by Doxygen for globus_xio…

Error Types – Enumerationsenum globus_xio_ordering_error_type_t { GLOBUS_XIO_ORDERING_ERROR_READ, GLOBUS_XIO_ORDERING_ERROR_CANCEL } Detailed DescriptionThe errors reported by ORDERING driver include GLOBUS_XIO_ERROR_COMMAND, GLOBUS_XIO_ERROR_MEMORY, GLOBUS_XIO_ERROR_STATE, GLOBUS_XIO_ERROR_CANCELED See Also: globus_xio_driver_error_match() globus_error_errno_match()Enumeration Type Documentationenum globus_xio_ordering_error_type_tdoxygen varargs filter stuff ORDERING driver specific error types Enumerator GLOBUS_XIO_ORDERING_ERROR_READ Indicates that an error occured in reading data GLOBUS_XIO_ORDERING_ERROR_CANCEL Indicates an error occured in canceling an operationAuthorGenerated…

Env Variables – The ordering driver uses the following environment variable • GLOBUS_XIO_ORDERING_DEBUG Available if using a debug build. See globus_debug.h for format.AuthorGenerated automatically by Doxygen for globus_xio from the source code.

Attributes and Cntls – Enumerationsenum globus_xio_ordering_cmd_t { GLOBUS_XIO_ORDERING_SET_OFFSET, GLOBUS_XIO_ORDERING_SET_MAX_READ_COUNT, GLOBUS_XIO_ORDERING_GET_MAX_READ_COUNT, GLOBUS_XIO_ORDERING_SET_BUFFERING, GLOBUS_XIO_ORDERING_GET_BUFFERING, GLOBUS_XIO_ORDERING_SET_BUF_SIZE, GLOBUS_XIO_ORDERING_GET_BUF_SIZE, GLOBUS_XIO_ORDERING_SET_MAX_BUF_COUNT, GLOBUS_XIO_ORDERING_GET_MAX_BUF_COUNT } Functionsglobus_result_t globus_xio_handle_cntl (handle, driver, GLOBUS_XIO_ORDERING_SET_OFFSET, globus_off_t offset) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_ORDERING_SET_MAX_READ_COUNT, int max_read_count) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_ORDERING_GET_MAX_READ_COUNT, int *max_read_count_out) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_ORDERING_SET_BUFFERING, globus_bool_t buffering) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_ORDERING_GET_BUFFERING, globus_bool_t *buffering_out) globus_result_t globus_xio_attr_cntl (attr,…

Globus XIO ORDERING Driver – ModulesOpening/Closing Reading/Writing Env Variables Attributes and Cntls Types Error Types Detailed DescriptionAuthorGenerated automatically by Doxygen for globus_xio from the source code.

builtins/ordering/globus_xio_ordering_driver.h – XIO ORDERING Driver. Synopsis#include ‘globus_common.h’ Enumerationsenum globus_xio_ordering_error_type_t { GLOBUS_XIO_ORDERING_ERROR_READ, GLOBUS_XIO_ORDERING_ERROR_CANCEL } enum globus_xio_ordering_cmd_t { GLOBUS_XIO_ORDERING_SET_OFFSET, GLOBUS_XIO_ORDERING_SET_MAX_READ_COUNT, GLOBUS_XIO_ORDERING_GET_MAX_READ_COUNT, GLOBUS_XIO_ORDERING_SET_BUFFERING, GLOBUS_XIO_ORDERING_GET_BUFFERING, GLOBUS_XIO_ORDERING_SET_BUF_SIZE, GLOBUS_XIO_ORDERING_GET_BUF_SIZE, GLOBUS_XIO_ORDERING_SET_MAX_BUF_COUNT, GLOBUS_XIO_ORDERING_GET_MAX_BUF_COUNT } Functionsglobus_result_t globus_xio_handle_cntl (handle, driver, GLOBUS_XIO_ORDERING_SET_OFFSET, globus_off_t offset) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_ORDERING_SET_MAX_READ_COUNT, int max_read_count) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_ORDERING_GET_MAX_READ_COUNT, int *max_read_count_out) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_ORDERING_SET_BUFFERING, globus_bool_t buffering) globus_result_t…

Attributes and Cntls – Enumerationsenum globus_xio_ordering_cmd_t { GLOBUS_XIO_ORDERING_SET_OFFSET, GLOBUS_XIO_ORDERING_SET_MAX_READ_COUNT, GLOBUS_XIO_ORDERING_GET_MAX_READ_COUNT, GLOBUS_XIO_ORDERING_SET_BUFFERING, GLOBUS_XIO_ORDERING_GET_BUFFERING, GLOBUS_XIO_ORDERING_SET_BUF_SIZE, GLOBUS_XIO_ORDERING_GET_BUF_SIZE, GLOBUS_XIO_ORDERING_SET_MAX_BUF_COUNT, GLOBUS_XIO_ORDERING_GET_MAX_BUF_COUNT } Functionsglobus_result_t globus_xio_handle_cntl (handle, driver, GLOBUS_XIO_ORDERING_SET_OFFSET, globus_off_t offset) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_ORDERING_SET_MAX_READ_COUNT, int max_read_count) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_ORDERING_GET_MAX_READ_COUNT, int *max_read_count_out) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_ORDERING_SET_BUFFERING, globus_bool_t buffering) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_ORDERING_GET_BUFFERING, globus_bool_t *buffering_out) globus_result_t globus_xio_attr_cntl (attr,…

Globus XIO API – Typedefstypedef void(* globus_xio_accept_callback_t )(globus_xio_server_t server, globus_xio_handle_t handle, globus_result_t result, void *user_arg) typedef void(* globus_xio_server_callback_t )(globus_xio_server_t server, void *user_arg) typedef globus_bool_t(* globus_xio_timeout_callback_t )(globus_xio_handle_t handle, globus_xio_operation_type_t type, void *user_arg) typedef void(* globus_xio_callback_t )(globus_xio_handle_t handle, globus_result_t result, void *user_arg) 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,…

Globus XIO API – Typedefstypedef void(* globus_xio_accept_callback_t )(globus_xio_server_t server, globus_xio_handle_t handle, globus_result_t result, void *user_arg) typedef void(* globus_xio_server_callback_t )(globus_xio_server_t server, void *user_arg) typedef globus_bool_t(* globus_xio_timeout_callback_t )(globus_xio_handle_t handle, globus_xio_operation_type_t type, void *user_arg) typedef void(* globus_xio_callback_t )(globus_xio_handle_t handle, globus_result_t result, void *user_arg) 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,…

Globus XIO Net Manager Driver – Net Manager XIO Driver. Enumerationsenum globus_xio_net_manager_cntl_t { GLOBUS_XIO_NET_MANAGER_SET_TASK_ID, GLOBUS_XIO_NET_MANAGER_GET_TASK_ID } Functionsglobus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_NET_MANAGER_SET_TASK_ID, const char *task_id) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_NET_MANAGER_GET_TASK_ID, const char **task_id) Detailed DescriptionNet Manager XIO Driver. The Globus XIO Network Manager Driver interfaces with the globus_net_manager library to integrate network manager functionality within the…

xio_driver/globus_xio_net_manager_driver.h – Network Manager XIO Driver. Synopsis#include ‘globus_common.h’ #include ‘globus_net_manager_attr.h’ Enumerationsenum globus_xio_net_manager_cntl_t { GLOBUS_XIO_NET_MANAGER_SET_TASK_ID, GLOBUS_XIO_NET_MANAGER_GET_TASK_ID } Functionsglobus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_NET_MANAGER_SET_TASK_ID, const char *task_id) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_NET_MANAGER_GET_TASK_ID, const char **task_id) Detailed DescriptionNetwork Manager XIO Driver. AuthorGenerated automatically by Doxygen for globus_net_manager from the source code.

Globus XIO Net Manager Driver – Net Manager XIO Driver. Enumerationsenum globus_xio_net_manager_cntl_t { GLOBUS_XIO_NET_MANAGER_SET_TASK_ID, GLOBUS_XIO_NET_MANAGER_GET_TASK_ID } Functionsglobus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_NET_MANAGER_SET_TASK_ID, const char *task_id) globus_result_t globus_xio_attr_cntl (attr, driver, GLOBUS_XIO_NET_MANAGER_GET_TASK_ID, const char **task_id) Detailed DescriptionNet Manager XIO Driver. The Globus XIO Network Manager Driver interfaces with the globus_net_manager library to integrate network manager functionality within the…

Error Types – Enumerationsenum globus_xio_mode_e_error_type_t { GLOBUS_XIO_MODE_E_HEADER_ERROR } Detailed DescriptionThe errors reported by MODE_E driver include GLOBUS_XIO_ERROR_COMMAND, GLOBUS_XIO_ERROR_MEMORY, GLOBUS_XIO_ERROR_STATE, GLOBUS_XIO_ERROR_PARAMETER, GLOBUS_XIO_ERROR_EOF, GLOBUS_XIO_ERROR_CANCELED, GLOBUS_XIO_MODE_E_HEADER_ERROR See Also: globus_xio_driver_error_match() globus_error_errno_match()Enumeration Type Documentationenum globus_xio_mode_e_error_type_tMODE_E driver specific error types Enumerator GLOBUS_XIO_MODE_E_HEADER_ERROR Indicates that the mode_e header is erroneousAuthorGenerated automatically by Doxygen for globus_xio from the source code.

Types – AuthorGenerated automatically by Doxygen for globus_xio from the source code.

Server – globus_xio_server_create() causes a mode_e listener to be created and listened upon. globus_xio_server_register_accept() performs an asynchronous accept(). globus_xio_server_register_close() cleans up the internal resources associated with the mode_e server. All accepted handles inherit all mode_e specific attributes set in the attr to globus_xio_server_create() AuthorGenerated automatically by Doxygen for globus_xio from the source code.

Reading/Writing – Mode E is unidirectional. Clients can only write and the server can only read. The globus_xio_register_read() enforce that the waitforbytes parameter should be one. When multiple transport streams are used between the client and the server, data might not be delivered in order. globus_xio_data_descriptor_cntl() can be used to get the offset of the…

Opening/Closing – An XIO handle with the mode_e driver can be created with either globus_xio_handle_create() or globus_xio_server_register_accept(). If the handle is created with globus_xio_handle_create(), the contact string passed to ref globus_xio_register_open() call must contain a host name and service/port. The number of streams required can be specified on the attr using GLOBUS_XIO_MODE_E_SET_NUM_STREAMS (default is one…

Error Types – Enumerationsenum globus_xio_mode_e_error_type_t { GLOBUS_XIO_MODE_E_HEADER_ERROR } Detailed DescriptionThe errors reported by MODE_E driver include GLOBUS_XIO_ERROR_COMMAND, GLOBUS_XIO_ERROR_MEMORY, GLOBUS_XIO_ERROR_STATE, GLOBUS_XIO_ERROR_PARAMETER, GLOBUS_XIO_ERROR_EOF, GLOBUS_XIO_ERROR_CANCELED, GLOBUS_XIO_MODE_E_HEADER_ERROR See Also: globus_xio_driver_error_match() globus_error_errno_match()Enumeration Type Documentationenum globus_xio_mode_e_error_type_tMODE_E driver specific error types Enumerator GLOBUS_XIO_MODE_E_HEADER_ERROR Indicates that the mode_e header is erroneousAuthorGenerated automatically by Doxygen for globus_xio from the source code.