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 entries and
       presents the output in a meaningfull, 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 brighness
       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     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     Show  detailed  battery  status  information,  for  all  battery
              entries found.

       -c     Show  CPU  information (type, speed, PM capabilities, throttling
              states).

       -e     Show just about everything : more info on  the  batteries,  ACPI
              version, kernel version, CPU, . . .

       -f     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     Show help text.

       -j     Eject   Thinkpad  ultrabay  device.   Requires  write  acces  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/tochiba/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     Show thermal zone(s) information, including trip_points.

       -T     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     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 support APM only, which may however sometimes  work  even
       better than ACPI . . .

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| tiscali |dot| be) and may be freely distributed under the terms of
       the  GNU  General  Public License.  There is ABSOLUTELY NO WARRANTY for
       this program.