source: general/sysutils/lm_sensors.xml@ ee22698

10.0 10.1 11.0 11.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since ee22698 was ee22698, checked in by Ken Moffat <ken@…>, 10 years ago

tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10569 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 11.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY lm_sensors-download-http
8 "http://dl.lm-sensors.org/lm-sensors/releases/lm_sensors-&lm_sensors-version;.tar.bz2">
9 <!ENTITY lm_sensors-download-ftp
10 "ftp://ftp.netroedge.com/pub/lm-sensors/lm_sensors-&lm_sensors-version;.tar.bz2">
11 <!ENTITY lm_sensors-md5sum "f357ba00b080ab102a170f7bf8bb2578">
12 <!ENTITY lm_sensors-size "168 KB">
13 <!ENTITY lm_sensors-buildsize "2.4 MB">
14 <!ENTITY lm_sensors-time "0.1 SBU">
15]>
16
17<sect1 id="lm_sensors" xreflabel="lm_sensors-&lm_sensors-version;">
18 <?dbhtml filename="lm_sensors.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>lm_sensors-&lm_sensors-version;</title>
26
27 <indexterm zone="lm_sensors">
28 <primary sortas="a-lm_sensors">lm_sensors</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to Lm Sensors</title>
33
34 <para>
35 The <application>Lm Sensors</application> package provides user-space
36 support for the hardware monitoring drivers in the Linux kernel.
37 This is useful for monitoring the temperature of the CPU and adjusting the
38 performance of some hardware (such as cooling fans).
39 </para>
40
41 &lfs72_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&lm_sensors-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&lm_sensors-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &lm_sensors-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &lm_sensors-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &lm_sensors-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &lm_sensors-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">Lm Sensors Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Required</bridgehead>
80 <para role="required">
81 <xref linkend="which"/>.
82 </para>
83
84 <bridgehead renderas="sect4">Optional</bridgehead>
85 <para role="optional">
86 <ulink url="http://oss.oetiker.ch/rrdtool/">RRDtool</ulink>.
87 </para>
88
89 <para condition="html" role="usernotes">
90 User Notes: <ulink url="&blfs-wiki;/lm_sensors"/>
91 </para>
92 </sect2>
93
94 <sect2 role="kernel" id="lm_sensors-kernel">
95 <title>Kernel Configuration</title>
96
97 <para>
98 Getting your kernel config right is an iterative process that may require
99 that you recompile your kernel a couple of times. The simplest way to go
100 about it is to start by enabling modules and then compile everything that
101 may be needed by Lm Sensors as a module:
102 </para>
103
104<screen><literal>General setup ---&gt;
105 [*] Prompt for development and/or incomplete code/drivers
106
107[*] Enable loadable module support ---&gt;
108
109Bus options (PCI etc.) ---&gt;
110 [*] PCI support
111
112Device Drivers ---&gt;
113 [*] I2C support
114 [*] I2C device interface
115 I2C Algorithms ---&gt;
116 &lt;M&gt; (configure all of them as modules)
117 I2C Hardware Bus support ---&gt;
118 &lt;M&gt; (configure all of them as modules)
119 I2C Hardware Bus support ---&gt;
120 &lt;M&gt; (configure all of them as modules)
121 [*] Hardware Monitoring support ---&gt;
122 &lt;M&gt; (configure all of them as modules)</literal></screen>
123
124 <para>
125 Recompile your kernel and reboot into the new kernel. Don't forget to
126 <command>make modules_install</command> We will come back to the kernel in
127 the Configuring section below.
128 </para>
129
130 <indexterm zone="lm_sensors lm_sensors-kernel">
131 <primary sortas="d-lm_sensors">lm_sensors</primary>
132 </indexterm>
133 </sect2>
134
135 <sect2 role="installation">
136 <title>Installation of Lm Sensors</title>
137
138 <para>
139 Install <application>Lm Sensors</application> by running the following
140 commands:
141 </para>
142
143<screen><userinput>make PREFIX=/usr BUILD_STATIC_LIB=0 \
144 MANDIR=/usr/share/man</userinput></screen>
145
146 <para>
147 This package does not come with a test suite.
148 </para>
149
150 <para>
151 Now, as the <systemitem class="username">root</systemitem> user:
152 </para>
153
154<screen role="root"><userinput>make PREFIX=/usr BUILD_STATIC_LIB=0 \
155 MANDIR=/usr/share/man install &amp;&amp;
156mkdir -p /usr/share/doc/lm_sensors-&lm_sensors-version; &amp;&amp;
157cp -rf doc/* /usr/share/doc/lm_sensors-&lm_sensors-version;</userinput></screen>
158 </sect2>
159
160 <sect2 role="commands">
161 <title>Command Explanations</title>
162
163 <para>
164 <parameter>BUILD_STATIC_LIB=0</parameter>: This parameter disables
165 compiling and installing the static version of libsensors.
166 </para>
167
168 <para>
169 <parameter>PROG_EXTRA=sensord</parameter>: This parameter enables
170 compiling sensord, a daemon that can monitor your system at regular
171 intervals. Compiling <command>sensord</command> requires
172 <ulink url="http://oss.oetiker.ch/rrdtool/">RRDtool</ulink>. Compiling
173 RRDtool 1.4.6 requires a sed: <command>sed -i '/ sv_undef/d'
174 bindings/perl-shared/RRDs.xs</command>.
175 </para>
176 </sect2>
177
178 <sect2 role="configuration">
179 <title>Configuring Lm Sensors</title>
180
181 <sect3 id="lm_sensors-config">
182 <title>Config File</title>
183 <para><filename>/etc/sensors3.conf</filename>.</para>
184
185 <indexterm zone="lm_sensors lm_sensors-config">
186 <primary
187 sortas="e-etc-path-Configfilename2">/etc/sensors3.conf</primary>
188 </indexterm>
189 </sect3>
190
191 <sect3><title>Configuration Information</title>
192
193 <para>
194 To find out what hardware sensors your system has, as the
195 <systemitem class="username">root</systemitem> user:
196 </para>
197
198<screen role="root"><userinput>sensors-detect</userinput></screen>
199
200 <para>
201 Hopefully it will load the appropriate modules and give you a summary
202 at the end. Now you know what is needed you can recompile your kernel
203 and just enable the options you need (ie, don't enable the modules you
204 can't use).
205 </para>
206 </sect3>
207 </sect2>
208
209 <sect2 role="content">
210 <title>Contents</title>
211
212 <segmentedlist>
213 <segtitle>Installed Programs</segtitle>
214 <segtitle>Installed Library</segtitle>
215 <segtitle>Installed Directories</segtitle>
216
217 <seglistitem>
218 <seg>
219 fancontrol,
220 isadump,
221 isaset,
222 pwmconfig,
223 sensors,
224 sensors-conf-convert and
225 sensors-detect.
226 </seg>
227 <seg>libsensors.so.</seg>
228 <seg>
229 /usr/include/sensors and
230 /usr/share/doc/lm_sensors-&lm_sensors-version;.
231 </seg>
232 </seglistitem>
233 </segmentedlist>
234
235 <variablelist>
236 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
237 <?dbfo list-presentation="list"?>
238 <?dbhtml list-presentation="table"?>
239
240 <varlistentry id="fancontrol">
241 <term><command>fancontrol</command></term>
242 <listitem>
243 <para>
244 is a shell script for use with lm_sensors. It reads its
245 configuration from a file, then calculates fan speeds from
246 temperatures and sets the corresponding PWM outputs to the computed
247 values.
248 </para>
249 <indexterm zone="lm_sensors fancontrol">
250 <primary sortas="b-fancontrol">fancontrol</primary>
251 </indexterm>
252 </listitem>
253 </varlistentry>
254
255 <varlistentry id="isadump">
256 <term><command>isadump</command></term>
257 <listitem>
258 <para>
259 is a small helper program to examine registers visible through the
260 ISA bus. It is intended to probe any chip that lives on the ISA bus
261 working with an address register and a data register (I2C-like
262 access) or a flat range (of up to 256 bytes).
263 </para>
264 <indexterm zone="lm_sensors isadump">
265 <primary sortas="b-isadump">isadump</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="isaset">
271 <term><command>isaset</command></term>
272 <listitem>
273 <para>
274 is a small helper program to set registers visible through the ISA
275 bus.
276 </para>
277 <indexterm zone="lm_sensors isaset">
278 <primary sortas="b-isaset">isaset</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 <varlistentry id="pwmconfig">
284 <term><command>pwmconfig</command></term>
285 <listitem>
286 <para>
287 tests the pulse width modulation (PWM) outputs of sensors and
288 configures fancontrol.
289 </para>
290 <indexterm zone="lm_sensors pwmconfig">
291 <primary sortas="b-pwmconfig">pwmconfig</primary>
292 </indexterm>
293 </listitem>
294 </varlistentry>
295
296 <varlistentry id="sensors">
297 <term><command>sensors</command></term>
298 <listitem>
299 <para>
300 prints the current readings of all sensor chips.
301 </para>
302 <indexterm zone="lm_sensors sensors">
303 <primary sortas="b-sensors">sensors</primary>
304 </indexterm>
305 </listitem>
306 </varlistentry>
307
308 <varlistentry id="sensors-conf-convert">
309 <term><command>sensors-conf-convert</command></term>
310 <listitem>
311 <para>
312 is a Perl script to convert lm-sensors version 2 configuration files
313 to work with version 3.
314 </para>
315 <indexterm zone="lm_sensors sensors-conf-convert">
316 <primary sortas="b-sensors-conf-convert">sensors-conf-convert</primary>
317 </indexterm>
318 </listitem>
319 </varlistentry>
320
321 <varlistentry id="sensors-detect">
322 <term><command>sensors-detect</command></term>
323 <listitem>
324 <para>
325 is a Perl script that will walk you through the process of scanning
326 your system for various hardware monitoring chips, or sensors,
327 supported by libsensors(3), or more generally by the lm_sensors
328 tool suite.
329 </para>
330 <indexterm zone="lm_sensors sensors-detect">
331 <primary sortas="b-sensors-detect">sensors-detect</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 <varlistentry id="libsensors">
337 <term><filename class="libraryfile">libsensors.so</filename></term>
338 <listitem>
339 <para>
340 contains the lm_sensors API functions.
341 </para>
342 <indexterm zone="lm_sensors libsensors">
343 <primary sortas="c-libsensors">libsensors.so</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347 </variablelist>
348 </sect2>
349</sect1>
Note: See TracBrowser for help on using the repository browser.