X-Git-Url: http://git.wpitchoune.net/gitweb/?p=psensor.git;a=blobdiff_plain;f=README;h=15c908a58687226b26d56b817f06afbc59bc97a7;hp=9f2cf4ca02d0c134d1066cff0907068ad6dcbf9a;hb=90ec04c6efb1f0b9e3887a86b1da9e7d0d33f16f;hpb=609664bb77874990e10f8073e54bb7f1645c8d72 diff --git a/README b/README index 9f2cf4c..15c908a 100644 --- a/README +++ b/README @@ -1,113 +1,174 @@ -Psensor - Temperature Monitoring For Linux ------------------------------------------- += Psensor README +:docinfo2: +:toc: +:icons: font -Psensor is a graphical temperature monitor for Linux. +Introduction +------------ + +Psensor is a graphical hardware monitoring application for Linux. -It can monitor: +It draws realtime charts and raises alerts about: - * the temperature of the motherboard and CPU sensors (using - lm-sensors). - * the temperature of the NVidia GPUs (using XNVCtrl). - * the temperature of the Hard Disk Drives (using hddtemp). - * the rotation speed of the fans (using lm-sensors). - * the temperature of a remote computer. + * the temperature of the motherboard and CPU sensors (using + lm-sensors). + * the temperature of the NVidia GPUs (using XNVCtrl). + * the temperature of ATI GPUs (using ATI ADL SDK). + * the temperature of the Hard Disk Drives (using hddtemp, libatasmart + or udisks2). + * the rotation speed of the fans. + * the temperature of a remote computer. + * the CPU load. -Alarms using Desktop Notification can be set to each sensor to notify -high temperatures. +Alerts are using Desktop Notification and a specific GTK+ status icon. -For Ubuntu users, Psensor is providing an Application Indicator to -alert users when a temperature is too high. +For Ubuntu users, Psensor is providing an Application Indicator which turns +red under alert and a menu for quickly check all sensors. -To monitor the temperature of a remote computer: +It is possible to monitor remotely a computer: - * start psensor-server on the remote computer. The default port is - 3131 and can be changed by using the '--port=PORT' command line - option. + * start +psensor-server+ on the remote computer. - * start psensor with the '--url' option: - psensor --url=http://hostname:3131 + * start +psensor+ using: +psensor --url=http://hostname:3131+. -WARNING: -psensor-server does not provide any way to restrict the connection to -the HTTP server, worst, no effort has been made against malicious HTTP -attacks. You should make the psensor-server port available only to a -network or computer you trust by using the usual network security -tools of the system (for example, iptables). ++psensor-server+ is a minimal Web server, a Web browser can be used to +monitor the remote computer by opening the URL: ++http://hostname:3131+. +[WARNING] ++psensor-server+ does not provide any way to restrict the connection +to the HTTP server, worst, no effort has been made against malicious +HTTP attacks. You should make the +psensor-server+ port available +only to a network or computer you trust by using the usual network +security tools of the system (for example: +http://www.netfilter.org/projects/iptables/index.html[iptables]). -Installation ------------- +Installation Using Distribution Packages +---------------------------------------- + +Debian +~~~~~~ + +For Debian, the binary and source packages are available in the +Wheezy, unstable and testing repositories. + +Debian package information is available at: +http://packages.qa.debian.org/p/psensor.html. + +To do the installation: +-------------------------------------------- +sudo apt-get install psensor psensor-server +-------------------------------------------- Ubuntu ------- +~~~~~~ -For Ubuntu, the easy way to install Psensor and Psensor-server is to -use the dedicated PPA. +Since Ubuntu Oneiric (11.10), psensor is available in the universe +repository of Ubuntu. -For the last stable version: +To install +psensor+ or +psensor-server+: +------------------------------------ +sudo apt-get install psensor +sudo apt-get install psensor-server +------------------------------------ + +Or search them in the Ubuntu Software Center. + +For other Ubuntu releases or user the more recent release, the easiest +way is to use the dedicated PPA. + +Last stable version: +------------------------------------------------- sudo apt-get apt-add-repository ppa:/jfi/psensor sudo apt-get update sudo apt-get install psensor +sudo apt-get install psensor-server +------------------------------------------------- -For the last development version: +Last development version which should not contain major bugs: +---------------------------------------------------------- sudo apt-get apt-add-repository ppa:/jfi/psensor-unstable sudo apt-get update sudo apt-get install psensor sudo apt-get install psensor-server +---------------------------------------------------------- -Alternatively, you can download Ubuntu binary packages from: -http://wpitchoune.net/psensor/files/ubuntu/ -The manual installation of the psensor and psensor-server packages -requires also the installation of psensor-common which contains -the multiple languages support. +Daily trunk build which may contain major bugs and partialy +implemented features: +------------------------------------------------------------- +sudo apt-get apt-add-repository ppa:/jfi/psensor-daily-trunk +sudo apt-get update +sudo apt-get install psensor +sudo apt-get install psensor-server +------------------------------------------------------------- -Installation from source archive +Installation From Source Archive -------------------------------- -Psensor compilation requires: ++psensor+ and +psensor-server+ can be compiled and installed on any +modern GNU/Linux distribution. + +Compilation Prerequisites +~~~~~~~~~~~~~~~~~~~~~~~~~ + +The compilation of +psensor+ requires: - * make/gcc + * make + * gcc (or llvm) * lm-sensors * library sensors4 - * library gtk2 - * library gconf2 - * help2man + * library gtk3 >=3.4 + * help2man (optional, required to produce the manpage) + * asciidoctor (optional, required to produce the html version of the + faq) + * cppcheck (optional, static source checker) * library libnotify (optional) - * library libappindicator (optional) + * library libappindicator >= 3.0 (optional) * library libXNVCtrl (optional) - * library json0 and curl (optional, required for remote monitoring) + * library json-c >= 0.11.99 and curl (optional, required for remote monitoring) * library unity (>=v3.4.2, optional) + * library gtop2 (optional, required for CPU usage) + * library atasmart (optional, for disk monitoring) + * library udisk2 (optional, for disk monitoring) + +The specific requirements for +psensor-server+: -Psensor-server compilation requires: - * make/gcc - * lm-sensors - * library sensors4 - * help2man * library libmicrohttpd - * library json0 - * library LUA5.1 (optional, required to enable HTML page generation - of the psensor-server webserver) - * library gtop2 (optional, required for CPU usage) + * library json-c >= 0.11.99 Compilation and Installation Steps ----------------------------------- +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. download the source archive from: http://wpitchoune.net/psensor/files +2. Extract files from the source archive +3. Compilation: +./configure;make clean all+ +4. Installation: +make install+ (require to have root permission) +5. Start the sensor detection script: +sensors-detect+ and follows the +instructions. Reboot or activate the kernel modules which have +been found. +6. Run: +psensor+ - * Extract files from the source archive - * Compilation: - ./configure - make clean all - - * Installation: - make install +ATI/AMD GPU Support +~~~~~~~~~~~~~~~~~~~ - * Start the sensor detection script: 'sensors-detect' and follows the -instructions +When the OpenSource ATI driver is used, the monitoring +information is available throw lm-sensors and does not require the +following instructions. - * Verify the sensor detection by running: 'sensors' +When the proprietary ATI driver(Catalyst) is used, the build is +requiring an additional library. - * Run 'psensor' +Download the +http://developer.amd.com/sdks/ADLSDK/Pages/default.aspx[ATI ADL SDK] +and extracts the files of the archive into a directory [dir]. + +Replace the step 3. of the above section by +./configure +--with-libatiadl=[dir]+ where +[dir]+ must be the directory where you +have extracted the ATI ADL SDK. Other steps are indentical. Contact ------- -Bugs and comments can be sent to wpitchoune@gmail.com + +Bugs and comments can be sent to jeanfi@gmail.com. + Home page: http://wpitchoune.net/psensor \ No newline at end of file