add trick to change the windows manager
[www.git] / www / psensor / faq.html
1 <!DOCTYPE html>
2 <html lang="en">
3 <head>
4 <meta charset="UTF-8">
5 <!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
6 <meta name="viewport" content="width=device-width, initial-scale=1.0">
7 <meta name="generator" content="Asciidoctor 1.5.4">
8 <title>Psensor Frequently Asked Questions</title>
9 <link rel="stylesheet" href="./../style.css">
10 <script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
11 <script src="nav.js"></script>
12 <script src="https://apis.google.com/js/platform.js" async defer>
13 </script>
14 </head>
15 <body class="article">
16 <div id="header">
17 <h1>Psensor Frequently Asked Questions</h1>
18 <div id="toc" class="toc">
19 <div id="toctitle">Table of Contents</div>
20 <ul class="sectlevel1">
21 <li><a href="#S_NoSensors">No sensors or only cpu usage is displayed</a></li>
22 <li><a href="#S_ATIMonitoring">How to monitor an ATI card using the Catalyst driver?</a></li>
23 <li><a href="#S_WrongTemperature">The reported temperature is obviously wrong</a></li>
24 <li><a href="#S_WhatIsTheSensor">What is the sensors XXXX?</a></li>
25 <li><a href="#S_BugReport">How to report a bug?</a></li>
26 <li><a href="#S_SubmitIdea">How to send ideas, questions or comments?</a></li>
27 <li><a href="#S_Contribute">How to contribute?</a></li>
28 <li><a href="#S_UbuntuInstall">How to install Psensor on Ubuntu?</a></li>
29 <li><a href="#S_DebianInstall">How to install Psensor on Debian?</a></li>
30 <li><a href="#S_PPA">What is the difference between the 3 Ubuntu PPAs?</a></li>
31 <li><a href="#S_ArchLinuxInstall">How to install Psensor on ArchLinux?</a></li>
32 <li><a href="#S_OtherInstall">How to install Psensor on my Linux distribution?</a></li>
33 <li><a href="#S_LOG">How to log sensors temperatures?</a></li>
34 <li><a href="#S_NO_GRAPH_DISPLAYED">No graphs are displayed, but the table of the main window is displaying sensors</a></li>
35 <li><a href="#S_autostart">Launch Psensor automaticaly on session startup</a></li>
36 <li><a href="#S_disk">How to monitor the temperature of a disk with hddtemp?</a></li>
37 <li><a href="#S_SimilarSoft">Is there any other similar softwares?</a></li>
38 <li><a href="#S_HideSensor">Is it possible to hide sensors in the main window?</a></li>
39 </ul>
40 </div>
41 </div>
42 <div id="content">
43 <div id="preamble">
44 <div class="sectionbody">
45 <div class="paragraph">
46 <p>The last version of this FAQ is available at <a href="http://wpitchoune.net/gitweb/?p=psensor.git;a=blob_plain;f=doc/faq.html;hb=HEAD" class="bare">http://wpitchoune.net/gitweb/?p=psensor.git;a=blob_plain;f=doc/faq.html;hb=HEAD</a>.</p>
47 </div>
48 </div>
49 </div>
50 <div class="sect1">
51 <h2 id="S_NoSensors">No sensors or only cpu usage is displayed</h2>
52 <div class="sectionbody">
53 <div class="paragraph">
54 <p>Psensor is relying on few libraries or softwares for retrieving the
55 information about the computer:</p>
56 </div>
57 <div class="ulist">
58 <ul>
59 <li>
60 <p>motherboard and CPUs sensors: the information is retrieved
61 from the lm-sensors library, it requires that
62 sensors-detect has been run and the kernel module
63 correctly installed. sensors can be used for checking.</p>
64 </li>
65 <li>
66 <p>GPUs: it depends on which driver you are using:</p>
67 <div class="ulist">
68 <ul>
69 <li>
70 <p>Opensource drivers (nouveau for Nvidia GPUs or
71 radeon/ati for ATI GPUs) is used and support sensor
72 monitoring for your GPU, the information is using
73 lm-sensors, same steps than above.</p>
74 </li>
75 <li>
76 <p>proprietary driver Nvidia: run nvidia-settings to
77 check that it supports sensors monitoring.</p>
78 </li>
79 <li>
80 <p>proprietary driver Catalyst/fglx: use aticonfig to
81 check that it supports sensors monitoring. Important
82 note: it requires that you are using a Psensor
83 binary compiled with the ATI support.</p>
84 </li>
85 </ul>
86 </div>
87 </li>
88 </ul>
89 </div>
90 <div class="paragraph">
91 <p>For hard disk drives, psensor can use:</p>
92 </div>
93 <div class="ulist">
94 <ul>
95 <li>
96 <p>udisks2: added since 1.1.2 release. It is the default and
97 recommended provider.</p>
98 </li>
99 <li>
100 <p>hddtemp: verify that it is correctly reporting temperature by
101 using the command: sudo hddtemp /dev/sda. It is the default
102 provider until 1.1.2 release.</p>
103 </li>
104 <li>
105 <p>atasmart library: before the 1.1.2 release it can be enabled
106 by using the command line option --use-libatasmart.</p>
107 </li>
108 </ul>
109 </div>
110 <div class="paragraph">
111 <p>If the underlying software is reporting sensors which are not
112 displayed by Psensor, it is probably a bug in Psensor, so please
113 report it. Otherwise, the issue is on the underlying software itself
114 and you should contact the corresponding development team or refer to
115 its documentation.</p>
116 </div>
117 <div class="paragraph">
118 <p>Since the release 1.1.2, the providers can be enabled or disabled directly
119 from the user interface (Preferences&gt;Provider).</p>
120 </div>
121 </div>
122 </div>
123 <div class="sect1">
124 <h2 id="S_ATIMonitoring">How to monitor an ATI card using the Catalyst driver?</h2>
125 <div class="sectionbody">
126 <div class="paragraph">
127 <p>For monitoring ATI card using the proprietary Catalyst driver, Psensor
128 must be compiled with a proprietary library which is not packaged in
129 any Linux distribution.</p>
130 </div>
131 <div class="paragraph">
132 <p>Unfortunely, due to the license of this library, I cannot provide a
133 compiled version of Psensor, even in a Ubuntu PPA or Ubuntu/Debian
134 standard repositories. You have to compile Psensor sensor. You can
135 find the instructions in the section ATI/AMD GPU Support of the
136 README file available in the Psensor source archives.</p>
137 </div>
138 <div class="paragraph">
139 <p>If you are using the ATI OpenSource driver, it is not needed to
140 compile Psensor with this proprietary library.</p>
141 </div>
142 </div>
143 </div>
144 <div class="sect1">
145 <h2 id="S_WrongTemperature">The reported temperature is obviously wrong</h2>
146 <div class="sectionbody">
147 <div class="paragraph">
148 <p>If the reported temperature is obviously wrong (never change, lower
149 than the ambiant temperature, negative, higher than the sun
150 temperature, etc):</p>
151 </div>
152 <div class="ulist">
153 <ul>
154 <li>
155 <p>most of the time it is not a bug in Psensor nor in the
156 underlying monitoring libraries:</p>
157 <div class="ulist">
158 <ul>
159 <li>
160 <p>if the temperature does not change, it might be due
161 to an existent sensor not wired by the hardware
162 manufacturer.</p>
163 </li>
164 <li>
165 <p>the goal of the sensor is to allow the system to
166 detect critical temperature and NOT to report an
167 exact temperature. Most sensors report a relative
168 temperature. The more it differs from the critical
169 temperature , the more it is wrong.</p>
170 </li>
171 </ul>
172 </div>
173 </li>
174 <li>
175 <p>It is only a bug in Psensor if the underlying libraries
176 report a different information than Psensor (use the
177 appropriate command or software: sensors, aticonfig or
178 hddtemp to check). In this case, please report a bug.</p>
179 </li>
180 </ul>
181 </div>
182 </div>
183 </div>
184 <div class="sect1">
185 <h2 id="S_WhatIsTheSensor">What is the sensors XXXX?</h2>
186 <div class="sectionbody">
187 <div class="paragraph">
188 <p>Since Psensor v0.7.0.4, open the preferences of the sensor (click on
189 its name in the main window and select the menu item Preferences), and
190 look at the Chip field.</p>
191 </div>
192 <div class="paragraph">
193 <p>For older Psensor releases, look at the Id field, if the string is
194 starting with:</p>
195 </div>
196 <div class="ulist">
197 <ul>
198 <li>
199 <p>lmsensor coretemp: Intel CPU.</p>
200 </li>
201 <li>
202 <p>lmsensor k10temp, lmsensor k8temp, lmsensor fam15h_power: AMD CPU.</p>
203 </li>
204 <li>
205 <p>nvidia or lmsensor nouveau: NVIDIA GPU.</p>
206 </li>
207 <li>
208 <p>hdd: hard disk drive.</p>
209 </li>
210 <li>
211 <p>amd: AMD GPU.</p>
212 </li>
213 <li>
214 <p>lmsensor C B: C is the name of the chip, B the name of the adapter.</p>
215 </li>
216 </ul>
217 </div>
218 <div class="paragraph">
219 <p>For more information about lmsensor devices, see
220 <a href="http://lm-sensors.org/wiki/Devices" class="bare">http://lm-sensors.org/wiki/Devices</a>.</p>
221 </div>
222 </div>
223 </div>
224 <div class="sect1">
225 <h2 id="S_BugReport">How to report a bug?</h2>
226 <div class="sectionbody">
227 <div class="paragraph">
228 <p>Please use <a href="https://bugs.launchpad.net/psensor/+filebug" class="bare">https://bugs.launchpad.net/psensor/+filebug</a> to report bugs
229 even if it can only reproduced with a non-Ubuntu distribution or a
230 release not available in the standard Ubuntu repositories.</p>
231 </div>
232 <div class="paragraph">
233 <p>You can also use
234 <a href="https://bugs.launchpad.net/ubuntu/+source/psensor/+filebug" class="bare">https://bugs.launchpad.net/ubuntu/+source/psensor/+filebug</a> if the bug
235 can be reproduced with a package from the standard Ubuntu
236 repositories.</p>
237 </div>
238 <div class="paragraph">
239 <p>If you don’t want to use the launchpad, you can send the report by
240 email to:</p>
241 </div>
242 <div class="ulist">
243 <ul>
244 <li>
245 <p><a href="mailto:psensor-users@googlegroups.com">psensor-users@googlegroups.com</a></p>
246 </li>
247 <li>
248 <p>or <a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a>.</p>
249 </li>
250 </ul>
251 </div>
252 <div class="paragraph">
253 <p>If the bug is concerning Debian or Ubuntu derivatives distribution,
254 please add in its description the output of the command: apt-cache
255 policy psensor.</p>
256 </div>
257 <div class="paragraph">
258 <p>If it is related to the Psensor source compilation, please add the
259 full output of the configure command.</p>
260 </div>
261 </div>
262 </div>
263 <div class="sect1">
264 <h2 id="S_SubmitIdea">How to send ideas, questions or comments?</h2>
265 <div class="sectionbody">
266 <div class="paragraph">
267 <p>Check the FAQ or the TODO pages.</p>
268 </div>
269 <div class="paragraph">
270 <p>If you don’t find the information, you can send an email to the public
271 mailing-list <a href="mailto:psensor-users@googlegroups.com">psensor-users@googlegroups.com</a> or directly to me:
272 <a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a>.</p>
273 </div>
274 </div>
275 </div>
276 <div class="sect1">
277 <h2 id="S_Contribute">How to contribute?</h2>
278 <div class="sectionbody">
279 <div class="paragraph">
280 <p>See <a href="http://wpitchoune.net/blog/psensor/how-to-contribute/" class="bare">http://wpitchoune.net/blog/psensor/how-to-contribute/</a>.</p>
281 </div>
282 </div>
283 </div>
284 <div class="sect1">
285 <h2 id="S_UbuntuInstall">How to install Psensor on Ubuntu?</h2>
286 <div class="sectionbody">
287 <div class="paragraph">
288 <p>Psensor is in the official repository, search psensor in the
289 software center and install it. More information at:
290 <a href="http://wpitchoune.net/blog/psensor/ubuntu-integration/" class="bare">http://wpitchoune.net/blog/psensor/ubuntu-integration/</a>.</p>
291 </div>
292 </div>
293 </div>
294 <div class="sect1">
295 <h2 id="S_DebianInstall">How to install Psensor on Debian?</h2>
296 <div class="sectionbody">
297 <div class="paragraph">
298 <p>Psensor is in the official repository since Debian 7.0. You can get
299 the last packaged version from the sid repository. More information
300 at: <a href="http://packages.qa.debian.org/p/psensor.html" class="bare">http://packages.qa.debian.org/p/psensor.html</a>.</p>
301 </div>
302 </div>
303 </div>
304 <div class="sect1">
305 <h2 id="S_PPA">What is the difference between the 3 Ubuntu PPAs?</h2>
306 <div class="sectionbody">
307 <div class="ulist">
308 <ul>
309 <li>
310 <p>ppa:jfi/ppa: last stable version.</p>
311 </li>
312 <li>
313 <p>ppa:jfi/psensor-unstable: last development version, no
314 major bug is expected.</p>
315 </li>
316 <li>
317 <p>ppa:jfi/psensor-daily-trunk: build each day directly from
318 the GIT source repository. It may contain major bugs or
319 incomplete features. Useful for contributors or testing
320 whether a bug is fixed.</p>
321 </li>
322 </ul>
323 </div>
324 </div>
325 </div>
326 <div class="sect1">
327 <h2 id="S_ArchLinuxInstall">How to install Psensor on ArchLinux?</h2>
328 <div class="sectionbody">
329 <div class="paragraph">
330 <p>See <a href="http://aur.archlinux.org/packages.php?ID=37807" class="bare">http://aur.archlinux.org/packages.php?ID=37807</a>.</p>
331 </div>
332 </div>
333 </div>
334 <div class="sect1">
335 <h2 id="S_OtherInstall">How to install Psensor on my Linux distribution?</h2>
336 <div class="sectionbody">
337 <div class="paragraph">
338 <p>Psensor packages are available in the standard repositories of Ubuntu
339 (since Oneiric) and Debian (since v7) distributions.</p>
340 </div>
341 <div class="paragraph">
342 <p>For other distributions, you will find the compilation and
343 installation instructions in the section Installation from source
344 archive in the README file of the source archive. Psensor should
345 compile in any modern distribution.</p>
346 </div>
347 </div>
348 </div>
349 <div class="sect1">
350 <h2 id="S_LOG">How to log sensors temperatures?</h2>
351 <div class="sectionbody">
352 <div class="paragraph">
353 <p>The best way is probably to use sensord or a custom script based on
354 the output of the different commands like sensors.</p>
355 </div>
356 <div class="paragraph">
357 <p>Anyway, as I received several requests about such feature, since the
358 0.7.0.4 release it is implemented in both psensor ( menu preferences &gt;
359 sensors &gt; enable log of measures) and psensor-server
360 (--sensor-log-file option). For psensor the log file is
361 $HOME/.psensor/sensors.log.</p>
362 </div>
363 </div>
364 </div>
365 <div class="sect1">
366 <h2 id="S_NO_GRAPH_DISPLAYED">No graphs are displayed, but the table of the main window is displaying sensors</h2>
367 <div class="sectionbody">
368 <div class="paragraph">
369 <p>In the sensors table of the main window, switch on the checkbox of the last
370 column (named Enabled or Graph depending on the Psensor version).</p>
371 </div>
372 </div>
373 </div>
374 <div class="sect1">
375 <h2 id="S_autostart">Launch Psensor automaticaly on session startup</h2>
376 <div class="sectionbody">
377 <div class="paragraph">
378 <p>Since the version 1.0.1, Psensor is no more started automaticaly by default.</p>
379 </div>
380 <div class="paragraph">
381 <p>Open the Preferences window, select the Startup tab and switch on
382 the option Launch on session startup.</p>
383 </div>
384 <div class="paragraph">
385 <p>This feature is requiring that the Desktop Environment supports the
386 <a href="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">XDG
387 specification</a>.</p>
388 </div>
389 </div>
390 </div>
391 <div class="sect1">
392 <h2 id="S_disk">How to monitor the temperature of a disk with hddtemp?</h2>
393 <div class="sectionbody">
394 <div class="paragraph">
395 <p>Until the release 1.1.2, Psensor is using hddtemp by default to
396 retrieve the temperature of the disks.</p>
397 </div>
398 <div class="paragraph">
399 <p>If hddtemp is installed but no disk temperature is reported, check
400 that the daemon is running by using for example the command ps
401 -eaf|grep hddtemp.
402 It should output something like:</p>
403 </div>
404 <div class="listingblock">
405 <div class="content">
406 <pre>root      1433     1  0 May28 ?        00:00:21 /usr/sbin/hddtemp -d -l 127.0.0.1 -p 7634 -s | /dev/sdb</pre>
407 </div>
408 </div>
409 <div class="paragraph">
410 <p>Depending on the Linux distribution, the installation of the hddtemp
411 package does not enable the hddtemp daemon automaticaly.</p>
412 </div>
413 <div class="paragraph">
414 <p>In this case, edit the file /etc/default/hddtemp and set
415 RUN_DAEMON to "true". After edition, it should contain the
416 following line:</p>
417 </div>
418 <div class="listingblock">
419 <div class="content">
420 <pre>RUN_DAEMON="true"</pre>
421 </div>
422 </div>
423 <div class="paragraph">
424 <p>For Debian/Ubuntu, you can use at root:</p>
425 </div>
426 <div class="listingblock">
427 <div class="content">
428 <pre>dpkg-reconfigure hddtemp</pre>
429 </div>
430 </div>
431 <div class="paragraph">
432 <p>and reply yes when asked whether hddtemp daemon must be
433 run during the startup.</p>
434 </div>
435 </div>
436 </div>
437 <div class="sect1">
438 <h2 id="S_SimilarSoft">Is there any other similar softwares?</h2>
439 <div class="sectionbody">
440 <div class="paragraph">
441 <p>Here is a list of few well-known sensors monitoring softwares:</p>
442 </div>
443 <div class="ulist">
444 <ul>
445 <li>
446 <p>for X11: <a href="http://freecode.com/projects/xsensors" class="bare">http://freecode.com/projects/xsensors</a></p>
447 </li>
448 <li>
449 <p>for GNOME2: <a href="http://sensors-applet.sourceforge.net/" class="bare">http://sensors-applet.sourceforge.net/</a></p>
450 </li>
451 <li>
452 <p>for Ubuntu Unity: <a href="https://launchpad.net/indicator-sensors" class="bare">https://launchpad.net/indicator-sensors</a></p>
453 </li>
454 <li>
455 <p>more general, but can be configured to display sensors
456 information: <a href="http://conky.sourceforge.net/" class="bare">http://conky.sourceforge.net/</a></p>
457 </li>
458 </ul>
459 </div>
460 </div>
461 </div>
462 <div class="sect1">
463 <h2 id="S_HideSensor">Is it possible to hide sensors in the main window?</h2>
464 <div class="sectionbody">
465 <div class="paragraph">
466 <p>Before v1.1.1, the sensors retrieved from the lm-sensor library can be
467 ignored directly in the lm-sensor configuration. See the manpage
468 of sensors.conf(5).</p>
469 </div>
470 <div class="paragraph">
471 <p>Since v1.1.1, it is possible to hide a sensor, uncheck the setting
472 'Display sensor in the list of sensors' in the sensor preferences.</p>
473 </div>
474 </div>
475 </div>
476 </div>
477 <div id="footer">
478 <div id="footer-text">
479 Last updated 2017-02-04 23:14:51 CET
480 </div>
481 </div>
482 </body>
483 </html>