xref: /linux/Documentation/ABI/testing/sysfs-class-led-trigger-netdev (revision 79790b6818e96c58fe2bffee1b418c16e64e7b80)
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
91*5fe5e2a3SChristian Marangi		Present only if the named network device supports 10Mbps link speed.
92*5fe5e2a3SChristian Marangi
932ffb8d02SChristian MarangiWhat:		/sys/class/leds/<led>/link_100
942ffb8d02SChristian MarangiDate:		Jun 2023
952ffb8d02SChristian MarangiKernelVersion:	6.5
962ffb8d02SChristian MarangiContact:	linux-leds@vger.kernel.org
972ffb8d02SChristian MarangiDescription:
982ffb8d02SChristian Marangi		Signal the link speed state of 100Mbps of the named network device.
992ffb8d02SChristian Marangi
1002ffb8d02SChristian Marangi		If set to 0 (default), the LED's normal state is off.
1012ffb8d02SChristian Marangi
1022ffb8d02SChristian Marangi		If set to 1, the LED's normal state reflects the link state
1032ffb8d02SChristian Marangi		speed of 100Mbps of the named network device.
1042ffb8d02SChristian Marangi		Setting this value also immediately changes the LED state.
1052ffb8d02SChristian Marangi
106*5fe5e2a3SChristian Marangi		Present only if the named network device supports 100Mbps link speed.
107*5fe5e2a3SChristian Marangi
1082ffb8d02SChristian MarangiWhat:		/sys/class/leds/<led>/link_1000
1092ffb8d02SChristian MarangiDate:		Jun 2023
1102ffb8d02SChristian MarangiKernelVersion:	6.5
1112ffb8d02SChristian MarangiContact:	linux-leds@vger.kernel.org
1122ffb8d02SChristian MarangiDescription:
1132ffb8d02SChristian Marangi		Signal the link speed state of 1000Mbps of the named network device.
1142ffb8d02SChristian Marangi
1152ffb8d02SChristian Marangi		If set to 0 (default), the LED's normal state is off.
1162ffb8d02SChristian Marangi
1172ffb8d02SChristian Marangi		If set to 1, the LED's normal state reflects the link state
1182ffb8d02SChristian Marangi		speed of 1000Mbps of the named network device.
1192ffb8d02SChristian Marangi		Setting this value also immediately changes the LED state.
1202ffb8d02SChristian Marangi
121*5fe5e2a3SChristian Marangi		Present only if the named network device supports 1000Mbps link speed.
122*5fe5e2a3SChristian Marangi
123ee8bfb47SDaniel GolleWhat:		/sys/class/leds/<led>/link_2500
124ee8bfb47SDaniel GolleDate:		Nov 2023
125ee8bfb47SDaniel GolleKernelVersion:	6.8
126ee8bfb47SDaniel GolleContact:	linux-leds@vger.kernel.org
127ee8bfb47SDaniel GolleDescription:
128ee8bfb47SDaniel Golle		Signal the link speed state of 2500Mbps of the named network device.
129ee8bfb47SDaniel Golle
130ee8bfb47SDaniel Golle		If set to 0 (default), the LED's normal state is off.
131ee8bfb47SDaniel Golle
132ee8bfb47SDaniel Golle		If set to 1, the LED's normal state reflects the link state
133ee8bfb47SDaniel Golle		speed of 2500Mbps of the named network device.
134ee8bfb47SDaniel Golle		Setting this value also immediately changes the LED state.
135ee8bfb47SDaniel Golle
136*5fe5e2a3SChristian Marangi		Present only if the named network device supports 2500Mbps link speed.
137*5fe5e2a3SChristian Marangi
138ee8bfb47SDaniel GolleWhat:		/sys/class/leds/<led>/link_5000
139ee8bfb47SDaniel GolleDate:		Nov 2023
140ee8bfb47SDaniel GolleKernelVersion:	6.8
141ee8bfb47SDaniel GolleContact:	linux-leds@vger.kernel.org
142ee8bfb47SDaniel GolleDescription:
143ee8bfb47SDaniel Golle		Signal the link speed state of 5000Mbps of the named network device.
144ee8bfb47SDaniel Golle
145ee8bfb47SDaniel Golle		If set to 0 (default), the LED's normal state is off.
146ee8bfb47SDaniel Golle
147ee8bfb47SDaniel Golle		If set to 1, the LED's normal state reflects the link state
148ee8bfb47SDaniel Golle		speed of 5000Mbps of the named network device.
149ee8bfb47SDaniel Golle		Setting this value also immediately changes the LED state.
150ee8bfb47SDaniel Golle
151*5fe5e2a3SChristian Marangi		Present only if the named network device supports 5000Mbps link speed.
152*5fe5e2a3SChristian Marangi
153ee8bfb47SDaniel GolleWhat:		/sys/class/leds/<led>/link_10000
154ee8bfb47SDaniel GolleDate:		Nov 2023
155ee8bfb47SDaniel GolleKernelVersion:	6.8
156ee8bfb47SDaniel GolleContact:	linux-leds@vger.kernel.org
157ee8bfb47SDaniel GolleDescription:
158ee8bfb47SDaniel Golle		Signal the link speed state of 10000Mbps of the named network device.
159ee8bfb47SDaniel Golle
160ee8bfb47SDaniel Golle		If set to 0 (default), the LED's normal state is off.
161ee8bfb47SDaniel Golle
162ee8bfb47SDaniel Golle		If set to 1, the LED's normal state reflects the link state
163ee8bfb47SDaniel Golle		speed of 10000Mbps of the named network device.
164ee8bfb47SDaniel Golle		Setting this value also immediately changes the LED state.
165ee8bfb47SDaniel Golle
166*5fe5e2a3SChristian Marangi		Present only if the named network device supports 10000Mbps link speed.
167*5fe5e2a3SChristian Marangi
1682ffb8d02SChristian MarangiWhat:		/sys/class/leds/<led>/half_duplex
1692ffb8d02SChristian MarangiDate:		Jun 2023
1702ffb8d02SChristian MarangiKernelVersion:	6.5
1712ffb8d02SChristian MarangiContact:	linux-leds@vger.kernel.org
1722ffb8d02SChristian MarangiDescription:
1732ffb8d02SChristian Marangi		Signal the link half duplex state of the named network device.
1742ffb8d02SChristian Marangi
1752ffb8d02SChristian Marangi		If set to 0 (default), the LED's normal state is off.
1762ffb8d02SChristian Marangi
1772ffb8d02SChristian Marangi		If set to 1, the LED's normal state reflects the link half
1782ffb8d02SChristian Marangi		duplex state of the named network device.
1792ffb8d02SChristian Marangi		Setting this value also immediately changes the LED state.
1802ffb8d02SChristian Marangi
1812ffb8d02SChristian MarangiWhat:		/sys/class/leds/<led>/full_duplex
1822ffb8d02SChristian MarangiDate:		Jun 2023
1832ffb8d02SChristian MarangiKernelVersion:	6.5
1842ffb8d02SChristian MarangiContact:	linux-leds@vger.kernel.org
1852ffb8d02SChristian MarangiDescription:
1862ffb8d02SChristian Marangi		Signal the link full duplex state of the named network device.
1872ffb8d02SChristian Marangi
1882ffb8d02SChristian Marangi		If set to 0 (default), the LED's normal state is off.
1892ffb8d02SChristian Marangi
1902ffb8d02SChristian Marangi		If set to 1, the LED's normal state reflects the link full
1912ffb8d02SChristian Marangi		duplex state of the named network device.
1922ffb8d02SChristian Marangi		Setting this value also immediately changes the LED state.
193