source: general/sysutils/lm_sensors.xml@ e917814

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY lm_sensors-download-http "https://github.com/lm-sensors/lm-sensors/archive/V&lm-sensors-version;/lm-sensors-&lm-sensors-version;.tar.gz">
  <!ENTITY lm_sensors-download-ftp  " ">
  <!ENTITY lm_sensors-md5sum        "f60e47b5eb50bbeed48a9f43bb08dd5e">
  <!ENTITY lm_sensors-size          "268 KB">
  <!ENTITY lm_sensors-buildsize     "2.6 MB">
  <!ENTITY lm_sensors-time          "less than 0.1 SBU">
]>

<sect1 id="lm_sensors" xreflabel="lm-sensors-&lm-sensors-version;">
  <?dbhtml filename="lm_sensors.html"?>


  <title>Lm-sensors-&lm-sensors-version;</title>

  <indexterm zone="lm_sensors">
    <primary sortas="a-lm_sensors">lm_sensors</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Lm_sensors</title>

    <para>
      The <application>lm_sensors</application> package provides userspace
      support for the hardware monitoring drivers in the Linux kernel.
      This is useful for monitoring the temperature of the CPU and adjusting the
      performance of some hardware (such as cooling fans).
    </para>

    &lfs113_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&lm_sensors-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&lm_sensors-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &lm_sensors-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &lm_sensors-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &lm_sensors-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &lm_sensors-time;
        </para>
      </listitem>
    </itemizedlist>

<!--    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Required patch:
          <ulink url="&patch-root;/lm_sensors-&lm_sensors-version;-upstream_fixes-1.patch"/>
        </para>
      </listitem>
    </itemizedlist> -->

    <bridgehead renderas="sect3">lm_sensors Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="which"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <ulink url="https://oss.oetiker.ch/rrdtool/">RRDtool</ulink> (required to
      build the <command>sensord</command> program) and
      <ulink role="runtime"
             url="https://www.nongnu.org/dmidecode/">dmidecode</ulink>
      (runtime)
    </para>

  </sect2>

  <sect2 role="kernel" id="lm_sensors-kernel">
    <title>Kernel Configuration</title>

    <para>
      Getting your kernel config right is an iterative process that may require
      that you recompile your kernel a couple of times. The simplest way to go
      about it is to start by enabling modules and then compile everything that
      may be needed by Lm Sensors as a module:
    </para>

<screen><literal>[*] Enable loadable module support  ---&gt;  [CONFIG_MODULES]

Device Drivers  ---&gt;
  [*] PCI support ---&gt;                    [CONFIG_PCI]
  I2C support ---&gt;
    &lt;*/M&gt; I2C device interface            [CONFIG_I2C_CHARDEV]<!--
Seems to be automatically selected and invisible on linux 3.17:
    I2C Algorithms  -&45;-&gt;
      &lt;M&gt; (configure all of them as modules)-->
    I2C Hardware Bus support  ---&gt;
      &lt;M&gt; (configure all of them as modules)
  &lt;*/M&gt; Hardware Monitoring support  ---&gt; [CONFIG_HWMON]
    &lt;M&gt; (configure all of them as modules)</literal></screen>

    <para>
      Recompile your kernel and reboot into the new kernel. Don't forget to
      <command>make modules_install</command> We will come back to the kernel in
      the Configuring section below.
    </para>

    <indexterm zone="lm_sensors lm_sensors-kernel">
      <primary sortas="d-lm_sensors">lm_sensors</primary>
    </indexterm>
  </sect2>

  <sect2 role="installation">
    <title>Installation of Lm_sensors</title>

    <para>
      Install <application>Lm_sensors</application> by running the following
      commands:
    </para>

<!-- <screen><userinput>patch -Np1 -i ../lm_sensors-&lm_sensors-version;-upstream_fixes-1.patch &amp;&amp; -->
<screen><userinput>make PREFIX=/usr        \
     BUILD_STATIC_LIB=0 \
     MANDIR=/usr/share/man</userinput></screen>

    <para>
      This package does not come with a test suite.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>make PREFIX=/usr        \
     BUILD_STATIC_LIB=0 \
     MANDIR=/usr/share/man install &amp;&amp;

install -v -m755 -d /usr/share/doc/lm_sensors-&lm-sensors-version; &amp;&amp;
cp -rv              README INSTALL doc/* \
                    /usr/share/doc/lm_sensors-&lm-sensors-version;</userinput></screen>
  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <parameter>BUILD_STATIC_LIB=0</parameter>: This parameter disables
      compiling and installing the static version of
      <filename class="libraryfile">libsensors</filename>.
    </para>

    <para>
      <option>PROG_EXTRA=sensord</option>: This parameter enables
      compiling <command>sensord</command>, a daemon that can monitor your
      system at regular intervals. Compiling <command>sensord</command> requires
      <ulink url="https://oss.oetiker.ch/rrdtool/">RRDtool</ulink>. Be sure
      to install RRDtool in <filename class="directory">/usr</filename>
      by running <command>make prefix=/usr</command> when building it.
      Otherwise, Lm_sensors will not find it easily.
    </para>

  </sect2>

  <sect2 role="configuration">
    <title>Configuring Lm_sensors</title>

    <sect3 id="lm_sensors-config">
      <title>Config File</title>

      <para>
        <filename>/etc/sensors3.conf</filename>
      </para>

      <indexterm zone="lm_sensors lm_sensors-config">
        <primary
        sortas="e-etc-path-Configfilename2">/etc/sensors3.conf</primary>
      </indexterm>

    </sect3>

    <sect3><title>Configuration Information</title>

      <para>
        To find out what hardware sensors your system has, issue the following
        command as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>sensors-detect</userinput></screen>

      <para>
        The appropriate modules should have been loaded and a summary is
        displayed at the end. Now you know what is needed and you can recompile
        your kernel to enable just the options you need (i.e., don't enable the
        modules you cannot use).
      </para>

    </sect3>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Library</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>
          fancontrol, isadump, isaset, pwmconfig, sensors, sensors-conf-convert,
          sensors-detect, and optionally, sensord
        </seg>
        <seg>
          libsensors.so
        </seg>
        <seg>
          /etc/sensors.d,
          /usr/include/sensors and
          /usr/share/doc/lm_sensors-&lm-sensors-version;
        </seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="fancontrol">
        <term><command>fancontrol</command></term>
        <listitem>
          <para>
            is a shell script for use with <application>lm_sensors</application>.
            It reads its configuration from a file<!--what file?-->, then
            calculates fan speeds from temperatures and sets the corresponding
            PWM outputs to the computed values
          </para>
          <indexterm zone="lm_sensors fancontrol">
            <primary sortas="b-fancontrol">fancontrol</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="isadump">
        <term><command>isadump</command></term>
        <listitem>
          <para>
            is a small helper program to examine registers visible through the
            ISA bus. It is intended to probe any chip that lives on the ISA bus
            working with an address register and a data register (I2C-like
            access) or a flat range (of up to 256 bytes)
          </para>
          <indexterm zone="lm_sensors isadump">
            <primary sortas="b-isadump">isadump</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="isaset">
        <term><command>isaset</command></term>
        <listitem>
          <para>
            is a small helper program to set registers visible through the ISA
            bus
          </para>
          <indexterm zone="lm_sensors isaset">
            <primary sortas="b-isaset">isaset</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="pwmconfig">
        <term><command>pwmconfig</command></term>
        <listitem>
          <para>
            tests the pulse width modulation (PWM) outputs of sensors and
            configures fancontrol
          </para>
          <indexterm zone="lm_sensors pwmconfig">
            <primary sortas="b-pwmconfig">pwmconfig</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="sensors">
        <term><command>sensors</command></term>
        <listitem>
          <para>
            prints the current readings of all sensor chips
          </para>
          <indexterm zone="lm_sensors sensors">
            <primary sortas="b-sensors">sensors</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="sensors-conf-convert">
        <term><command>sensors-conf-convert</command></term>
        <listitem>
          <para>
            is a <application>Perl</application> script to convert
            <application>lm-sensors</application> version 2 configuration files
            to work with version 3
          </para>
          <indexterm zone="lm_sensors sensors-conf-convert">
            <primary sortas="b-sensors-conf-convert">sensors-conf-convert</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="sensors-detect">
        <term><command>sensors-detect</command></term>
        <listitem>
          <para>
            is a <application>Perl</application> script that will walk you
            through the process of scanning your system for various hardware
            monitoring chips (sensors) supported by
            <filename class="libraryfile">libsensors</filename>, or more
            generally by the <application>lm_sensors</application> tool suite
          </para>
          <indexterm zone="lm_sensors sensors-detect">
            <primary sortas="b-sensors-detect">sensors-detect</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="sensord">
        <term><command>sensord</command></term>
        <listitem>
          <para>
            (optional) is a daemon that can be used to periodically log sensor
            readings
          </para>
          <indexterm zone="lm_sensors sensord">
            <primary sortas="b-sensord">sensord</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libsensors">
        <term><filename class="libraryfile">libsensors.so</filename></term>
        <listitem>
          <para>
            contains the <application>lm_sensors</application> API functions
          </para>
          <indexterm zone="lm_sensors libsensors">
            <primary sortas="c-libsensors">libsensors.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>