Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

libsdp (3lib)

Name

libsdp - Sockets Direct Protocol library

Synopsis

Please see following description for synopsis

Description

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.


       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)