libsdp - Sockets Direct Protocol library
Please see following description for synopsis
libsdp(3lib) libsdp(3lib)
NAME
libsdp - Sockets Direct Protocol library
DESCRIPTION
libsdp is a LD_PRELOAD-able library that can be used to migrate exist-
ing applications use InfiniBand Sockets Direct Protocol (SDP) instead
of TCP sockets, transparently and without recompilations. To setup lib-
sdp please follow the instructions below.
SETUP
libsdp.so isn't setup automatically. it can be used in one of 2 ways:
1) LD_PRELOAD environment variable. Setting this to the name of the
library you want to use will cause it to be preloaded.
2) Adding the name of the library using crle(1).
The library should be installed in a directory in which the dynamic
loader searches for shared libraries (as specified by LD_LIBRARY_PATH,
crle(1) , etc). Alternatively, you can specify the full path to the
library that you want to use in LD_PRELOAD or crle(1) described above.
If you have multiple library versions (e.g. 64/32 bit) and want the
linker to select between them automatically. This done for eample using
LD_LIBRARY_PATH to point to both the lib (the 32 bit version) and
lib/64 directories and LD_RELOAD the libsdp.so. This way the correct
32/64bit libsdp.so will be selected. For example using bash this can be
written:
LD_LIBRARY_PATH=/usr/lib/secure/64/:/usr/lib/secure LD_PRELOAD=lib-
sdp.so ssh
CONFIGURATION
libsdp supports two modes of configuration:
1) simple operation where it converts all calls to socket(3C) with
a family of AF_INET and a type of SOCK_STREAM into family of
AF_INET_SDP.
2) selective mode where it uses a configuration file to select
which sockets will be using SDP and which will not.
Note: both of these modes are designed to work with both IPv4 qand
IPv6. But only IPv4 works currently, because Solaris SDP with IPv6,
does not use AF_INET_SDP. (Note in Linux, the underlying SDP kernel
implementation does not support IPv6.)
For real world applications where communication with X, authentication,
DNS and other servers connected through TCP is required the selective
mode is required. Simple mode will be selected in one of the following
conditions:
1) The environment variable SIMPLE_LIBSDP to a non-empty value
2) No configuration file is defined or is un-readble
3) The configuration file does not include any address family rule
For information on how to configure libsdp, see libsdp.conf(5),
installed in /etc/libsdp.conf The user can further control the
file to be used for configuration by setting the environment
variable: LIBSDP_CONFIG_FILE
FILES
/usr/lib/secure/libsdp.so shared object
/usr/lib/secure/64/libsdp.so 64 bit shared object
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------------+
|Availability | network/open-fabrics |
+---------------+-----------------------+
|Stability | Pass-through volatile |
+---------------+-----------------------+
SEE ALSO
socket(3HEAD), attributes(7), libsdp.conf(5)
NOTES
Non-blocking connect in "both" mode defaults to SDP. Specific rules
might be needed for applications to operate properly.
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from ['https://www.openfabrics.org/down-
loads/ibutils/ibutils-1.5.7-0.2.gbd7e502.tar.gz', 'https://www.openfab-
rics.org/downloads/libibverbs/libibverbs-1.1.8.tar.gz',
'https://www.openfabrics.org/downloads/libmlx4/libmlx4-1.0.6.tar.gz',
'https://www.openfabrics.org/downloads/libsdp/lib-
sdp-1.1.108-0.15.gd7fdb72.tar.gz', 'https://www.openfabrics.org/down-
loads/management/infiniband-diags-1.6.5.tar.gz', 'https://www.openfab-
rics.org/downloads/management/libibmad-1.3.12.tar.gz',
'https://www.openfabrics.org/downloads/management/libibu-
mad-1.3.10.2.tar.gz', 'https://www.openfabrics.org/downloads/manage-
ment/opensm-3.3.19.tar.gz', 'https://www.openfabrics.org/down-
loads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz', 'https://www.open-
fabrics.org/downloads/qperf/qperf-0.4.9.tar.gz', 'https://www.openfab-
rics.org/downloads/rdmacm/librdmacm-1.0.21.tar.gz', 'https://www.open-
fabrics.org/downloads/rds-tools/rds-tools-2.0.4.tar.gz'].
Further information about this software can be found on the open source
community website at http://www.openfabrics.org/.
Sep 20, 2010 libsdp(3lib)