355 lines · plain
1What: /sys/class/net/<iface>/name_assign_type2Date: July 20143KernelVersion: 3.174Contact: netdev@vger.kernel.org5Description:6 Indicates the name assignment type. Possible values are:7 8 == ==========================================================9 1 enumerated by the kernel, possibly in an unpredictable way10 2 predictably named by the kernel11 3 named by userspace12 4 renamed13 == ==========================================================14 15What: /sys/class/net/<iface>/addr_assign_type16Date: July 201017KernelVersion: 3.218Contact: netdev@vger.kernel.org19Description:20 Indicates the address assignment type. Possible values are:21 22 == =============================23 0 permanent address24 1 randomly generated25 2 stolen from another device26 3 set using dev_set_mac_address27 == =============================28 29What: /sys/class/net/<iface>/addr_len30Date: April 200531KernelVersion: 2.6.1232Contact: netdev@vger.kernel.org33Description:34 Indicates the hardware address size in bytes.35 Values vary based on the lower-level protocol used by the36 interface (Ethernet, FDDI, ATM, IEEE 802.15.4...). See37 include/uapi/linux/if_*.h for actual values.38 39What: /sys/class/net/<iface>/address40Date: April 200541KernelVersion: 2.6.1242Contact: netdev@vger.kernel.org43Description:44 Hardware address currently assigned to this interface.45 Format is a string, e.g: 00:11:22:33:44:55 for an Ethernet MAC46 address.47 48What: /sys/class/net/<bridge iface>/bridge/group_fwd_mask49Date: January 201250KernelVersion: 3.251Contact: netdev@vger.kernel.org52Description:53 Bitmask to allow forwarding of link local frames with address54 01-80-C2-00-00-0X on a bridge device. Only values that set bits55 not matching BR_GROUPFWD_RESTRICTED in net/bridge/br_private.h56 allowed.57 Default value 0 does not forward any link local frames.58 59 Restricted bits:60 61 == ========================================================62 0 01-80-C2-00-00-00 Bridge Group Address used for STP63 1 01-80-C2-00-00-01 (MAC Control) 802.3 used for MAC PAUSE64 2 01-80-C2-00-00-02 (Link Aggregation) 802.3ad65 == ========================================================66 67 Any values not setting these bits can be used. Take special68 care when forwarding control frames e.g. 802.1X-PAE or LLDP.69 70What: /sys/class/net/<iface>/broadcast71Date: April 200572KernelVersion: 2.6.1273Contact: netdev@vger.kernel.org74Description:75 Hardware broadcast address for this interface. Format is a76 string, e.g: ff:ff:ff:ff:ff:ff for an Ethernet broadcast MAC77 address.78 79What: /sys/class/net/<iface>/carrier80Date: April 200581KernelVersion: 2.6.1282Contact: netdev@vger.kernel.org83Description:84 Indicates the current physical link state of the interface.85 Possible values are:86 87 == =====================88 0 physical link is down89 1 physical link is up90 == =====================91 92 Note: some special devices, e.g: bonding and team drivers will93 allow this attribute to be written to force a link state for94 operating correctly and designating another fallback interface.95 96What: /sys/class/net/<iface>/dev_id97Date: April 200898KernelVersion: 2.6.2699Contact: netdev@vger.kernel.org100Description:101 Indicates the device unique identifier. Format is an hexadecimal102 value. This is used to disambiguate interfaces which might be103 stacked (e.g: VLAN interfaces) but still have the same MAC104 address as their parent device.105 106What: /sys/class/net/<iface>/dev_port107Date: February 2014108KernelVersion: 3.15109Contact: netdev@vger.kernel.org110Description:111 Indicates the port number of this network device, formatted112 as a decimal value. Some NICs have multiple independent ports113 on the same PCI bus, device and function. This attribute allows114 userspace to distinguish the respective interfaces.115 116 Note: some device drivers started to use 'dev_id' for this117 purpose since long before 3.15 and have not adopted the new118 attribute ever since. To query the port number, some tools look119 exclusively at 'dev_port', while others only consult 'dev_id'.120 If a network device has multiple client adapter ports as121 described in the previous paragraph and does not set this122 attribute to its port number, it's a kernel bug.123 124What: /sys/class/net/<iface>/dormant125Date: March 2006126KernelVersion: 2.6.17127Contact: netdev@vger.kernel.org128Description:129 Indicates whether the interface is in dormant state. Possible130 values are:131 0: interface is not dormant132 1: interface is dormant133 134 This attribute can be used by supplicant software to signal that135 the device is not usable unless some supplicant-based136 authentication is performed (e.g: 802.1x). 'link_mode' attribute137 will also reflect the dormant state.138 139What: /sys/class/net/<iface>/testing140Date: April 2002141KernelVersion: 5.8142Contact: netdev@vger.kernel.org143Description:144 Indicates whether the interface is under test. Possible145 values are:146 147 == =============================148 0 interface is not being tested149 1 interface is being tested150 == =============================151 152 When an interface is under test, it cannot be expected153 to pass packets as normal.154 155What: /sys/class/net/<iface>/duplex156Date: October 2009157KernelVersion: 2.6.33158Contact: netdev@vger.kernel.org159Description:160 Indicates the interface latest or current duplex value. Possible161 values are:162 163 ==== ===========164 half half duplex165 full full duplex166 ==== ===========167 168 Note: This attribute is only valid for interfaces that implement169 the ethtool get_link_ksettings method (mostly Ethernet).170 171What: /sys/class/net/<iface>/flags172Date: April 2005173KernelVersion: 2.6.12174Contact: netdev@vger.kernel.org175Description:176 Indicates the interface flags as a bitmask in hexadecimal. See177 include/uapi/linux/if.h for a list of all possible values and178 the flags semantics.179 180What: /sys/class/net/<iface>/ifalias181Date: September 2008182KernelVersion: 2.6.28183Contact: netdev@vger.kernel.org184Description:185 Indicates/stores an interface alias name as a string. This can186 be used for system management purposes.187 188What: /sys/class/net/<iface>/ifindex189Date: April 2005190KernelVersion: 2.6.12191Contact: netdev@vger.kernel.org192Description:193 Indicates the system-wide interface unique index identifier as a194 decimal number. This attribute is used for mapping an interface195 identifier to an interface name. It is used throughout the196 networking stack for specifying the interface specific197 requests/events.198 199What: /sys/class/net/<iface>/iflink200Date: April 2005201KernelVersion: 2.6.12202Contact: netdev@vger.kernel.org203Description:204 Indicates the system-wide interface unique index identifier a205 the interface is linked to. Format is decimal. This attribute is206 used to resolve interfaces chaining, linking and stacking.207 Physical interfaces have the same 'ifindex' and 'iflink' values.208 209What: /sys/class/net/<iface>/link_mode210Date: March 2006211KernelVersion: 2.6.17212Contact: netdev@vger.kernel.org213Description:214 Indicates the interface link mode, as a decimal number. This215 attribute should be used in conjunction with 'dormant' attribute216 to determine the interface usability. Possible values:217 218 == =================219 0 default link mode220 1 dormant link mode221 == =================222 223What: /sys/class/net/<iface>/mtu224Date: April 2005225KernelVersion: 2.6.12226Contact: netdev@vger.kernel.org227Description:228 Indicates the interface currently configured MTU value, in229 bytes, and in decimal format. Specific values depends on the230 lower-level interface protocol used. Ethernet devices will show231 a 'mtu' attribute value of 1500 unless changed.232 233What: /sys/class/net/<iface>/netdev_group234Date: January 2011235KernelVersion: 2.6.39236Contact: netdev@vger.kernel.org237Description:238 Indicates the interface network device group, as a decimal239 integer. Default value is 0 which corresponds to the initial240 network devices group. The group can be changed to affect241 routing decisions (see: net/ipv4/fib_rules and242 net/ipv6/fib6_rules.c).243 244What: /sys/class/net/<iface>/operstate245Date: March 2006246KernelVersion: 2.6.17247Contact: netdev@vger.kernel.org248Description:249 Indicates the interface RFC2863 operational state as a string.250 251 Possible values are:252 253 "unknown", "notpresent", "down", "lowerlayerdown", "testing",254 "dormant", "up".255 256What: /sys/class/net/<iface>/phys_port_id257Date: July 2013258KernelVersion: 3.12259Contact: netdev@vger.kernel.org260Description:261 Indicates the interface unique physical port identifier within262 the NIC, as a string.263 264What: /sys/class/net/<iface>/phys_port_name265Date: March 2015266KernelVersion: 4.0267Contact: netdev@vger.kernel.org268Description:269 Indicates the interface physical port name within the NIC,270 as a string.271 272What: /sys/class/net/<iface>/speed273Date: October 2009274KernelVersion: 2.6.33275Contact: netdev@vger.kernel.org276Description:277 Indicates the interface latest or current speed value. Value is278 an integer representing the link speed in Mbits/sec.279 280 Note: this attribute is only valid for interfaces that implement281 the ethtool get_link_ksettings method (mostly Ethernet).282 283What: /sys/class/net/<iface>/tx_queue_len284Date: April 2005285KernelVersion: 2.6.12286Contact: netdev@vger.kernel.org287Description:288 Indicates the interface transmit queue len in number of packets,289 as an integer value. Value depend on the type of interface,290 Ethernet network adapters have a default value of 1000 unless291 configured otherwise292 293What: /sys/class/net/<iface>/type294Date: April 2005295KernelVersion: 2.6.12296Contact: netdev@vger.kernel.org297Description:298 Indicates the interface protocol type as a decimal value. See299 include/uapi/linux/if_arp.h for all possible values.300 301What: /sys/class/net/<iface>/phys_switch_id302Date: November 2014303KernelVersion: 3.19304Contact: netdev@vger.kernel.org305Description:306 Indicates the unique physical switch identifier of a switch this307 port belongs to, as a string.308 309What: /sys/class/net/<iface>/phydev310Date: May 2017311KernelVersion: 4.13312Contact: netdev@vger.kernel.org313Description:314 Symbolic link to the PHY device this network device is attached315 to.316 317What: /sys/class/net/<iface>/carrier_changes318Date: Mar 2014319KernelVersion: 3.15320Contact: netdev@vger.kernel.org321Description:322 32-bit unsigned integer counting the number of times the link has323 seen a change from UP to DOWN and vice versa324 325What: /sys/class/net/<iface>/carrier_up_count326Date: Jan 2018327KernelVersion: 4.16328Contact: netdev@vger.kernel.org329Description:330 32-bit unsigned integer counting the number of times the link has331 been up332 333What: /sys/class/net/<iface>/carrier_down_count334Date: Jan 2018335KernelVersion: 4.16336Contact: netdev@vger.kernel.org337Description:338 32-bit unsigned integer counting the number of times the link has339 been down340 341What: /sys/class/net/<iface>/threaded342Date: Jan 2021343KernelVersion: 5.12344Contact: netdev@vger.kernel.org345Description:346 Boolean value to control the threaded mode per device. User could347 set this value to enable/disable threaded mode for all napi348 belonging to this device, without the need to do device up/down.349 350 Possible values:351 == ==================================352 0 threaded mode disabled for this dev353 1 threaded mode enabled for this dev354 == ==================================355