source: general/sysutils/lm_sensors.xml@ da3947ef

10.0 10.1 11.0 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since da3947ef was da3947ef, checked in by Douglas R. Reno <renodr@…>, 7 years ago

More GCC5 Tags

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

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