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

NAME

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

Syntax

17       ethextractifids [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                 -E/--eth config_file
45                           Specifies  the  Intel  Ethernet configuration file.
46                           Default is /etc/eth-tools/mgt_config.xml file.
47
48
49
50
51
52                 -F/--focus point
53                           Specifies the focus area for report. Used to  limit
54                           scope of report. Refer to Point Syntax for details.
55
56
57
58

Point Syntax

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

Examples

202       # List all the ifids in the fabric:
203
204       ethextractifids
205
206
207
208       # List all the ifids of end-nodes:
209
210       ethextractifids -F "nodetype:NIC"
211
212
213
214Copyright(C) 2020              Intel Corporation            ethextractifids(8)