Documentation/hwmon/userspace-tools.rst

   1 Userspace tools
   2 ===============
   3
   4 Introduction
   5 ------------
   6
   7 Most mainboards have sensor chips to monitor system health (like temperatures,
   8 voltages, fans speed). They are often connected through an I2C bus, but some
   9 are also connected directly through the ISA bus.
  10
  11 The kernel drivers make the data from the sensor chips available in the /sys
  12 virtual filesystem. Userspace tools are then used to display the measured
  13 values or configure the chips in a more friendly manner.
  14
  15 Lm-sensors
  16 ----------
  17
  18 Core set of utilities that will allow you to obtain health information,
  19 setup monitoring limits etc. You can get them on their homepage
  20 http://www.lm-sensors.org/ or as a package from your Linux distribution.
  21
  22 If from website:
  23 Get lm-sensors from project web site. Please note, you need only userspace
  24 part, so compile with "make user" and install with "make user_install".
  25
  26 General hints to get things working:
  27
  28 0) get lm-sensors userspace utils
  29 1) compile all drivers in I2C and Hardware Monitoring sections as modules
  30    in your kernel
  31 2) run sensors-detect script, it will tell you what modules you need to load.
  32 3) load them and run "sensors" command, you should see some results.
  33 4) fix sensors.conf, labels, limits, fan divisors
  34 5) if any more problems consult FAQ, or documentation
  35
  36 Other utilities
  37 ---------------
  38
  39 If you want some graphical indicators of system health look for applications
  40 like: gkrellm, ksensors, xsensors, wmtemp, wmsensors, wmgtemp, ksysguardd,
  41 hardware-monitor
  42
  43 If you are server administrator you can try snmpd or mrtgutils.