1 What: /sys/class/net/<iface>/name_as
2 Date: July 2014
3 KernelVersion: 3.17
4 Contact: netdev@vger.kernel.org
5 Description:
6 Indicates the name assignment
7
8 == ===========================
9 1 enumerated by the kernel, p
10 2 predictably named by the ke
11 3 named by userspace
12 4 renamed
13 == ===========================
14
15 What: /sys/class/net/<iface>/addr_as
16 Date: July 2010
17 KernelVersion: 3.2
18 Contact: netdev@vger.kernel.org
19 Description:
20 Indicates the address assignme
21
22 == ===========================
23 0 permanent address
24 1 randomly generated
25 2 stolen from another device
26 3 set using dev_set_mac_addre
27 == ===========================
28
29 What: /sys/class/net/<iface>/addr_le
30 Date: April 2005
31 KernelVersion: 2.6.12
32 Contact: netdev@vger.kernel.org
33 Description:
34 Indicates the hardware address
35 Values vary based on the lower
36 interface (Ethernet, FDDI, ATM
37 include/uapi/linux/if_*.h for
38
39 What: /sys/class/net/<iface>/address
40 Date: April 2005
41 KernelVersion: 2.6.12
42 Contact: netdev@vger.kernel.org
43 Description:
44 Hardware address currently ass
45 Format is a string, e.g: 00:11
46 address.
47
48 What: /sys/class/net/<bridge iface>/
49 Date: January 2012
50 KernelVersion: 3.2
51 Contact: netdev@vger.kernel.org
52 Description:
53 Bitmask to allow forwarding of
54 01-80-C2-00-00-0X on a bridge
55 not matching BR_GROUPFWD_RESTR
56 allowed.
57 Default value 0 does not forwa
58
59 Restricted bits:
60
61 == ===========================
62 0 01-80-C2-00-00-00 Bridge Gr
63 1 01-80-C2-00-00-01 (MAC Cont
64 2 01-80-C2-00-00-02 (Link Agg
65 == ===========================
66
67 Any values not setting these b
68 care when forwarding control f
69
70 What: /sys/class/net/<iface>/broadca
71 Date: April 2005
72 KernelVersion: 2.6.12
73 Contact: netdev@vger.kernel.org
74 Description:
75 Hardware broadcast address for
76 string, e.g: ff:ff:ff:ff:ff:ff
77 address.
78
79 What: /sys/class/net/<iface>/carrier
80 Date: April 2005
81 KernelVersion: 2.6.12
82 Contact: netdev@vger.kernel.org
83 Description:
84 Indicates the current physical
85 Possible values are:
86
87 == =====================
88 0 physical link is down
89 1 physical link is up
90 == =====================
91
92 Note: some special devices, e.
93 allow this attribute to be wri
94 operating correctly and design
95
96 What: /sys/class/net/<iface>/dev_id
97 Date: April 2008
98 KernelVersion: 2.6.26
99 Contact: netdev@vger.kernel.org
100 Description:
101 Indicates the device unique id
102 value. This is used to disambi
103 stacked (e.g: VLAN interfaces)
104 address as their parent device
105
106 What: /sys/class/net/<iface>/dev_por
107 Date: February 2014
108 KernelVersion: 3.15
109 Contact: netdev@vger.kernel.org
110 Description:
111 Indicates the port number of t
112 as a decimal value. Some NICs
113 on the same PCI bus, device an
114 userspace to distinguish the r
115
116 Note: some device drivers star
117 purpose since long before 3.15
118 attribute ever since. To query
119 exclusively at 'dev_port', whi
120 If a network device has multip
121 described in the previous para
122 attribute to its port number,
123
124 What: /sys/class/net/<iface>/dormant
125 Date: March 2006
126 KernelVersion: 2.6.17
127 Contact: netdev@vger.kernel.org
128 Description:
129 Indicates whether the interfac
130 values are:
131 0: interface is not dormant
132 1: interface is dormant
133
134 This attribute can be used by
135 the device is not usable unles
136 authentication is performed (e
137 will also reflect the dormant
138
139 What: /sys/class/net/<iface>/testing
140 Date: April 2002
141 KernelVersion: 5.8
142 Contact: netdev@vger.kernel.org
143 Description:
144 Indicates whether the interfac
145 values are:
146
147 == ===========================
148 0 interface is not being test
149 1 interface is being tested
150 == ===========================
151
152 When an interface is under tes
153 to pass packets as normal.
154
155 What: /sys/class/net/<iface>/duplex
156 Date: October 2009
157 KernelVersion: 2.6.33
158 Contact: netdev@vger.kernel.org
159 Description:
160 Indicates the interface latest
161 values are:
162
163 ==== ===========
164 half half duplex
165 full full duplex
166 ==== ===========
167
168 Note: This attribute is only v
169 the ethtool get_link_ksettings
170
171 What: /sys/class/net/<iface>/flags
172 Date: April 2005
173 KernelVersion: 2.6.12
174 Contact: netdev@vger.kernel.org
175 Description:
176 Indicates the interface flags
177 include/uapi/linux/if.h for a
178 the flags semantics.
179
180 What: /sys/class/net/<iface>/ifalias
181 Date: September 2008
182 KernelVersion: 2.6.28
183 Contact: netdev@vger.kernel.org
184 Description:
185 Indicates/stores an interface
186 be used for system management
187
188 What: /sys/class/net/<iface>/ifindex
189 Date: April 2005
190 KernelVersion: 2.6.12
191 Contact: netdev@vger.kernel.org
192 Description:
193 Indicates the system-wide inte
194 decimal number. This attribute
195 identifier to an interface nam
196 networking stack for specifyin
197 requests/events.
198
199 What: /sys/class/net/<iface>/iflink
200 Date: April 2005
201 KernelVersion: 2.6.12
202 Contact: netdev@vger.kernel.org
203 Description:
204 Indicates the system-wide inte
205 the interface is linked to. Fo
206 used to resolve interfaces cha
207 Physical interfaces have the s
208
209 What: /sys/class/net/<iface>/link_mo
210 Date: March 2006
211 KernelVersion: 2.6.17
212 Contact: netdev@vger.kernel.org
213 Description:
214 Indicates the interface link m
215 attribute should be used in co
216 to determine the interface usa
217
218 == =================
219 0 default link mode
220 1 dormant link mode
221 == =================
222
223 What: /sys/class/net/<iface>/mtu
224 Date: April 2005
225 KernelVersion: 2.6.12
226 Contact: netdev@vger.kernel.org
227 Description:
228 Indicates the interface curren
229 bytes, and in decimal format.
230 lower-level interface protocol
231 a 'mtu' attribute value of 150
232
233 What: /sys/class/net/<iface>/netdev_
234 Date: January 2011
235 KernelVersion: 2.6.39
236 Contact: netdev@vger.kernel.org
237 Description:
238 Indicates the interface networ
239 integer. Default value is 0 wh
240 network devices group. The gro
241 routing decisions (see: net/ip
242 net/ipv6/fib6_rules.c).
243
244 What: /sys/class/net/<iface>/opersta
245 Date: March 2006
246 KernelVersion: 2.6.17
247 Contact: netdev@vger.kernel.org
248 Description:
249 Indicates the interface RFC286
250
251 Possible values are:
252
253 "unknown", "notpresent", "down
254 "dormant", "up".
255
256 What: /sys/class/net/<iface>/phys_po
257 Date: July 2013
258 KernelVersion: 3.12
259 Contact: netdev@vger.kernel.org
260 Description:
261 Indicates the interface unique
262 the NIC, as a string.
263
264 What: /sys/class/net/<iface>/phys_po
265 Date: March 2015
266 KernelVersion: 4.0
267 Contact: netdev@vger.kernel.org
268 Description:
269 Indicates the interface physic
270 as a string.
271
272 What: /sys/class/net/<iface>/speed
273 Date: October 2009
274 KernelVersion: 2.6.33
275 Contact: netdev@vger.kernel.org
276 Description:
277 Indicates the interface latest
278 an integer representing the li
279
280 Note: this attribute is only v
281 the ethtool get_link_ksettings
282
283 What: /sys/class/net/<iface>/tx_queu
284 Date: April 2005
285 KernelVersion: 2.6.12
286 Contact: netdev@vger.kernel.org
287 Description:
288 Indicates the interface transm
289 as an integer value. Value dep
290 Ethernet network adapters have
291 configured otherwise
292
293 What: /sys/class/net/<iface>/type
294 Date: April 2005
295 KernelVersion: 2.6.12
296 Contact: netdev@vger.kernel.org
297 Description:
298 Indicates the interface protoc
299 include/uapi/linux/if_arp.h fo
300
301 What: /sys/class/net/<iface>/phys_sw
302 Date: November 2014
303 KernelVersion: 3.19
304 Contact: netdev@vger.kernel.org
305 Description:
306 Indicates the unique physical
307 port belongs to, as a string.
308
309 What: /sys/class/net/<iface>/phydev
310 Date: May 2017
311 KernelVersion: 4.13
312 Contact: netdev@vger.kernel.org
313 Description:
314 Symbolic link to the PHY devic
315 to.
316
317 What: /sys/class/net/<iface>/carrier
318 Date: Mar 2014
319 KernelVersion: 3.15
320 Contact: netdev@vger.kernel.org
321 Description:
322 32-bit unsigned integer counti
323 seen a change from UP to DOWN
324
325 What: /sys/class/net/<iface>/carrier
326 Date: Jan 2018
327 KernelVersion: 4.16
328 Contact: netdev@vger.kernel.org
329 Description:
330 32-bit unsigned integer counti
331 been up
332
333 What: /sys/class/net/<iface>/carrier
334 Date: Jan 2018
335 KernelVersion: 4.16
336 Contact: netdev@vger.kernel.org
337 Description:
338 32-bit unsigned integer counti
339 been down
340
341 What: /sys/class/net/<iface>/threade
342 Date: Jan 2021
343 KernelVersion: 5.12
344 Contact: netdev@vger.kernel.org
345 Description:
346 Boolean value to control the t
347 set this value to enable/disab
348 belonging to this device, with
349
350 Possible values:
351 == ===========================
352 0 threaded mode disabled for
353 1 threaded mode enabled for t
354 == ===========================
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.