NAME

       acpitool - a Linux ACPI client, allowing you to query or set ACPI values

SYNOPSIS

       acpitool [ -aAbBcefFhjlmnosStTvVwWz ]

DESCRIPTION

       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.

OPTIONS

       -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

REMARKS

       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.

BUGS

       Let me know if you think you found one.

FILES

       /proc/acpi/...
       /proc/acpi/toshiba
       /proc/acpi/asus
       /proc/acpi/ibm
       /sys/power/state

HOMEPAGE

       http://freeunix.dyndns.org:8000/site2/acpitool.shtml

AUTHOR

       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.

AcpiTool 0.5                                       24 Jul 2008                                       ACPITOOL(1)