Fixed restoration of the panel divider position.
[psensor.git] / doc / faq.txt
index 048c679..cc4c714 100644 (file)
@@ -1,5 +1,6 @@
-Psensor Frequently Asked Questions
-==================================
+= Psensor Frequently Asked Questions
+:docinfo2:
+:toc:
 
 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.
 
 
 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 +8,8 @@ The last version of this FAQ is available at http://wpitchoune.net/gitweb/?p=pse
 No sensors or only cpu usage is displayed
 -----------------------------------------
 
 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
 
        - motherboard and CPUs sensors: the information is retrieved
           from the lm-sensors library, it requires that
@@ -29,11 +31,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.
 
                   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
 
 If the underlying software is reporting sensors which are not
 displayed by Psensor, it is probably a bug in Psensor, so please
@@ -41,6 +49,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.
 
 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?
 -----------------------------------------------------
 [[S_ATIMonitoring]]
 How to monitor an ATI card using the Catalyst driver?
 -----------------------------------------------------
@@ -121,8 +132,7 @@ repositories.
 If you don’t want to use the launchpad, you can send the report by
 email to:
 
 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,
       - or jeanfi@gmail.com.
 
 If the bug is concerning Debian or Ubuntu derivatives distribution,
@@ -139,9 +149,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
 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]]
        
 
 [[S_Contribute]]
@@ -208,7 +217,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
 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]]
 
 
 [[S_NO_GRAPH_DISPLAYED]]
 
@@ -227,6 +237,45 @@ Since the version 1.0.1, Psensor is no more started automaticaly by default.
 Open the +Preferences+ window, select the +Startup+ tab and switch on
 the option +Launch on session startup+.
 
 Open the +Preferences+ window, select the +Startup+ tab and switch on
 the option +Launch on session startup+.
 
+This feature is requiring that the Desktop Environment supports the
+http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG
+specification].
+
+[[S_disk]]
+How to monitor the temperature of a disk with +hddtemp+?
+--------------------------------------------------------
+
+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
+-eaf|grep hddtemp+.
+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
+---------------------
+
+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:
+
+------------------
+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?
 -------------------------------------
 [[S_SimilarSoft]]
 Is there any other similar softwares?
 -------------------------------------
@@ -241,3 +290,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/
 
        - 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.