1
2opaextractlids(8)      Master map: IFSFFCLIRG (Man Page)     opaextractlids(8)
3
4
5

NAME

7       opaextractlids
8
9
10
11       Produces  a  CSV  file  listing  all or some of the LIDs in the fabric.
12       opaextractlids is a front end to the opareport tool.  The  output  from
13       this  tool  can  be  imported  into  a  spreadsheet  or parsed by other
14       scripts.
15

Syntax

17       opaextractlids [opareport options]
18

Options

20       --help    Produces full help text.
21
22
23       opareport options
24                 The following options are passed to opareport. This subset is
25                 considered  typical  and  useful for this command. By design,
26                 the tool ignores -o/--output report option.
27
28
29
30
31                 -h/--hfi hfi
32                           Specifies the HFI, numbered 1..n. Using 0 specifies
33                           that the -p port port is a system-wide port number.
34                           (Default is 0.)
35
36
37
38
39
40                 -p/--port port
41                           Specifies the port, numbered 1..n. Using  0  speci‐
42                           fies the first active port. (Default is 0.)
43
44
45
46
47
48                 -X/--infile snapshot_input
49                           Generates  a  report  using  the  data in the snap‐
50                           shot_input file. snapshot_input must have been gen‐
51                           erated  during  a  previous  -o  snapshot run. When
52                           used, the -s, -i, -C, and -a options  are  ignored.
53                           '-'  may  be  used as the snapshot_input to specify
54                           stdin.
55
56
57
58
59
60                 -F/--focus point
61                           Specifies the focus area for report. Used  for  all
62                           reports  except  route  to  limit  scope of report.
63                           Refer to Point Syntax for details.
64
65
66
67

-h and -p options permit a variety of selections:

69       -h 0      First active port in system (default).
70
71
72       -h 0 -p 0 First active port in system.
73
74
75       -h x      First active port on HFI x.
76
77
78       -h x -p 0 First active port on HFI x.
79
80
81       -h 0 -p y Port y within system (no matter which ports are active).
82
83
84       -h x -p y HFI x, port y.
85
86
87

Point Syntax

89       gid:value value is numeric port GID of form: subnet:guid.
90
91
92       lid:value value is numeric LID.
93
94
95       lid:value:node
96                 value is numeric LID, selects entire node with given LID.
97
98
99       lid:value:port:value2
100                 value is numeric LID of node, value2 is port number.
101
102
103       portguid:value
104                 value is numeric port GUID.
105
106
107       nodeguid:value
108                 value is numeric node GUID.
109
110
111       nodeguid:value1:port:value2
112                 value1 is numeric node GUID, value2 is port number.
113
114
115       iocguid:value
116                 value is numeric IOC GUID.
117
118
119       iocguid:value1:port:value2
120                 value1 is numeric IOC GUID, value2 is port number.
121
122
123       systemguid:value
124                 value is numeric system image GUID.
125
126
127       systemguid:value1:port:value2
128                 value1 is the numeric system image GUID, value2 is port  num‐
129                 ber.
130
131
132       ioc:value value is IOC Profile ID String (IOC Name).
133
134
135       ioc:value1:port:value2
136                 value1  is  IOC  Profile ID String (IOC Name), value2 is port
137                 number.
138
139
140       iocpat:value
141                 value is glob pattern for IOC Profile ID String (IOC Name).
142
143
144       iocpat:value1:port:value2
145                 value1 is glob pattern for IOC Profile ID String (IOC  Name),
146                 value2 is port number.
147
148
149       ioctype:value
150                 value is IOC type (SRP or OTHER).
151
152
153       ioctype:value1:port:value2
154                 value1 is IOC type (SRP or OTHER); value2 is port number.
155
156
157       node:value
158                 value is node description (node name).
159
160
161       node:value1:port:value2
162                 value1  is  node description (node name), value2 is port num‐
163                 ber.
164
165
166       nodepat:value
167                 value is glob pattern for node description (node name).
168
169
170       nodepat:value1:port:value2
171                 value1 is the glob pattern for  the  node  description  (node
172                 name), value2 is port number.
173
174
175       nodedetpat:value
176                 value is glob pattern for node details.
177
178
179       nodedetpat:value1:port:value2
180                 value1  is  the  glob pattern for the node details, value2 is
181                 port number.
182
183
184       nodetype:value
185                 value is node type (SW, FI, or RT).
186
187
188       nodetype:value1:port:value2
189                 value1 is node type (SW, FI, or RT), value2 is port number.
190
191
192       rate:value
193                 value is string for rate (25g, 50g, 75g, 100g), omits  switch
194                 mgmt port 0.
195
196
197       portstate:value
198                 value  is  a  string  for  state  (down, init, armed, active,
199                 notactive, initarmed).
200
201
202       portphysstate:value
203                 value is a string for PHYs state (polling,  disabled,  train‐
204                 ing, linkup, recovery, offline, test)
205
206
207       mtucap:value
208                 value  is  MTU  size  (2048, 4096, 8192, 10240), omits switch
209                 mgmt port 0.
210
211
212       labelpat:value
213                 value is glob pattern for cable label.
214
215
216       lengthpat:value
217                 value is glob pattern for cable length.
218
219
220       cabledetpat:value
221                 value is glob pattern for cable details.
222
223
224       cabinflenpat:value
225                 value is glob pattern for cable info length.
226
227
228       cabinfvendnamepat:value
229                 value is glob pattern for cable info vendor name.
230
231
232       cabinfvendpnpat:value
233                 value is glob pattern for cable info vendor part number.
234
235
236       cabinfvendrevpat:value
237                 value is glob pattern for cable info vendor revision.
238
239
240       cabinfvendsnpat:value
241                 value is glob pattern for cable info vendor serial number.
242
243
244       cabinftype:value
245                 value is either optical,  passive_copper,  active_copper,  or
246                 unknown.
247
248
249       linkdetpat:value
250                 value is glob pattern for link details.
251
252
253       portdetpat:value
254                 value is glob pattern for port details.
255
256
257       sm        Specifies the master subnet manager (SM).
258
259
260       smdetpat:value
261                 value is glob pattern for SM details.
262
263
264       route:point1:point2
265                 Specifies  all  ports  along the routes between the two given
266                 points.
267
268
269       led:value value is either on or off for LED port beacon.
270
271
272       linkqual:value
273                 Specifies the ports with a link quality equal to value.
274
275
276       linkqualLE:value
277                 Specifies the ports with a link quality less than or equal to
278                 value.
279
280
281       linkqualGE:value
282                 Specifies the ports with a link quality greater than or equal
283                 to value.
284
285

Examples

287       # List all the lids in the fabric:
288       opaextractlids
289
290       # List all the lids of end-nodes:
291       opaextractlids -F "nodetype:FI"
292
293       # List all the lids on the 2nd HFI's fabric of a multi-plane fabric:
294       opaextractlids -h 2
295
296
297
298Copyright(C) 2015-2018         Intel Corporation             opaextractlids(8)