Imported Upstream version 2.6.0

docs/man/upsd.users.txt

@@ -0,0 +1,88 @@
+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/
+