README for bbcpufreq -- cpufreqd gui-frontend for blackbox window manager.

Requirements: To compile and run bbcpufreq you need following libraries: - libcpufreq: http://www.kernel.org/pub/linux/utils/kernel/cpufreq/cpufrequtils.html libcpufreq depends on libsysfs - libsysfs: http://linux-diag.sourceforge.net/Sysfsutils.html - libgtk2: www.gtk.org

Compilation & Instalation:

Type 'make' to compile bbcpufreq. Type 'make install' (as root) to install bbcpufreq to default install directory (/usr/local/bin).

Running bbcpufreq:

To do anything useful with bbcpufreq you'll need 2 things: 1) Setup cpufreqd to use unix socket for local communication -- in [General] section of /etc/cpufreqd.conf set line:
enable_remote=1

2) You also have to be able to read cpufreqd socket. One way is to run bbcpufreq with with root's privileges. If you use sudo, you can just put following line to /etc/sudoers:

username ALL = NOPASSWD: path/to/bbcpufreq

Another way is to set group ownership for cpufreqd socket. In [General] section of /etc/cpufreqd.conf set line:

remote_group = user_group

Don't forget to replace user_group with desired value. This way you don't need root's privileges at all.

Using bbcpufreq is simple -- just click on the program icon to bring up program menu. The menu lets you select power profile (as defined in cpufreqd conf. file) and/or tell cpufreqd to go dynamic (cpufreqd decides about power policy) or to go manual (user is able to select power profile).

Licensing & Copying:

bbcpufreq is licensed under the GNU General Public License (GPL) Version2, June 1991. See file COPYING for full text of GPL.

Reporting bugs:

You may report bugs, if you care. Writing an email to the author <xzazriv@fi.muni.cz> is a good way. All contributions are welcome.

Credits & Thanks:

Josh King <jking@dwave.net>, author of bbrun, for inspiration.
Martijn Pieterse (pieterse@xs4all.nl), xpm_to_xbm is just modifications of his original work (wmppp).
Dominik Brodowski <linux@brodo.de> & Mattia Dongili <malattia@gmail.com>, Hrvoje Zeba <hrvoje@boo.mi2.hr> authors of cpufreqd and cpufrequtils. get_cpus(), system_info() and find_socket() are based on their work.

Happy end:

If you find this program completely useless, you are most likely right.