.\" Automatically generated by Pandoc 1.19.2.4
.\"
.TH "fi_tcp" "7" "2020\-04\-14" "Libfabric Programmer\[aq]s Manual" "\@VERSION\@"
.hy
.SH NAME
.PP
fi_tcp \- The msg sockets Fabric Provider
.SH OVERVIEW
.PP
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.
.SH SUPPORTED FEATURES
.PP
The following features are supported
.TP
.B \f[I]Endpoint types\f[]
\f[I]FI_EP_MSG\f[] is the only supported endpoint type.
Reliable datagram endpoint over TCP sockets can be achieved by layering
RxM over tcp provider.
.RS
.RE
\f[I]FI_EP_RDM\f[] is supported by layering ofi_rxm provider on top of
the tcp provider.
.RS
.RE
.TP
.B \f[I]Endpoint capabilities\f[]
The tcp provider currently supports \f[I]FI_MSG\f[], \f[I]FI_RMA\f[]
.RS
.RE
.TP
.B \f[I]Progress\f[]
Currently tcp provider supports only \f[I]FI_PROGRESS_MANUAL\f[]
.RS
.RE
.TP
.B \f[I]Shared Rx Context\f[]
The tcp provider supports shared receive context
.RS
.RE
.TP
.B \f[I]Multi recv buffers\f[]
The tcp provider supports multi recv buffers
.RS
.RE
.SH RUNTIME PARAMETERS
.PP
The tcp provider check for the following enviroment variables \-
.TP
.B \f[I]FI_TCP_IFACE\f[]
A specific can be requested with this variable
.RS
.RE
.TP
.B \f[I]FI_TCP_PORT_LOW_RANGE/FI_TCP_PORT_HIGH_RANGE\f[]
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.
.RS
.RE
.SH LIMITATIONS
.PP
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.
.SH SEE ALSO
.PP
\f[C]fabric\f[](7), \f[C]fi_provider\f[](7), \f[C]fi_getinfo\f[](3)
.SH AUTHORS
OpenFabrics.