acpitool - a Linux ACPI client, allowing you to query or set ACPI values
acpitool [ -aAbBcefFhjlmnosStTvVwWz ]
acpitool is a Linux ACPI client. It simply reads
/proc/acpi or
/sys/class entries and presents the output in a meaningful,
human-readable format.
It provides a.o. information on battery status, AC adapter presence, thermal
reading, etc. This command is most useful on laptops with an ACPI compliant
BIOS and a Linux kernel, preferably from the 2.6 series, with ACPI enabled.
Acpitool also allows the machine to be put into standby, if your laptop
supports it.
If your laptop is a
Toshiba , it allows you to set the LCD brightness
level and toggle the fan on/off.
If you have an
Asus laptop, it can also set the LCD brightness level,
switch the LCD panel on or off, and control the mail led and wireless led.
If you have an
IBM Thinkpad laptop, it can once again set the LCD
brightness level, and also eject the ultrabay device.
- -a, --ac_adapter
- Show AC adapter presence
- -A
- Show supported Asus ACPI extensions (LCD brightness level,
video out routing DSDT/acpi4asus info)
- -b
- Show battery status information, available batteries
only.
- -B, --battery
- Show detailed battery status information, for all battery
entries found.
- -c, --cpu
- Show CPU information (type, speed, PM capabilities,
throttling states, c-state usage, frequency scaling).
- -e
- Show just about everything : more info on the batteries,
ACPI version, kernel version, CPU, . . .
- -f, --fan
- Show fan status (shows fan info specific to Toshiba or IBM
Thinkpad, if applicable).
- -F x
- Force the fan on (x=1) or switch back to auto mode (x=0).
Works only on Toshiba laptops. The fan is switched off ONLY if it was
forced on first, not if it was switched on automatically. Requires write
access to /proc/acpi/toshiba/fan
- -h, --help
- Show help text.
- -j
- Eject Thinkpad ultrabay device. Requires write access to
/proc/acpi/ibm/bay
- -l x
- Set LCD brightness level to x, where x is in the range
0..7. Works only on Toshiba and IBM Thinkpad laptops. Requires write
access to /proc/acpi/toshiba/lcd or
/proc/acpi/ibm/brightness
Illegal values for x will result in the value being set to either 0 or
7.
- -m x
- Switch the mail led on (x=1) or off (x=0). Works only on
Asus laptops. Requires write access to /proc/acpi/asus/mled
- -n x
- Switch the wireless led on (x=1) or off (x=0). Works only
on Asus laptops. Requires write access to /proc/acpi/asus/wled
- -o x
- Switch the LCD panel on (x=1) or off (x=0). Works only on
Asus laptops. Requires write access to /proc/acpi/asus/lcd
- -s, --suspend to memory
- Put the machine into sleep state S3, if possible. Requires
write access to /proc/acpi/sleep (kernel 2.4.x) or
/sys/power/state (kernel 2.6.x)
- -S, --suspend to disk ?
- Put the machine into sleep state S4, if possible. Requires
write access to /proc/acpi/sleep (kernel 2.4.x) or
/sys/power/state (kernel 2.6.x)
- -t, --thermal
- Show thermal zone(s) information, including
trip_points.
- -T, --Toshiba
- Show supported Toshiba ACPI extensions, currently being LCD
brightness level, video out routing (what display is the video chip
sending to) and fan status (on/off, forced or not).
- -v
- Show more verbose output when something is not found. Makes
sense only when used together with other options.
- -V, --version
- Show acpitool version number and release date, then
exit.
- -w
- Show the wakeup capable devices. (Available since ACPI
20040715, check your version).
- -W x
- Enable/disable wakeup capable device x. Run 'acpitool -w'
to see valid numbers for x. Requires write access to
/proc/acpi/wakeup
- -z x
- Set Asus LCD brightness level to x, where x is 0..15. Works
only on Asus laptops. Requires write access to
/proc/acpi/asus/brn
This program absolutely requires a Linux kernel with ACPI support enabled. This
program will not work without it.
IBM Thinkpad support is part of the Linux kernel since kernel 2.6.10.
Don't blame me if
acpitool can't suspend your laptop : there are quite
some problematic laptops out there. Check the acpi-bugzilla list if you don't
believe me ;)
Note that some options, like -F, -l , -j, -s, -W and -z, require write access to
some of the
/proc/acpi entries. This requires
acpitool either to
be run as
root or either administrative measures must be taken, most
likely by root, to allow ordinary users to write to these files. Creating a
group for ACPI users and setting permissions accordingly comes to mind.
Also note that older laptops (< 2000) often simply don't have ACPI support,
they usually support APM only.
Let me know if you think you found one.
/proc/acpi/...
/proc/acpi/toshiba
/proc/acpi/asus
/proc/acpi/ibm
/sys/power/state
http://freeunix.dyndns.org:8000/site2/acpitool.shtml
This program is written and maintained by David Leemans (davidleemans |at|
scarlet |dot| be) and may be freely distributed under the terms of the GNU
General Public License. There is ABSOLUTELY NO WARRANTY for this
program.