lm-sensors/doc/progs

This is a list of additional programs, that may or may not be installed by
`make install', and that usually can be found in the `prog' directory of
this package.

These programs are generally small utilities used for debugging,
and installation of the lm_sensors package, and for demonstrating
the use of the drivers and libraries in this package.
For more elaborate programs (for example, GUI sensor displays),
see useful_addresses.html.


* doc/developers/editticket (written in shell, not installed)
  Calls netscape to edit a specific support ticket.

* doc/developers/readticket (written in shell, not installed)
  Calls netscape to read a specific support ticket.

* prog/config/grab_busses.sh (written in bash and awk, not installed)
  This program helps you generate the `bus' statements for your configuration
  file. It read /proc/bus/i2c (or the file specified on the command-line),
  and prints to stdout `bus' statements reflecting the currently detected
  adapters.

* prog/daemon/healthd.sh (written in bash, not installed)
  An example of a very simple hardware health monitoring daemon.

* prog/detect/i2cdetect (written in C, not installed)
  This program scans your complete I2C or SMBus adapter for connected devices.
  Not all devices can be detected in this way, though; and it may hang your
  bus. Syntax:
    ./i2cdetect 0
  Here the '0' stands for the bus number (run i2cdetect with no arguments 
  to list all installed busses).

* prog/detect/sensors-detect (written in Perl, installed by 'make install')
  This program tries to detect the available SMBus adapters and the chips
  connected to them and/or the ISA bus. It also generates modprobe lines
  and module options. This program is interactive and will ask you about
  all information it needs.

* prog/doc/doc-features.pl (written in Perl, not installed)
  This program is used to help us generate driver documentation; it scans
  some C source programs to do this. Syntax:
    ./doc-features.pl BASE [PREFIX...]
  BASE is the path to the base directory of the lm_sensors tree
  PREFIX is one of more prefixes of chips you want documented; if left out,
  all chips are documented.

* prog/doc/doc-insmod.pl (written in Perl, not installed)
  This program is used to help us generate driver documentation; it reads
  all module information and outputs insmod parameter information. Syntax:
    ./doc-insmod.pl DRIVER

* prog/dump/i2cdump (written in C, not installed)
  This program dumps the registers of a I2C device that understands
  the 'byte data' or 'word data' and block read SMBus protocols.
  Usual syntax:
    ./i2cdump 0 0x49 b
  Here the '0' stands for the bus number (run i2cdump with no arguments 
  to list all installed busses).
  '0x49' is the device address, and 'b' or 'w' stands for byte
  or word data.

* prog/dump/i2cset (written in C, not installed)
  This program is used to write the register of a I2C device.
  Usual syntax:
    ./i2cset bus device address data

* prog/dump/isadump (written in C, not installed)
  This program dumps the registers of LM78-like chips, or more
  exactly, chips which use one I/O-port for its address and one as its
  data register. Usual syntax: 
     ./isadump 0x295 0x296

* prog/eeprom/decode-dimms.pl (written in Perl 5, not installed)
  This program decodes the information generated by the `eeprom.o' module.
  It will only work for the installed eeprom module from the src/ directory,
  not for the old one in the i2c/drivers/ directory.

* prog/eeprom/decode-vaio.pl (written in Perl 5, not installed)
  This program decodes the information in a Sony Vaio laptop
  identification eeprom at 0x57.

* prog/eepromer/eepromer (written in C, not installed)
  This program reads and writes eeproms.
  Danger: Do not use this to write your DRAM DIMM eeproms.

* prog/hotplug/m7101.o (kernel module, not installed)
  An experimental kernel module to enable the Acer Labs 7101 PCI device.
  See prog/hotplug/README for details.

* prog/hotplug/p4b_smbus.o (kernel module, not installed)
  An experimental kernel module to enable the i801 2443 PCI device
  on Asus P4B boards.
  See prog/hotplug/README.p4b for details.

* prog/init/lm_sensors.init (shell script, not installed)
  A SysV init script to be installed in /etc/rc.d/init.d/
  It inserts the bus and chip modules.

* prog/init/sensord.init (shell script, not installed)
  A SysV init script to be installed in /etc/rc.d/init.d/
  It inserts the bus and chip modules and starts the sensord daemon.

* prog/matorb/displayit.pl (written in Perl, not installed)
  A simple Perl script to display a 'screen' on a Matrix Orbital Display.

* prog/maxilife/sysinfo.sh (written in shell, not installed)
  Write system information to the HP Maxilife LCD display using writelcd.sh.

* prog/maxilife/writelcd.sh (written in shell, not installed)
  Write a string to the HP Maxilife LCD display.

* prog/mkdev/mkdev.sh (written in bash, not installed)
  This script creates the /dev/i2c-* files. Please check the source before
  you run it, as you may need to set some variables first.

* prog/rrd/sens_update_rrd (written in bash, not installed)
  This script gathers sensors data and adds it to a round robin database
  (RRD). RRD is then used to display the graphed data in web pages.
  See prog/rrd/README for more information.

* prog/sensord/sensord (written in C, installed by `make install-prog-sensord')
  This daemon can be used to periodically log sensor readings from
  the sensors hardware to syslog, and to alert (using syslog level ALERT)
  when a sensor alarm is signalled; for example, if a fan fails, a temperature
  limit is exceeded, etc.

* prog/sensors/sensors (written in C, installed by `make install')
  This pretty-prints the information provided by the modules. It is a normal
  console application, using stdout. It is essential, because
  unlike the raw /proc/sys/dev/sensors/*/* files, it takes your configuration
  file into account.

* prog/tellerstats/gather.sh, tellerstats.sh (written in bash, not installed)
  These scripts gather sensors data and graph the data for web pages.
  See prog/tellerstats/README for more information.

* prog/xeon/decode-xeon.pl (written in Perl, not installed)
  ID ROM data decoding for Xeon processors.