SETLEDS(1) General Commands Manual SETLEDS(1)
NAME
setleds - set the keyboard leds
SYNOPSIS
setleds [-v] [-L] [-D] [-F] [{+|-}num] [{+|-}caps] [{+|-}scroll]
DESCRIPTION
Setleds reports and changes the led flag settings of a VT (namely Num-
Lock, CapsLock and ScrollLock). Without arguments, setleds prints the
current settings. With arguments, it sets or clears the indicated flags
(and leaves the others unchanged). The settings before and after the
change are reported if the -v flag is given.
The led flag settings are specific for each VT (and the VT corresponding
to stdin is used).
By default (or with option -F), setleds will only change the VT flags
(and their setting may be reflected by the keyboard leds).
With option -D, setleds will change both the VT flags and their default
settings (so that a subsequent reset will not undo the change). This
might be useful for people who always want to have numlock set.
With option -L, setleds will not touch the VT flags, but only change the
leds. From this moment on, the leds will no longer reflect the VT flags
(but display whatever is put into them). The command setleds -L (with-
out further arguments) will restore the situation in which the leds re-
flect the VT flags.
One might use setleds in /etc/rc to define the initial and default state
of NumLock, e.g. by
INITTY=/dev/tty[1-8]
for tty in $INITTY; do
setleds -D +num < $tty
done
OPTIONS
-num +num
Clear or set NumLock. (At present, the NumLock setting influ-
ences the interpretation of keypad keys. Pressing the NumLock
key complements the NumLock setting.)
-caps +caps
Clear or set CapsLock. (At present, the CapsLock setting comple-
ments the Shift key when applied to letters. Pressing the Cap-
sLock key complements the CapsLock setting.)
-scroll +scroll
Clear or set ScrollLock. (At present, pressing the ScrollLock
key (or ^S/^Q) stops/starts console output.)
BUGS
In keyboard application mode the NumLock key does not influence the Num-
Lock flag setting.
AUTHORS
Andries Brouwer <aeb@cwi.nl>
SEE ALSO
loadkeys(1)
kbd 24 Sep 1994 SETLEDS(1)
Generated by dwww version 1.16 on Tue Dec 16 04:05:48 CET 2025.