NAME

fi_tcp - The msg sockets Fabric Provider

OVERVIEW

The tcp provider can be used on any system that supports TCP sockets. The provider is not intended to provide performance improvements over regular TCP sockets, but rather to allow developers to write, test,and debug application code even on platforms that do not have high-performance fabric hardware.

SUPPORTED FEATURES

The following features are supported

Endpoint types
FI_EP_MSG is the only supported endpoint type. Reliable datagram endpoint over TCP sockets can be achieved by layering RxM over tcp provider.

FI_EP_RDM is supported by layering ofi_rxm provider on top of the tcp provider.

Endpoint capabilities
The tcp provider currently supports FI_MSG, FI_RMA
Progress
Currently tcp provider supports only FI_PROGRESS_MANUAL
Shared Rx Context
The tcp provider supports shared receive context
Multi recv buffers
The tcp provider supports multi recv buffers

RUNTIME PARAMETERS

The tcp provider check for the following environment variables -

FI_TCP_IFACE
A specific network interface can be requested with this variable
FI_TCP_PORT_LOW_RANGE/FI_TCP_PORT_HIGH_RANGE
These variables are used to set the range of ports to be used by the tcp provider for its passive endpoint creation. This is useful where only a range of ports are allowed by firewall for tcp connections.
FI_TCP_TX_SIZE
Default tx context size (default: 256)
FI_TCP_RX_SIZE
Default rx context size (default: 256)

LIMITATIONS

The tcp provider is implemented over TCP sockets to emulate libfabric API. Hence the performance may be lower than what an application might see implementing to sockets directly, depending on the types of data transfers the application is trying to achieve.

SEE ALSO

fabric(7), fi_provider(7), fi_getinfo(3)