1ACPITOOL(1)                      User Commands                     ACPITOOL(1)
2
3
4

NAME

6       acpitool  - a Linux ACPI client, allowing you to query or set ACPI val‐
7       ues
8

SYNOPSIS

10       acpitool [ -aAbBcefFhjlmnosStTvVwWz ]
11

DESCRIPTION

13       acpitool is  a  Linux  ACPI  client.  It  simply  reads  /proc/acpi  or
14       /sys/class entries and presents the output in a meaningful, human-read‐
15       able format.
16
17       It provides a.o. information on battery status,  AC  adapter  presence,
18       thermal  reading,  etc.  This command is most useful on laptops with an
19       ACPI compliant BIOS and a Linux kernel, preferably from the 2.6 series,
20       with ACPI enabled.
21
22       Acpitool also allows the machine to be put into standby, if your laptop
23       supports it.
24
25       If your laptop is a Toshiba , it allows you to set the  LCD  brightness
26       level and toggle the fan on/off.
27
28       If  you  have an Asus laptop, it can also set the LCD brightness level,
29       switch the LCD panel on or off, and control the mail led  and  wireless
30       led.
31
32       If  you  have  an  IBM  Thinkpad  laptop, it can once again set the LCD
33       brightness level, and also eject the ultrabay device.
34
35

OPTIONS

37       -a, --ac_adapter
38              Show AC adapter presence
39
40       -A     Show supported Asus ACPI extensions (LCD brightness level, video
41              out routing DSDT/acpi4asus info)
42
43       -b     Show battery status information, available batteries only.
44
45       -B, --battery
46              Show  detailed  battery  status  information,  for  all  battery
47              entries found.
48
49       -c, --cpu
50              Show CPU information (type, speed, PM  capabilities,  throttling
51              states, c-state usage, frequency scaling).
52
53       -e     Show  just  about  everything : more info on the batteries, ACPI
54              version, kernel version, CPU, . . .
55
56       -f, --fan
57              Show fan status (shows fan  info  specific  to  Toshiba  or  IBM
58              Thinkpad, if applicable).
59
60       -F x   Force  the fan on (x=1) or switch back to auto mode (x=0). Works
61              only on Toshiba laptops.  The fan is switched off ONLY if it was
62              forced  on  first,  not  if  it  was  switched on automatically.
63              Requires write access to /proc/acpi/toshiba/fan
64
65       -h, --help
66              Show help text.
67
68       -j     Eject  Thinkpad  ultrabay  device.   Requires  write  acces   to
69              /proc/acpi/ibm/bay
70
71       -l x   Set  LCD  brightness  level  to x, where x is in the range 0..7.
72              Works only on Toshiba and IBM Thinkpad laptops.  Requires  write
73              access to /proc/acpi/toshiba/lcd or /proc/acpi/ibm/brightness
74              Illegal  values  for  x  will  result  in the value being set to
75              either 0 or 7.
76
77       -m x   Switch the mail led on (x=1) or off (x=0). Works  only  on  Asus
78              laptops.  Requires write access to /proc/acpi/asus/mled
79
80       -n x   Switch  the  wireless  led  on (x=1) or off (x=0). Works only on
81              Asus laptops.  Requires write access to /proc/acpi/asus/wled
82
83       -o x   Switch the LCD panel on (x=1) or off (x=0). Works only  on  Asus
84              laptops.  Requires write access to /proc/acpi/asus/lcd
85
86       -s, --suspend to memory
87              Put  the  machine  into  sleep  state S3, if possible.  Requires
88              write   access   to   /proc/acpi/sleep   (kernel    2.4.x)    or
89              /sys/power/state (kernel 2.6.x)
90
91       -S, --suspend to disk ?
92              Put  the  machine  into  sleep  state S4, if possible.  Requires
93              write   access   to   /proc/acpi/sleep   (kernel    2.4.x)    or
94              /sys/power/state (kernel 2.6.x)
95
96       -t, --thermal
97              Show thermal zone(s) information, including trip_points.
98
99       -T, --Toshiba
100              Show  supported  Toshiba  ACPI  extensions,  currently being LCD
101              brightness level, video out routing (what display is  the  video
102              chip sending to) and fan status (on/off, forced or not).
103
104       -v     Show  more  verbose  output  when  something is not found. Makes
105              sense only when used together with other options.
106
107       -V, --version
108              Show acpitool version number and release date, then exit.
109
110       -w     Show the wakeup capable devices. (Available since ACPI 20040715,
111              check your version).
112
113       -W x   Enable/disable wakeup capable device x. Run 'acpitool -w' to see
114              valid numbers for x.  Requires write access to /proc/acpi/wakeup
115
116       -z x   Set Asus LCD brightness level to x, where x is 0..15. Works only
117              on Asus laptops.  Requires write access to /proc/acpi/asus/brn
118

REMARKS

120       This  program  absolutely  requires  a  Linux  kernel with ACPI support
121       enabled. This program will not work without it.
122
123       IBM Thinkpad support is part of the Linux kernel since kernel 2.6.10.
124
125       Don't blame me if acpitool can't suspend your laptop : there are  quite
126       some problematic laptops out there. Check the acpi-bugzilla list if you
127       don't believe me ;)
128
129       Note that some options, like -F, -l , -j, -s, -W  and -z, require write
130       access to some of the /proc/acpi entries. This requires acpitool either
131       to be run as root or either administrative measures must be taken, most
132       likely by root, to allow ordinary users to write to these files. Creat‐
133       ing a group for ACPI users and setting permissions accordingly comes to
134       mind.
135
136       Also note that older laptops (< 2000) often simply don't have ACPI sup‐
137       port, they usually support APM only.
138

BUGS

140       Let me know if you think you found one.
141

FILES

143       /proc/acpi/...
144       /proc/acpi/toshiba
145       /proc/acpi/asus
146       /proc/acpi/ibm
147       /sys/power/state
148

HOMEPAGE

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

AUTHOR

153       This program is written and maintained by David  Leemans  (davidleemans
154       |at| scarlet |dot| be) and may be freely distributed under the terms of
155       the GNU General Public License.  There is ABSOLUTELY  NO  WARRANTY  for
156       this program.
157
158
159
160AcpiTool 0.5                      24 Jul 2008                      ACPITOOL(1)
Impressum