File: i8kbuttons.1

package info (click to toggle)
i8kutils 1.27
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k, lenny
  • size: 236 kB
  • ctags: 167
  • sloc: ansic: 1,212; sh: 778; makefile: 157
file content (76 lines) | stat: -rw-r--r-- 3,005 bytes parent folder | download | duplicates (2)
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
.TH i8kbuttons 1 "20 August 2002" "Massimo Dal Zotto" Utilities
.SH "NAME"
.LP 
I8kbuttons \- Monitor the status of Fn\-buttons on Dell Inspiron laptops.
.SH "SYNTAX"
.LP 
i8kbuttons [\fI<options>\fP]
.SH "DESCRIPTION"
.LP 
The i8kbuttons daemon monitors the status of the two volume buttons
of the Inspiron 8000 and the corresponding Fn\- combinations.
.LP 
When a button is pressed the daemon runs the corresponding command
specified in the command\-line options. By specifying the proper
commnds it is then possible to control the volume of the sound mixer
or run any other command you like.
.LP 
It must be noted that although the program has default commands for the
various buttons there are no standard mixer command shipped with the many
Linux distributions which can change volume incrementally and support
the mute/restore function.
The default commands must therefore be overriden with specific commands
depending on which mixer software is installed. Example:
.IP
i8kbuttons -u "aumix -v +10" -d "aumix -v -10" -m "aumix -v 0" -r 100 -v
.SH "OPTIONS"
.LP 
The program accepts the following command\-line options:
.LP 
.TP 
\fB\-v\fR, \fB\-\-verbose\fR
Verbose mode, show all commands executed.
.TP 
\fB\-u\fR, \fB\-\-up\fR <\fIcommand\fP>
Specifies the command to be executed when the VolumeUp button is pressed.
.TP 
\fB\-d\fR, \fB\-\-down\fR <\fIcommand\fP>
Specifies the command to be executed when the VolumeDown button is pressed.
.TP 
\fB\-m\fR, \fB\-\-mute\fR <\fIcommand\fP>
Specifies the command to be executed when the VolumeOn/Off button is pressed.
.TP 
\fB\-t\fR, \fB\-\-timeout\fR <\fImilliseconds\fP>
Specifies the interval in milliseconds at which the daemon checks the
button status. Useful values are in the range 50\-200. Default is 100.
.TP 
\fB\-r\fR, \fB\-\-repeat\fR <\fImilliseconds\fP>
Specifies the autorepeat interval in milliseconds. Useful values are in the
range 100\-1000. Default is 0, i.e. no autorepeat. Autorepeat starts after
an initial delay of 250 milliseconds. 
.LP 
This program can be used by normal users or started as daemon by an init
script. Under Debian GNU/Linux it is possible to start automatically the
daemon at boot by creating an /etc/i8kbuttons configfile and setting the
I8KBUTTONS_UP_CMD, I8KBUTTONS_DOWN_CMD and I8KBUTTONS_MUTE_CMD variables
with the command which must be executed by the program. Note the the
/etc/i8kbuttons configfile is not installed by the i8kutils package because
the program is usually run by normal users. If you want to use it as daemon
you must create the config file yourself.
.SH "FILES"
.LP 
\fI/proc/i8k\fP
.br 
\fI/etc/i8kbuttons\fP
.SH "AUTHORS"
.LP 
Massimo Dal Zotto <dz@debian.org>
.SH "COPYRIGHT"
.LP 
i8kbuttons and all the i8kutils programs, scripts and other files are
distributed under the GNU General Public License (GPL).
On Debian GNU/Linux systems, the complete text of the GNU General
Public License can be found in `/usr/share/common-licenses/GPL'.
.SH "SEE ALSO"
.LP 
i8kctl(1), i8kmon(1)