Merge tag 'upstream/1.2.0'
[psensor-pkg-debian.git] / doc / faq.txt
index 1de2f69..12c8a4f 100644 (file)
@@ -1,5 +1,5 @@
-Psensor Frequently Asked Questions
-==================================
+Psensor Frequently Asked Questions
+:docinfo2:
 
 The last version of this FAQ is available at http://wpitchoune.net/gitweb/?p=psensor.git;a=blob_plain;f=doc/faq.html;hb=HEAD.
 
@@ -7,7 +7,8 @@ The last version of this FAQ is available at http://wpitchoune.net/gitweb/?p=pse
 No sensors or only cpu usage is displayed
 -----------------------------------------
 
-Psensor is relying on few libraries or softwares for retrieving the information about the computer:
+Psensor is relying on few libraries or softwares for retrieving the
+information about the computer:
 
        - motherboard and CPUs sensors: the information is retrieved
           from the lm-sensors library, it requires that
@@ -29,11 +30,17 @@ Psensor is relying on few libraries or softwares for retrieving the information
                   note: it requires that you are using a Psensor
                   binary compiled with the ATI support.
 
-       - HDDs: it uses the hddtemp daemon. Verify that it is
-          correctly reporting temperature by using the command: +sudo
-          hddtemp /dev/sda+. If hddtemp does not support your disk,
-          you may want to try using the libatasmart support instead
-          (option +--use-libatasmart+).
+For hard disk drives, psensor can use:
+
+    - udisks2: added since 1.1.2 release. It is the default and
+      recommended provider.
+   
+    - hddtemp: verify that it is correctly reporting temperature by
+      using the command: +sudo hddtemp /dev/sda+. It is the default
+      provider until 1.1.2 release.
+
+    - atasmart library: before the 1.1.2 release it can be enabled
+      by using the command line option +--use-libatasmart+.
 
 If the underlying software is reporting sensors which are not
 displayed by Psensor, it is probably a bug in Psensor, so please
@@ -41,6 +48,9 @@ report it. Otherwise, the issue is on the underlying software itself
 and you should contact the corresponding development team or refer to
 its documentation.
 
+Since the release 1.1.2, the providers can be enabled or disabled directly
+from the user interface (+Preferences>Provider+).
+
 [[S_ATIMonitoring]]
 How to monitor an ATI card using the Catalyst driver?
 -----------------------------------------------------
@@ -121,8 +131,7 @@ repositories.
 If you don’t want to use the launchpad, you can send the report by
 email to:
 
-      - psensor-users@googlegroups.com (require registration at:
-        https://groups.google.com/forum/?fromgroups&hl=en#!forum/psensor-users)
+      - psensor-users@googlegroups.com
       - or jeanfi@gmail.com.
 
 If the bug is concerning Debian or Ubuntu derivatives distribution,
@@ -139,9 +148,8 @@ How to send ideas, questions or comments?
 Check the FAQ or the TODO pages.
 
 If you don’t find the information, you can send an email to the public
-mailing-list psensor-users@googlegroups.com (require registration at:
-https://groups.google.com/forum/?fromgroups&hl=en#!forum/psensor-users) 
-or send an email directly to me: jeanfi@gmail.com.
+mailing-list psensor-users@googlegroups.com or directly to me:
+jeanfi@gmail.com.
        
 
 [[S_Contribute]]
@@ -208,7 +216,8 @@ the output of the different commands like +sensors+.
 Anyway, as I received several requests about such feature, since the
 0.7.0.4 release it is implemented in both psensor ( menu preferences >
 sensors > enable log of measures) and psensor-server
-(+--sensor-log-file+ option).
+(+--sensor-log-file+ option). For psensor the log file is
++$HOME/.psensor/sensors.log+.
 
 [[S_NO_GRAPH_DISPLAYED]]
 
@@ -232,11 +241,11 @@ http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG
 specification].
 
 [[S_disk]]
-How to monitor the temperature of a disk?
------------------------------------------
+How to monitor the temperature of a disk with +hddtemp+?
+--------------------------------------------------------
 
-By default, Psensor is using +hddtemp+ to retrieve the temperature of
-the disks.
+Until the release 1.1.2, Psensor is using +hddtemp+ by default to
+retrieve the temperature of the disks.
 
 If +hddtemp+ is installed but no disk temperature is reported, check
 that the daemon is running by using for example the command +ps
@@ -247,16 +256,24 @@ It should output something like:
 root      1433     1  0 May28 ?        00:00:21 /usr/sbin/hddtemp -d -l 127.0.0.1 -p 7634 -s | /dev/sdb
 ---------------------
 
-Since recent Ubuntu releases, installing the +hddtemp+ package is not
-enough, it is required to manually allow the +hddtemp+ daemon. Edit the
-file +/etc/default/hddtemp+ and set +RUN_DAEMON+ to +"true"+.
+Depending on the Linux distribution, the installation of the +hddtemp+
+package does not enable the hddtemp daemon automaticaly.
+
+In this case, edit the file +/etc/default/hddtemp+ and set
++RUN_DAEMON+ to +"true"+. After edition, it should contain the
+following line:
 
 ------------------
-# hddtemp network daemon switch. If set to true, hddtemp will listen
-# for incoming connections.
 RUN_DAEMON="true"
 ------------------
 
+For Debian/Ubuntu, you can use at root:
+------------------
+dpkg-reconfigure hddtemp
+------------------
+
+and reply +yes+ when asked whether hddtemp daemon must be
+run during the startup.
 
 [[S_SimilarSoft]]
 Is there any other similar softwares?
@@ -272,3 +289,14 @@ Here is a list of few well-known sensors monitoring softwares:
 
        - more general, but can be configured to display sensors
           information: http://conky.sourceforge.net/
+
+[[S_HideSensor]]
+Is it possible to hide sensors in the main window?
+--------------------------------------------------
+
+Before v1.1.1, the sensors retrieved from the lm-sensor library can be
+ignored directly in the lm-sensor configuration. See the manpage
+of sensors.conf(5).
+
+Since v1.1.1, it is possible to hide a sensor, uncheck the setting
+'Display sensor in the list of sensors' in the sensor preferences.