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)