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

NAME

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

Syntax

17       ethextracterror [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                 -A/--allports
55                           Gets PortInfo for down switch ports.
56
57
58
59
60
61                 -E/--eth config_file
62                           Specifies the Intel  Ethernet  configuration  file.
63                           Default is /etc/eth-tools/mgt_config.xml file.
64
65
66
67
68
69                 -F/--focus point
70                           Specifies  the focus area for report. Used to limit
71                           scope of report. Refer to Point Syntax for details.
72
73
74
75

Point Syntax

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

Examples

219       # List all the link errors in the fabric:
220
221       ethextracterror
222
223
224
225       # List all the link errors related to a switch named "coresw1":
226
227       ethextracterror -F "node:coresw1"
228
229
230
231       # List all the link errors for end-nodes:
232
233       ethextracterror -F "nodetype:NIC"
234
235
236
237Copyright(C) 2020              Intel Corporation            ethextracterror(8)