1
2ethextractsellinks(8)        EFSFFCLIRG (Man Page)       ethextractsellinks(8)
3
4
5

NAME

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

Syntax

17       ethextractsellinks [ethreport  options]
18

Options

20       --help
21
22                 Produces full help text.
23
24
25       ethreport options
26
27                 The following options are passed to ethreport. This subset is
28                 considered  typical  and  useful for this command. By design,
29                 the tool ignores -o/--output report option.
30
31
32
33
34                 -X/--infile snapshot_input
35                           Generates a report using  the  data  in  the  snap‐
36                           shot_input file. snapshot_input must have been gen‐
37                           erated during a previous -o snapshot run.  '-'  may
38                           be used as the snapshot_input to specify stdin.
39
40
41
42
43
44                 -T/--topology topology_input
45                           Uses topology_input file to augment and verify fab‐
46                           ric information. When used, various reports can  be
47                           augmented with information not available electroni‐
48                           cally. '-' may be used to specify stdin.
49
50
51
52
53
54                 -E/--eth config_file
55                           Specifies the Intel  Ethernet  configuration  file.
56                           Default is /etc/eth-tools/mgt_config.xml file.
57
58
59
60
61
62                 -F/--focus point
63                           Specifies  the focus area for report. Used to limit
64                           scope of report. Refer to Point Syntax for details.
65
66
67
68

Point Syntax

70       ifid:value
71
72                 value is numeric ifid.
73
74
75       ifid:value:node
76
77                 value is numeric ifid, selects node with given ifid.
78
79
80       ifid:value:port:value2
81
82                 value is numeric ifid of node, value2 is port number.
83
84
85       mgmtifaddr:value
86
87                 value is numeric port mgmtifaddr.
88
89
90       ifaddr:value
91
92                 value is numeric node ifaddr.
93
94
95       ifaddr:value1:port:value2
96
97                 value1 is numeric node ifaddr, value2 is port number.
98
99
100       chassisid:value
101
102                 value is numeric chassisid.
103
104
105       chassisid:value1:port:value2
106
107                 value1 is numeric chassisid, value2 is port number.
108
109
110       node:value
111
112                 value is node description (node name).
113
114
115       node:value1:port:value2
116
117                 value1 is node description (node name), value2 is  port  num‐
118                 ber.
119
120
121       nodepat:value
122
123                 value is glob pattern for node description (node name).
124
125
126       nodepat:value1:port:value2
127
128                 value1  is  the  glob  pattern for the node description (node
129                 name), value2 is port number.
130
131
132       nodedetpat:value
133
134                 value is glob pattern for node details.
135
136
137       nodedetpat:value1:port:value2
138
139                 value1 is the glob pattern for the node  details,  value2  is
140                 port number.
141
142
143       nodetype:value
144
145                 value is node type (SW or NIC).
146
147
148       nodetype:value1:port:value2
149
150                 value1 is node type (SW or NIC), value2 is port number.
151
152
153       rate:value
154
155                 value  is string for rate (25g, 50g, 75g, 100g), omits switch
156                 mgmt port 0.
157
158
159       portstate:value
160
161                 value is a string for state (up, down, testing, unknown, dor‐
162                 mant, notactive).
163
164
165       portphysstate:value
166
167                 value  is  a  string  for  PHYs state (other, unknown, opera‐
168                 tional, standby, shutdown, reset)
169
170
171       mtucap:value
172
173                 value is MTU size (maximum size  65535),  omits  switch  mgmt
174                 port 0.
175
176
177       linkdetpat:value
178
179                 value is glob pattern for link details.
180
181
182       portdetpat:value
183
184                 value is glob pattern for port details.
185
186
187       nodepatfile:FILENAME
188
189                 Specifies  the name of file with the list of nodepats or node
190                 descriptions.
191
192
193       nodepairpatfile:FILENAME
194
195                 Specifies the name of file with the list of node pairs, sepa‐
196                 rated by a colon.
197
198
199       ldr
200
201                 Specifies  the  ports  with  a  non-zero  link down reason or
202                 neighbor link down reason.
203
204
205       ldr:value
206
207                 Specifies the ports with a link down reason or neighbor  link
208                 down reason equal to value.
209
210

Examples

212       # List all the links in the fabric:
213
214       ethextractsellinks
215
216
217
218       # List all the links to a switch named "coresw1":
219
220       ethextractsellinks -F "node:coresw1"
221
222
223
224       # List all the connections to end-nodes:
225
226       ethextractsellinks -F "nodetype:NIC"
227
228
229
230Copyright(C) 2020              Intel Corporation         ethextractsellinks(8)