1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101
|
.\" Made by Sampo Niskanen
.TH ledcontrol 1 "February, 2001" "ledcontrol @VERSION@"
.SH NAME
ledcontrol \- set LED states
.SH SYNOPSIS
.B ledcontrol
[OPTIONS] COMMAND...
.SH PACKAGE DESCRIPTION
.B Ledcontrol
is both the name of the ledcontrol package and a script in it. This
section deals with the ledcontrol package in general; the rest of the
man page with the script.
.PP
.B Ledcontrol
is a package which allows you to show arbitrary information on the
normally-unused keyboard LEDs. It is fully scriptable, so you can show
any TRUE/FALSE condition accessible or indicate an arbitrary value. It
supports blinking LEDs with priority levels and animations. The LEDs
not used function as normal.
.PP
.B Ledcontrol
works both in X and on a text console.
.PP
.B Ledcontrol
consists of the following pieces:
.TP
\fBledd\fR
The LED daemon.
.B ledd
must be running when the other programs are used. On startup, it
executes programs and/or scripts to tell it how to set the LEDs. It is
configured in \fIledd.conf\fR (see
.BR ledd (8)
and
.BR ledd.conf (5)).
.TP
\fBstartup.sh\fR
The default script to start on startup. It should not be executed by
the user. It is configured in \fIledcontrol.conf\fR (see
.BR startup.sh (8)
and
.BR ledcontrol.conf (5)).
.TP
\fBledcontrol\fR
A script that gives commands directly to ledd. Can be used from the
command line to set the LED states (documented in this file).
.TP
\fBgled\fR
A graphical front-end for ledcontrol made using GTK+. Useful for
testing commands and experimenting (see
.BR gled (1)).
.SH DESCRIPTION
.PP
.B ledcontrol
can be used to set the LED states of
.BR ledd (8)
from the command line or scripts. It searches the default (or given)
configuration file for \fBpipefile\fR parameters and chooses a
suitable pipe through which to give
.B ledd
the command.
The following options are accepted:
.TP
\fB\-h\fR, \fB\-\-help\fR
Show short help message.
.TP
\fB\-v\fR, \fB\-V\fR, \fB\-\-version\fR
Show version information.
.TP
\fB\-c\fR \fIFILE\fR, \fB\-\-config\fR \fIFILE\fR
Read configuration file \fIFILE\fR for \fBpipefile\fR
commands. Several files may be given by repeating the option. Disables
reading of default configuration file.
.TP
\fB\-p\fR \fIFILE\fR, \fB\-\-pipe\fR \fIFILE\fR
Add \fIFILE\fR to the list of pipes to choose from. Several pipes may
be given by repeating the option. Disables reading of default
configuration file.
.PP
For a description of COMMAND, consult
.BR ledd (8)
section
.BR COMMANDS .
.SH LICENSE
Ledcontrol and all its pieces (including the script \fBledcontrol\fR)
are distributed under the GNU General Public License (GPL).
.SH FILES
.TP
\fI@sysconfdir_int@/ledd.conf\fR
default configuration file for
.B ledd
.SH "SEE ALSO"
.BR ledd (8),
.BR ledd.conf (5),
.BR gled (1),
.BR startup.sh (8),
.BR ledcontrol.conf (5)
.SH AUTHOR
Ledcontrol was written by Sampo Niskanen <sampo.niskanen@iki.fi>. You
can get the latest version of ledcontrol from
.I http://www.iki.fi/sampo.niskanen/ledcontrol/
|