doc/faq.txt

   1 Psensor Frequently Asked Questions
   2 ==================================
   3
   4 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.
   5
   6 [[S_NoSensors]]
   7 No sensors or only cpu usage is displayed
   8 -----------------------------------------
   9
  10 Psensor is relying on few libraries or softwares for retrieving the
  11 information about the computer:
  12
  13         - motherboard and CPUs sensors: the information is retrieved
  14           from the lm-sensors library, it requires that
  15           +sensors-detect+ has been run and the kernel module
  16           correctly installed. +sensors+ can be used for checking.
  17
  18         - GPUs: it depends on which driver you are using:
  19
  20                 * Opensource drivers (nouveau for Nvidia GPUs or
  21                   radeon/ati for ATI GPUs) is used and support sensor
  22                   monitoring for your GPU, the information is using
  23                   lm-sensors, same steps than above.
  24
  25                 * proprietary driver Nvidia: run +nvidia-settings+ to
  26                   check that it supports sensors monitoring.
  27
  28                 * proprietary driver Catalyst/fglx: use +aticonfig+ to
  29                   check that it supports sensors monitoring. Important
  30                   note: it requires that you are using a Psensor
  31                   binary compiled with the ATI support.
  32
  33 For hard disk drives, psensor can use:
  34
  35     - udisks2: added since 1.1.2 release. It is the default and
  36       recommended provider.
  37
  38     - hddtemp: verify that it is correctly reporting temperature by
  39       using the command: +sudo hddtemp /dev/sda+. It is the default
  40       provider until 1.1.2 release.
  41
  42     - atasmart library: before the 1.1.2 release it can be enabled
  43       by using the command line option +--use-libatasmart+.
  44
  45 If the underlying software is reporting sensors which are not
  46 displayed by Psensor, it is probably a bug in Psensor, so please
  47 report it. Otherwise, the issue is on the underlying software itself
  48 and you should contact the corresponding development team or refer to
  49 its documentation.
  50
  51 Since the release 1.1.2, the providers can be enabled or disabled directly
  52 from the user interface (+Preferences>Provider+).
  53
  54 [[S_ATIMonitoring]]
  55 How to monitor an ATI card using the Catalyst driver?
  56 -----------------------------------------------------
  57
  58 For monitoring ATI card using the proprietary Catalyst driver, Psensor
  59 must be compiled with a proprietary library which is not packaged in
  60 any Linux distribution.
  61
  62 Unfortunely, due to the license of this library, I cannot provide a
  63 compiled version of Psensor, even in a Ubuntu PPA or Ubuntu/Debian
  64 standard repositories. You have to compile Psensor sensor. You can
  65 find the instructions in the section +ATI/AMD GPU Support+ of the
  66 README file available in the Psensor source archives.
  67
  68 If you are using the ATI OpenSource driver, it is not needed to
  69 compile Psensor with this proprietary library.
  70
  71 [[S_WrongTemperature]]
  72 The reported temperature is obviously wrong
  73 -------------------------------------------
  74
  75 If the reported temperature is obviously wrong (never change, lower
  76 than the ambiant temperature, negative, higher than the sun
  77 temperature, etc):
  78
  79         - most of the time it is not a bug in Psensor nor in the
  80           underlying monitoring libraries:
  81
  82                 * if the temperature does not change, it might be due
  83                   to an existent sensor not wired by the hardware
  84                   manufacturer.
  85
  86                 * the goal of the sensor is to allow the system to
  87                   detect critical temperature and NOT to report an
  88                   exact temperature. Most sensors report a relative
  89                   temperature. The more it differs from the critical
  90                   temperature , the more it is wrong.
  91
  92         - It is only a bug in Psensor if the underlying libraries
  93           report a different information than Psensor (use the
  94           appropriate command or software: +sensors+, +aticonfig+ or
  95           +hddtemp+ to check). In this case, please report a bug.
  96
  97 [[S_WhatIsTheSensor]]
  98 What is the sensors XXXX?
  99 -------------------------
 100
 101 Since Psensor v0.7.0.4, open the preferences of the sensor (click on
 102 its name in the main window and select the menu item Preferences), and
 103 look at the Chip field.
 104
 105 For older Psensor releases, look at the Id field, if the string is
 106 starting with:
 107
 108         - +lmsensor coretemp+: Intel CPU.
 109         - +lmsensor k10temp+, +lmsensor k8temp+, +lmsensor fam15h_power+: AMD CPU.
 110         - +nvidia+ or +lmsensor nouveau+: NVIDIA GPU.
 111         - +hdd+: hard disk drive.
 112         - +amd+: AMD GPU.
 113         - +lmsensor C B+: C is the name of the chip, B the name of the adapter.
 114
 115 For more information about lmsensor devices, see
 116 http://lm-sensors.org/wiki/Devices.
 117
 118 [[S_BugReport]]
 119 How to report a bug?
 120 --------------------
 121
 122 Please use https://bugs.launchpad.net/psensor/+filebug to report bugs
 123 even if it can only reproduced with a non-Ubuntu distribution or a
 124 release not available in the standard Ubuntu repositories.
 125
 126 You can also use
 127 https://bugs.launchpad.net/ubuntu/+source/psensor/+filebug if the bug
 128 can be reproduced with a package from the standard Ubuntu
 129 repositories.
 130
 131 If you don’t want to use the launchpad, you can send the report by
 132 email to:
 133
 134       - psensor-users@googlegroups.com
 135       - or jeanfi@gmail.com.
 136
 137 If the bug is concerning Debian or Ubuntu derivatives distribution,
 138 please add in its description the output of the command: +apt-cache
 139 policy psensor+.
 140
 141 If it is related to the Psensor source compilation, please add the
 142 full output of the +configure+ command.
 143
 144 [[S_SubmitIdea]]
 145 How to send ideas, questions or comments?
 146 -----------------------------------------
 147
 148 Check the FAQ or the TODO pages.
 149
 150 If you don’t find the information, you can send an email to the public
 151 mailing-list psensor-users@googlegroups.com or directly to me:
 152 jeanfi@gmail.com.
 153
 154
 155 [[S_Contribute]]
 156 How to contribute?
 157 ------------------
 158
 159 See http://wpitchoune.net/blog/psensor/how-to-contribute/.
 160
 161 [[S_UbuntuInstall]]
 162 How to install Psensor on Ubuntu?
 163 ---------------------------------
 164
 165 Psensor is in the official repository, search +psensor+ in the
 166 software center and install it. More information at:
 167 http://wpitchoune.net/blog/psensor/ubuntu-integration/.
 168
 169 [[S_DebianInstall]]
 170 How to install Psensor on Debian?
 171 ---------------------------------
 172
 173 Psensor is in the official repository since Debian 7.0. You can get
 174 the last packaged version from the sid repository. More information
 175 at: http://packages.qa.debian.org/p/psensor.html.
 176
 177 [[S_PPA]]
 178 What is the difference between the 3 Ubuntu PPAs?
 179 -------------------------------------------------
 180
 181         - +ppa:jfi/ppa+: last stable version.
 182
 183         - +ppa:jfi/psensor-unstable+: last development version, no
 184           major bug is expected.
 185
 186         - +ppa:jfi/psensor-daily-trunk+: build each day directly from
 187           the GIT source repository. It may contain major bugs or
 188           incomplete features. Useful for contributors or testing
 189           whether a bug is fixed.
 190
 191 [[S_ArchLinuxInstall]]
 192 How to install Psensor on ArchLinux?
 193 ------------------------------------
 194
 195 See http://aur.archlinux.org/packages.php?ID=37807.
 196
 197 [[S_OtherInstall]]
 198 How to install Psensor on my Linux distribution?
 199 ------------------------------------------------
 200
 201 Psensor packages are available in the standard repositories of Ubuntu
 202 (since Oneiric) and Debian (since v7) distributions.
 203
 204 For other distributions, you will find the compilation and
 205 installation instructions in the section +Installation from source
 206 archive+ in the README file of the source archive. Psensor should
 207 compile in any modern distribution.
 208
 209 [[S_LOG]]
 210 How to log sensors temperatures?
 211 --------------------------------
 212
 213 The best way is probably to use sensord or a custom script based on
 214 the output of the different commands like +sensors+.
 215
 216 Anyway, as I received several requests about such feature, since the
 217 0.7.0.4 release it is implemented in both psensor ( menu preferences >
 218 sensors > enable log of measures) and psensor-server
 219 (+--sensor-log-file+ option).
 220
 221 [[S_NO_GRAPH_DISPLAYED]]
 222
 223 No graphs are displayed, but the table of the main window is displaying sensors
 224 -------------------------------------------------------------------------------
 225
 226 In the sensors table of the main window, switch on the checkbox of the last
 227 column (named +Enabled+ or +Graph+ depending on the Psensor version).
 228
 229 [[S_autostart]]
 230 Launch Psensor automaticaly on session startup
 231 ----------------------------------------------
 232
 233 Since the version 1.0.1, Psensor is no more started automaticaly by default.
 234
 235 Open the +Preferences+ window, select the +Startup+ tab and switch on
 236 the option +Launch on session startup+.
 237
 238 This feature is requiring that the Desktop Environment supports the
 239 http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG
 240 specification].
 241
 242 [[S_disk]]
 243 How to monitor the temperature of a disk with +hddtemp+?
 244 -----------------------------------------
 245
 246 Until the release 1.1.2, Psensor is using +hddtemp+ by default to
 247 retrieve the temperature of the disks.
 248
 249 If +hddtemp+ is installed but no disk temperature is reported, check
 250 that the daemon is running by using for example the command +ps
 251 -eaf|grep hddtemp+.
 252 It should output something like:
 253
 254 ---------------------
 255 root      1433     1  0 May28 ?        00:00:21 /usr/sbin/hddtemp -d -l 127.0.0.1 -p 7634 -s | /dev/sdb
 256 ---------------------
 257
 258 Depending on the Linux distribution, the installation of the +hddtemp+
 259 package does not enable the hddtemp daemon automaticaly.
 260
 261 In this case, edit the file +/etc/default/hddtemp+ and set
 262 +RUN_DAEMON+ to +"true"+ like in the following example:
 263
 264 ------------------
 265 # hddtemp network daemon switch. If set to true, hddtemp will listen
 266 # for incoming connections.
 267 RUN_DAEMON="true"
 268 ------------------
 269
 270 For Debian/Ubuntu, you can use
 271 ------------------
 272 dpkg-reconfigure hddtemp
 273 ------------------
 274
 275 and reply +yes+ when asked whether hddtemp daemon must be
 276 run during the startup.
 277
 278 [[S_SimilarSoft]]
 279 Is there any other similar softwares?
 280 -------------------------------------
 281
 282 Here is a list of few well-known sensors monitoring softwares:
 283
 284         - for X11: http://freecode.com/projects/xsensors
 285
 286         - for GNOME2: http://sensors-applet.sourceforge.net/
 287
 288         - for Ubuntu Unity: https://launchpad.net/indicator-sensors
 289
 290         - more general, but can be configured to display sensors
 291           information: http://conky.sourceforge.net/
 292
 293 [[S_HideSensor]]
 294 Is it possible to hide sensors in the main window?
 295 --------------------------------------------------
 296
 297 Before v1.1.1, the sensors retrieved from the lm-sensor library can be
 298 ignored directly in the lm-sensor configuration. See the manpage
 299 of sensors.conf(5).
 300
 301 Since v1.1.1, it is possible to hide a sensor, uncheck the setting
 302 'Display sensor in the list of sensors' in the sensor preferences.