2023-11-28 04:01:00

by Daniel Golle

Subject: [PATCH v3 2/2] docs: ABI: sysfs-class-led-trigger-netdev: add new modes and entry

Document newly introduced modes for the LED netdev trigger.

Add documentation for new modes:
- link_2500
- link_5000
- link_10000

Signed-off-by: Daniel Golle <[email protected]>
---
v3: include this documentation patch as well

.../testing/sysfs-class-led-trigger-netdev | 39 +++++++++++++++++++
1 file changed, 39 insertions(+)

diff --git a/Documentation/ABI/testing/sysfs-class-led-trigger-netdev b/Documentation/ABI/testing/sysfs-class-led-trigger-netdev
index f6d9d72ce77b7..a6c307c4befa0 100644
--- a/Documentation/ABI/testing/sysfs-class-led-trigger-netdev
+++ b/Documentation/ABI/testing/sysfs-class-led-trigger-netdev
@@ -114,6 +114,45 @@ Description:
speed of 1000Mbps of the named network device.
Setting this value also immediately changes the LED state.

+What: /sys/class/leds/<led>/link_2500
+Date: Nov 2023
+KernelVersion: 6.8
+Contact: [email protected]
+Description:
+ Signal the link speed state of 2500Mbps of the named network device.
+
+ If set to 0 (default), the LED's normal state is off.
+
+ If set to 1, the LED's normal state reflects the link state
+ speed of 2500Mbps of the named network device.
+ Setting this value also immediately changes the LED state.
+
+What: /sys/class/leds/<led>/link_5000
+Date: Nov 2023
+KernelVersion: 6.8
+Contact: [email protected]
+Description:
+ Signal the link speed state of 5000Mbps of the named network device.
+
+ If set to 0 (default), the LED's normal state is off.
+
+ If set to 1, the LED's normal state reflects the link state
+ speed of 5000Mbps of the named network device.
+ Setting this value also immediately changes the LED state.
+
+What: /sys/class/leds/<led>/link_10000
+Date: Nov 2023
+KernelVersion: 6.8
+Contact: [email protected]
+Description:
+ Signal the link speed state of 10000Mbps of the named network device.
+
+ If set to 0 (default), the LED's normal state is off.
+
+ If set to 1, the LED's normal state reflects the link state
+ speed of 10000Mbps of the named network device.
+ Setting this value also immediately changes the LED state.
+
What: /sys/class/leds/<led>/half_duplex
Date: Jun 2023
KernelVersion: 6.5
--
2.43.0

2023-12-07 16:31:27

by Marek Behún

Subject: Re: [PATCH v3 2/2] docs: ABI: sysfs-class-led-trigger-netdev: add new modes and entry

On Tue, 28 Nov 2023 04:00:39 +0000
Daniel Golle <[email protected]> wrote:

> Document newly introduced modes for the LED netdev trigger.
>
> Add documentation for new modes:
> - link_2500
> - link_5000
> - link_10000
>
> Signed-off-by: Daniel Golle <[email protected]>
> ---
> v3: include this documentation patch as well
>
> .../testing/sysfs-class-led-trigger-netdev | 39 +++++++++++++++++++
> 1 file changed, 39 insertions(+)
>
> diff --git a/Documentation/ABI/testing/sysfs-class-led-trigger-netdev b/Documentation/ABI/testing/sysfs-class-led-trigger-netdev
> index f6d9d72ce77b7..a6c307c4befa0 100644
> --- a/Documentation/ABI/testing/sysfs-class-led-trigger-netdev
> +++ b/Documentation/ABI/testing/sysfs-class-led-trigger-netdev
> @@ -114,6 +114,45 @@ Description:
> speed of 1000Mbps of the named network device.
> Setting this value also immediately changes the LED state.
>
> +What: /sys/class/leds/<led>/link_2500
> +Date: Nov 2023
> +KernelVersion: 6.8
> +Contact: [email protected]
> +Description:
> + Signal the link speed state of 2500Mbps of the named network device.

Should this file be present even if the network device does not support
that speed?

Marek