47 lines
1.5 KiB
Groff
47 lines
1.5 KiB
Groff
|
.TH upsstats.cgi 8 "Mon Sep 2 2002" "" "Network UPS Tools (NUT)"
|
||
|
|
.SH NAME
|
||
|
|
upsstats.cgi \- Web\(hybased UPS status viewer
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.B upsstats.cgi
|
||
|
|
|
||
|
|
.SH NOTE
|
||
|
|
As a CGI program, this should be invoked through your web server.
|
||
|
|
If you run it from the command line, it will either complain about
|
||
|
|
unauthorized access or spew a bunch of HTML at you.
|
||
|
|
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.B upsstats.cgi
|
||
|
|
uses template files to build web pages containing status information
|
||
|
|
from UPS hardware. It can repeat sections of those template files to
|
||
|
|
monitor several UPSes simultaneously, or focus on a single UPS.
|
||
|
|
|
||
|
|
These templates can also include references to \fBupsimage.cgi\fR(8)
|
||
|
|
for graphical displays of battery charge levels, voltage readings, and
|
||
|
|
the UPS load.
|
||
|
|
|
||
|
|
.SH ACCESS CONTROL
|
||
|
|
upsstats will only talk to \fBupsd\fR(8) servers that have been defined
|
||
|
|
in your \fBhosts.conf\fR(5). If it complains that "Access to that host
|
||
|
|
is not authorized", check that file first.
|
||
|
|
|
||
|
|
.SH TEMPLATES
|
||
|
|
The web page that is displayed is actually a template containing
|
||
|
|
commands to upsstats which are replaced by status information. The
|
||
|
|
default file used for the overview is upsstats.html.
|
||
|
|
|
||
|
|
When monitoring a single UPS, the file displayed is
|
||
|
|
upsstats\-single.html.
|
||
|
|
|
||
|
|
The format of these files, including the possible commands, is
|
||
|
|
documented in \fBupsstats.html\fR(5).
|
||
|
|
|
||
|
|
|
||
|
|
.SH FILES
|
||
|
|
\fBhosts.conf\fR(5) \fBupsstats.html\fR(5)
|
||
|
|
|
||
|
|
.SH SEE ALSO
|
||
|
|
\fBupsimage.cgi\fR(8)
|
||
|
|
|
||
|
|
.SS Internet resources:
|
||
|
|
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
|