2014-08-18 22:56:18 +00:00
|
|
|
.TH WMACPI 1 "April 15 2004"
|
2014-08-18 22:56:10 +00:00
|
|
|
.SH NAME
|
2014-08-18 22:56:14 +00:00
|
|
|
wmacpi \- Battery status monitor for systems supporting ACPI
|
2014-08-18 22:56:10 +00:00
|
|
|
.SH NAME
|
2014-08-18 22:56:14 +00:00
|
|
|
acpi \- Query battery status for systems supporting ACPI
|
2014-08-18 22:56:10 +00:00
|
|
|
.SH SYNOPSIS
|
2014-08-18 22:56:14 +00:00
|
|
|
.B wmacpi
|
2014-08-18 22:56:10 +00:00
|
|
|
[
|
|
|
|
.RI -c
|
|
|
|
value ]
|
|
|
|
[
|
|
|
|
.RI -d
|
|
|
|
display ]
|
|
|
|
[
|
|
|
|
.RI -m
|
|
|
|
battery no ]
|
|
|
|
[
|
2014-08-18 22:56:12 +00:00
|
|
|
.RI -s
|
|
|
|
sample rate ]
|
|
|
|
[
|
2014-08-18 22:56:10 +00:00
|
|
|
.RI -v
|
|
|
|
]
|
2014-08-18 22:56:11 +00:00
|
|
|
]
|
|
|
|
.RI -n
|
|
|
|
]
|
2014-08-18 22:56:10 +00:00
|
|
|
[
|
2014-08-18 22:56:14 +00:00
|
|
|
.RI -w
|
|
|
|
]
|
|
|
|
[
|
|
|
|
.RI -a
|
|
|
|
samples ]
|
|
|
|
[
|
2014-08-18 22:56:10 +00:00
|
|
|
.RI -V
|
|
|
|
]
|
|
|
|
[
|
|
|
|
.RI -h
|
|
|
|
]
|
|
|
|
.PP
|
2014-08-18 22:56:14 +00:00
|
|
|
.B acpi
|
2014-08-18 22:56:10 +00:00
|
|
|
[
|
|
|
|
.RI -a
|
|
|
|
samples ]
|
|
|
|
[
|
|
|
|
.RI -v
|
|
|
|
]
|
|
|
|
[
|
|
|
|
.RI -V
|
|
|
|
]
|
2014-08-18 22:56:18 +00:00
|
|
|
]
|
|
|
|
.RI -b
|
|
|
|
]
|
|
|
|
[
|
|
|
|
.RI -r
|
|
|
|
]
|
2014-08-18 22:56:10 +00:00
|
|
|
[
|
|
|
|
.RI -h
|
|
|
|
]
|
|
|
|
.SH DESCRIPTION
|
|
|
|
This manual page documents briefly the
|
2014-08-18 22:56:14 +00:00
|
|
|
.B wmacpi
|
2014-08-18 22:56:10 +00:00
|
|
|
command.
|
|
|
|
.PP
|
2014-08-18 22:56:14 +00:00
|
|
|
.B wmacpi
|
2014-08-18 22:56:10 +00:00
|
|
|
is a program that displays the current battery status in a WindowMaker
|
|
|
|
dock app, on systems that support Intel's Advanced Configuration and
|
|
|
|
Power Interface specification (ACPI).
|
|
|
|
.PP
|
|
|
|
The program monitors a battery, displaying its current percentage
|
|
|
|
charge via a bar and a numeric value. It also displays the current
|
|
|
|
power status for the system, the time remaining (calculated based on
|
|
|
|
the remaining battery capacity and the current rate of power usage),
|
|
|
|
and a scrolling message with some hopefully useful information.
|
|
|
|
.PP
|
|
|
|
Clicking on the window cycles through the batteries that the ACPI
|
|
|
|
system knows about.
|
|
|
|
.PP
|
2014-08-18 22:56:14 +00:00
|
|
|
.B acpi
|
2014-08-18 22:56:10 +00:00
|
|
|
queries the battery status from the command line. It prints the power
|
|
|
|
status, the percentage remaining for each battery found, and the time
|
|
|
|
remaining if the system is on battery, or the time remaining for each
|
|
|
|
battery to reach full charge if the batteries are charging.
|
|
|
|
.SH OPTIONS
|
2014-08-18 22:56:14 +00:00
|
|
|
.B wmacpi
|
2014-08-18 22:56:10 +00:00
|
|
|
.TP
|
2014-08-18 22:56:12 +00:00
|
|
|
.B \-c percentage
|
2014-08-18 22:56:10 +00:00
|
|
|
Set critical low alarm at <value>% (default: 10%).
|
|
|
|
.TP
|
2014-08-18 22:56:12 +00:00
|
|
|
.B \-d display
|
2014-08-18 22:56:10 +00:00
|
|
|
Set the X display to open the window on.
|
|
|
|
.TP
|
2014-08-18 22:56:12 +00:00
|
|
|
.B \-m battery number
|
2014-08-18 22:56:10 +00:00
|
|
|
Set the battery to monitor initially.
|
|
|
|
.TP
|
2014-08-18 22:56:12 +00:00
|
|
|
.B \-s sample rate
|
2014-08-18 22:56:19 +00:00
|
|
|
Set the rate at which to sample the ACPI data, in number of times per
|
|
|
|
minute. Minimum is 1, ie once a minute, default is 20, maximum is 600.
|
2014-08-18 22:56:12 +00:00
|
|
|
.TP
|
2014-08-18 22:56:11 +00:00
|
|
|
.B \-n
|
|
|
|
Disable blinking power glyph when charging. Note that it still blinks when
|
|
|
|
the battery reports its capacity state as critical.
|
2014-08-18 22:56:12 +00:00
|
|
|
.TP
|
2014-08-18 22:56:14 +00:00
|
|
|
.B \-w
|
|
|
|
Run wmacpi in command line mode - this operates identically to
|
|
|
|
.B acpi
|
|
|
|
..
|
|
|
|
.TP
|
|
|
|
.B \-a num
|
|
|
|
Average the time remaining over num samples. This greatly improves the
|
|
|
|
accuracy of the reported time remaining.
|
|
|
|
.TP
|
2014-08-18 22:56:10 +00:00
|
|
|
.B \-v
|
|
|
|
Increase the verbosity of the program. Can be used more than once -
|
|
|
|
each successive use increases the verbosity.
|
|
|
|
.TP
|
|
|
|
.B \-V
|
|
|
|
Print the version information.
|
|
|
|
.TP
|
2014-08-18 22:56:18 +00:00
|
|
|
.B \-b
|
2014-08-18 22:56:19 +00:00
|
|
|
Enable blinking of the power glyph when charging the batteries.
|
2014-08-18 22:56:18 +00:00
|
|
|
.TP
|
|
|
|
.B \-r
|
|
|
|
Disable scrolling message.
|
|
|
|
.TP
|
2014-08-18 22:56:10 +00:00
|
|
|
.B \-h
|
|
|
|
Display help.
|
|
|
|
.TP
|
2014-08-18 22:56:14 +00:00
|
|
|
.B acpi
|
2014-08-18 22:56:10 +00:00
|
|
|
.TP
|
|
|
|
.B \-a num
|
|
|
|
Average the time remaining over num samples. This greatly improves the
|
|
|
|
accuracy of the reported time remaining.
|
|
|
|
.TP
|
|
|
|
.B \-v
|
|
|
|
Increase the verbosity of the program, as for
|
2014-08-18 22:56:14 +00:00
|
|
|
.B wmacpi
|
2014-08-18 22:56:10 +00:00
|
|
|
.TP
|
|
|
|
.B \-V
|
|
|
|
Print the version information.
|
|
|
|
.TP
|
|
|
|
.B \-h
|
|
|
|
Display help.
|
|
|
|
.TP
|
|
|
|
.SH SEE ALSO
|
|
|
|
.BR wmapm (1)
|
|
|
|
.br
|
|
|
|
.SH AUTHOR
|
|
|
|
.B wmacpi
|
2014-08-18 22:56:14 +00:00
|
|
|
was originally written by Tim Copperfield <timecop@japan.co.jp>, then
|
|
|
|
completely rewritten after 1.34 by Simon Fowler <simon@dreamcraft.com.au>.
|
2014-08-18 22:56:10 +00:00
|
|
|
.PP
|
|
|
|
This manual page was originally written by Simon Richter
|
2014-08-18 22:56:14 +00:00
|
|
|
<sjr@debian.org> for the Debian GNU/Linux system, and then updated by
|
|
|
|
Simon Fowler.
|
2014-08-18 22:56:10 +00:00
|
|
|
.br
|
2014-08-18 22:56:18 +00:00
|
|
|
Last modification by Simon Fowler <simon@dreamcraft.com.au>, 2004-04-15.
|