Changes in sysfs-class-net

ebab9426 - Documentation/ABI: Fix typos

Mon, 14 Aug 2023 21:28:20 +0000

Documentation/ABI: Fix typosFix typos in Documentation/ABI. The changes are in descriptions orcomments where they shouldn't affect use of the ABIs.Signed-off-by: Bjorn Helgaas Reviewed-by: Randy Dunlap Link: https://lore.kernel.org/r/20230814212822.193684-2-helgaas@kernel.orgSigned-off-by: Jonathan Corbet List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

5fdd2f0e - net: add sysfs attribute to control napi threaded mode

Mon, 08 Feb 2021 19:34:10 +0000

net: add sysfs attribute to control napi threaded modeThis patch adds a new sysfs attribute to the network device class.Said attribute provides a per-device control to enable/disable thethreaded mode for all the napi instances of the given network device,without the need for a device up/down.User sets it to 1 or 0 to enable or disable threaded mode.Note: when switching between threaded and the current softirq based modefor a napi instance, it will not immediately take effect if the napi iscurrently being polled. The mode switch will happen for the next timenapi_schedule() is called.Co-developed-by: Paolo Abeni Signed-off-by: Paolo Abeni Co-developed-by: Hannes Frederic Sowa Signed-off-by: Hannes Frederic Sowa Co-developed-by: Felix Fietkau Signed-off-by: Felix Fietkau Signed-off-by: Wei Wang Reviewed-by: Alexander Duyck Signed-off-by: David S. Miller List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

1088ee22 - docs: ABI: sysfs-class-net: fix a typo

Mon, 02 Nov 2020 10:32:13 +0000

docs: ABI: sysfs-class-net: fix a typoclas->classSigned-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/4bba2a1592df5a9435c8d4757a9abf20246e2a99.1604312590.git.mchehab+huawei@kernel.orgSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

54a19b4d - docs: ABI: cleanup several ABI documents

Fri, 30 Oct 2020 07:40:50 +0000

docs: ABI: cleanup several ABI documentsThere are some ABI documents that, while they don't generateany warnings, they have issues when parsed by get_abi.pl scripton its output result.Address them, in order to provide a clean output.Reviewed-by: Tom Rix # for fpga-managerReviewed-By: Kajol Jain # for sysfs-bus-event_source-devices-hv_gpci and sysfs-bus-event_source-devices-hv_24x7Acked-by: Jonathan Cameron #for IIOAcked-by: Oded Gabbay # for HabanalabsAcked-by: Vaibhav Jain # for sysfs-bus-papr-pmemAcked-by: Cezary Rojewski # for catptAcked-by: Suzuki K Poulose Acked-by: Ilya Dryomov # for rbdAcked-by: Jonathan Corbet Signed-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/5bc78e5b68ed1e9e39135173857cb2e753be868f.1604042072.git.mchehab+huawei@kernel.orgSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

db30a577 - net: Add testing sysfs attribute

Sun, 19 Apr 2020 22:11:51 +0000

net: Add testing sysfs attributeSimilar to speed, duplex and dorment, report the testing statusin sysfs.Signed-off-by: Andrew Lunn Reviewed-by: Florian Fainelli Signed-off-by: David S. Miller List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

4c0b6534 - Documentation/ABI: document /sys/class/net/*/dev_port

Thu, 06 Sep 2018 14:51:10 +0000

Documentation/ABI: document /sys/class/net/*/dev_portThe sysfs field was introduced 4 years ago along with fixes to variousdrivers that erroneously used `dev_id' for that purpose, but it was notproperly documented anywhere.See commit v3.14-rc3-739-g3f85944fe207.Signed-off-by: Arseny Maslennikov Signed-off-by: Doug Ledford List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

9b300495 - ethtool: drop get_settings and set_settings callbacks

Tue, 28 Aug 2018 17:56:58 +0000

ethtool: drop get_settings and set_settings callbacksSince [gs]et_settings ethtool_ops callbacks have been deprecated inFebruary 2016, all in tree NIC drivers have been converted to provide[gs]et_link_ksettings() and out of tree drivers have had enough time to dothe same.Drop get_settings() and set_settings() and implement both ETHTOOL_[GS]SETand ETHTOOL_[GS]LINKSETTINGS only using [gs]et_link_ksettings().Signed-off-by: Michal Kubecek Signed-off-by: David S. Miller List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

b2d3bcfa - net: core: Expose number of link up/down transitions

Thu, 18 Jan 2018 17:59:13 +0000

net: core: Expose number of link up/down transitionsExpose the number of times the link has been going UP or DOWN, andupdate the "carrier_changes" counter to be the sum of these two events.While at it, also update the sysfs-class-net documentation to cover:carrier_changes (3.15), carrier_up_count (4.16) and carrier_down_count(4.16)Signed-off-by: David Decotigny [Florian:* rebase* add documentation* merge carrier_changes with up/down counters]Signed-off-by: Florian Fainelli Signed-off-by: David S. Miller List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

8f602198 - net: sysfs: Document "phydev" symbolic link

Thu, 25 May 2017 16:21:42 +0000

net: sysfs: Document "phydev" symbolic linkNow that we link the network device to its PHY device, document thissysfs symbolic link.Signed-off-by: Florian Fainelli Signed-off-by: David S. Miller List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

784b58a3 - bridge: change BR_GROUPFWD_RESTRICTED to allow forwarding of LLDP frames

Mon, 04 May 2015 20:47:13 +0000

bridge: change BR_GROUPFWD_RESTRICTED to allow forwarding of LLDP framesBR_GROUPFWD_RESTRICTED bitmask restricts users from setting values to/sys/class/net/brX/bridge/group_fwd_mask that allow forwarding ofsome IEEE 802.1D Table 7-10 Reserved addresses: (MAC Control) 802.3 01-80-C2-00-00-01 (Link Aggregation) 802.3 01-80-C2-00-00-02 802.1AB LLDP 01-80-C2-00-00-0EChange BR_GROUPFWD_RESTRICTED to allow to forward LLDP frames and documentgroup_fwd_mask.e.g. echo 16384 > /sys/class/net/brX/bridge/group_fwd_maskallows to forward LLDP frames.This may be needed for bridge setups used for network troubleshooting orany other scenario where forwarding of LLDP frames is desired (e.g. bridgeconnecting a virtual machine to real switch transmitting LLDP frames thatvirtual machine needs to receive).Tested on a simple bridge setup with two interfaces and host transmittingLLDP frames on one side of this bridge (used lldpd). Setting group_fwd_maskas described above lets LLDP frames traverse bridge.Signed-off-by: Bernhard Thaler Signed-off-by: David S. Miller List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

db24a904 - net: add support for phys_port_name

Wed, 18 Mar 2015 02:23:15 +0000

net: add support for phys_port_nameSimilar to port id allow netdevices to specify port names and exportthe name via sysfs. Drivers can implement the netdevice operation toassist udev in having sane default names for the devices using therule:$ cat /etc/udev/rules.d/80-net-setup-link.rulesSUBSYSTEM=="net", ACTION=="add", ATTR{phys_port_name}!="",NAME="$attr{phys_port_name}"Use of phys_name versus phys_id was suggested-by Jiri Pirko.Signed-off-by: David Ahern Acked-by: Jiri Pirko Acked-by: Scott Feldman Signed-off-by: David S. Miller List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

aecbe01e - net-sysfs: expose physical switch id for particular device

Fri, 28 Nov 2014 13:34:19 +0000

net-sysfs: expose physical switch id for particular deviceSigned-off-by: Jiri Pirko Reviewed-by: Thomas Graf Acked-by: John Fastabend Acked-by: Andy Gospodarek Acked-by: Florian Fainelli Signed-off-by: David S. Miller List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

1578ea3a - Documentation: ABI/testing: Spelling s/calss/class/

Tue, 12 Aug 2014 23:26:57 +0000

Documentation: ABI/testing: Spelling s/calss/class/Signed-off-by: Junien Fridrick Signed-off-by: Jiri Kosina List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

685343fc - net: add name_assign_type netdev attribute

Mon, 14 Jul 2014 14:37:22 +0000

net: add name_assign_type netdev attributeBased on a patch by David Herrmann.The name_assign_type attribute gives hints where the interface name of agiven net-device comes from. These values are currently defined: NET_NAME_ENUM: The ifname is provided by the kernel with an enumerated suffix, typically based on order of discovery. Names may be reused and unpredictable. NET_NAME_PREDICTABLE: The ifname has been assigned by the kernel in a predictable way that is guaranteed to avoid reuse and always be the same for a given device. Examples include statically created devices like the loopback device and names deduced from hardware properties (including being given explicitly by the firmware). Names depending on the order of discovery, or in any other way on the existence of other devices, must not be marked as PREDICTABLE. NET_NAME_USER: The ifname was provided by user-space during net-device setup. NET_NAME_RENAMED: The net-device has been renamed from userspace. Once this type is set, it cannot change again. NET_NAME_UNKNOWN: This is an internal placeholder to indicate that we yet haven't yet categorized the name. It will not be exposed to userspace, rather -EINVAL is returned.The aim of these patches is to improve user-space renaming of interfaces. Asa general rule, userspace must rename interfaces to guarantee that names staythe same every time a given piece of hardware appears (at boot, or whenattaching it). However, there are several situations where userspace shouldnot perform the renaming, and that depends on both the policy of the localadmin, but crucially also on the nature of the current interface name.If an interface was created in repsonse to a userspace request, and userspacealready provided a name, we most probably want to leave that name alone. Themain instance of this is wifi-P2P devices created over nl80211, which currentlyhave a long-standing bug where they are getting renamed by udev. We label suchnames NET_NAME_USER.If an interface, unbeknown to us, has already been renamed from userspace, wemost probably want to leave also that alone. This will typically happen whenthird-party plugins (for instance to udev, but the interface is generic so couldbe from anywhere) renames the interface without informing udev about it. Atypical situation is when you switch root from an installer or an initrd to thereal system and the new instance of udev does not know what happened beforethe switch. These types of problems have caused repeated issues in the past. Tosolve this, once an interface has been renamed, its name is labelledNET_NAME_RENAMED.In many cases, the kernel is actually able to name interfaces in such away that there is no need for userspace to rename them. This is the case whenthe enumeration order of devices, or in fact any other (non-parent) device onthe system, can not influence the name of the interface. Examples includestatically created devices, or any naming schemes based on hardware propertiesof the interface. In this case the admin may prefer to use the kernel-providednames, and to make that possible we label such names NET_NAME_PREDICTABLE.We want the kernel to have tho possibilty of performing predictable interfacenaming itself (and exposing to userspace that it has), as the informationnecessary for a proper naming scheme for a certain class of devices may notbe exposed to userspace.The case where renaming is almost certainly desired, is when the kernel hasgiven the interface a name using global device enumeration based on order ofdiscovery (ethX, wlanY, etc). These naming schemes are labelled NET_NAME_ENUM.Lastly, a fallback is left as NET_NAME_UNKNOWN, to indicate that a driver hasnot yet been ported. This is mostly useful as a transitionary measure, allowingus to label the various naming schemes bit by bit.v8: minor documentation fixesv9: move comment to the right commitSigned-off-by: Tom Gundersen Reviewed-by: David Herrmann Reviewed-by: Kay Sievers Signed-off-by: David S. Miller List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

79499bca - net: sysfs: add missing phys_port_id documentation

Fri, 23 May 2014 23:35:40 +0000

net: sysfs: add missing phys_port_id documentationAdd documentation for the phys_port_id sysfs attribute of a networkdevice.Signed-off-by: Florian Fainelli Signed-off-by: David S. Miller List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net

39f1a2f0 - net: sysfs: add Documentation entries for basic set of attributes

Fri, 28 Mar 2014 21:25:57 +0000

net: sysfs: add Documentation entries for basic set of attributesAdd sysfs attributes Documentation entries for the basic set ofattributes that are exposed by a network device in/sys/class/net//Signed-off-by: Florian Fainelli Signed-off-by: David S. Miller List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-net