Debian Codegraph @

upstream/fedora-44/man1/setleds.1

raw
1 .\" @(#)setleds.1 1.0 940924 aeb
2 .TH SETLEDS 1 "24 Sep 1994" "kbd"
3 .SH NAME
4 setleds \- set the keyboard leds
5 .SH SYNOPSIS
6 .B setleds
7 .RI [ "-v" "] [" "-L" "] [" "-D" "] [" "-F" ]
8 .RI [ {+|-}num "] [" {+|-}caps "] [" {+|-}scroll ]
9 .SH DESCRIPTION
10 .IX "setleds command" "" "\fLsetleds\fR command"
11 .LP
12 .B Setleds
13 reports and changes the led flag settings of a VT
14 (namely NumLock, CapsLock and ScrollLock).
15 Without arguments,
16 .B setleds
17 prints the current settings.
18 With arguments, it sets or clears the indicated flags
19 (and leaves the others unchanged). The settings before
20 and after the change are reported if the \-v flag is given.
21 .LP
22 The led flag settings are specific for each VT (and the VT
23 corresponding to stdin is used).
24 .LP
25 By default (or with option \-F),
26 .B setleds
27 will only change the VT flags (and their setting may be
28 reflected by the keyboard leds).
29 .LP
30 With option \-D,
31 .B setleds
32 will change both the VT flags and their default settings
33 (so that a subsequent reset will not undo the change).
34 This might be useful for people who always want to have numlock set.
35 .LP
36 With option \-L,
37 .B setleds
38 will not touch the VT flags, but only change the leds.
39 From this moment on, the leds will no longer reflect the VT flags
40 (but display whatever is put into them). The command
41 .B "setleds -L"
42 (without further arguments) will restore the situation in which
43 the leds reflect the VT flags.
44 .LP
45 One might use
46 .B setleds
47 in /etc/rc to define the initial and default state of NumLock,
48 e.g. by
49 .br
50 .in +5m
51 INITTY=/dev/tty[1-8]
52 .br
53 for tty in $INITTY; do
54 .br
55 .in +5m
56 setleds \-D +num < $tty
57 .br
58 .in -5m
59 done
60 .in -5m
61 .SH OPTIONS
62 .TP
63 \-num +num
64 Clear or set NumLock.
65 (At present, the NumLock setting influences the
66 interpretation of keypad keys.
67 Pressing the NumLock key complements the NumLock setting.)
68 .TP
69 \-caps +caps
70 Clear or set CapsLock.
71 (At present, the CapsLock setting complements the Shift key
72 when applied to letters.
73 Pressing the CapsLock key complements the CapsLock setting.)
74 .TP
75 \-scroll +scroll
76 Clear or set ScrollLock.
77 (At present, pressing the ScrollLock key (or ^S/^Q) stops/starts
78 console output.)
79 .SH "BUGS"
80 In keyboard application mode the NumLock key does not
81 influence the NumLock flag setting.
82 .SH AUTHORS
83 Andries Brouwer <[email protected]>
84 .SH "SEE ALSO"
85 .BR loadkeys (1)
86