1ACPITOOL(1) User Commands ACPITOOL(1)
2
6 acpitool - a Linux ACPI client, allowing you to query or set ACPI val‐
7 ues
8
10 acpitool [ -aAbBcefFhjlmnosStTvVwWz ]
11
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 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 Acpitool also allows the machine to be put into standby, if your laptop
23 supports it.
24 If your laptop is a Toshiba , it allows you to set the LCD brightness
26 level and toggle the fan on/off.
27 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 If you have an IBM Thinkpad laptop, it can once again set the LCD
33 brightness level, and also eject the ultrabay device.
34
37 -a, --ac_adapter
38 Show AC adapter presence
39 -A Show supported Asus ACPI extensions (LCD brightness level, video
41 out routing DSDT/acpi4asus info)
42 -b Show battery status information, available batteries only.
44 -B, --battery
46 Show detailed battery status information, for all battery
47 entries found.
48 -c, --cpu
50 Show CPU information (type, speed, PM capabilities, throttling
51 states, c-state usage, frequency scaling).
52 -e Show just about everything : more info on the batteries, ACPI
54 version, kernel version, CPU, . . .
55 -f, --fan
57 Show fan status (shows fan info specific to Toshiba or IBM
58 Thinkpad, if applicable).
59 -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 -h, --help
66 Show help text.
67 -j Eject Thinkpad ultrabay device. Requires write acces to
69 /proc/acpi/ibm/bay
70 -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 -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 -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 -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 -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 -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 -t, --thermal
97 Show thermal zone(s) information, including trip_points.
98 -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 -v Show more verbose output when something is not found. Makes
105 sense only when used together with other options.
106 -V, --version
108 Show acpitool version number and release date, then exit.
109 -w Show the wakeup capable devices. (Available since ACPI 20040715,
111 check your version).
112 -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 -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
120 This program absolutely requires a Linux kernel with ACPI support
121 enabled. This program will not work without it.
122 IBM Thinkpad support is part of the Linux kernel since kernel 2.6.10.
124 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 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 Also note that older laptops (< 2000) often simply don't have ACPI sup‐
137 port, they usually support APM only.
138
140 Let me know if you think you found one.
141
143 /proc/acpi/...
144 /proc/acpi/toshiba
145 /proc/acpi/asus
146 /proc/acpi/ibm
147 /sys/power/state
148
150 http://freeunix.dyndns.org:8000/site2/acpitool.shtml
151
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.
157AcpiTool 0.5 24 Jul 2008 ACPITOOL(1)