linux/tools/power/cpupower
Dominik Brodowski 7fe2f6399a cpupowerutils - cpufrequtils extended with quite some features
CPU power consumption vs performance tuning is no longer
limited to CPU frequency switching anymore: deep sleep states,
traditional dynamic frequency scaling and hidden turbo/boost
frequencies are tied close together and depend on each other.
The first two exist on different architectures like PPC, Itanium and
ARM, the latter (so far) only on X86. On X86 the APU (CPU+GPU) will
only run most efficiently if CPU and GPU has proper power management
in place.

Users and Developers want to have *one* tool to get an overview what
their system supports and to monitor and debug CPU power management
in detail. The tool should compile and work on as many architectures
as possible.

Once this tool stabilizes a bit, it is intended to replace the
Intel-specific tools in tools/power/x86

Signed-off-by: Dominik Brodowski <linux@dominikbrodowski.net>
2011-07-29 18:35:36 +02:00
..
bench cpupowerutils - cpufrequtils extended with quite some features 2011-07-29 18:35:36 +02:00
build cpupowerutils - cpufrequtils extended with quite some features 2011-07-29 18:35:36 +02:00
debug cpupowerutils - cpufrequtils extended with quite some features 2011-07-29 18:35:36 +02:00
lib cpupowerutils - cpufrequtils extended with quite some features 2011-07-29 18:35:36 +02:00
man cpupowerutils - cpufrequtils extended with quite some features 2011-07-29 18:35:36 +02:00
po cpupowerutils - cpufrequtils extended with quite some features 2011-07-29 18:35:36 +02:00
utils cpupowerutils - cpufrequtils extended with quite some features 2011-07-29 18:35:36 +02:00
.gitignore cpupowerutils - cpufrequtils extended with quite some features 2011-07-29 18:35:36 +02:00
AUTHORS cpupowerutils - cpufrequtils extended with quite some features 2011-07-29 18:35:36 +02:00
COPYING cpupowerutils - cpufrequtils extended with quite some features 2011-07-29 18:35:36 +02:00
Makefile cpupowerutils - cpufrequtils extended with quite some features 2011-07-29 18:35:36 +02:00
README cpupowerutils - cpufrequtils extended with quite some features 2011-07-29 18:35:36 +02:00
ToDo cpupowerutils - cpufrequtils extended with quite some features 2011-07-29 18:35:36 +02:00

The cpufrequtils package (homepage: 
http://www.kernel.org/pub/linux/utils/kernel/cpufreq/cpufrequtils.html ) 
consists of the following elements:

requirements
------------

On x86 pciutils is needed at runtime (-lpci).
For compilation pciutils-devel (pci/pci.h) and a gcc version
providing cpuid.h is needed.
For both it's not explicitly checked for (yet).


libcpufreq
----------

"libcpufreq" is a library which offers a unified access method for userspace
tools and programs to the cpufreq core and drivers in the Linux kernel. This
allows for code reduction in userspace tools, a clean implementation of
the interaction to the cpufreq core, and support for both the sysfs and proc
interfaces [depending on configuration, see below].


compilation and installation
----------------------------

make
su
make install

should suffice on most systems. It builds default libcpufreq,
cpufreq-set and cpufreq-info files and installs them in /usr/lib and
/usr/bin, respectively. If you want to set up the paths differently and/or
want to configure the package to your specific needs, you need to open
"Makefile" with an editor of your choice and edit the block marked
CONFIGURATION.


THANKS
------
Many thanks to Mattia Dongili who wrote the autotoolization and
libtoolization, the manpages and the italian language file for cpufrequtils;
to Dave Jones for his feedback and his dump_psb tool; to Bruno Ducrot for his
powernow-k8-decode and intel_gsic tools as well as the french language file;
and to various others commenting on the previous (pre-)releases of 
cpufrequtils.


        Dominik Brodowski