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


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].


utils
-----

"cpufreq-info" determines current cpufreq settings, and provides useful
debug information to users and bug-hunters.
"cpufreq-set" allows to set a specific frequency and/or new cpufreq policies
without having to type "/sys/devices/system/cpu/cpu0/cpufreq" all the time.


debug
-----

A few debug tools helpful for cpufreq have been merged into this package,
but as they are highly architecture specific they are not built by default.


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

./configure && make
su
make install

should suffice on most systems. It builds default libcpufreq,
cpufreq-set and cpufreq-info files and installs them in /usr/local/lib and
/usr/local/bin, respectively. Due to the autotoolization by Mattia Dongili
the standard options to make and make install, like "--prefix=/usr", can be
passed and (should) work correctly.


options and dependencies
------------------------

./configure by default enables the sysfs interface, but disables the

deprecated /proc interface to the cpufreq core in the Linux kernel. For
the sysfs interface to build and work correctly, you need "libsysfs", which
is part of the "sysfsutils" package. Current requirement is
        sysfsutils-1.0.0
or later.

To disable the sysfs interface, pass the option "--disable-sysfs" to
./configure.


To enable the (deprecated) /proc interface support, pass the option
"--enable-proc" to ./configure.


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
