nut-debian/docs/man/upsd.users.txt

UPSD.USERS(5)
=============

NAME
----
upsd.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 section set the 
parameters associated with that user's privileges.  The section begins
with the name of the user in brackets, and continues until the next user
name in brackets or EOF.  These users are independent of /etc/passwd.

Here are some examples to get you started:

	[admin]
		password = mypass
		actions = set
		instcmds = all

	[pfy]
		password = duh
		instcmds = test.panel.start
		instcmds = test.panel.stop

	[monmaster]
		password = blah
		upsmon master

	[monslave]
		password = abcd
		upsmon slave

FIELDS
------

*password*::

Set the password for this user.

*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.  To specify multiple commands, use multiple
instances of the instcmds field.  For the full list of what your UPS
supports, use "upscmd -l".
+
The +cmdvartab+ file supplied with the distribution contains a list
of most of the known command names.

*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 ALSO
--------

linkman:upsd[8], linkman:upsd.conf[5]

INTERNET RESOURCES
------------------
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/