File: README.html

package info (click to toggle)
psensor 1.1.3-2%2Bdeb8u1
links: PTS, VCS
area: main
in suites: jessie
size: 3,748 kB
sloc: ansic: 7,194; sh: 4,979; perl: 3,922; makefile: 335; xml: 210; sed: 16
file content (688 lines) | stat: -rw-r--r-- 18,116 bytes
parent folder | download | duplicates (5)
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
    "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.6.9" />
<title>Psensor README</title>
<style type="text/css">

body {
    background: #e2e2e2;
    color: #333333;
    font-family: Ubuntu,Arial,sans-serif;
    line-height: 1.6;
    font-weight: lighter;
    margin: 1em 2em 2em 2em;
    padding: 0 0 0 0;
}

h1 {
    font-size: 2.813em;
    margin: 0 0 0.267em 0;
    padding: 0 0 0 0;
    font-weight: normal;
}

h2 {
    font-size: 2em;
    margin: 0 0 0.375em;
    padding: 0 0 0 0;
    font-weight: normal;
}

h3 {
    font-size: 1.438em;
    margin: 0 0 0.522em;
    padding: 0 0 0 0;
    font-weight: normal;
}

h4 {
    font-size: 1.219em;
    margin: 0 0 0.615em;
    padding: 0 0 0 0;
    font-weight: normal;
}

h5 {
    font-size: 1em;
    margin: 0 0 0.75em;
    padding: 0 0 0 0;
    font-weight: bold;
}

h6 {
    font-weight: normal;
    font-size: 0.813em;
    letter-spacing: 0.1em;
    margin: 0 0 0.923em;
    text-transform: uppercase;
    padding: 0 0 0 0;
}

li {
    margin: 0 0 0 1em;
    line-height: 1.6;
}

li p {
    margin: 0 0 0 0;
}

ul {
    margin: 0 0 0 0;
    padding: 0 0 0 0;
}

a:link, a:visited {
    color: #19B6EE;
    text-decoration: none;
}

a:hover {
    text-decoration: underline;
}

code, pre, tt {
    font-family: "Ubuntu Mono","Courier New",Courier,monospace;
    font-weight: normal;
    color: #333333;
}

pre {
    background: none repeat scroll 0 0 #e0e0e0;
    border-radius: 4px;
    padding: 0.5em 0.5em;
    margin: 0 0 0 0;
    white-space: pre-wrap;
    word-wrap: break-word;
}

table {
    width: 100%;
    text-align: left;
}

#footer {
    margin: 0 0 0 0;
    font-size: 0.8em;
    font-weight: lighter;
    clear: both;
    text-align: right;
}

#page {
    margin: 0 0 0 0;
    padding: 0 0 0 0;
}

#main {
    background: #ffffff;

   -moz-box-sizing: border-box;

    padding: 2em 2em 2em 2em;

    -moz-border-radius: 4px;
    -webkit-border-radius: 4px;
    border-radius: 4px;

    -webkit-box-shadow: 0 2px 2px 0 #C2C2C2;
    box-shadow: 0 2px 2px 0 #C2C2C2;
}

#menu {
    background: #ffffff;
   -moz-box-sizing: border-box;
    padding: 2em 2em 2em 2em;

    -moz-border-radius: 4px;
    -webkit-border-radius: 4px;
    border-radius: 4px;

    -webkit-box-shadow: 0 2px 2px 0 #C2C2C2;
    box-shadow: 0 2px 2px 0 #C2C2C2;
}

#menu-list, #menu-list > li > ul  {
    list-style-type: none;
}

/* menu on left col, content on right col */

#menu {
    float: left;
    width: 18%;
}

#main {
    float: right;
    width: 80%;
}

/* asciidoc */

#toc, #content {
    margin: 0em 0em 2em 0em;

    background: #ffffff;
   -moz-box-sizing: border-box;
    padding: 2em 2em 2em 2em;

    -moz-border-radius: 4px;
    -webkit-border-radius: 4px;
    border-radius: 4px;

    -webkit-box-shadow: 0 2px 2px 0 #C2C2C2;
    box-shadow: 0 2px 2px 0 #C2C2C2;
}


</style>
<script type="text/javascript">
/*<![CDATA[*/
var asciidoc = {  // Namespace.

/////////////////////////////////////////////////////////////////////
// Table Of Contents generator
/////////////////////////////////////////////////////////////////////

/* Author: Mihai Bazon, September 2002
 * http://students.infoiasi.ro/~mishoo
 *
 * Table Of Content generator
 * Version: 0.4
 *
 * Feel free to use this script under the terms of the GNU General Public
 * License, as long as you do not remove or alter this notice.
 */

 /* modified by Troy D. Hanson, September 2006. License: GPL */
 /* modified by Stuart Rackham, 2006, 2009. License: GPL */

// toclevels = 1..4.
toc: function (toclevels) {

  function getText(el) {
    var text = "";
    for (var i = el.firstChild; i != null; i = i.nextSibling) {
      if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
        text += i.data;
      else if (i.firstChild != null)
        text += getText(i);
    }
    return text;
  }

  function TocEntry(el, text, toclevel) {
    this.element = el;
    this.text = text;
    this.toclevel = toclevel;
  }

  function tocEntries(el, toclevels) {
    var result = new Array;
    var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
    // Function that scans the DOM tree for header elements (the DOM2
    // nodeIterator API would be a better technique but not supported by all
    // browsers).
    var iterate = function (el) {
      for (var i = el.firstChild; i != null; i = i.nextSibling) {
        if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
          var mo = re.exec(i.tagName);
          if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
            result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
          }
          iterate(i);
        }
      }
    }
    iterate(el);
    return result;
  }

  var toc = document.getElementById("toc");
  if (!toc) {
    return;
  }

  // Delete existing TOC entries in case we're reloading the TOC.
  var tocEntriesToRemove = [];
  var i;
  for (i = 0; i < toc.childNodes.length; i++) {
    var entry = toc.childNodes[i];
    if (entry.nodeName.toLowerCase() == 'div'
     && entry.getAttribute("class")
     && entry.getAttribute("class").match(/^toclevel/))
      tocEntriesToRemove.push(entry);
  }
  for (i = 0; i < tocEntriesToRemove.length; i++) {
    toc.removeChild(tocEntriesToRemove[i]);
  }

  // Rebuild TOC entries.
  var entries = tocEntries(document.getElementById("content"), toclevels);
  for (var i = 0; i < entries.length; ++i) {
    var entry = entries[i];
    if (entry.element.id == "")
      entry.element.id = "_toc_" + i;
    var a = document.createElement("a");
    a.href = "#" + entry.element.id;
    a.appendChild(document.createTextNode(entry.text));
    var div = document.createElement("div");
    div.appendChild(a);
    div.className = "toclevel" + entry.toclevel;
    toc.appendChild(div);
  }
  if (entries.length == 0)
    toc.parentNode.removeChild(toc);
},


/////////////////////////////////////////////////////////////////////
// Footnotes generator
/////////////////////////////////////////////////////////////////////

/* Based on footnote generation code from:
 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
 */

footnotes: function () {
  // Delete existing footnote entries in case we're reloading the footnodes.
  var i;
  var noteholder = document.getElementById("footnotes");
  if (!noteholder) {
    return;
  }
  var entriesToRemove = [];
  for (i = 0; i < noteholder.childNodes.length; i++) {
    var entry = noteholder.childNodes[i];
    if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
      entriesToRemove.push(entry);
  }
  for (i = 0; i < entriesToRemove.length; i++) {
    noteholder.removeChild(entriesToRemove[i]);
  }

  // Rebuild footnote entries.
  var cont = document.getElementById("content");
  var spans = cont.getElementsByTagName("span");
  var refs = {};
  var n = 0;
  for (i=0; i<spans.length; i++) {
    if (spans[i].className == "footnote") {
      n++;
      var note = spans[i].getAttribute("data-note");
      if (!note) {
        // Use [\s\S] in place of . so multi-line matches work.
        // Because JavaScript has no s (dotall) regex flag.
        note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
        spans[i].innerHTML =
          "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
          "' title='View footnote' class='footnote'>" + n + "</a>]";
        spans[i].setAttribute("data-note", note);
      }
      noteholder.innerHTML +=
        "<div class='footnote' id='_footnote_" + n + "'>" +
        "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
        n + "</a>. " + note + "</div>";
      var id =spans[i].getAttribute("id");
      if (id != null) refs["#"+id] = n;
    }
  }
  if (n == 0)
    noteholder.parentNode.removeChild(noteholder);
  else {
    // Process footnoterefs.
    for (i=0; i<spans.length; i++) {
      if (spans[i].className == "footnoteref") {
        var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
        href = href.match(/#.*/)[0];  // Because IE return full URL.
        n = refs[href];
        spans[i].innerHTML =
          "[<a href='#_footnote_" + n +
          "' title='View footnote' class='footnote'>" + n + "</a>]";
      }
    }
  }
},

install: function(toclevels) {
  var timerId;

  function reinstall() {
    asciidoc.footnotes();
    if (toclevels) {
      asciidoc.toc(toclevels);
    }
  }

  function reinstallAndRemoveTimer() {
    clearInterval(timerId);
    reinstall();
  }

  timerId = setInterval(reinstall, 500);
  if (document.addEventListener)
    document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
  else
    window.onload = reinstallAndRemoveTimer;
}

}
asciidoc.install(2);
/*]]>*/
</script>
</head>
<body class="article">
<div id="header">
<h1>Psensor README</h1>
<div id="toc">
  <div id="toctitle">Table of Contents</div>
  <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
</div>
</div>
<div id="content">
<div class="sect1">
<h2 id="_introduction">1. Introduction</h2>
<div class="sectionbody">
<div class="paragraph"><p>Psensor is a graphical hardware monitoring application for Linux.</p></div>
<div class="paragraph"><p>It draws realtime charts and raises alerts about:</p></div>
<div class="ulist"><ul>
<li>
<p>
the temperature of the motherboard and CPU sensors (using
   lm-sensors).
</p>
</li>
<li>
<p>
the temperature of the NVidia GPUs (using XNVCtrl).
</p>
</li>
<li>
<p>
the temperature of the Hard Disk Drives (using hddtemp or libatasmart).
</p>
</li>
<li>
<p>
the rotation speed of the fans (using lm-sensors).
</p>
</li>
<li>
<p>
the temperature of a remote computer.
</p>
</li>
<li>
<p>
the cpu load.
</p>
</li>
</ul></div>
<div class="paragraph"><p>Alerts are using Desktop Notification and a specific GTK+ status icon.</p></div>
<div class="paragraph"><p>For Ubuntu users, Psensor is providing an Application Indicator which turns
red under alert and a menu for quickly check all sensors.</p></div>
<div class="paragraph"><p>It is possible to monitor remotely a computer:</p></div>
<div class="ulist"><ul>
<li>
<p>
start <code>psensor-server</code> on the remote computer.
</p>
</li>
<li>
<p>
start <code>psensor</code> using: <code>psensor --url=http://hostname:3131</code>.
</p>
</li>
</ul></div>
<div class="paragraph"><p><code>psensor-server</code> is a minimal Web server, a Web browser can be used to
monitor the remote computer by opening the URL:
<code>http://hostname:3131</code>.</p></div>
<div class="admonitionblock">
<table><tr>
<td class="icon">
<div class="title">Warning</div>
</td>
<td class="content"><code>psensor-server</code> 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 <code>psensor-server</code> port available
only to a network or computer you trust by using the usual network
security tools of the system (for example:
<a href="http://www.netfilter.org/projects/iptables/index.html">iptables</a>).</td>
</tr></table>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_installation_using_distribution_packages">2. Installation Using Distribution Packages</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="_debian">2.1. Debian</h3>
<div class="paragraph"><p>For Debian, the binary and source packages are available in the
Wheezy, unstable and testing repositories.</p></div>
<div class="paragraph"><p>Debian package information is available at:
<a href="http://packages.qa.debian.org/p/psensor.html">http://packages.qa.debian.org/p/psensor.html</a>.</p></div>
<div class="paragraph"><p>To do the installation:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>sudo apt-get install psensor psensor-server</code></pre>
</div></div>
</div>
<div class="sect2">
<h3 id="_ubuntu">2.2. Ubuntu</h3>
<div class="paragraph"><p>Since Ubuntu Oneiric (11.10), psensor is available in the universe
repository of Ubuntu.</p></div>
<div class="paragraph"><p>To install <code>psensor</code> or <code>psensor-server</code>:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>sudo apt-get install psensor
sudo apt-get install psensor-server</code></pre>
</div></div>
<div class="paragraph"><p>Or search them in the Ubuntu Software Center.</p></div>
<div class="paragraph"><p>For other Ubuntu releases or user the more recent release, the easiest
way is to use the dedicated PPA.</p></div>
<div class="paragraph"><p>Last stable version:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>sudo apt-get apt-add-repository ppa:/jfi/psensor
sudo apt-get update
sudo apt-get install psensor
sudo apt-get install psensor-server</code></pre>
</div></div>
<div class="paragraph"><p>Last development version which should not contain major bugs:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>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</code></pre>
</div></div>
<div class="paragraph"><p>Daily trunk build which may contain major bugs and partialy
implemented features:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>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</code></pre>
</div></div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_installation_from_source_archive">3. Installation From Source Archive</h2>
<div class="sectionbody">
<div class="paragraph"><p><code>psensor</code> and <code>psensor-server</code> can be compiled and installed on any
modern GNU/Linux distribution.</p></div>
<div class="sect2">
<h3 id="_compilation_prerequisites">3.1. Compilation Prerequisites</h3>
<div class="paragraph"><p>The compilation of <code>psensor</code> requires:</p></div>
<div class="ulist"><ul>
<li>
<p>
make
</p>
</li>
<li>
<p>
gcc (or llvm)
</p>
</li>
<li>
<p>
lm-sensors
</p>
</li>
<li>
<p>
library sensors4
</p>
</li>
<li>
<p>
library gtk3 &gt;=3.4
</p>
</li>
<li>
<p>
help2man
</p>
</li>
<li>
<p>
asciidoc (optional, required to produce the html version of the
   faq)
</p>
</li>
<li>
<p>
cppcheck (optional, static source checker)
</p>
</li>
<li>
<p>
library libnotify (optional)
</p>
</li>
<li>
<p>
library libappindicator (optional)
</p>
</li>
<li>
<p>
library libXNVCtrl (optional)
</p>
</li>
<li>
<p>
library json-c &gt;= 0.11.99 and curl (optional, required for remote monitoring)
</p>
</li>
<li>
<p>
library unity (&gt;=v3.4.2, optional)
</p>
</li>
<li>
<p>
library gtop2 (optional, required for CPU usage)
</p>
</li>
<li>
<p>
library atasmart (optional, for disk monitoring)
</p>
</li>
</ul></div>
<div class="paragraph"><p>The specific requirements for <code>psensor-server</code>:</p></div>
<div class="ulist"><ul>
<li>
<p>
library libmicrohttpd
</p>
</li>
<li>
<p>
library json0
</p>
</li>
</ul></div>
</div>
<div class="sect2">
<h3 id="_compilation_and_installation_steps">3.2. Compilation and Installation Steps</h3>
<div class="olist arabic"><ol class="arabic">
<li>
<p>
download the source archive from: <a href="http://wpitchoune.net/psensor/files">http://wpitchoune.net/psensor/files</a>
</p>
</li>
<li>
<p>
Extract files from the source archive
</p>
</li>
<li>
<p>
Compilation: <code>./configure;make clean all</code>
</p>
</li>
<li>
<p>
Installation:  <code>make install</code> (require to have root permission)
</p>
</li>
<li>
<p>
Start the sensor detection script: <code>sensors-detect</code> and follows the
instructions. Reboot or activate the kernel modules which have
been found.
</p>
</li>
<li>
<p>
To monitor HDDs, the <code>hddtemp</code> daemon must be installed and running.
</p>
</li>
<li>
<p>
Run: <code>psensor</code>
</p>
</li>
</ol></div>
</div>
<div class="sect2">
<h3 id="_ati_amd_gpu_support">3.3. ATI/AMD GPU Support</h3>
<div class="paragraph"><p>When the OpenSource ATI driver is used, the monitoring
information is available throw lm-sensors and does not require the
following instructions.</p></div>
<div class="paragraph"><p>When the proprietary ATI driver(Catalyst) is used, the build is
requiring an additional library.</p></div>
<div class="paragraph"><p>Download the
<a href="http://developer.amd.com/sdks/ADLSDK/Pages/default.aspx">ATI ADL SDK</a>
and extracts the files of the archive into a directory [dir].</p></div>
<div class="paragraph"><p>Replace the step 3. of the above section by <code>./configure
--with-libatiadl=[dir]</code> where <code>[dir]</code> must be the directory where you
have extracted the ATI ADL SDK. Other steps are indentical.</p></div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_contact">4. Contact</h2>
<div class="sectionbody">
<div class="paragraph"><p>Bugs and comments can be sent to <a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a>.</p></div>
<div class="paragraph"><p>Home page: <a href="http://wpitchoune.net/psensor">http://wpitchoune.net/psensor</a></p></div>
</div>
</div>
</div>
<div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
Last updated 2014-08-23 13:50:12 CEST
</div>
</div>
</body>
</html>