source: general/sysutils/lm_sensors.xml@ 726744f4

systemd-13485
Last change on this file since 726744f4 was 726744f4, checked in by Douglas R. Reno <renodr@…>, 9 years ago

Move libdrm from X Libraries to General Libraries
Update to mesa-11.0.2
More LFS 7.8-systemd Tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@16506 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 12.4 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 &lfs78_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>[*] Enable loadable module support ---&gt; [CONFIG_MODULES]
117
118Bus options (PCI etc.) ---&gt;
119 [*] PCI support [CONFIG_PCI]
120
121Device Drivers ---&gt;
122 I2C support ---&gt;
123 &lt;*/M&gt; I2C device interface [CONFIG_I2C_CHARDEV]<!--
124Seems to be automatically selected and invisible on linux 3.17:
125 I2C Algorithms -&45;-&gt;
126 &lt;M&gt; (configure all of them as modules)-->
127 I2C Hardware Bus support ---&gt;
128 &lt;M&gt; (configure all of them as modules)
129 &lt;*/M&gt; Hardware Monitoring support ---&gt; [CONFIG_HWMON]
130 &lt;M&gt; (configure all of them as modules)</literal></screen>
131
132 <para>
133 Recompile your kernel and reboot into the new kernel. Don't forget to
134 <command>make modules_install</command> We will come back to the kernel in
135 the Configuring section below.
136 </para>
137
138 <indexterm zone="lm_sensors lm_sensors-kernel">
139 <primary sortas="d-lm_sensors">lm_sensors</primary>
140 </indexterm>
141 </sect2>
142
143 <sect2 role="installation">
144 <title>Installation of lm_sensors</title>
145
146 <para>
147 Install <application>lm_sensors</application> by running the following
148 commands:
149 </para>
150
151<screen><userinput>make PREFIX=/usr \
152 BUILD_STATIC_LIB=0 \
153 MANDIR=/usr/share/man</userinput></screen>
154
155 <para>
156 This package does not come with a test suite.
157 </para>
158
159 <para>
160 Now, as the <systemitem class="username">root</systemitem> user:
161 </para>
162
163<screen role="root"><userinput>make PREFIX=/usr \
164 BUILD_STATIC_LIB=0 \
165 MANDIR=/usr/share/man install &amp;&amp;
166
167install -v -dm755 /usr/share/doc/lm_sensors-&lm_sensors-version; &amp;&amp;
168cp -rv README INSTALL doc/* \
169 /usr/share/doc/lm_sensors-&lm_sensors-version;</userinput></screen>
170 </sect2>
171
172 <sect2 role="commands">
173 <title>Command Explanations</title>
174
175 <para>
176 <parameter>BUILD_STATIC_LIB=0</parameter>: This parameter disables
177 compiling and installing the static version of
178 <filename class="libraryfile">libsensors</filename>.
179 </para>
180
181 <para>
182 <parameter>PROG_EXTRA=sensord</parameter>: This parameter enables
183 compiling <command>sensord</command>, a daemon that can monitor your
184 system at regular intervals. Compiling <command>sensord</command> requires
185 <ulink url="http://oss.oetiker.ch/rrdtool/">RRDtool</ulink>. Compiling
186 RRDtool 1.4.6 requires a sed: <command>sed -i '/ sv_undef/d'
187 bindings/perl-shared/RRDs.xs</command>.
188 </para>
189
190 </sect2>
191
192 <sect2 role="configuration">
193 <title>Configuring Lm Sensors</title>
194
195 <sect3 id="lm_sensors-config">
196 <title>Config File</title>
197
198 <para>
199 <filename>/etc/sensors3.conf</filename>
200 </para>
201
202 <indexterm zone="lm_sensors lm_sensors-config">
203 <primary
204 sortas="e-etc-path-Configfilename2">/etc/sensors3.conf</primary>
205 </indexterm>
206
207 </sect3>
208
209 <sect3><title>Configuration Information</title>
210
211 <para>
212 To find out what hardware sensors your system has, issue the following
213 command as the <systemitem class="username">root</systemitem> user:
214 </para>
215
216<screen role="root"><userinput>sensors-detect</userinput></screen>
217
218 <para>
219 The appropriate modules should have been loaded and a summary is
220 displayed at the end. Now you know what is needed and you can recompile
221 your kernel to enable just the options you need (i.e., don't enable the
222 modules you cannot use).
223 </para>
224
225 </sect3>
226
227 </sect2>
228
229 <sect2 role="content">
230 <title>Contents</title>
231
232 <segmentedlist>
233 <segtitle>Installed Programs</segtitle>
234 <segtitle>Installed Library</segtitle>
235 <segtitle>Installed Directories</segtitle>
236
237 <seglistitem>
238 <seg>
239 fancontrol, isadump, isaset, pwmconfig, sensors, sensors-conf-convert,
240 sensors-detect, and optionally, sensord
241 </seg>
242 <seg>
243 libsensors.so
244 </seg>
245 <seg>
246 /etc/sensors.d,
247 /usr/include/sensors and
248 /usr/share/doc/lm_sensors-&lm_sensors-version;
249 </seg>
250 </seglistitem>
251 </segmentedlist>
252
253 <variablelist>
254 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
255 <?dbfo list-presentation="list"?>
256 <?dbhtml list-presentation="table"?>
257
258 <varlistentry id="fancontrol">
259 <term><command>fancontrol</command></term>
260 <listitem>
261 <para>
262 is a shell script for use with <application>lm_sensors</application>.
263 It reads its configuration from a file<!--what file?-->, then
264 calculates fan speeds from temperatures and sets the corresponding
265 PWM outputs to the computed values.
266 </para>
267 <indexterm zone="lm_sensors fancontrol">
268 <primary sortas="b-fancontrol">fancontrol</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272
273 <varlistentry id="isadump">
274 <term><command>isadump</command></term>
275 <listitem>
276 <para>
277 is a small helper program to examine registers visible through the
278 ISA bus. It is intended to probe any chip that lives on the ISA bus
279 working with an address register and a data register (I2C-like
280 access) or a flat range (of up to 256 bytes).
281 </para>
282 <indexterm zone="lm_sensors isadump">
283 <primary sortas="b-isadump">isadump</primary>
284 </indexterm>
285 </listitem>
286 </varlistentry>
287
288 <varlistentry id="isaset">
289 <term><command>isaset</command></term>
290 <listitem>
291 <para>
292 is a small helper program to set registers visible through the ISA
293 bus.
294 </para>
295 <indexterm zone="lm_sensors isaset">
296 <primary sortas="b-isaset">isaset</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="pwmconfig">
302 <term><command>pwmconfig</command></term>
303 <listitem>
304 <para>
305 tests the pulse width modulation (PWM) outputs of sensors and
306 configures fancontrol.
307 </para>
308 <indexterm zone="lm_sensors pwmconfig">
309 <primary sortas="b-pwmconfig">pwmconfig</primary>
310 </indexterm>
311 </listitem>
312 </varlistentry>
313
314 <varlistentry id="sensors">
315 <term><command>sensors</command></term>
316 <listitem>
317 <para>
318 prints the current readings of all sensor chips.
319 </para>
320 <indexterm zone="lm_sensors sensors">
321 <primary sortas="b-sensors">sensors</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325
326 <varlistentry id="sensors-conf-convert">
327 <term><command>sensors-conf-convert</command></term>
328 <listitem>
329 <para>
330 is a <application>Perl</application> script to convert
331 <application>lm-sensors</application> version 2 configuration files
332 to work with version 3.
333 </para>
334 <indexterm zone="lm_sensors sensors-conf-convert">
335 <primary sortas="b-sensors-conf-convert">sensors-conf-convert</primary>
336 </indexterm>
337 </listitem>
338 </varlistentry>
339
340 <varlistentry id="sensors-detect">
341 <term><command>sensors-detect</command></term>
342 <listitem>
343 <para>
344 is a <application>Perl</application> script that will walk you
345 through the process of scanning your system for various hardware
346 monitoring chips (sensors) supported by
347 <filename class="libraryfile">libsensors</filename>, or more
348 generally by the <application>lm_sensors</application> tool suite.
349 </para>
350 <indexterm zone="lm_sensors sensors-detect">
351 <primary sortas="b-sensors-detect">sensors-detect</primary>
352 </indexterm>
353 </listitem>
354 </varlistentry>
355
356 <varlistentry id="sensord">
357 <term><command>sensord</command></term>
358 <listitem>
359 <para>
360 (optional) is a daemon that can be used to periodically log sensor
361 readings.
362 </para>
363 <indexterm zone="lm_sensors sensord">
364 <primary sortas="b-sensord">sensord</primary>
365 </indexterm>
366 </listitem>
367 </varlistentry>
368
369 <varlistentry id="libsensors">
370 <term><filename class="libraryfile">libsensors.so</filename></term>
371 <listitem>
372 <para>
373 contains the <application>lm_sensors</application> API functions.
374 </para>
375 <indexterm zone="lm_sensors libsensors">
376 <primary sortas="c-libsensors">libsensors.so</primary>
377 </indexterm>
378 </listitem>
379 </varlistentry>
380
381 </variablelist>
382
383 </sect2>
384
385</sect1>
Note: See TracBrowser for help on using the repository browser.