Provided by: nut_2.2.1-2.1ubuntu7_i386 bug


       upsd.users - Administrative user definitions for NUT upsd


       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.

       Here are some examples to get you started:

                        password = mypass
                        allowfrom = workstation admhome
                        actions = set
                        instcmds = all

                        password = duh
                        allowfrom = gameosbox
                        instcmds = test.panel.start

                        password = blah
                        allowfrom = bigserver
                        upsmon master

                        password = abcd
                        allowfrom = workstation
                        upsmon slave



              Set the password for this user.


              Grant access to the user based on the source  IP  address.   The
              values  for  this  field  are  the  names  of  your  ACLs in the


              Allow the user to do certain things with  upsd.   Valid  actions

                   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.


              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.


       upsd(8), upsd.conf(5)

   Internet resources:
       The NUT (Network UPS Tools) home page:

                                Mon Jul 14 2003                  UPSD.USERS(5)