1ethextractmissinglinks(8) EFSFFCLIRG (Man Page) ethextractmissinglinks(8)
3
7 ethextractmissinglinks
8 Produces a CSV file listing all or some of the links in the fabric.
12 ethextractmissinglinks is a front end to the ethreport tool that gener‐
13 ates a report listing all or some of the links that are present in the
14 supplied topology file, but are missing in the fabric. The output from
15 this tool can be imported into a spreadsheet or parsed by other
16 scripts.
17
19 ethextractmissinglinks [-T topology_input] [-o report]
20 [ethreport options]
21
23 --help
24 Produces full help text.
26 -T/--topology topology_input
29 Specifies the topology file to verify against. Default is
31 /etc/eth-tools/topology.xml
32 -o/--output report
35 Specifies the report type for output. Refer to Report Types
37 for details.
38 ethreport options
41 The following options are passed to ethreport. This subset is
43 considered typical and useful for this command.
44 -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. '-' may
52 be used as the snapshot_input to specify stdin.
53 -E/--eth config_file
59 Specifies the Ethernet Mgt configuration file. De‐
60 fault is /etc/eth-tools/mgt_config.xml file.
61 -p plane
67 Name of the enabled plane defined in Mgt config
68 file, default is the first enabled plane.
69 -F/--focus point
75 Specifies the focus area for report. Used to limit
76 scope of report. Refer to Point Syntax for details.
77
82 verifylinks
83 Compares fabric (or snapshot) links to supplied topology and
85 identifies differences and omissions.
86 verifyextlinks
89 Compares fabric (or snapshot) links to supplied topology and
91 identifies differences and omissions. Limits analysis to
92 links external to systems.
93 verifyniclinks
96 Compares fabric (or snapshot) links to supplied topology and
98 identify differences and omissions. Limits analysis to links
99 to NICs.
100 verifyislinks
103 Compares fabric (or snapshot) links to supplied topology and
105 identify differences and omissions. Limits analysis to inter-
106 switch links.
107 verifyextislinks
110 Compares fabric (or snapshot) links to supplied topology and
112 identify differences and omissions. Limits analysis to inter-
113 switch links external to systems.
114 verifyall
117 Returns verifynics, verifysws, and verifylinks reports.
119
123 ifid:value
124 value is numeric ifid.
126 ifid:value:node
129 value is numeric ifid, selects node with given ifid.
131 ifid:value:port:value2
134 value is numeric ifid of node, value2 is port number.
136 ifid:value:portid:value2
139 value is numeric ifid of node, value2 is port id.
141 mgmtifaddr:value
144 value is numeric port mgmtifaddr.
146 ifaddr:value
149 value is numeric node ifaddr.
151 ifaddr:value1:port:value2
154 value1 is numeric node ifaddr, value2 is port number.
156 ifaddr:value1:portid:value2
159 value1 is numeric node ifaddr, value2 is port id.
161 chassisid:value
164 value is numeric chassisid.
166 chassisid:value1:port:value2
169 value1 is numeric chassisid, value2 is port number.
171 chassisid:value1:portid:value2
174 value1 is numeric chassisid, value2 is port id.
176 node:value
179 value is node description (node name).
181 node:value1:port:value2
184 value1 is node description (node name), value2 is port num‐
186 ber.
187 node:value1:portid:value2
190 value1 is node description (node name), value2 is port id.
192 nodepat:value
195 value is glob pattern for node description (node name).
197 nodepat:value1:port:value2
200 value1 is the glob pattern for the node description (node
202 name), value2 is port number.
203 nodepat:value1:portid:value2
206 value1 is the glob pattern for the node description (node
208 name), value2 is port id.
209 nodedetpat:value
212 value is glob pattern for node details.
214 nodedetpat:value1:port:value2
217 value1 is the glob pattern for the node details, value2 is
219 port number.
220 nodedetpat:value1:portid:value2
223 value1 is the glob pattern for the node details, value2 is
225 port id.
226 nodetype:value
229 value is node type (SW or NIC).
231 nodetype:value1:port:value2
234 value1 is node type (SW or NIC), value2 is port number.
236 nodetype:value1:portid:value2
239 value1 is node type (SW or NIC), value2 is port id.
241 rate:value
244 value is string for rate (25g, 50g, 75g, 100g), omits switch
246 mgmt port 0.
247 portstate:value
250 value is a string for state (up, down, testing, unknown, dor‐
252 mant, notactive).
253 portphysstate:value
256 value is a string for PHYs state (other, unknown, opera‐
258 tional, standby, shutdown, reset)
259 mtucap:value
262 value is MTU size (maximum size 65535), omits switch mgmt
264 port 0.
265 linkdetpat:value
268 value is glob pattern for link details.
270 portdetpat:value
273 value is glob pattern for port details.
275 nodepatfile:FILENAME
278 Specifies the name of file with the list of nodepats or node
280 descriptions.
281 nodepairpatfile:FILENAME
284 Specifies the name of file with the list of node pairs, sepa‐
286 rated by a colon.
287 ldr
290 Specifies the ports with a non-zero link down reason or
292 neighbor link down reason.
293 ldr:value
296 Specifies the ports with a link down reason or neighbor link
298 down reason equal to value.
299
302 List all the missing links in the fabric:
303 ethextractmissinglinks
305 List all the missing links to a switch named "coresw1":
309 ethextractmissinglinks -T topology.plane.xml -F "node:coresw1"
311 List all the missing connections to end-nodes:
315 ethextractmissinglinks -o verifyniclinks
317 List all the missing links between two switches:
321 ethextractmissinglinks -o verifyislinks -T topology.plane.xml
323Copyright(C) 2020-2022 Intel Corporation ethextractmissinglinks(8)