Imported Upstream version 2.6.0

docs/man/upsimage.cgi.8

@@ -0,0 +1,69 @@
+'\" t
+.\"     Title: upsimage.cgi
+.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
+.\"      Date: 12/24/2010
+.\"    Manual: NUT Manual
+.\"    Source: Network UPS Tools
+.\"  Language: English
+.\"
+.TH "UPSIMAGE\&.CGI" "8" "12/24/2010" "Network UPS Tools" "NUT Manual"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+upsimage.cgi \- Image\-generating helper for upsstats\&.cgi
+.SH "SYNOPSIS"
+.sp
+\fBupsimage\&.cgi\fR
+.if n \{\
+.sp
+.\}
+.RS 4
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
+\fBNote\fR
+.ps -1
+.br
+.sp
+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 PNG at you\&.
+.sp .5v
+.RE
+.SH "DESCRIPTION"
+.sp
+\fBupsimage\&.cgi\fR generates the graphical bars that make up the right side of the page generated by \fBupsstats.cgi\fR(8)\&. These represent the current battery charge, utility voltage, and UPS load where available\&.
+.sp
+The images are in PNG format, and are created by linking to Boutell\(cqs excellent gd library\&.
+.SH "ACCESS CONTROL"
+.sp
+upsstats will only talk to \fBupsd\fR(8) servers that have been defined in your \fBhosts.conf\fR(5)\&. If it complains about "Access to that host is not authorized", check that file first\&.
+.SH "FILES"
+.sp
+\fBhosts.conf\fR(5)
+.SH "SEE ALSO"
+.sp
+\fBupsd\fR(8), \fBupsstats.cgi\fR(8)
+.SS "Internet resources:"
+.sp
+The gd home page: http://www\&.boutell\&.com/gd/
+.sp
+The NUT (Network UPS Tools) home page: http://www\&.networkupstools\&.org/