~ubuntu-branches/ubuntu/saucy/nut/saucy

« back to all changes in this revision

Viewing changes to man/upsstats.html.5

  • Committer: Chuck Short
  • Date: 2013-05-13 12:57:25 UTC
  • Revision ID: zulcss@ubuntu.com-20130513125725-llq8wsohyhq9idsy
* Merge from Debian.  Remaining changes:
  - debian/control:
    + remove Build-Depends on libpowerman0-dev
    + remove nut-powerman-pdu
  - debian/nut-powerman-pdu.{install,manpages}: dropped for now
  - debian/{nut-cgi,nut-server}.postinst: add nut to the dialout and nut
    groups unconditonally to handle the upgrade from hardy release.
  - debian/source_nut.py, debian/{nut,nut-server,nut-client}.install,
    debian/rules: Install apport hooks for all top-level nut packages.
  - debian/rules: Use udev version for Ubuntu
  - debian/series, debian/patches/backport-fix-lp753661.patch: re-enabled
* Non-maintainer upload with fixes for wheezy.
* debian/nut-client.preinst: also revert /etc/nut/nut.conf mangling done
  by postinst during upgrade from lenny to squeeze (Really closes: #677054)
  Thanks to Andreas Beckmann for the review.
* Merge from Debian.  Remaining changes:
  - debian/control:
    + remove Build-Depends on libpowerman0-dev
    + remove nut-powerman-pdu
  - debian/nut-powerman-pdu.{install,manpages}: dropped for now
  - debian/{nut-cgi,nut-server}.postinst: add nut to the dialout and nut
    groups unconditonally to handle the upgrade from hardy release.
  - debian/source_nut.py, debian/{nut,nut-server,nut-client}.install,
    debian/rules: Install apport hooks for all top-level nut packages.
  - debian/rules: Use udev version for Ubuntu
  - debian/series, debian/patches/backport-fix-lp753661.patch: re-enabled
* Dropped the following patches, no longer required:
  - debian/patches/CVE-2012-2944.patch (included upstream)
* Non-maintainer upload with fixes for wheezy.
* Only remove /etc/init.d/nut from previous versions of nut in nut-server
  postinst if there are no local changes.
* Also remove /etc/init.d/nut in nut-client postinst. Thanks to 
  Laurent Bigonville for the hint.
* Only fix permissions of configfiles on first install.
* debian/control: Fix typo in package description. Thanks to Julien Cristau
  for spotting this.
* Non-maintainer upload.
* debian/nut-client.preinst: revert /etc/nut/nut.conf mangling done by older
  versions of the postinst (Closes: #677054)
* debian/rules: Stop the nut-client before nut-server on systems using
  static
  boot ordering (Closes: #679451)
* debian/nut-server.postinst: Remove /etc/init.d/nut on upgrade
  (Closes: #677822)
* Rename nut-server.lintian-overrides to nut-client.lintian-overrides and
  adjust overrides now that ups-monitor is shipped in nut-client package
  (Closes: #677947)
* Add debian/patches/0001-fix-upsmon-regression.patch: Fix upsmon/upssched
  regression (Taken from upstream) (Closes: #679513)
* Move nut metapackage to Section: metapackages
* Also create nut user when installing nut-client package and do not delete
  it on purge anymore (Closes: #682000)
* Drop /etc/default/nut → /etc/nut/nut.conf migration code, migration
  happends before squeeze release and this was against policy to have a
  maintainer script modifying a conffile in the first place (Closes: #684392)
* Add dependency against adduser and lsb-base on nut-client package
* Be sure that client is stopped before the server also when using
  dependencies based boot
* Fix package descriptions (Closes: #678068)
* Also install /bin/upssched-cmd in nut-client package as this script is
  referenced in default upssched.conf config file
* debian/watch: Update watch file
* Be sure that all maintainer scripts are returning 0 at their end
* New upstream release (Closes: #671444)
* acknowledges NMU (Closes: #613643)
* debian/nut-client.init: fix action "start" and use of log_*_*msg
  LSB log functions (Closes: #675619)
* debian/nut-server.preinst: remove obsolete file(s) left in
  /etc/udev/rules.d and related processing: udev files are now located
  in /lib/udev/rules, and there is no reason to modify the dedicated
  USB UPS rules (52-nut-usbups.rules) (Closes: #660072)
* debian/nut-server.init: rewrite to match upsd / drivers startup scope
* debian/nut-client.init: created to match upsmon startup scope
  (Closes: #634858)
* debian/nut.TODO.Debian, debian/Makefile.am: updated to reflect the above
* debian/rules: install nut-client.init, and update to reflect the above
* debian/control, debian/Makefile.am: updated to reflect the above
* debian/control:
  - add Breaks on nut-server (<< 2.6.3-1~)
  - bump Standards-Version to 3.9.3
* debian/nut-client.links: renamed from debian/nut-server.links, since
  ups-monitor is now provided by nut-client initscript
* debian/nut.README.Debian: renamed from nut-server.README.Debian,
  to provide it with both client and server packages
* debian/nut-server.install: add missing drivers (clone-outlet,
  liebert-esp2 and microdowell)
* debian/nut-server.manpages: add missing manual pages (apcsmart-old,
  ivtscd, liebert-esp2 and microdowell)
* SECURITY UPDATE: remote denial of service
 - debian/CVE-2012-2944.patch: limit the set of parsed characters to ' '
   through '~'
 - CVE-2012-2944
* Merge from Debian testing.  Remaining changes:
  - debian/control: Drop Build-Depends on libpowerman0-dev (currently in 
    universe)
  - debian/{nut-cgi,nut-server}.postinst: add nut to the dialout and nut 
    groups unconditonally to handle the upgrade from hardy release.
  - debian/nut-powerman-pdu.{install,manpages}: dropped for now.
  - debian/source_nut.py, debian/{nut,nut-server,nut-client}.install, 
    debian/rules: Install apport hooks for all top-level nut packages.
  - debian/rules: Use udev version for Ubuntu.
  - debian/series, debian/patches/backport-fix-lp753661.patch: re-enabled.
* New upstream release (Closes: #635186, #598741, #633756, #638221)
* debian/nut-server.{install,manpages}: add richcomm_usb
* debian/nut-server.install, debian/rules: install Avahi service file
* debian/rules, nut-client.install: install Augeas lenses
* debian/nut-server.README.Debian: clarify udev explanation (Closes: #529664)
* debian/patches/0001-fix_spelling_and_typo.patch,
  debian/patches/0003-libupsclient-version.patch: removed since these are now
  fixed upstream
* debian/patches/series: updated
* Merge from debian unstable.  Remaining changes:
  - debian/control: Drop Build-Depends on libpowerman0-dev (currently in 
    universe)
  - debian/{nut-cgi,nut-server}.postinst: add nut to the dialout and nut 
    groups unconditonally to handle the upgrade from hardy release.
  - debian/nut-powerman-pdu.{install,manpages}: dropped for now.
  - debian/source_nut.py, debian/{nut,nut-server,nut-client}.install, 
    debian/rules: Install apport hooks for all top-level nut packages.
  - debian/rules: Use udev version for Ubuntu.
  - debian/series, debian/patches/backport-fix-lp753661.patch: re-enabled.
* New upstream release (Closes: #594989)
* debian/control:
  - remove legacy Build-Depends for nut-hal-drivers on libdbus and libglib
  - Build-Depends-Indep on docbook-xsl for offline document
    generation (Closes: #635347)
* debian/nut-server.install: add apcsmart-old
* debian/nut-server.init:
  - add udev as Required-Start/Stop (Closes: #642412)
  - remove legacy support for /etc/default/nut (Closes: #638021)
* debian/patches/0003-libupsclient-version.patch: added to fix the missing
  libupsclient version info bump
* debian/libupsclient1-dev.links: update link name
* debian/libupsclient1.symbols: add with upscli_tryconnect
* debian/nut.TODO.Debian: update and complete the TODO list
* Fix FTBFS for Ubuntu (LP: #815760):
  - debian/control: Build-Depends-Indep on docbook-xsl for offline 
    document generation.
* Merge from Debian unstable (LP: #811976). Remaining changes:
  - debian/control: Drop Build-Depends on libpowerman0-dev (currently in 
    universe)
  - debian/{nut-cgi,nut-server}.postinst: add nut to the dialout and nut 
    groups unconditonally to handle the upgrade from hardy release.
  - debian/nut-powerman-pdu.{install,manpages}: dropped for now.
  - debian/source_nut.py, debian/{nut,nut-server,nut-client}.install, 
    debian/rules: Install apport hooks for all top-level nut packages.
  - debian/rules: Use udev version for Ubuntu.
  - debian/series, debian/patches/backport-fix-lp753661.patch: re-enabled.
* debian/nut.README.Debian: Adjust udev rules naming for permissions override
  (Closes: #529664)
* Re-add and refresh debian/patches/0001-fix_spelling_and_typo.patch:
  Some typos and spelling errors remain.
* Split nut package into nut-client and nut-server, keep nut package as
  metapackage
* Generate PDF and html doc and install it in nut-doc package
* debian/rules:
  - List non-installed files
  - Includes python-module.mk
  - Add flags to build documentation and install it
* debian/control:
  - Add python-nut package and add python build-dependency
  - Set nut-powerman-pdu priority to extras
  - Add nut-monitor package
  - Add nut-doc package and add required C/R/P
  - Add libups-nut-perl package
* debian/nut-server.prerm: Remove /var/run/nut during removal
* Merge from debian unstable.  Remaining changes:
  - debian/control:
    + Drop Build-Depends on libpowerman0-dev (currently in universe)
  - debian/{nut-cgi,nut}.postinst: add nut to the dialout and nut groups
    unconditonally to handle the upgrade from hardy release.
  - debian/nut-powerman-pdu.{install,manpages}: dropped for now.
  - debian/source_nut.py, debian/nut.install, debian/rules: Install apport hook.
  - debian/rules: Use udev version for Ubuntu.
* debian/patches/backport-fix-lp753661.patch: Refreshed.
* Drop changes due to .pc being not clean.
* New upstream release (Closes: #595953, #614842, #595773)
* debian/patches/*.patch: removed since these are now fixed upstream
* Drop HAL package and build-dependencies (Closes: #613197)
* debian/control:
  - Bump Standards-Version to 3.9.2 (no further changes)
  - Drop autotools build-dependencies (not needed anymore)
  - Drop non-existing build-dependencies
* debian/rules:
  - Correctly pass flags to configure
* Merge from debian unstable (LP: #789323).  Remaining changes:
  + debian/control:
    - Update maintainer as per spec.
    - Add Breaks on nut-hal-drivers to ensure we have correct udev version.
    - Drop libpowerman0-dev from the Build-Depends (currently in universe)
  + debian/{nut-cgi,nut}.postinst: add nut to the dialout and nut groups
    unconditonally to handle the upgrade from hardy release.
  + debian/nut-powerman-pdu.install, debian/nut-powerman-pdu.manpages: dropped for now.
  + debian/nul-hal-drivers.{docs,install,postinst,preinst}: Dropped since hal is in universe now
  + debian/nut.links: must create the init script link, used if the upse needs to be powered down
    (LP: #357583)
  + debian/source_nut.py, debian/nut.install, debian/rules: Install apport hook.
  + debian/patches/backport-fix-lp753661.patch
  + Dropped:
    - debian/patches/fix_pc_file.patch: replaced by debian's 0002-fix_libupsclient_pc.patch
* debian/patches/fix_pc_file.patch: add DEP3 patch header
* debian/patches/debian-changes-2.6.0-1: remove that accidental file
* debian/nut-snmp.docs: Distribute snmp.txt doc file (Closes: #548295)
* d/p/0001-fix_spelling_and_typo.patch: Update and refresh
* debian/nut.lintian-overrides: Fix typo
* debian/patch/0002-fix_libupsclient_pc.patch: Fix libupsclient.pc (Closes:
  #624255)
* debian/rules:
  - Switch to cdbs
  - Remove not existing configure options (Closes: #611813)
  - Drop Phony rules (Closes: #613699)
* debian/control:
  - Add cdbs build-dependency
* debian/patches/backport-fix-lp753661.patch: Backport fix 
  to trim extraneous end-of-line, in buggy HID string tables, 
  which results in upsc breaking the communication pipe.
  (LP: #753661)
* fix_pc_file.patch: fix .pc source files by using LIBSSL_LIBS instead of
  LIBSSL_LDFLAGS to avoid a FTBFS in packages that uses libupsclient.pc
  (LP: #743484)
* Merge from Debian unstable, remaining changes:
  + debian/control:
    - Update maintainer as per spec.
    - Add Breaks on nut-hal-drivers to ensure we have correct udev version.
    - Drop libpowerman0-dev from the Build-Depends (currently in universe)
  + debian/{nut-cgi,nut}.postinst: add nut to the dialout and nut groups
    unconditonally to hanle the upgrade from hardy release.
  + debian/nut-powerman-pdu.install, debian/nut-powerman-pdu.manpages: dropped for now.
  + debian/nul-hal-drivers.{docs,install,postinst,preinst}: Dropped since hal is in universe now
  + debian/nut.links: must create the init script link, used if the upse needs to be powered down
    (LP: #357583)
  + debian/source_nut.py, debian/nut.install, debian/rules: Install apport hook.
  + Dropped:
    - debian/patches/0002-fix_udev_action.patch: Accepted upstream.
    - debian/patches/0004-netvision-improvements-lp-600950: no longer needed.
    - debian/patches/0005-fix-nut-m4.patch: no longer needed.
    - debian/patches/9999-autoconf.patch: no longer needed.
* New upstream release (Closes: #575176, #588648, #609597, #687985)
* debian/patches/*.patch: removed since these are now fixed upstream
* debian/patches/0001-fix_spelling_and_typo.patch,
  debian/patches/series: reworked to match the new upstream release
* debian/nut.install, debian/nut.manpages: remove obsolete reference to
  megatec and megatec_usb, now respectively replaced by blazer_ser and
  blazer_usb
* debian/nut.docs: limit distributed documentation
* debian/control:
  - Wrap build-dependencies
  - Change nut-cgi Recommends to apache2 | httpd-cgi
* debian/nut.postinst: Only trigger USB subsystem, should Closes: #574769
* debian/patches/0002-fix_udev_action.patch: Use SUBSYSTEM instead of BUS
* debian/control, debian/rules, 
  debian/nut-hal-drivers.{docs,install,postinst,preinst}: Drop
  nut-hal-drivers since Nut doesnt go into universe.
* Split patches/debian-changes-2.4.3-2ubuntu1 into
  patches/0005-fix-nut-m4.patch and patches/9999-autoconf.patch
* Readd lost debian/patches0004-netvision-improvements-lp-600950.patch patch
  (LP: #707050)
* debian/patches/0002-fix_udev_action.patch:
  Change BUS to SUBSYSTEMS, since the former is deprecated. (LP: #692171)
* debian/nut.postinst: Uncomment missing call to adduser
* debian/control: Drop hal build dependency, we don't need the daemon to
  build the package. Add a hal dependency to nut-hal-drivers, which is the
  only thing that actually needs it.
* Merge from debian unstable.  Remaining changes:
  + debian/control:
    - Update maintainer as per spec.
    - Add Breaks on nut-hal-drivers to ensure we have correct udev version.
    - Drop libpowerman0-dev from the Build-Depends (currently in universe)
  + debian/{nut-cgi,nut}.postinst: add nut to the dialout and nut groups
    unconditonally to hanle the upgrade from hardy release.
  + debian/nut-powerman-pdu.install, debian/nut-powerman-pdu.manpages: dropped for now.
  + debian/nut.links: must create the init script link, used if the upse needs to be powered down
    (LP: #357583)
  + debian/nut.postinst: Update udevadm trigger.
    "libusb_get_report: error sending control message: 
     Operation not permitted" error on some UPS devices. (LP: #572262)
  + debian/source_nut.py, debian/nut.install, debian/rules: Install apport hook.
  + debian/patches/netvision-improvements-lp-600950.patch: Add improvements
    for netvision UPSes
  + Fix FTBFS with ld --as-needed.
  + Dropped:
    - debian/patches/03_udev_rules_change.dpatch: Use debian's instead.
    - debian/patches/04_nut_small-buffers.dpatch: Use debian's instead.
* debian/control:
  - Bump Standards-Version to 3.9.1
  - Update Vcs-* fields to new GIT repository
  - Add myself as Uploaders
* Switch to dpkg-source 3.0 (quilt) format (Closes: #573601)
* debian/patches/0001-low_speed_usb_ups.patch: Use patch system for changes
  that were applied directly in the source
* Add debian/gbp.conf file
* debian/watch: Bump version to 3
* Add debian/patches/0002-fix_udev_action.patch: Also set permission for
  "change" udev ACTION (Closes: #557178)
* debian/nut.postrm: Do not try to remove nut user is deluser is not
  installed anymore
* debian/nut.manpages: Install manpage nut.conf.5 (Closes: #528222)
* debian/copyright: Fix copyright-with-old-dh-make-debian-copyright
* Remove nut-snmp.lintian-overrides, not needed anymore
* debian/patches/0003-fix_spelling_and_typo.patch: Fix some spelling errors
* Add debian/libupsclient1.symbols file
* Add debian/nut.links: Re-add /etc/init.d/ups-monitor that was lost for
  some reasons (Closes: #592351)
* debian/nut.lintian-overrides: Add override for
  init.d-script-does-not-provide-itself /etc/init.d/ups-monitor
* Drop libupsclient1.post{inst,rm}: ldconfig call is added automatically by
  debhelper
* debian/libupsclient1-dev.install: Do not ship /lib/libupsclient.la anymore
* debian/rules: Remove dpatch logic as we are using package source version
  '3.0 (quilt)'
* debian/compat: Bump debhelper compatibility to 8
* Non-maintainer upload.
* drivers/libhid.c: Apply r2407 from upstream to fix bug with some
  low speed UPS devices. (Closes: #583371)
* Fix FTBFS with ld --as-needed.
* debian/patches/netvision-improvements-lp-600950.patch: Add improvements for netvision UPSes 
  (LP: #600950) 
* debian/source_nut.py, debian/nut.install, debian/rules: Install apport hook. 
* debian/patches/04_nut-small-buffers.dpatch: Fix "libusb_get_report: error sending control message: 
  Operation not permitted" error on some UPS devices. (LP: #572262)
* debian/nut.postinst: Revert dropping of --action=change. "add" events must
  not ever be triggered automatically.
* Add 03_udev_rules_change.dpatch: Run udev rules on change events, too.
* debian/control: grr...fix ftbfs. 
* Merge from debian testing.  Remaining changes (LP: #535152):
  + debian/control:
    - Update maintainer as per spec.
    - Add Breaks on nut-hal-drivers to ensure we have correct udev version.
    - Drop libpowerman0-dev from the Build-Depends (currently in universe)
  + debian/{nut-cgi,nut}.postinst: add nut to the dialout and nut groups
    unconditonally to hanle the upgrade from hardy release.
  + debian/nut-powerman-pdu.install, debian/nut-powerman-pdu.manpages: dropped for now.
  + debian/nut.links: must create the init script link, used if the upse needs to be powered down
    (LP: #357583)
  + debian/nut.postinst: Update udevadm trigger.
  + Dropped:
    - debian/patches/02-fix-trust-pw4130m.dpatch: No longer needed.
* New upstream release (Closes: #544390, #528222, #539747, #526811,
  #562064)
* debian/nut.install, debian/nut.manpages:
  - remove cyberpower driver and manpage
  - add bestfortress, clone and ivtscd drivers and manpages
* debian/rules:
  - change udev dir to /lib/udev (Closes: #522327)
  - replace deprecated calls to 'dh_clean -k' by dh_prep (Closes: #536599)
* debian/rules, debian/nut.install, debian/nut.install,
  debian/nut.README.Debian: install configuration files, without the
  sample suffix (Closes: #528641)
* debian/nut.links: restored (Closes: #522506)
* debian/nut.init:
  - source nut.conf instead of default/nut for POWEROFF_WAIT(Closes:
    #538173)
  - fix status checking (Closes: #538785)
  - improve detection of non configured system and beautify related
    output (Closes: #563112)
  - use 'invoke-rc.d' instead of calling the reboot script directly
  - add $remote_fs to Required-Start and Required-Stop
* debian/nut.postrm: remove udev files and simplify cleanup (Closes:
  #541629)
* debian/control:
  - remove Luca Filipozzi from the Uploaders list (Closes: #568987)
  - update Standards-Version to 3.8.4
  - remove the debconf dependency
  - bump debhelper version to (>= 7) in Build-Depends, for dh_prep
  - add Breaks on nut-hal-drivers to ensure we have correct udev version
* Remove debconf support since it was related to really old nut
  version (Closes: #518056):
  - remove nut-cgi.config, nut.config, nut-cgi.templates, nut.templates,
    and po/ directory
  - update nut-cgi.postinst
* debian/nut.dirs: remove /var/run/nut to conform to Debian Policy
* debian/nut.postint:
  - create /var/run/nut if needed
  - improve security checks
* debian/nut.README.Debian: add a security note for ups.conf
* debian/watch: URL update
* debian/patches/02-fix-trust-pw4130m.dpatch: Fix issues with Trust
  PW-4130M UPS. (LP: #447586) 

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH upsstats.html 5 "Thu Feb  9 2006" "" "Network UPS Tools (NUT)"
2
 
.SH NAME
3
 
upsstats.html \- HTML template for Network UPS Tools upsstats
4
 
 
5
 
.SH DESCRIPTION
6
 
 
7
 
This file is used by \fBupsstats.cgi\fR(8) to generate status pages.
8
 
Certain commands are recognized, and will be replaced with various
9
 
status elements on the fly.
10
 
 
11
 
.SH FORMATTING
12
 
 
13
 
Commands can be placed anywhere on a line, but must start and end with @.
14
 
Any extra characters before or after the commands will be passed through
15
 
unchanged.  It is allowed to use more than one command on a single line,
16
 
as long as each command has its own start and end character.  If you need
17
 
to use the @ sign, use &#64; to prevent it from being treated as a start
18
 
character.
19
 
 
20
 
.SH BLOCK CONTROL
21
 
 
22
 
Some commands begin blocks - sections of the template that will be
23
 
included, excluded, or repeated depending on certain parameters.
24
 
 
25
 
.SH BLOCK CONTROL - ITERATION
26
 
 
27
 
.IP @FOREACHUPS@
28
 
Starts a block that will be repeated for each MONITOR directive in the
29
 
\fBhosts.conf\fR(5).  This is how you can generate pages that monitor
30
 
all of your systems simultaneously.
31
 
 
32
 
.IP @ENDFOR@
33
 
Ends a FOREACHUPS block.
34
 
 
35
 
.SH BLOCK CONTROL - MATCHING SPECIFIC CASES
36
 
 
37
 
.IP "@IFSUPP var@"
38
 
Starts a block that will only be printed if the variable var is
39
 
supported by the current UPS.  This is generally used to suppress "not
40
 
supported" messages by avoiding the label and variable call entirely.
41
 
 
42
 
.IP "@IFEQ var value@"
43
 
Starts a block if the value returned from the variable var matches
44
 
value.
45
 
 
46
 
.IP "@IFBETWEEN varlow varhigh varvalue@"
47
 
Starts a block if the value returned by the variable varvalue is between
48
 
the values returned by the variables varlow and varhigh.
49
 
 
50
 
.IP @ELSE@
51
 
If the previous IF-command did not match, perform this instead.
52
 
 
53
 
.IP @ENDIF@
54
 
Ends an IF/ELSE-block.
55
 
 
56
 
.SH BLOCK CONTROL - ADVANCED EXPRESSIONS
57
 
 
58
 
Even though the parser is pretty limited, it's still possible to create
59
 
rather advanced expressions. The key to this is the fact that
60
 
multiple block control commands are AND:ed. This is illustrated with an
61
 
example (more examples are available in upsstats.html).
62
 
 
63
 
@IFSUPP ambient.humidity@
64
 
 
65
 
@IFSUPP ambient.temperature@
66
 
 
67
 
This UPS knows both ambient temperature and humidity.
68
 
 
69
 
@ELSE@
70
 
 
71
 
@IFSUPP ambient.humidity@
72
 
 
73
 
This UPS only knows ambient humidity.
74
 
 
75
 
@ELSE@
76
 
 
77
 
@IFSUPP ambient.temperature@
78
 
 
79
 
This UPS only knows ambient temperature.
80
 
 
81
 
@ELSE
82
 
 
83
 
This UPS knows nothing, how annoying.
84
 
 
85
 
@ENDIF@
86
 
 
87
 
.P
88
 
 
89
 
.SH OTHER COMMANDS
90
 
 
91
 
.IP @AMBTEMP@
92
 
Insert the ambient temperature in the current temperature scale.
93
 
 
94
 
.IP "@DATE format@"
95
 
Insert the current date and time.  The format string is passed to strftime,
96
 
so almost anything is possible.  See \fBstrftime\fR(3) for possible values.
97
 
 
98
 
.IP @DEGREES@
99
 
Insert the entity for degrees (&deg;) and either C or F depending on
100
 
the current temperature scale.
101
 
 
102
 
.IP @HOST@
103
 
Insert the designation of the host being monitored, like myups@localhost.
104
 
 
105
 
.IP @HOSTDESC@
106
 
Insert the host's description from \fBhosts.conf\fR(5).
107
 
 
108
 
.IP @HOSTLINK@
109
 
Insert a link to upsstats.cgi with the "host" variable set to the
110
 
current UPS.  This is only useful within a FOREACHUPS block.
111
 
 
112
 
.IP "@IMG varname [\fIextra\fR]@"
113
 
Insert an IMG SRC to \fBupsimage.cgi\fR(8) for one of these
114
 
status variables:
115
 
 
116
 
        battery.charge - Battery charge - a percentage
117
 
 
118
 
        battery.voltage - The charge on the battery in volts
119
 
 
120
 
        input.frequency - Incoming utility frequency (Hz)
121
 
 
122
 
        input.voltage - Incoming utility voltage
123
 
 
124
 
        input.L1-L2.voltage - Incoming voltage, L1-L2 (3phase)
125
 
 
126
 
        input.L2-L3.voltage - Incoming voltage, L2-L3 (3phase)
127
 
 
128
 
        input.L3-L1.voltage - Incoming voltage, L3-L1 (3phase)
129
 
 
130
 
        output.frequency - Outgoing utility frequency (Hz)
131
 
 
132
 
        output.voltage - Outgoing voltage (from the UPS)
133
 
 
134
 
        output.L1-L2.voltage - Outgoing voltage, L1-L2 (3phase)
135
 
 
136
 
        output.L2-L3.voltage - Outgoing voltage, L2-L3 (3phase)
137
 
 
138
 
        output.L3-L1.voltage - Outgoing voltage, L3-L1 (3phase)
139
 
 
140
 
        output.L1.power.percent - UPS load, L1 (3phase)
141
 
 
142
 
        output.L2.power.percent - UPS load, L2 (3phase)
143
 
 
144
 
        output.L3.power.percent - UPS load, L3 (3phase)
145
 
 
146
 
        ups.load - UPS load - percentage
147
 
 
148
 
        ups.temperature - UPS temperature 
149
 
 
150
 
\fIextra\fR is where you can put additional definitions.  Right now
151
 
the valid definitions are colors for various parts of the bars drawn
152
 
by upsimage.cgi.  Possible color names are:
153
 
 
154
 
        back_col - background color
155
 
 
156
 
        scale_num_col - scale number color
157
 
 
158
 
        summary_col - summary color (number at the bottom)
159
 
 
160
 
        ok_zone_maj_col - major scale color for the normal ("ok") zone
161
 
 
162
 
        ok_zone_min_col - minor scale color for the normal ("ok") zone
163
 
 
164
 
        neutral_zone_maj_col - major scale color for the neutral zone
165
 
 
166
 
        neutral_zone_min_col - minor scale color for the neutral zone
167
 
 
168
 
        warn_zone_maj_col - major scale color for the warning zone
169
 
 
170
 
        warn_zone_min_col - minor scale color for the warning zone
171
 
 
172
 
        bar_col - the color of the bar in the middle
173
 
 
174
 
All colors are hex triplets - 0xff0000 is red, 0x00ff00 is green, and
175
 
0x0000ff is blue.
176
 
 
177
 
Examples:
178
 
 
179
 
        @IMG battery.charge@
180
 
 
181
 
        @IMG battery.charge back_col=0xff00ff bar_col=0xaabbcc@
182
 
 
183
 
        @IMG input.voltage ok_zone_maj_col=0x123456@
184
 
 
185
 
.IP @REFRESH@
186
 
Insert the META header magic for refreshing the page if that variable
187
 
has been set by the browser.  This needs to be in the HEAD section of
188
 
the page.
189
 
 
190
 
.IP @STATUS@
191
 
Expand the abbreviations in the ups.status variable - OL becomes
192
 
"On line", OB becomes "On battery", and so on.
193
 
 
194
 
.IP @STATUSCOLOR@
195
 
Insert red, green, or yellow color triplets depending on the severity of
196
 
the current UPS status.  Normal operations are green, warnings like
197
 
voltage trim/boost or "off" are yellow, and other events like being on
198
 
battery or having a low battery are red.
199
 
 
200
 
.IP "@VAR varname@"
201
 
Insert the current value of the status variable varname on the host being 
202
 
monitored, or "Not supported".
203
 
 
204
 
.IP @RUNTIME@
205
 
Inserts the current runtime, in hh:mm:ss format.
206
 
 
207
 
.IP @TEMPC@
208
 
Use the Celsius scale for temperature data (default).
209
 
 
210
 
.IP @TEMPF@
211
 
Use the Fahrenheit scale for temperature data.
212
 
 
213
 
.IP @UPSTEMP@
214
 
Insert the UPS temperature in the current scale.
215
 
 
216
 
.IP @BATTTEMP@
217
 
Insert the battery temperature in the current scale.
218
 
 
219
 
.IP @UTILITYCOLOR@
220
 
Obsoleted. Use IFBETWEEN instead (see example in upsstats.html).
221
 
 
222
 
.IP @VERSION@
223
 
Insert the version number of the software.
224
 
 
225
 
.SH OTHER TEMPLATES
226
 
\fBupsstats.cgi\fR(8) will also open a file called upsstats-single.html
227
 
if you call it with "host=" set in the URL.  That file uses the same
228
 
rules and techniques documented here.
229
 
 
230
 
.SH SEE ALSO
231
 
\fBupsstats.cgi\fR(8), \fBupsimage.cgi\fR(8)
232
 
 
233
 
.SS Internet resources:
234
 
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/