|
|
AjaxToaster 1.0.0 RC2 (Default branch)
07-21-2008
|
|
PSENSOR-SERVER(1) User Commands PSENSOR-SERVER(1) NAME
psensor-server - Temperature and system monitoring Web server SYNOPSIS
psensor-server [OPTION]... DESCRIPTION
psensor-server is an HTTP server for monitoring hardware sensors remotely. It provides a JSON Web service which can be used by psensor(1) to monitor remotely the hardware sensors of a computer. It can provide information about: * the temperature of the motherboard and CPU sensors (using lm-sensors). * the temperature of the Hard Disk Drives (using hddtemp). * the rotation speed of the fans (using lm-sensors). It is also possible to connect to the psensor-server with a browser, a simple Web page is displaying the sensors information and the CPU usage. The URL http://hostname:3131/api/1.0/sensors/[id] returns a JSON object containing all information about a sensor. [id] is the uniq identi- fier of the sensor. Here is an example of the JSON object of type 'sensor': { "id": "lmsensor acpitz-virtual-0 temp1", "name": "temp1", "type": 257, "min": 47.800000, "max": 60.800000, "measures": [ { "value": 47.800000, "time": 1311374873 }, { "value": 49.800000, "time": 1311374878 }, { "value": 49.800000, "time": 1311374883 } ], "last_measure": { "value": 49.800000, "time": 1311374883 } } Fields of the type 'sensor': * id: the uniq identifier of the sensor. * name: a humean readable name of the sensor (might not be uniq). * type: the type of sensor. Look at src/lib/psensor.h for the different types. * min: the minimal value of the sensor. * max: the maximal value of the sensor. * measures: all measures of the sensor. * last_measure: the last value of the sensor. * time: the time of a measure as the number of seconds since 1970/01/01. The URL http://hostname:3131/api/1.0/sensors returns a JSON array containing all JSON objects of type 'sensor'. If run in debug mode, psensor-server can be stopped by sending an HTTP request with the URL 'http://hostname:port/api/1.0/server/stop'. OPTIONS
-h, --help display this help and exit -v, --version display version information and exit -d,--debug run in debug mode -p,--port=PORT webserver port -w,--wdir=DIR directory containing webserver pages 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 secu- rity tools of the system (for example, iptables(8) ). REPORTING BUGS
Report bugs to: jeanfi@gmail.com psensor home page: <http://wpitchoune.net/psensor> COPYRIGHT
Copyright (C) 2010-2012 jeanfi@gmail.com License GPLv2: GNU GPL version 2 or later <http://www.gnu.org/licenses/old-licenses/gpl-2.0.html> This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. SEE ALSO
psensor(1), sensors(1), sensors-detect(8) psensor-server 0.6.2.17 March 2012 PSENSOR-SERVER(1)