1UPSD.USERS(5)                     NUT Manual                     UPSD.USERS(5)
2
3
4

NAME

6       upsd.users - Administrative user definitions for NUT upsd
7

DESCRIPTION

9       Administrative commands such as setting variables and the instant
10       commands are powerful, and access to them needs to be restricted. This
11       file defines who may access them, and what is available.
12
13       Each user gets its own section. The fields in that section set the
14       parameters associated with that user’s privileges. The section begins
15       with the name of the user in brackets, and continues until the next
16       user name in brackets or EOF. These users are independent of
17       /etc/passwd.
18
19       Here are some examples to get you started:
20
21           [admin]
22                   password = mypass
23                   actions = set
24                   instcmds = all
25
26           [pfy]
27                   password = duh
28                   instcmds = test.panel.start
29                   instcmds = test.panel.stop
30
31           [monmaster]
32                   password = blah
33                   upsmon master
34
35           [monslave]
36                   password = abcd
37                   upsmon slave
38

FIELDS

40       password
41           Set the password for this user.
42
43       actions
44           Allow the user to do certain things with upsd. Valid actions are:
45
46           SET
47               change the value of certain variables in the UPS
48
49           FSD
50               set the forced shutdown flag in the UPS. This is equivalent to
51               an "on battery + low battery" situation for the purposes of
52               monitoring.
53
54               The list of actions is expected to grow in the future.
55
56       instcmds
57           Let a user initiate specific instant commands. Use "ALL" to grant
58           all commands automatically. To specify multiple commands, use
59           multiple instances of the instcmds field. For the full list of what
60           your UPS supports, use "upscmd -l".
61
62           The cmdvartab file supplied with the distribution contains a list
63           of most of the known command names.
64
65       upsmon
66           Add the necessary actions for a upsmon process to work. This is
67           either set to "master" or "slave".
68
69           Do not attempt to assign actions to upsmon by hand, as you may miss
70           something important. This method of designating a "upsmon user" was
71           created so internal capabilities could be changed later on without
72           breaking existing installations.
73

SEE ALSO

75       upsd(8), upsd.conf(5)
76

INTERNET RESOURCES

78       The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
79
80
81
82Network UPS Tools                 09/15/2011                     UPSD.USERS(5)