View Source: upscmd(8) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages

UPSCMD
!!!UPSCMD
NAME
SYNOPSIS
DESCRIPTION
OPTIONS
UNATTENDED MODE
DANGEROUS COMMANDS
DIAGNOSTICS
BUGS
SEE ALSO
----
!!NAME


upscmd - UPS administration program for instant commands
!!SYNOPSIS


__upscmd -h__


__upscmd -l__ ''ups''


__upscmd [[-u__ ''username''__] [[-p__
''password''__]__ ''ups command''
!!DESCRIPTION


__upscmd__ allows you to invoke
__


On hardware that supports it, you can use this program to
start and stop battery tests, invoke a front panel test
(beep!), turn the load on or off, and more.
!!OPTIONS


-h


Display the help message.


-l ''ups''


Show the list of supported instant commands on that UPS.
Some hardware may not support any of them.


-u ''username''


Set the username for the connection to the server. This is
optional, and you will be prompted for this when invoking a
command if -u is not used.


-p ''password''


Set the password to authenticate to the server. This is also
optional like -u, and you will be prompted for it if
necessary.


''ups''


Connect to that UPS. The format for this option is
[[upsname@]hostname[[:port].
!!UNATTENDED MODE


If you run this program inside a shell script or similar to
invoke a command, you will need to specify all of the
information on the command line. This means using -u and -p.
Otherwise it will put up a prompt and your program will
hang.


This is not necessary when displaying the list, as the
username and password are not required for read-only
mode.
!!DANGEROUS COMMANDS


Some drivers like apcsmart(8) have built-in paranoia
for the dangerous commands like OFF. To make them actually
turn off the load, you will have to send the command twice
within a short window. That is, you will have to send it
once, then send it again after 3 seconds elapse but before
15 seconds pass.


This paranoia is entirely defined within the driver. upsd
and upscmd have no control over the timing.
!!DIAGNOSTICS


upscmd won't work unless you provide a valid username and
password. If you get
upsd.users__(5) has an entry for you,
and that the username you are using has permissions to SET
variables.
!!BUGS


There is currently no way to tell the user when the driver
requires confirmation to invoke a command such as OFF.
Similarly, there is not yet a way to tell the user if a
command succeeds or fails.
!!SEE ALSO


upsd(8), upsct2(8)


__Internet resources:__


The NUT (Network UPS Tools) home page:
http://www.exploits.org/nut/


NUT mailing list archives and information:
http://lists.exploits.org/
----

7 pages link to upscmd(8):

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Last edited on Tuesday, June 4, 2002 12:31:22 am by "perry"

Edit PageHistory Diff Info LikePages