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
SET_NODEDESC.SH(1M) SET_NODEDESC.SH(1M)
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(1M) of the system. The common Node descrip-
tor string can be set to a string other than the hostname(1M) 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.
EXAMPLES
1. Set Node descriptor string to hostname(1M) 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
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+---------------+----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+----------------------+
|Availability | network/open-fabrics |
+---------------+----------------------+
|Stability | Volatile |
+---------------+----------------------+
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original community
source was downloaded from ['http://www.openfabrics.org/downloads/ibu-
tils/ibutils-1.5.7.tar.gz', 'http://www.openfabrics.org/down-
loads/libibverbs/libibverbs-1.1.4-1.22.g7257cd3.tar.gz',
'http://www.openfabrics.org/down-
loads/libmlx4/libmlx4-1.0.1-1.18.gb810a27.tar.gz', 'http://www.openfab-
rics.org/downloads/libsdp/libsdp-1.1.108-0.15.gd7fdb72.tar.gz',
'http://www.openfabrics.org/downloads/management/infiniband-
diags-1.5.8.tar.gz', 'http://www.openfabrics.org/downloads/manage-
ment/libibmad-1.3.7.tar.gz', 'http://www.openfabrics.org/downloads/man-
agement/libibumad-1.3.7.tar.gz', 'http://www.openfabrics.org/down-
loads/management/opensm-3.3.9.tar.gz', 'http://www.openfab-
rics.org/downloads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz',
'http://www.openfabrics.org/down-
loads/qperf/qperf-0.4.6-0.1.gb81434e.tar.gz', 'http://www.openfab-
rics.org/downloads/rdmacm/librdmacm-1.0.14.1.tar.gz', 'http://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 4 April 2011 SET_NODEDESC.SH(1M)