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                   actions = fsd
25                   instcmds = all
26
27           [pfy]
28                   password = duh
29                   instcmds = test.panel.start
30                   instcmds = test.panel.stop
31
32           [upswired]
33                   password = blah
34                   upsmon primary
35
36           [observer]
37                   password = abcd
38                   upsmon secondary
39

FIELDS

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

SEE ALSO

78       upsd(8), upsd.conf(5)
79
80   Internet resources:
81       The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
82
83
84
85Network UPS Tools 2.8.0           04/26/2022                     UPSD.USERS(5)
Impressum