df54026a62
Source obtained from http://sourceforge.net/projects/wmacpi/files/. 2003 September 23 0.92 Fix a few more bugs, and include an option to allow the user to specify how often to sample the ACPI data - some BIOSes disable all interrupts while reading from the battery, which apparently causes some interactivity issues. I have no idea why reading once every three seconds (which is our default), but there've been some complaints.
141 lines
2.9 KiB
Groff
141 lines
2.9 KiB
Groff
.TH WMACPI-NG 1 "July 11, 2003"
|
|
.SH NAME
|
|
wmacpi-ng \- Battery status monitor for systems supporting ACPI
|
|
.SH NAME
|
|
acpi-ng \- Query battery status for systems supporting ACPI
|
|
.SH SYNOPSIS
|
|
.B wmacpi-ng
|
|
[
|
|
.RI -b
|
|
]
|
|
[
|
|
.RI -c
|
|
value ]
|
|
[
|
|
.RI -d
|
|
display ]
|
|
[
|
|
.RI -m
|
|
battery no ]
|
|
[
|
|
.RI -s
|
|
sample rate ]
|
|
[
|
|
.RI -v
|
|
]
|
|
]
|
|
.RI -n
|
|
]
|
|
[
|
|
.RI -V
|
|
]
|
|
[
|
|
.RI -h
|
|
]
|
|
.PP
|
|
.B acpi-ng
|
|
[
|
|
.RI -a
|
|
samples ]
|
|
[
|
|
.RI -v
|
|
]
|
|
[
|
|
.RI -V
|
|
]
|
|
[
|
|
.RI -h
|
|
]
|
|
.SH DESCRIPTION
|
|
This manual page documents briefly the
|
|
.B wmacpi-ng
|
|
command.
|
|
.PP
|
|
.B wmacpi-ng
|
|
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
|
|
.B acpi-ng
|
|
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
|
|
.B wmacpi-ng
|
|
.TP
|
|
.B \-b
|
|
Make noise when battery is critical low (beep).
|
|
.TP
|
|
.B \-c percentage
|
|
Set critical low alarm at <value>% (default: 10%).
|
|
.TP
|
|
.B \-d display
|
|
Set the X display to open the window on.
|
|
.TP
|
|
.B \-m battery number
|
|
Set the battery to monitor initially.
|
|
.TP
|
|
.B \-s sample rate
|
|
Set the rate at which to sample the ACPI data (default is 100, which
|
|
translates to once every three seconds. 10 gives once every 30 seconds,
|
|
1 once every 300 seconds (five minutes), 1000 once every 0.3 seconds).
|
|
.TP
|
|
.B \-n
|
|
Disable blinking power glyph when charging. Note that it still blinks when
|
|
the battery reports its capacity state as critical.
|
|
.TP
|
|
.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
|
|
.B \-h
|
|
Display help.
|
|
.TP
|
|
.B acpi-ng
|
|
.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
|
|
.B wmacpi-ng
|
|
.TP
|
|
.B \-V
|
|
Print the version information.
|
|
.TP
|
|
.B \-h
|
|
Display help.
|
|
.TP
|
|
.SH SEE ALSO
|
|
.BR wmapm (1)
|
|
.br
|
|
.SH AUTHOR
|
|
.B wmacpi
|
|
as written by Tim Copperfield <timecop@japan.co.jp>.
|
|
.B wmacpi-ng
|
|
is a reworking of
|
|
.B wmacpi 1.34
|
|
to support recent kernel versions, performed by Simon Fowler
|
|
<simon@dreamcraft.com.au>.
|
|
.PP
|
|
This manual page was originally written by Simon Richter
|
|
<sjr@debian.org> for the Debian GNU/Linux system, and then updated for
|
|
.B wmacpi-ng
|
|
by Simon Fowler.
|
|
.br
|
|
Last modification by Simon Fowler <simon@dreamcraft.com.au>, 2003-07-11.
|