xref: /linux/Documentation/ABI/testing/sysfs-class-led-trigger-netdev (revision ee8bfb47222a5cc59dee345b7369c5f2068e78cd)
106f502f5SBen WhittenWhat:		/sys/class/leds/<led>/device_name
206f502f5SBen WhittenDate:		Dec 2017
306f502f5SBen WhittenKernelVersion:	4.16
406f502f5SBen WhittenContact:	linux-leds@vger.kernel.org
506f502f5SBen WhittenDescription:
606f502f5SBen Whitten		Specifies the network device name to monitor.
706f502f5SBen Whitten
806f502f5SBen WhittenWhat:		/sys/class/leds/<led>/interval
906f502f5SBen WhittenDate:		Dec 2017
1006f502f5SBen WhittenKernelVersion:	4.16
1106f502f5SBen WhittenContact:	linux-leds@vger.kernel.org
1206f502f5SBen WhittenDescription:
1306f502f5SBen Whitten		Specifies the duration of the LED blink in milliseconds.
1406f502f5SBen Whitten		Defaults to 50 ms.
1506f502f5SBen Whitten
1644f0fb8dSMarek Behún		When offloaded is true, the interval value MUST be set to the
172ffb8d02SChristian Marangi		default value and cannot be changed.
182ffb8d02SChristian Marangi		Trying to set any value in this specific mode will return
192ffb8d02SChristian Marangi		an EINVAL error.
202ffb8d02SChristian Marangi
2106f502f5SBen WhittenWhat:		/sys/class/leds/<led>/link
2206f502f5SBen WhittenDate:		Dec 2017
2306f502f5SBen WhittenKernelVersion:	4.16
2406f502f5SBen WhittenContact:	linux-leds@vger.kernel.org
2506f502f5SBen WhittenDescription:
2606f502f5SBen Whitten		Signal the link state of the named network device.
2754a19b4dSMauro Carvalho Chehab
2806f502f5SBen Whitten		If set to 0 (default), the LED's normal state is off.
2954a19b4dSMauro Carvalho Chehab
3006f502f5SBen Whitten		If set to 1, the LED's normal state reflects the link state
3106f502f5SBen Whitten		of the named network device.
3206f502f5SBen Whitten		Setting this value also immediately changes the LED state.
3306f502f5SBen Whitten
3454a19b4dSMauro Carvalho Chehab
3506f502f5SBen WhittenWhat:		/sys/class/leds/<led>/tx
3606f502f5SBen WhittenDate:		Dec 2017
3706f502f5SBen WhittenKernelVersion:	4.16
3806f502f5SBen WhittenContact:	linux-leds@vger.kernel.org
3906f502f5SBen WhittenDescription:
4006f502f5SBen Whitten		Signal transmission of data on the named network device.
4154a19b4dSMauro Carvalho Chehab
4206f502f5SBen Whitten		If set to 0 (default), the LED will not blink on transmission.
4354a19b4dSMauro Carvalho Chehab
4406f502f5SBen Whitten		If set to 1, the LED will blink for the milliseconds specified
4506f502f5SBen Whitten		in interval to signal transmission.
4606f502f5SBen Whitten
4744f0fb8dSMarek Behún		When offloaded is true, the blink interval is controlled by
4844f0fb8dSMarek Behún		hardware and won't reflect the value set in interval.
492ffb8d02SChristian Marangi
5006f502f5SBen WhittenWhat:		/sys/class/leds/<led>/rx
5106f502f5SBen WhittenDate:		Dec 2017
5206f502f5SBen WhittenKernelVersion:	4.16
5306f502f5SBen WhittenContact:	linux-leds@vger.kernel.org
5406f502f5SBen WhittenDescription:
5506f502f5SBen Whitten		Signal reception of data on the named network device.
5654a19b4dSMauro Carvalho Chehab
5706f502f5SBen Whitten		If set to 0 (default), the LED will not blink on reception.
5854a19b4dSMauro Carvalho Chehab
5906f502f5SBen Whitten		If set to 1, the LED will blink for the milliseconds specified
6006f502f5SBen Whitten		in interval to signal reception.
612ffb8d02SChristian Marangi
6244f0fb8dSMarek Behún		When offloaded is true, the blink interval is controlled by
6344f0fb8dSMarek Behún		hardware and won't reflect the value set in interval.
642ffb8d02SChristian Marangi
6544f0fb8dSMarek BehúnWhat:		/sys/class/leds/<led>/offloaded
662ffb8d02SChristian MarangiDate:		Jun 2023
672ffb8d02SChristian MarangiKernelVersion:	6.5
682ffb8d02SChristian MarangiContact:	linux-leds@vger.kernel.org
692ffb8d02SChristian MarangiDescription:
7044f0fb8dSMarek Behún		Communicate whether the LED trigger modes are offloaded to
7144f0fb8dSMarek Behún		hardware or whether software fallback is used.
722ffb8d02SChristian Marangi
732ffb8d02SChristian Marangi		If 0, the LED is using software fallback to blink.
742ffb8d02SChristian Marangi
7544f0fb8dSMarek Behún		If 1, the LED blinking in requested mode is offloaded to
7644f0fb8dSMarek Behún		hardware.
772ffb8d02SChristian Marangi
782ffb8d02SChristian MarangiWhat:		/sys/class/leds/<led>/link_10
792ffb8d02SChristian MarangiDate:		Jun 2023
802ffb8d02SChristian MarangiKernelVersion:	6.5
812ffb8d02SChristian MarangiContact:	linux-leds@vger.kernel.org
822ffb8d02SChristian MarangiDescription:
832ffb8d02SChristian Marangi		Signal the link speed state of 10Mbps of the named network device.
842ffb8d02SChristian Marangi
852ffb8d02SChristian Marangi		If set to 0 (default), the LED's normal state is off.
862ffb8d02SChristian Marangi
872ffb8d02SChristian Marangi		If set to 1, the LED's normal state reflects the link state
882ffb8d02SChristian Marangi		speed of 10MBps of the named network device.
892ffb8d02SChristian Marangi		Setting this value also immediately changes the LED state.
902ffb8d02SChristian Marangi
912ffb8d02SChristian MarangiWhat:		/sys/class/leds/<led>/link_100
922ffb8d02SChristian MarangiDate:		Jun 2023
932ffb8d02SChristian MarangiKernelVersion:	6.5
942ffb8d02SChristian MarangiContact:	linux-leds@vger.kernel.org
952ffb8d02SChristian MarangiDescription:
962ffb8d02SChristian Marangi		Signal the link speed state of 100Mbps of the named network device.
972ffb8d02SChristian Marangi
982ffb8d02SChristian Marangi		If set to 0 (default), the LED's normal state is off.
992ffb8d02SChristian Marangi
1002ffb8d02SChristian Marangi		If set to 1, the LED's normal state reflects the link state
1012ffb8d02SChristian Marangi		speed of 100Mbps of the named network device.
1022ffb8d02SChristian Marangi		Setting this value also immediately changes the LED state.
1032ffb8d02SChristian Marangi
1042ffb8d02SChristian MarangiWhat:		/sys/class/leds/<led>/link_1000
1052ffb8d02SChristian MarangiDate:		Jun 2023
1062ffb8d02SChristian MarangiKernelVersion:	6.5
1072ffb8d02SChristian MarangiContact:	linux-leds@vger.kernel.org
1082ffb8d02SChristian MarangiDescription:
1092ffb8d02SChristian Marangi		Signal the link speed state of 1000Mbps of the named network device.
1102ffb8d02SChristian Marangi
1112ffb8d02SChristian Marangi		If set to 0 (default), the LED's normal state is off.
1122ffb8d02SChristian Marangi
1132ffb8d02SChristian Marangi		If set to 1, the LED's normal state reflects the link state
1142ffb8d02SChristian Marangi		speed of 1000Mbps of the named network device.
1152ffb8d02SChristian Marangi		Setting this value also immediately changes the LED state.
1162ffb8d02SChristian Marangi
117*ee8bfb47SDaniel GolleWhat:		/sys/class/leds/<led>/link_2500
118*ee8bfb47SDaniel GolleDate:		Nov 2023
119*ee8bfb47SDaniel GolleKernelVersion:	6.8
120*ee8bfb47SDaniel GolleContact:	linux-leds@vger.kernel.org
121*ee8bfb47SDaniel GolleDescription:
122*ee8bfb47SDaniel Golle		Signal the link speed state of 2500Mbps of the named network device.
123*ee8bfb47SDaniel Golle
124*ee8bfb47SDaniel Golle		If set to 0 (default), the LED's normal state is off.
125*ee8bfb47SDaniel Golle
126*ee8bfb47SDaniel Golle		If set to 1, the LED's normal state reflects the link state
127*ee8bfb47SDaniel Golle		speed of 2500Mbps of the named network device.
128*ee8bfb47SDaniel Golle		Setting this value also immediately changes the LED state.
129*ee8bfb47SDaniel Golle
130*ee8bfb47SDaniel GolleWhat:		/sys/class/leds/<led>/link_5000
131*ee8bfb47SDaniel GolleDate:		Nov 2023
132*ee8bfb47SDaniel GolleKernelVersion:	6.8
133*ee8bfb47SDaniel GolleContact:	linux-leds@vger.kernel.org
134*ee8bfb47SDaniel GolleDescription:
135*ee8bfb47SDaniel Golle		Signal the link speed state of 5000Mbps of the named network device.
136*ee8bfb47SDaniel Golle
137*ee8bfb47SDaniel Golle		If set to 0 (default), the LED's normal state is off.
138*ee8bfb47SDaniel Golle
139*ee8bfb47SDaniel Golle		If set to 1, the LED's normal state reflects the link state
140*ee8bfb47SDaniel Golle		speed of 5000Mbps of the named network device.
141*ee8bfb47SDaniel Golle		Setting this value also immediately changes the LED state.
142*ee8bfb47SDaniel Golle
143*ee8bfb47SDaniel GolleWhat:		/sys/class/leds/<led>/link_10000
144*ee8bfb47SDaniel GolleDate:		Nov 2023
145*ee8bfb47SDaniel GolleKernelVersion:	6.8
146*ee8bfb47SDaniel GolleContact:	linux-leds@vger.kernel.org
147*ee8bfb47SDaniel GolleDescription:
148*ee8bfb47SDaniel Golle		Signal the link speed state of 10000Mbps of the named network device.
149*ee8bfb47SDaniel Golle
150*ee8bfb47SDaniel Golle		If set to 0 (default), the LED's normal state is off.
151*ee8bfb47SDaniel Golle
152*ee8bfb47SDaniel Golle		If set to 1, the LED's normal state reflects the link state
153*ee8bfb47SDaniel Golle		speed of 10000Mbps of the named network device.
154*ee8bfb47SDaniel Golle		Setting this value also immediately changes the LED state.
155*ee8bfb47SDaniel Golle
1562ffb8d02SChristian MarangiWhat:		/sys/class/leds/<led>/half_duplex
1572ffb8d02SChristian MarangiDate:		Jun 2023
1582ffb8d02SChristian MarangiKernelVersion:	6.5
1592ffb8d02SChristian MarangiContact:	linux-leds@vger.kernel.org
1602ffb8d02SChristian MarangiDescription:
1612ffb8d02SChristian Marangi		Signal the link half duplex state of the named network device.
1622ffb8d02SChristian Marangi
1632ffb8d02SChristian Marangi		If set to 0 (default), the LED's normal state is off.
1642ffb8d02SChristian Marangi
1652ffb8d02SChristian Marangi		If set to 1, the LED's normal state reflects the link half
1662ffb8d02SChristian Marangi		duplex state of the named network device.
1672ffb8d02SChristian Marangi		Setting this value also immediately changes the LED state.
1682ffb8d02SChristian Marangi
1692ffb8d02SChristian MarangiWhat:		/sys/class/leds/<led>/full_duplex
1702ffb8d02SChristian MarangiDate:		Jun 2023
1712ffb8d02SChristian MarangiKernelVersion:	6.5
1722ffb8d02SChristian MarangiContact:	linux-leds@vger.kernel.org
1732ffb8d02SChristian MarangiDescription:
1742ffb8d02SChristian Marangi		Signal the link full duplex state of the named network device.
1752ffb8d02SChristian Marangi
1762ffb8d02SChristian Marangi		If set to 0 (default), the LED's normal state is off.
1772ffb8d02SChristian Marangi
1782ffb8d02SChristian Marangi		If set to 1, the LED's normal state reflects the link full
1792ffb8d02SChristian Marangi		duplex state of the named network device.
1802ffb8d02SChristian Marangi		Setting this value also immediately changes the LED state.
181