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

NAME

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

Syntax

17       opaextractsellinks [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                 -T/--topology topology_input
61                           Uses topology_input file to augment and verify fab‐
62                           ric  information. When used, various reports can be
63                           augmented with information not available electroni‐
64                           cally  (such  as  cable labels). '-' may be used to
65                           specify stdin.
66
67
68
69
70
71                 -F/--focus point
72                           Specifies the focus area for report. Used  for  all
73                           reports  except  route  to  limit  scope of report.
74                           Refer to Point Syntax for details.
75
76
77
78

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

80       -h 0      First active port in system (default).
81
82
83       -h 0 -p 0 First active port in system.
84
85
86       -h x      First active port on HFI x.
87
88
89       -h x -p 0 First active port on HFI x.
90
91
92       -h 0 -p y Port y within system (no matter which ports are active).
93
94
95       -h x -p y HFI x, port y.
96
97
98

Point Syntax

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

Examples

298       # List all the links in the fabric:
299       opaextractsellinks
300
301       # List all the links to a switch named "coresw1":
302       opaextractsellinks -F "node:coresw1"
303
304       # List all the connections to end-nodes:
305       opaextractsellinks -F "nodetype:FI"
306
307       # List all the links on the 2nd HFI's fabric of a multi-plane fabric:
308       opaextractsellinks -h 2
309
310
311
312Copyright(C) 2015-2018         Intel Corporation         opaextractsellinks(8)
Impressum