upsd.users(5)

1UPSD.USERS(5)               Network UPS Tools (NUT)              UPSD.USERS(5)
2
3
4

NAME

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

DESCRIPTION

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

FIELDS

44       password
45
46              Set the password for this user.
47
48
49       allowfrom
50
51              Grant access to the user based on the source  IP  address.   The
52              values  for  this  field  are  the  names  of  your  ACLs in the
53              upsd.conf(5).
54
55
56       actions
57
58              Allow the user to do certain things with  upsd.   Valid  actions
59              are:
60
61                   SET ‐ change the value of certain variables in the UPS
62
63                   FSD  ‐  set  the  forced shutdown flag in the UPS.  This is
64              equivalent to an "on battery + low battery"  situation  for  the
65              purposes of monitoring.
66
67              The list of actions is expected to grow in the future.
68
69
70       instcmds
71
72              Let  a  user  initiate  specific instant commands.  Use "ALL" to
73              grant all commands automatically.  For the  full  list  of  what
74              your UPS supports, use "upscmd -l".
75
76              The  cmdvartab  file  supplied  with the distribution contains a
77              list of most of the known command names.
78
79
80       upsmon
81
82              Add the necessary actions for a upsmon process to work.  This is
83              either set to "master" or "slave".
84
85              Do  not  attempt to assign actions to upsmon by hand, as you may
86              miss something important.  This method of designating a  "upsmon
87              user"  was  created  so  internal  capabilities could be changed
88              later on without breaking existing installations.
89
90

NAME

DESCRIPTION

FIELDS

SEE ALSO