1 What: /sys/class/net/<iface>/name_as 1 What: /sys/class/net/<iface>/name_assign_type
2 Date: July 2014 2 Date: July 2014
3 KernelVersion: 3.17 3 KernelVersion: 3.17
4 Contact: netdev@vger.kernel.org 4 Contact: netdev@vger.kernel.org
5 Description: 5 Description:
6 Indicates the name assignment 6 Indicates the name assignment type. Possible values are:
7 !! 7 1: enumerated by the kernel, possibly in an unpredictable way
8 == =========================== !! 8 2: predictably named by the kernel
9 1 enumerated by the kernel, p !! 9 3: named by userspace
10 2 predictably named by the ke !! 10 4: renamed
11 3 named by userspace <<
12 4 renamed <<
13 == =========================== <<
14 11
15 What: /sys/class/net/<iface>/addr_as 12 What: /sys/class/net/<iface>/addr_assign_type
16 Date: July 2010 13 Date: July 2010
17 KernelVersion: 3.2 14 KernelVersion: 3.2
18 Contact: netdev@vger.kernel.org 15 Contact: netdev@vger.kernel.org
19 Description: 16 Description:
20 Indicates the address assignme 17 Indicates the address assignment type. Possible values are:
21 !! 18 0: permanent address
22 == =========================== !! 19 1: randomly generated
23 0 permanent address !! 20 2: stolen from another device
24 1 randomly generated !! 21 3: set using dev_set_mac_address
25 2 stolen from another device <<
26 3 set using dev_set_mac_addre <<
27 == =========================== <<
28 22
29 What: /sys/class/net/<iface>/addr_le 23 What: /sys/class/net/<iface>/addr_len
30 Date: April 2005 24 Date: April 2005
31 KernelVersion: 2.6.12 25 KernelVersion: 2.6.12
32 Contact: netdev@vger.kernel.org 26 Contact: netdev@vger.kernel.org
33 Description: 27 Description:
34 Indicates the hardware address 28 Indicates the hardware address size in bytes.
35 Values vary based on the lower 29 Values vary based on the lower-level protocol used by the
36 interface (Ethernet, FDDI, ATM 30 interface (Ethernet, FDDI, ATM, IEEE 802.15.4...). See
37 include/uapi/linux/if_*.h for 31 include/uapi/linux/if_*.h for actual values.
38 32
39 What: /sys/class/net/<iface>/address 33 What: /sys/class/net/<iface>/address
40 Date: April 2005 34 Date: April 2005
41 KernelVersion: 2.6.12 35 KernelVersion: 2.6.12
42 Contact: netdev@vger.kernel.org 36 Contact: netdev@vger.kernel.org
43 Description: 37 Description:
44 Hardware address currently ass 38 Hardware address currently assigned to this interface.
45 Format is a string, e.g: 00:11 39 Format is a string, e.g: 00:11:22:33:44:55 for an Ethernet MAC
46 address. 40 address.
47 41
48 What: /sys/class/net/<bridge iface>/ 42 What: /sys/class/net/<bridge iface>/bridge/group_fwd_mask
49 Date: January 2012 43 Date: January 2012
50 KernelVersion: 3.2 44 KernelVersion: 3.2
51 Contact: netdev@vger.kernel.org 45 Contact: netdev@vger.kernel.org
52 Description: 46 Description:
53 Bitmask to allow forwarding of 47 Bitmask to allow forwarding of link local frames with address
54 01-80-C2-00-00-0X on a bridge 48 01-80-C2-00-00-0X on a bridge device. Only values that set bits
55 not matching BR_GROUPFWD_RESTR 49 not matching BR_GROUPFWD_RESTRICTED in net/bridge/br_private.h
56 allowed. 50 allowed.
57 Default value 0 does not forwa 51 Default value 0 does not forward any link local frames.
58 52
59 Restricted bits: 53 Restricted bits:
60 !! 54 0: 01-80-C2-00-00-00 Bridge Group Address used for STP
61 == =========================== !! 55 1: 01-80-C2-00-00-01 (MAC Control) 802.3 used for MAC PAUSE
62 0 01-80-C2-00-00-00 Bridge Gr !! 56 2: 01-80-C2-00-00-02 (Link Aggregation) 802.3ad
63 1 01-80-C2-00-00-01 (MAC Cont <<
64 2 01-80-C2-00-00-02 (Link Agg <<
65 == =========================== <<
66 57
67 Any values not setting these b 58 Any values not setting these bits can be used. Take special
68 care when forwarding control f 59 care when forwarding control frames e.g. 802.1X-PAE or LLDP.
69 60
70 What: /sys/class/net/<iface>/broadca 61 What: /sys/class/net/<iface>/broadcast
71 Date: April 2005 62 Date: April 2005
72 KernelVersion: 2.6.12 63 KernelVersion: 2.6.12
73 Contact: netdev@vger.kernel.org 64 Contact: netdev@vger.kernel.org
74 Description: 65 Description:
75 Hardware broadcast address for 66 Hardware broadcast address for this interface. Format is a
76 string, e.g: ff:ff:ff:ff:ff:ff 67 string, e.g: ff:ff:ff:ff:ff:ff for an Ethernet broadcast MAC
77 address. 68 address.
78 69
79 What: /sys/class/net/<iface>/carrier 70 What: /sys/class/net/<iface>/carrier
80 Date: April 2005 71 Date: April 2005
81 KernelVersion: 2.6.12 72 KernelVersion: 2.6.12
82 Contact: netdev@vger.kernel.org 73 Contact: netdev@vger.kernel.org
83 Description: 74 Description:
84 Indicates the current physical 75 Indicates the current physical link state of the interface.
85 Possible values are: !! 76 Posssible values are:
86 !! 77 0: physical link is down
87 == ===================== !! 78 1: physical link is up
88 0 physical link is down <<
89 1 physical link is up <<
90 == ===================== <<
91 79
92 Note: some special devices, e. 80 Note: some special devices, e.g: bonding and team drivers will
93 allow this attribute to be wri 81 allow this attribute to be written to force a link state for
94 operating correctly and design 82 operating correctly and designating another fallback interface.
95 83
96 What: /sys/class/net/<iface>/dev_id 84 What: /sys/class/net/<iface>/dev_id
97 Date: April 2008 85 Date: April 2008
98 KernelVersion: 2.6.26 86 KernelVersion: 2.6.26
99 Contact: netdev@vger.kernel.org 87 Contact: netdev@vger.kernel.org
100 Description: 88 Description:
101 Indicates the device unique id 89 Indicates the device unique identifier. Format is an hexadecimal
102 value. This is used to disambi 90 value. This is used to disambiguate interfaces which might be
103 stacked (e.g: VLAN interfaces) 91 stacked (e.g: VLAN interfaces) but still have the same MAC
104 address as their parent device 92 address as their parent device.
105 93
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 94 What: /sys/class/net/<iface>/dormant
125 Date: March 2006 95 Date: March 2006
126 KernelVersion: 2.6.17 96 KernelVersion: 2.6.17
127 Contact: netdev@vger.kernel.org 97 Contact: netdev@vger.kernel.org
128 Description: 98 Description:
129 Indicates whether the interfac 99 Indicates whether the interface is in dormant state. Possible
130 values are: 100 values are:
131 0: interface is not dormant 101 0: interface is not dormant
132 1: interface is dormant 102 1: interface is dormant
133 103
134 This attribute can be used by 104 This attribute can be used by supplicant software to signal that
135 the device is not usable unles 105 the device is not usable unless some supplicant-based
136 authentication is performed (e 106 authentication is performed (e.g: 802.1x). 'link_mode' attribute
137 will also reflect the dormant 107 will also reflect the dormant state.
138 108
139 What: /sys/class/net/<iface>/testing !! 109 What: /sys/clas/net/<iface>/duplex
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 110 Date: October 2009
157 KernelVersion: 2.6.33 111 KernelVersion: 2.6.33
158 Contact: netdev@vger.kernel.org 112 Contact: netdev@vger.kernel.org
159 Description: 113 Description:
160 Indicates the interface latest 114 Indicates the interface latest or current duplex value. Possible
161 values are: 115 values are:
162 !! 116 half: half duplex
163 ==== =========== !! 117 full: full duplex
164 half half duplex <<
165 full full duplex <<
166 ==== =========== <<
167 118
168 Note: This attribute is only v 119 Note: This attribute is only valid for interfaces that implement
169 the ethtool get_link_ksettings !! 120 the ethtool get_settings method (mostly Ethernet).
170 121
171 What: /sys/class/net/<iface>/flags 122 What: /sys/class/net/<iface>/flags
172 Date: April 2005 123 Date: April 2005
173 KernelVersion: 2.6.12 124 KernelVersion: 2.6.12
174 Contact: netdev@vger.kernel.org 125 Contact: netdev@vger.kernel.org
175 Description: 126 Description:
176 Indicates the interface flags 127 Indicates the interface flags as a bitmask in hexadecimal. See
177 include/uapi/linux/if.h for a 128 include/uapi/linux/if.h for a list of all possible values and
178 the flags semantics. 129 the flags semantics.
179 130
180 What: /sys/class/net/<iface>/ifalias 131 What: /sys/class/net/<iface>/ifalias
181 Date: September 2008 132 Date: September 2008
182 KernelVersion: 2.6.28 133 KernelVersion: 2.6.28
183 Contact: netdev@vger.kernel.org 134 Contact: netdev@vger.kernel.org
184 Description: 135 Description:
185 Indicates/stores an interface 136 Indicates/stores an interface alias name as a string. This can
186 be used for system management 137 be used for system management purposes.
187 138
188 What: /sys/class/net/<iface>/ifindex 139 What: /sys/class/net/<iface>/ifindex
189 Date: April 2005 140 Date: April 2005
190 KernelVersion: 2.6.12 141 KernelVersion: 2.6.12
191 Contact: netdev@vger.kernel.org 142 Contact: netdev@vger.kernel.org
192 Description: 143 Description:
193 Indicates the system-wide inte 144 Indicates the system-wide interface unique index identifier as a
194 decimal number. This attribute 145 decimal number. This attribute is used for mapping an interface
195 identifier to an interface nam 146 identifier to an interface name. It is used throughout the
196 networking stack for specifyin 147 networking stack for specifying the interface specific
197 requests/events. 148 requests/events.
198 149
199 What: /sys/class/net/<iface>/iflink 150 What: /sys/class/net/<iface>/iflink
200 Date: April 2005 151 Date: April 2005
201 KernelVersion: 2.6.12 152 KernelVersion: 2.6.12
202 Contact: netdev@vger.kernel.org 153 Contact: netdev@vger.kernel.org
203 Description: 154 Description:
204 Indicates the system-wide inte 155 Indicates the system-wide interface unique index identifier a
205 the interface is linked to. Fo 156 the interface is linked to. Format is decimal. This attribute is
206 used to resolve interfaces cha 157 used to resolve interfaces chaining, linking and stacking.
207 Physical interfaces have the s 158 Physical interfaces have the same 'ifindex' and 'iflink' values.
208 159
209 What: /sys/class/net/<iface>/link_mo 160 What: /sys/class/net/<iface>/link_mode
210 Date: March 2006 161 Date: March 2006
211 KernelVersion: 2.6.17 162 KernelVersion: 2.6.17
212 Contact: netdev@vger.kernel.org 163 Contact: netdev@vger.kernel.org
213 Description: 164 Description:
214 Indicates the interface link m 165 Indicates the interface link mode, as a decimal number. This
215 attribute should be used in co 166 attribute should be used in conjunction with 'dormant' attribute
216 to determine the interface usa 167 to determine the interface usability. Possible values:
217 !! 168 0: default link mode
218 == ================= !! 169 1: dormant link mode
219 0 default link mode <<
220 1 dormant link mode <<
221 == ================= <<
222 170
223 What: /sys/class/net/<iface>/mtu 171 What: /sys/class/net/<iface>/mtu
224 Date: April 2005 172 Date: April 2005
225 KernelVersion: 2.6.12 173 KernelVersion: 2.6.12
226 Contact: netdev@vger.kernel.org 174 Contact: netdev@vger.kernel.org
227 Description: 175 Description:
228 Indicates the interface curren 176 Indicates the interface currently configured MTU value, in
229 bytes, and in decimal format. 177 bytes, and in decimal format. Specific values depends on the
230 lower-level interface protocol 178 lower-level interface protocol used. Ethernet devices will show
231 a 'mtu' attribute value of 150 179 a 'mtu' attribute value of 1500 unless changed.
232 180
233 What: /sys/class/net/<iface>/netdev_ 181 What: /sys/class/net/<iface>/netdev_group
234 Date: January 2011 182 Date: January 2011
235 KernelVersion: 2.6.39 183 KernelVersion: 2.6.39
236 Contact: netdev@vger.kernel.org 184 Contact: netdev@vger.kernel.org
237 Description: 185 Description:
238 Indicates the interface networ 186 Indicates the interface network device group, as a decimal
239 integer. Default value is 0 wh 187 integer. Default value is 0 which corresponds to the initial
240 network devices group. The gro 188 network devices group. The group can be changed to affect
241 routing decisions (see: net/ip 189 routing decisions (see: net/ipv4/fib_rules and
242 net/ipv6/fib6_rules.c). 190 net/ipv6/fib6_rules.c).
243 191
244 What: /sys/class/net/<iface>/opersta 192 What: /sys/class/net/<iface>/operstate
245 Date: March 2006 193 Date: March 2006
246 KernelVersion: 2.6.17 194 KernelVersion: 2.6.17
247 Contact: netdev@vger.kernel.org 195 Contact: netdev@vger.kernel.org
248 Description: 196 Description:
249 Indicates the interface RFC286 197 Indicates the interface RFC2863 operational state as a string.
250 <<
251 Possible values are: 198 Possible values are:
252 <<
253 "unknown", "notpresent", "down 199 "unknown", "notpresent", "down", "lowerlayerdown", "testing",
254 "dormant", "up". 200 "dormant", "up".
255 201
256 What: /sys/class/net/<iface>/phys_po 202 What: /sys/class/net/<iface>/phys_port_id
257 Date: July 2013 203 Date: July 2013
258 KernelVersion: 3.12 204 KernelVersion: 3.12
259 Contact: netdev@vger.kernel.org 205 Contact: netdev@vger.kernel.org
260 Description: 206 Description:
261 Indicates the interface unique 207 Indicates the interface unique physical port identifier within
262 the NIC, as a string. 208 the NIC, as a string.
263 209
264 What: /sys/class/net/<iface>/phys_po 210 What: /sys/class/net/<iface>/phys_port_name
265 Date: March 2015 211 Date: March 2015
266 KernelVersion: 4.0 212 KernelVersion: 4.0
267 Contact: netdev@vger.kernel.org 213 Contact: netdev@vger.kernel.org
268 Description: 214 Description:
269 Indicates the interface physic 215 Indicates the interface physical port name within the NIC,
270 as a string. 216 as a string.
271 217
272 What: /sys/class/net/<iface>/speed 218 What: /sys/class/net/<iface>/speed
273 Date: October 2009 219 Date: October 2009
274 KernelVersion: 2.6.33 220 KernelVersion: 2.6.33
275 Contact: netdev@vger.kernel.org 221 Contact: netdev@vger.kernel.org
276 Description: 222 Description:
277 Indicates the interface latest 223 Indicates the interface latest or current speed value. Value is
278 an integer representing the li 224 an integer representing the link speed in Mbits/sec.
279 225
280 Note: this attribute is only v 226 Note: this attribute is only valid for interfaces that implement
281 the ethtool get_link_ksettings !! 227 the ethtool get_settings method (mostly Ethernet ).
282 228
283 What: /sys/class/net/<iface>/tx_queu 229 What: /sys/class/net/<iface>/tx_queue_len
284 Date: April 2005 230 Date: April 2005
285 KernelVersion: 2.6.12 231 KernelVersion: 2.6.12
286 Contact: netdev@vger.kernel.org 232 Contact: netdev@vger.kernel.org
287 Description: 233 Description:
288 Indicates the interface transm 234 Indicates the interface transmit queue len in number of packets,
289 as an integer value. Value dep 235 as an integer value. Value depend on the type of interface,
290 Ethernet network adapters have 236 Ethernet network adapters have a default value of 1000 unless
291 configured otherwise 237 configured otherwise
292 238
293 What: /sys/class/net/<iface>/type 239 What: /sys/class/net/<iface>/type
294 Date: April 2005 240 Date: April 2005
295 KernelVersion: 2.6.12 241 KernelVersion: 2.6.12
296 Contact: netdev@vger.kernel.org 242 Contact: netdev@vger.kernel.org
297 Description: 243 Description:
298 Indicates the interface protoc 244 Indicates the interface protocol type as a decimal value. See
299 include/uapi/linux/if_arp.h fo 245 include/uapi/linux/if_arp.h for all possible values.
300 246
301 What: /sys/class/net/<iface>/phys_sw 247 What: /sys/class/net/<iface>/phys_switch_id
302 Date: November 2014 248 Date: November 2014
303 KernelVersion: 3.19 249 KernelVersion: 3.19
304 Contact: netdev@vger.kernel.org 250 Contact: netdev@vger.kernel.org
305 Description: 251 Description:
306 Indicates the unique physical 252 Indicates the unique physical switch identifier of a switch this
307 port belongs to, as a string. 253 port belongs to, as a string.
308 254
309 What: /sys/class/net/<iface>/phydev 255 What: /sys/class/net/<iface>/phydev
310 Date: May 2017 256 Date: May 2017
311 KernelVersion: 4.13 257 KernelVersion: 4.13
312 Contact: netdev@vger.kernel.org 258 Contact: netdev@vger.kernel.org
313 Description: 259 Description:
314 Symbolic link to the PHY devic 260 Symbolic link to the PHY device this network device is attached
315 to. 261 to.
316 262
317 What: /sys/class/net/<iface>/carrier 263 What: /sys/class/net/<iface>/carrier_changes
318 Date: Mar 2014 264 Date: Mar 2014
319 KernelVersion: 3.15 265 KernelVersion: 3.15
320 Contact: netdev@vger.kernel.org 266 Contact: netdev@vger.kernel.org
321 Description: 267 Description:
322 32-bit unsigned integer counti 268 32-bit unsigned integer counting the number of times the link has
323 seen a change from UP to DOWN 269 seen a change from UP to DOWN and vice versa
324 270
325 What: /sys/class/net/<iface>/carrier 271 What: /sys/class/net/<iface>/carrier_up_count
326 Date: Jan 2018 272 Date: Jan 2018
327 KernelVersion: 4.16 273 KernelVersion: 4.16
328 Contact: netdev@vger.kernel.org 274 Contact: netdev@vger.kernel.org
329 Description: 275 Description:
330 32-bit unsigned integer counti 276 32-bit unsigned integer counting the number of times the link has
331 been up 277 been up
332 278
333 What: /sys/class/net/<iface>/carrier 279 What: /sys/class/net/<iface>/carrier_down_count
334 Date: Jan 2018 280 Date: Jan 2018
335 KernelVersion: 4.16 281 KernelVersion: 4.16
336 Contact: netdev@vger.kernel.org 282 Contact: netdev@vger.kernel.org
337 Description: 283 Description:
338 32-bit unsigned integer counti 284 32-bit unsigned integer counting the number of times the link has
339 been down 285 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.