1SMPQUERY(8)                   Open IB Diagnostics                  SMPQUERY(8)
2
3
4

NAME

6       smpquery - query InfiniBand subnet management attributes
7

SYNOPSIS

9       smpquery [options] <op> <dest dr_path|lid|guid> [op params]
10

DESCRIPTION

12       smpquery  allows  a  basic subset of standard SMP queries including the
13       following: node info, node description, switch info, port info.  Fields
14       are displayed in human readable format.
15

OPTIONS

17       Current supported operations (case insensitive) and their parameters:
18
19          Nodeinfo (NI) <addr>
20
21          Nodedesc (ND) <addr>
22
23          Portinfo (PI) <addr> [<portnum>]     # default port is zero
24
25          PortInfoExtended (PIE) <addr> [<portnum>]
26
27          Switchinfo (SI) <addr>
28
29          PKeyTable (PKeys) <addr> [<portnum>]
30
31          SL2VLTable (SL2VL) <addr> [<portnum>]
32
33          VLArbitration (VLArb) <addr> [<portnum>]
34
35          GUIDInfo (GI) <addr>
36
37          MlnxExtPortInfo (MEPI) <addr> [<portnum>]  # default port is zero
38
39       -c, --combined
40              Use Combined route address argument <lid> <DR_Path>
41
42       -x, --extended
43              Set  SMSupportsExtendedSpeeds  bit 31 in AttributeModifier (only
44              impacts PortInfo queries).
45
46       -K, --show_keys
47              show security keys (mkey, smkey, etc.) associated with  the  re‐
48              quest.
49
50   Addressing Flags
51       -D, --Direct     The address specified is a directed route
52
53          Examples:
54             [options] -D [options] "0"          # self port
55             [options] -D [options] "0,1,2,1,4"  # out via port 1, then 2, ...
56
57             (Note the second number in the path specified must match the port being
58             used.  This can be specified using the port selection flag '-P' or the
59             port found through the automatic selection process.)
60
61       -G, --Guid     The address specified is a Port GUID
62
63       -L, --Lid   The address specified is a LID
64
65       -s, --sm_port <smlid>     use 'smlid' as the target lid for SA queries.
66
67   Port Selection flags
68       -C, --Ca <ca_name>    use the specified ca_name.
69
70       -P, --Port <ca_port>    use the specified ca_port.
71
72   Local port Selection
73       Multiple  port/Multiple CA support: when no IB device or port is speci‐
74       fied (see the "local umad parameters" below), the libibumad library se‐
75       lects the port to use by the following criteria:
76
77          1. the first port that is ACTIVE.
78
79          2. if not found, the first port that is UP (physical link up).
80
81          If  a  port  and/or  CA name is specified, the libibumad library at‐
82          tempts to fulfill the user request, and will fail if it is not  pos‐
83          sible.
84
85          For example:
86
87              ibaddr                 # use the first port (criteria #1 above)
88              ibaddr -C mthca1       # pick the best port from "mthca1" only.
89              ibaddr -P 2            # use the second (active/up) port from the first available IB device.
90              ibaddr -C mthca0 -P 2  # use the specified port only.
91
92   Debugging flags
93       -d     raise  the  IB debugging level.  May be used several times (-ddd
94              or -d -d -d).
95
96       -e     show send and receive errors (timeouts and others)
97
98       -h, --help      show the usage message
99
100       -v, --verbose
101              increase the application verbosity level.  May be  used  several
102              times (-vv or -v -v -v)
103
104       -V, --version     show the version info.
105
106   Configuration flags
107       -t,  --timeout  <timeout_ms>  override  the default timeout for the so‐
108       licited mads.
109
110       --node-name-map <node-name-map> Specify a node name map.
111          This file maps GUIDs to more user friendly names.   See  FILES  sec‐
112          tion.
113
114       -y, --m_key <key>
115              use the specified M_key for requests. If non-numeric value (like
116              'x') is specified then a value will be prompted for.
117
118       --config, -z  <config_file> Specify alternate config file.
119          Default: /etc/infiniband-diags/ibdiag.conf
120

FILES

122   CONFIG FILE
123       /etc/infiniband-diags/ibdiag.conf
124
125       A global config file is provided to set some of the common options  for
126       all tools.  See supplied config file for details.
127
128   NODE NAME MAP FILE FORMAT
129       The  node  name map is used to specify user friendly names for nodes in
130       the output.  GUIDs are used to perform the lookup.
131
132       This  functionality  is  provided  by  the  opensm-libs  package.   See
133       opensm(8) for the file location for your installation.
134
135       Generically:
136
137          # comment
138          <guid> "<name>"
139
140       Example:
141
142          # IB1
143          # Line cards
144          0x0008f104003f125c "IB1 (Rack 11 slot 1   ) ISR9288/ISR9096 Voltaire sLB-24D"
145          0x0008f104003f125d "IB1 (Rack 11 slot 1   ) ISR9288/ISR9096 Voltaire sLB-24D"
146          0x0008f104003f10d2 "IB1 (Rack 11 slot 2   ) ISR9288/ISR9096 Voltaire sLB-24D"
147          0x0008f104003f10d3 "IB1 (Rack 11 slot 2   ) ISR9288/ISR9096 Voltaire sLB-24D"
148          0x0008f104003f10bf "IB1 (Rack 11 slot 12  ) ISR9288/ISR9096 Voltaire sLB-24D"
149
150          # Spines
151          0x0008f10400400e2d "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
152          0x0008f10400400e2e "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
153          0x0008f10400400e2f "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
154          0x0008f10400400e31 "IB1 (Rack 11 spine 2   ) ISR9288 Voltaire sFB-12D"
155          0x0008f10400400e32 "IB1 (Rack 11 spine 2   ) ISR9288 Voltaire sFB-12D"
156
157          # GUID   Node Name
158          0x0008f10400411a08 "SW1  (Rack  3) ISR9024 Voltaire 9024D"
159          0x0008f10400411a28 "SW2  (Rack  3) ISR9024 Voltaire 9024D"
160          0x0008f10400411a34 "SW3  (Rack  3) ISR9024 Voltaire 9024D"
161          0x0008f104004119d0 "SW4  (Rack  3) ISR9024 Voltaire 9024D"
162

EXAMPLES

164       ::     smpquery  portinfo  3  1                      # portinfo by lid,
165              with port modifier smpquery -G switchinfo 0x2C9000100D051  1   #
166              switchinfo  by  guid smpquery -D nodeinfo 0                    #
167              nodeinfo  by  direct  route  smpquery   -c   nodeinfo   6   0,12
168              # nodeinfo by combined route
169

SEE ALSO

171       smpdump (8)
172

AUTHOR

174       Hal Rosenstock
175              < hal@mellanox.com >
176
177
178
179
180                                  2017-08-21                       SMPQUERY(8)
Impressum