powersave
provides a command line interface to various power saving related
functionalities of your machine.
Powersave supports APM, ACPI and cpu-frequency scaling (speedstep, powernow, ...) features as well as
some ide disk power saving functionalities.
Take care that the appropriate modules for the features you want to use are loaded or compiled
into the kernel.
Some options may work correctly only with the latest kernels.
Some options are quite hardware dependent and you should be able to test their support
by using this tool.
Some information is only available if the powersave daemon is running.
Once you started the daemon you should only use the powersave daemon depending functions
or functions which just provide information about the system.
OPTIONS THAT NEED A RUNNING HAL DAEMON
--suspend-to-disk -U
Sends a hibernate (suspend to disk) request to HAL
--suspend-to-ram -u
Sends a suspend (suspend to ram) request to HAL
Sets the machine into suspend (APM) or S3/"Suspend to RAM" (ACPI) mode
--standby -m
Sends a standby request to HAL
--performance-speed -f
Makes the daemon to set the machine fixed to the the highest supported frequency.
This option needs your hardware to support CPU frequency scaling (SpeedStep/PowerNow).
--powersave-speed -l
Makes the daemon to set the machine fixed to the lowest supported frequency.
--dynamic-speed -A
Makes the daemon to adjust the frequency of your machine dynamically.
This is always a good solution (for battery and AC plugged in).
It saves a lot of power and reduces the noise of your fan (if controlled).
You should not recognise any loss of performance.
--set-dynamic-performance -g <x>
Set a value between 1 and 100 that specifies how sensible the dynamic CPUFreq
algorithm should be. The higher the value, the faster and the more often
the frequency is increased. Default is 50.
--get-dynamic-performance -G
Get the current performance value for the dynamic CPUFreq algorithm.
--cpufreq-state-info -c
Get the currently used CPUFreq policy.
get-brightness -K
Get the current brightness level of the display if supported. This works
at the moment with many toshiba, sony and asus notebooks.
get-brightness-levels -L
Get number of supported brightness levels.
set-brightness -k
Set the current brightness level. Get abailable brightness levels with -L
or give character 'u' for "brightness up" or character 'd' for "brightness
down"
OPTIONS THAT NEED ACPI WORKING AND THE APPROPRIATE KERNEL MODULES LOADED
--set-throttling-percent -p
Evaluates how much throttling states your machine supports and
sets the appropriate state according to your value.
Please specify the value in percent you want to throttle the CPU.
A value of 0 means no throttling, maximum CPU power.
Avoid values higher than 80%, because this could easily freeze your machine!
You need superuser rights for this option.
This funtion throttles all CPUs of your machine.
--get-throttling-info -t
Prints out the current and available throttling state of each
CPU in the system.
--apm-acpi -S
Evaluates whether your system supports APM or ACPI.
--battery-info -b
Prints out remaining battery capacity in percent and
remaining lifetime of battery. Remaining lifetime should
only give sensible values when working on battery power source.
It may happen that the remaining life time cannot be read
immediately after switching to battery power, try it again
after some seconds.
Depending whether your BIOS is buggy remaining lifetime
or even remaining percent can not be calculated.
Multiple batteries will be sumerized to a total.
--extended-battery-info -B
Prints out remaining battery capacity in percent and
remaining lifetime for each battery. This only works if
your system supports ACPI
ac-status-info -a
Evaluate whether AC adapter is plugged in or if you are
currently working on battery power.
get-thermal-info -T
iterates available thermal devices and prints current
temperature and defined trippoints
get-fan-info -F
detects which fan is on/off
OPTIONS THAT NEED A RUNNING POWERSAVE DAEMON
list-schemes -x
List all power schemes. Also shows which one is the current active one
and which are activated if power source changes to AC or battery power.
Configuration files for schemes are by default
located in /etc/powersave/scheme_*. A scheme
changes the power save policy of the powersave daemon. Changing the
power source (AC/Battery) normally switches the power policy/scheme. Use -e option
to switch between schemes manually.
get-scheme-description -X
Show the description of a scheme.
set-active-scheme -e
See above. Use -x to list all schemes you can switch to.
--cpu-enable -E <x>
Enables a single CPU. CPUs start from 0, but 0 can't be disabled because
it runs the main timer.
--cpu-disable -D <x>
Disables a single CPU. CPUs start from 0, but 0 can't be disabled because
it runs the main timer.
GENERAL OPTIONS - NEED NO KERNEL MODULS OR A RUNNING POWERSAVE DAEMON
--verbose -v
Set the debug level, allowed values: 0-31
Depending on how the binary was compiled
the output is written to stdout/stderr or directly
forwarded to the syslog daemon (default) or totally discarded.
So you normally should check /var/log/messages to check for
errors
1 Error
2 Warning
4 Diag
8 Info
16 Debug
e.g. Error + Warning: 1 + 2 -> 3
--version -V
prints the current compiled version of the package
RETURN VALUES
All options return 0 on success and any other value on failure.
Except:
--apm-acpi -S returns -1 if it fails, 2 for an APM machine and 1 for ACPI support!
--ac-status-info -a returns -1 if it fails, 2 for on AC and 1 for on battery power!
--cpufreq-state -c returns 1 if system is in maximum frequency (performance) mode,
2 if system is in minimum frequency (powersave) mode and 3 if frequency is adjusted
depending on CPU usage (dynamic mode)
This might change when using multiple options at once (see next).
MULTIPLE OPTIONS
Several parameters can be passed at once.
The order of the output of each parameter complies to the order as
listed above.
If an error occurs, the return value will be EXIT_FAILURE(1),
or lower than zero.
If no error occured the return value will 0.
If a parameter with a special return value (see above) is used zero will be overridden
with the meaning described above.
If several parameters with a special return value are passed, the last listed parameter with
a special return value will represent the return value.
BUGS
calculating frequency could be wrong if processor is in higher power save (C-)states
(C3 and above normally). This is normal.