1opaextractsellinks(8) Master map: IFSFFCLIRG (Man Page) opaextractsellinks(8)
3
7 opaextractsellinks
8 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
17 opaextractsellinks [opareport options]
18
20 --help Produces full help text.
21 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 -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 -p/--port port
41 Specifies the port, numbered 1..n. Using 0 speci‐
42 fies the first active port. (Default is 0.)
43 -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 -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 -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
80 -h 0 First active port in system (default).
81 -h 0 -p 0 First active port in system.
84 -h x First active port on HFI x.
87 -h x -p 0 First active port on HFI x.
90 -h 0 -p y Port y within system (no matter which ports are active).
93 -h x -p y HFI x, port y.
96
100 gid:value value is numeric port GID of form: subnet:guid.
101 lid:value value is numeric LID.
104 lid:value:node
107 value is numeric LID, selects entire node with given LID.
108 lid:value:port:value2
111 value is numeric LID of node, value2 is port number.
112 portguid:value
115 value is numeric port GUID.
116 nodeguid:value
119 value is numeric node GUID.
120 nodeguid:value1:port:value2
123 value1 is numeric node GUID, value2 is port number.
124 iocguid:value
127 value is numeric IOC GUID.
128 iocguid:value1:port:value2
131 value1 is numeric IOC GUID, value2 is port number.
132 systemguid:value
135 value is numeric system image GUID.
136 systemguid:value1:port:value2
139 value1 is the numeric system image GUID, value2 is port num‐
140 ber.
141 ioc:value value is IOC Profile ID String (IOC Name).
144 ioc:value1:port:value2
147 value1 is IOC Profile ID String (IOC Name), value2 is port
148 number.
149 iocpat:value
152 value is glob pattern for IOC Profile ID String (IOC Name).
153 iocpat:value1:port:value2
156 value1 is glob pattern for IOC Profile ID String (IOC Name),
157 value2 is port number.
158 ioctype:value
161 value is IOC type (SRP or OTHER).
162 ioctype:value1:port:value2
165 value1 is IOC type (SRP or OTHER); value2 is port number.
166 node:value
169 value is node description (node name).
170 node:value1:port:value2
173 value1 is node description (node name), value2 is port num‐
174 ber.
175 nodepat:value
178 value is glob pattern for node description (node name).
179 nodepat:value1:port:value2
182 value1 is the glob pattern for the node description (node
183 name), value2 is port number.
184 nodedetpat:value
187 value is glob pattern for node details.
188 nodedetpat:value1:port:value2
191 value1 is the glob pattern for the node details, value2 is
192 port number.
193 nodetype:value
196 value is node type (SW, FI, or RT).
197 nodetype:value1:port:value2
200 value1 is node type (SW, FI, or RT), value2 is port number.
201 rate:value
204 value is string for rate (25g, 50g, 75g, 100g), omits switch
205 mgmt port 0.
206 portstate:value
209 value is a string for state (down, init, armed, active,
210 notactive, initarmed).
211 portphysstate:value
214 value is a string for PHYs state (polling, disabled, train‐
215 ing, linkup, recovery, offline, test)
216 mtucap:value
219 value is MTU size (2048, 4096, 8192, 10240), omits switch
220 mgmt port 0.
221 labelpat:value
224 value is glob pattern for cable label.
225 lengthpat:value
228 value is glob pattern for cable length.
229 cabledetpat:value
232 value is glob pattern for cable details.
233 cabinflenpat:value
236 value is glob pattern for cable info length.
237 cabinfvendnamepat:value
240 value is glob pattern for cable info vendor name.
241 cabinfvendpnpat:value
244 value is glob pattern for cable info vendor part number.
245 cabinfvendrevpat:value
248 value is glob pattern for cable info vendor revision.
249 cabinfvendsnpat:value
252 value is glob pattern for cable info vendor serial number.
253 cabinftype:value
256 value is either optical, passive_copper, active_copper, or
257 unknown.
258 linkdetpat:value
261 value is glob pattern for link details.
262 portdetpat:value
265 value is glob pattern for port details.
266 sm Specifies the master subnet manager (SM).
269 smdetpat:value
272 value is glob pattern for SM details.
273 route:point1:point2
276 Specifies all ports along the routes between the two given
277 points.
278 led:value value is either on or off for LED port beacon.
281 linkqual:value
284 Specifies the ports with a link quality equal to value.
285 linkqualLE:value
288 Specifies the ports with a link quality less than or equal to
289 value.
290 linkqualGE:value
293 Specifies the ports with a link quality greater than or equal
294 to value.
295
298 # List all the links in the fabric:
299 opaextractsellinks
300 # List all the links to a switch named "coresw1":
302 opaextractsellinks -F "node:coresw1"
303 # List all the connections to end-nodes:
305 opaextractsellinks -F "nodetype:FI"
306 # List all the links on the 2nd HFI's fabric of a multi-plane fabric:
308 opaextractsellinks -h 2
309Copyright(C) 2015-2018 Intel Corporation opaextractsellinks(8)