source: general/sysutils/lm_sensors.xml@ c7ce750a

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 c7ce750a was c7ce750a, checked in by Krejzi <krejzi@…>, 10 years ago

Package updates.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10925 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 "73c2fcccdab6049d289c5e0c596192a1">
12 <!ENTITY lm_sensors-size "172 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 -pv /usr/share/doc/lm_sensors-&lm_sensors-version; &amp;&amp;
157cp -rfv 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
177 </sect2>
178
179 <sect2 role="configuration">
180 <title>Configuring Lm Sensors</title>
181
182 <sect3 id="lm_sensors-config">
183 <title>Config File</title>
184
185 <para>
186 <filename>/etc/sensors3.conf</filename>
187 </para>
188
189 <indexterm zone="lm_sensors lm_sensors-config">
190 <primary
191 sortas="e-etc-path-Configfilename2">/etc/sensors3.conf</primary>
192 </indexterm>
193
194 </sect3>
195
196 <sect3><title>Configuration Information</title>
197
198 <para>
199 To find out what hardware sensors your system has, as the
200 <systemitem class="username">root</systemitem> user:
201 </para>
202
203<screen role="root"><userinput>sensors-detect</userinput></screen>
204
205 <para>
206 Hopefully it will load the appropriate modules and give you a summary
207 at the end. Now you know what is needed you can recompile your kernel
208 and just enable the options you need (ie, don't enable the modules you
209 can't use).
210 </para>
211
212 </sect3>
213
214 </sect2>
215
216 <sect2 role="content">
217 <title>Contents</title>
218
219 <segmentedlist>
220 <segtitle>Installed Programs</segtitle>
221 <segtitle>Installed Library</segtitle>
222 <segtitle>Installed Directories</segtitle>
223
224 <seglistitem>
225 <seg>
226 fancontrol, isadump, isaset, pwmconfig,
227 sensors, sensors-conf-convert and
228 sensors-detect
229 </seg>
230 <seg>
231 libsensors.so
232 </seg>
233 <seg>
234 /usr/include/sensors and
235 /usr/share/doc/lm_sensors-&lm_sensors-version;
236 </seg>
237 </seglistitem>
238 </segmentedlist>
239
240 <variablelist>
241 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
242 <?dbfo list-presentation="list"?>
243 <?dbhtml list-presentation="table"?>
244
245 <varlistentry id="fancontrol">
246 <term><command>fancontrol</command></term>
247 <listitem>
248 <para>
249 is a shell script for use with lm_sensors. It reads its
250 configuration from a file, then calculates fan speeds from
251 temperatures and sets the corresponding PWM outputs to the computed
252 values.
253 </para>
254 <indexterm zone="lm_sensors fancontrol">
255 <primary sortas="b-fancontrol">fancontrol</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259
260 <varlistentry id="isadump">
261 <term><command>isadump</command></term>
262 <listitem>
263 <para>
264 is a small helper program to examine registers visible through the
265 ISA bus. It is intended to probe any chip that lives on the ISA bus
266 working with an address register and a data register (I2C-like
267 access) or a flat range (of up to 256 bytes).
268 </para>
269 <indexterm zone="lm_sensors isadump">
270 <primary sortas="b-isadump">isadump</primary>
271 </indexterm>
272 </listitem>
273 </varlistentry>
274
275 <varlistentry id="isaset">
276 <term><command>isaset</command></term>
277 <listitem>
278 <para>
279 is a small helper program to set registers visible through the ISA
280 bus.
281 </para>
282 <indexterm zone="lm_sensors isaset">
283 <primary sortas="b-isaset">isaset</primary>
284 </indexterm>
285 </listitem>
286 </varlistentry>
287
288 <varlistentry id="pwmconfig">
289 <term><command>pwmconfig</command></term>
290 <listitem>
291 <para>
292 tests the pulse width modulation (PWM) outputs of sensors and
293 configures fancontrol.
294 </para>
295 <indexterm zone="lm_sensors pwmconfig">
296 <primary sortas="b-pwmconfig">pwmconfig</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="sensors">
302 <term><command>sensors</command></term>
303 <listitem>
304 <para>
305 prints the current readings of all sensor chips.
306 </para>
307 <indexterm zone="lm_sensors sensors">
308 <primary sortas="b-sensors">sensors</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 <varlistentry id="sensors-conf-convert">
314 <term><command>sensors-conf-convert</command></term>
315 <listitem>
316 <para>
317 is a Perl script to convert lm-sensors version 2 configuration files
318 to work with version 3.
319 </para>
320 <indexterm zone="lm_sensors sensors-conf-convert">
321 <primary sortas="b-sensors-conf-convert">sensors-conf-convert</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325
326 <varlistentry id="sensors-detect">
327 <term><command>sensors-detect</command></term>
328 <listitem>
329 <para>
330 is a Perl script that will walk you through the process of scanning
331 your system for various hardware monitoring chips, or sensors,
332 supported by libsensors(3), or more generally by the lm_sensors
333 tool suite.
334 </para>
335 <indexterm zone="lm_sensors sensors-detect">
336 <primary sortas="b-sensors-detect">sensors-detect</primary>
337 </indexterm>
338 </listitem>
339 </varlistentry>
340
341 <varlistentry id="libsensors">
342 <term><filename class="libraryfile">libsensors.so</filename></term>
343 <listitem>
344 <para>
345 contains the lm_sensors API functions.
346 </para>
347 <indexterm zone="lm_sensors libsensors">
348 <primary sortas="c-libsensors">libsensors.so</primary>
349 </indexterm>
350 </listitem>
351 </varlistentry>
352
353 </variablelist>
354
355 </sect2>
356
357</sect1>
Note: See TracBrowser for help on using the repository browser.