Please note that these documents are for an OBSOLETE version of the Globus Toolkit. For more information see 5.2 End of Life

GT 5.2.2 Release Notes: XIO


1. Component Overview

Globus XIO is an extensible input/output library written in C for the Globus Toolkit. It provides a single API (open/close/read/write) that supports multiple wire protocols, with protocol implementations encapsulated as drivers. The XIO drivers distributed with 5.2.2 include TCP, UDP, file, HTTP, GSI, GSSAPI_FTP, TELNET and queuing. In addition, Globus XIO provides a driver development interface for use by protocol developers. This interface allows the developer to concentrate on writing protocol code rather than infrastructure, as XIO provides a framework for error handling, asynchronous message delivery, timeouts, etc. The XIO driver-based approach maximizes the reuse of code by supporting the notion of a driver stack. XIO drivers can be written as atomic units and stacked on top of one another. This modularization provides maximum flexibility and simplifies the design and evaluation of individual protocols.

2. Feature summary

Supported Features

  • Driver specific string attributes. Set values like tcp buffer size via string at runtime.
  • UDT driver.
  • Mode E Driver
  • Telnet Driver
  • Queuing Driver
  • Ordering Driver
  • Dynamically loadable drivers.
  • Single API to swappable IO implementations.
  • Asynchronous IO support.
  • Native timeout support.
  • Data descriptors for providing driver specific hints.
  • Modular driver stacks to maximize code reuse.
  • TCP, UDP, file, HTTP, telnet, mode E, GSI drivers.

Deprecated Features

  • GSSAPI_FTP driver now distributed with the GridFTP Server

3. Summary of Changes in XIO

3.1. New Features: XIO

None.

3.2. Improvements: XIO

None.

4. Fixed Bugs for XIO

None.

5. Known Problems in XIO

  • GT-107: GSI XIO Driver hangs in delegation code

6. Technology dependencies

XIO depends on the following GT components:

  • Globus Core
  • Globus Common
  • Globus GSSAPI

7. Tested platforms

Tested Platforms for XIO:

  • Linux

    • CentOS 5, 6 i386, x86_64
    • Debian 6, 7 (testing) i386, x86_64
    • Fedora 15, 16 i386, x86_64
    • Red Hat Enterprise Server 5, 6 i386, x86_64
    • Scientific Linux 5, 6 i386, x86_64
    • Ubuntu 10.04LTS, 10.10, 11.04, 11.10, 12.04 (testing) i386, x86_64

  • Mac OS X

    • Mac OS X 10.7 (Lion)

  • Solaris

    • Solaris 11 x86_64

8. Backward compatibility summary

Protocol changes since GT version 5.2.1

  • None.

API changes since GT version 5.2.1

  • globus_xio_stack_copy added to the API. This allows a user to duplicated a configured stack.
  • globus_xio_driver_set_eof_received added to the driver API. This function allows drivers to have multiple outstanding reads at one time.
  • globus_xio_driver_eof_received added to the driver API. Working in conjunction with globus_xio_driver_set_eof_received to allow drivers to have multiple outstanding reads.
  • Users can now pass in a NULL callback for timeouts and it is assumed that when time expires the user wants the operation to timeout. Previously a user callback was required where the user would decide if they wanted the timeout.

9. Associated Standards

Adoption of standards in XIO is determined by the drivers. All drivers distributed by XIO are compliant with the protocol they implement.

10. For More Information

See XIO for more information about this component.