| 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 useful_addresses.html. |
|---|
| 10 | |
|---|
| 11 | |
|---|
| 12 | * prog/config/grab_busses.sh (written in bash and awk, not installed) |
|---|
| 13 | This program helps you generate the `bus' statements for your configuration |
|---|
| 14 | file. It read /proc/bus/i2c (or the file specified on the command-line), |
|---|
| 15 | and prints to stdout `bus' statements reflecting the currently detected |
|---|
| 16 | adapters. |
|---|
| 17 | |
|---|
| 18 | * prog/daemon/healthd.sh (written in bash, not installed) |
|---|
| 19 | An example of a very simple hardware health monitoring daemon. |
|---|
| 20 | |
|---|
| 21 | * prog/detect/sensors-detect (written in Perl, installed by 'make install') |
|---|
| 22 | This program tries to detect the available SMBus adapters and the chips |
|---|
| 23 | connected to them, as well as Super-I/O and misc chips. It also generates |
|---|
| 24 | modprobe lines and module options. This program is interactive. |
|---|
| 25 | |
|---|
| 26 | * prog/dump/isadump (written in C, installed by 'make install') |
|---|
| 27 | This program dumps the registers of ISA or Super-I/O chips. |
|---|
| 28 | Usual syntax: |
|---|
| 29 | isadump 0x295 0x296 |
|---|
| 30 | isadump -k 0x55 0x2e 0x2f |
|---|
| 31 | |
|---|
| 32 | * prog/hotplug/unhide_ICH_SMBus (shell script, not installed) |
|---|
| 33 | It unhides the ICH Intel SMBus for 2.6 kernels |
|---|
| 34 | |
|---|
| 35 | * prog/init/lm_sensors.init (shell script, not installed) |
|---|
| 36 | A SysV init script to be installed in /etc/rc.d/init.d/ |
|---|
| 37 | It inserts the bus and chip modules. |
|---|
| 38 | |
|---|
| 39 | * prog/init/sensord.init (shell script, not installed) |
|---|
| 40 | A SysV init script to be installed in /etc/rc.d/init.d/ |
|---|
| 41 | It inserts the bus and chip modules and starts the sensord daemon. |
|---|
| 42 | |
|---|
| 43 | * prog/maxilife/sysinfo.sh (written in shell, not installed) |
|---|
| 44 | Write system information to the HP Maxilife LCD display using writelcd.sh. |
|---|
| 45 | |
|---|
| 46 | * prog/maxilife/writelcd.sh (written in shell, not installed) |
|---|
| 47 | Write a string to the HP Maxilife LCD display. |
|---|
| 48 | |
|---|
| 49 | * prog/mkdev/mkdev.sh (written in bash, not installed) |
|---|
| 50 | This script creates the /dev/i2c-* files. Please check the source before |
|---|
| 51 | you run it, as you may need to set some variables first. |
|---|
| 52 | |
|---|
| 53 | * prog/pwm/pwmconfig (shell script, installed by 'make install') |
|---|
| 54 | Formerly pwmtest, tests the pwm (pulse width modulation) outputs of sensors |
|---|
| 55 | for their effect on the fans and helps to setup the configfile for fancontrol. |
|---|
| 56 | |
|---|
| 57 | * prog/pwm/fancontrol (shell script, installed by 'make install') |
|---|
| 58 | Controls fanspeeds responding to changes on temperature sensors. |
|---|
| 59 | Configuration through pwmconfig. |
|---|
| 60 | |
|---|
| 61 | * prog/rrd/sens_update_rrd (written in bash, not installed) |
|---|
| 62 | This script gathers sensors data and adds it to a round robin database |
|---|
| 63 | (RRD). RRD is then used to display the graphed data in web pages. |
|---|
| 64 | See prog/rrd/README for more information. |
|---|
| 65 | |
|---|
| 66 | * prog/sensord/sensord (written in C, installed by `make install-prog-sensord') |
|---|
| 67 | This daemon can be used to periodically log sensor readings from |
|---|
| 68 | the sensors hardware to syslog, and to alert (using syslog level ALERT) |
|---|
| 69 | when a sensor alarm is signalled; for example, if a fan fails, a temperature |
|---|
| 70 | limit is exceeded, etc. |
|---|
| 71 | |
|---|
| 72 | * prog/sensors/sensors (written in C, installed by `make install') |
|---|
| 73 | This pretty-prints the information provided by the modules. It is a normal |
|---|
| 74 | console application, using stdout. It is essential, because |
|---|
| 75 | unlike the raw /proc/sys/dev/sensors/*/* files, it takes your configuration |
|---|
| 76 | file into account. |
|---|
| 77 | |
|---|
| 78 | * prog/tellerstats/gather.sh, tellerstats.sh (written in bash, not installed) |
|---|
| 79 | These scripts gather sensors data and graph the data for web pages. |
|---|
| 80 | See prog/tellerstats/README for more information. |
|---|
