


UPSD.USERS(5)        Network UPS Tools (NUT)        UPSD.USERS(5)


NAME
       upsd.users - Administrative user definitions for NUT upsd


DESCRIPTION
       Administrative  commands such as setting variables and the instant com-
       mands 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.

       Here are some examples to get you started:


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

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

                   [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.



                         Mon Nov 30 2009                        1





UPSD.USERS(5)        Network UPS Tools (NUT)        UPSD.USERS(5)


       instcmds

              Let  a  user  initiate  specific instant commands.  Use "ALL" to
              grant all commands automatically.  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.


UPGRADING FROM OLDER VERSIONS
       The allowfrom mechanism that existed in versions before  nut-2.4.0  has
       been  replaced  by  tcp-wrappers.  Further  details  are  described  in
       upsd(8).


SEE ALSO
       upsd(8), upsd.conf(5)


   Internet resources:
       The NUT (Network UPS Tools) home page: http://www.networkupstools.org/


























                         Mon Nov 30 2009                        2


