| 1 | This is a list of additional programs, that may or may not be installed by |
|---|
| 2 | `make install', and that can be found in the `prog' directory of |
|---|
| 3 | this package. |
|---|
| 4 | |
|---|
| 5 | These programs are generally small utilities used for debugging, |
|---|
| 6 | and installation of the lm_sensors package, and for demonstrating |
|---|
| 7 | the use of the drivers and libraries in this package. |
|---|
| 8 | For more elaborate programs (for example, GUI sensor displays), |
|---|
| 9 | see http://www.lm-sensors.org/wiki/UsefulLinks. |
|---|
| 10 | |
|---|
| 11 | |
|---|
| 12 | * prog/daemon/healthd.sh (written in bash, not installed) |
|---|
| 13 | An example of a very simple hardware health monitoring daemon. |
|---|
| 14 | |
|---|
| 15 | * prog/detect/sensors-detect (written in Perl, installed by 'make install') |
|---|
| 16 | This program tries to detect the available SMBus adapters and the chips |
|---|
| 17 | connected to them, as well as Super-I/O and misc chips. It also generates |
|---|
| 18 | modprobe lines and module options. This program is stand-alone (can be |
|---|
| 19 | run without installing lm-sensors) and interactive. |
|---|
| 20 | |
|---|
| 21 | * prog/dump/isadump (written in C, installed by 'make install') |
|---|
| 22 | This program dumps the registers of ISA or Super-I/O chips. |
|---|
| 23 | Usual syntax: |
|---|
| 24 | isadump 0x295 0x296 |
|---|
| 25 | isadump -k 0x55 0x2e 0x2f |
|---|
| 26 | |
|---|
| 27 | * prog/hotplug/unhide_ICH_SMBus (shell script, not installed) |
|---|
| 28 | It unhides the ICH Intel SMBus for 2.6 kernels |
|---|
| 29 | |
|---|
| 30 | * prog/init/lm_sensors.init (shell script, not installed) |
|---|
| 31 | A SysV init script to be installed in /etc/rc.d/init.d/ |
|---|
| 32 | It inserts the bus and chip modules. |
|---|
| 33 | |
|---|
| 34 | * prog/init/sensord.init (shell script, not installed) |
|---|
| 35 | A SysV init script to be installed in /etc/rc.d/init.d/ |
|---|
| 36 | It inserts the bus and chip modules and starts the sensord daemon. |
|---|
| 37 | |
|---|
| 38 | * prog/pwm/pwmconfig (shell script, installed by 'make install') |
|---|
| 39 | Formerly pwmtest, tests the pwm (pulse width modulation) outputs of sensors |
|---|
| 40 | for their effect on the fans and helps to setup the configfile for fancontrol. |
|---|
| 41 | |
|---|
| 42 | * prog/pwm/fancontrol (shell script, installed by 'make install') |
|---|
| 43 | Controls fanspeeds responding to changes on temperature sensors. |
|---|
| 44 | Configuration through pwmconfig. |
|---|
| 45 | |
|---|
| 46 | * prog/rrd/sens_update_rrd (written in bash, not installed) |
|---|
| 47 | This script gathers sensors data and adds it to a round robin database |
|---|
| 48 | (RRD). RRD is then used to display the graphed data in web pages. |
|---|
| 49 | See prog/rrd/README for more information. |
|---|
| 50 | |
|---|
| 51 | * prog/sensord/sensord (written in C, installed by `make install-prog-sensord') |
|---|
| 52 | This daemon can be used to periodically log sensor readings from |
|---|
| 53 | the sensors hardware to syslog, and to alert (using syslog level ALERT) |
|---|
| 54 | when a sensor alarm is signalled; for example, if a fan fails, a temperature |
|---|
| 55 | limit is exceeded, etc. |
|---|
| 56 | |
|---|
| 57 | * prog/sensors/sensors (written in C, installed by `make install') |
|---|
| 58 | This pretty-prints the information provided by the modules. It is a normal |
|---|
| 59 | console application, using stdout. It is essential, because |
|---|
| 60 | unlike the raw sysfs files, it takes your configuration file into account. |
|---|
| 61 | |
|---|
| 62 | * prog/tellerstats/gather.sh, tellerstats.sh (written in bash, not installed) |
|---|
| 63 | These scripts gather sensors data and graph the data for web pages. |
|---|
| 64 | See prog/tellerstats/README for more information. |
|---|
