t
Copyright (c) 2011, 2016, Oracle and/or its affiliates. All rights reserved.
Modified for Solaris to add the Solaris stability classification,
and to add a note about source availability.

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

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

The set_nodedesc.sh utility can be used to set or view Node description 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 descriptor 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 identifies the HCA to set the HCA specific Node Description string. The options -H and -G can be combined together with -N, to specify the common 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.

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 descriptiors :

 #set_nodedesc.sh -v

 "See Also"