Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

set_nodedesc.sh (8)

Name

set_nodedesc.sh - Set/View Node Description String for Infiniband Host Controller Adapters (HCA)s

Synopsis

set_nodedesc.sh

set_nodedesc.sh -N <CommonString>

set_nodedesc.sh -H <HCAString> -G GUID

set_nodedesc.sh -H <HCAString> -G GUID -N <CommonString>

set_nodedesc.sh -v

Description

SET_NODEDESC.SH(8)          System Manager's Manual         SET_NODEDESC.SH(8)



NAME
       set_nodedesc.sh  - Set/View Node Description String for Infiniband Host
       Controller Adapters (HCA)s

SYNOPSIS
       set_nodedesc.sh

       set_nodedesc.sh -N <CommonString>

       set_nodedesc.sh -H <HCAString> -G GUID

       set_nodedesc.sh -H <HCAString> -G GUID -N <CommonString>

       set_nodedesc.sh -v


DESCRIPTION
       The set_nodedesc.sh utility can be used to set or view   Node  descrip-
       tion strings for InfiniBand(IB) Host Controller Adapters(HCA). The node
       description string can consist of two parts :

            1. Node Description String common to all HCAs.
            2. Node Description String specific to an HCA.

       The complete Node Description string will be :

            <CommonNodeDescriptionString><HCANodeDescriptionString>

       The common Node Description String is used  if  no  HCA  specific  Node
       descr-  iption  string  is set. The Node Descriptor string from the HCA
       firmware will be used if common node descriptor is not set.

       set_nodedesc.sh called without arguments, sets the common node descrip-
       tor string to the hostname(1) of the system. The common Node descriptor
       string can be set to a string other than the hostname(1) using  the  -N
       option.

       The HCA specific Node Description String can be set using the -H and -G
       option. The Global Unique IDentifier (GUID) specified with  -G  identi-
       fies  the  HCA  to  set  the HCA specific Node Description string.  The
       options -H and -G can be combined together with -N, to specify the com-
       mon Node description String.

       The  -v option can be used to view the Node descriptors for all HCAs on
       the system. It will fail if no node description has been written on the
       system previously.


EXAMPLES
       1. Set Node descriptor string to hostname(1) for all HCAs:

            set_nodedesc.sh

       2. Set Node descriptor string to string "test":

            #set_nodedesc.sh -N "test"

       3. Setting the HCA specific Node Description for HCA with
          GUID 0x0002c903000008d0 to " hca_test" :

            #set_nodedesc.sh -H " hca_test" -G 0x0002c903000008d0

       4. Setting the HCA specific Node Description for HCA with GUID
          0x0002c903000008d0 to " hca_test1" and set the common node
          descriptor to "test1" :

            #set_nodedesc.sh -H " hca_test" -G 0x0002c903000008d0 -N "test1"

       5. Read all Node descriptors :

            #set_nodedesc.sh -v

See Also
ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | network/open-fabrics  |
       +---------------+-----------------------+
       |Stability      | Pass-through volatile |
       +---------------+-----------------------+

NOTES
       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/.



USER COMMANDS                     22 Dec 2020               SET_NODEDESC.SH(8)