UPSD.USERS(5) Network UPS Tools (NUT) UPSD.USERS(5)NAMEupsd.users - Administrative user definitions for NUT upsd
DESCRIPTION
Administrative commands such as setting variables and the
instant commands are powerful, and access to them needs to
be restricted. This file defines who may access them, and
what is available.
Each user gets its own section. The fields in that sec-
tion set the parameters associated with that user's privi-
leges. The section begins with the name of the user in
brackets, and continues until the next user name in brack-
ets or EOF.
Here are some examples to get you started:
[admin]
password = mypass
allowfrom = workstation admhome
actions = set
instcmds = all
[pfy]
password = duh
allowfrom = gameosbox
instcmds = fptest
[monmaster]
password = blah
allowfrom = bigserver
upsmon master
[monslave]
password = abcd
allowfrom = workstation
upsmon slave
FIELDS
password
Set the password for this user.
allowfrom
Grant access to the user based on the source IP
address. The values for this field are the names
of your ACLs in the ups.conf(5).
actions
Allow the user to do certain things with upsd.
Valid actions are:
SET - change the value of certain variables in
the UPS
FSD - set the forced shutdown flag in the UPS.
This is equivalent to an "on battery + low battery"
situation for the purposes of monitoring.
The list of actions is expected to grow in the
future.
instcmds
Let a user initiate specific instant commands. Use
"ALL" to grant all commands automatically. Here
are a few instant commands. For the full list, see
include/shared-tables.h or check with "upscmd -l".
FPTEST - Front panel test
BTEST0 - Stop battery test
BTEST1 - Start battery test
CAL0 - Stop calibration
CAL1 - Start calibration
upsmon Add the necessary actions for a upsmon process to
work. This is either set to "master" or "slave".
Do not attempt to assign actions to upsmon by hand,
as you may miss something important. This method
of designating a "upsmon user" was created so
internal capabilities could be changed later on
without breaking existing installations.
SEE ALSOupsd(8), upsd.conf(5)
Internet resources:
The NUT (Network UPS Tools) home page:
http://www.exploits.org/nut/
NUT mailing list archives and information:
http://lists.exploits.org/
Fri Sep 6 2002 UPSD.USERS(5)