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
                        allowfrom = workstation admhome
                        actions = set
                        instcmds = all

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

                   [monmaster]
                        password = blah
                        allowfrom = bigserver
                        upsmon master

                   [monslave]
                        password = abcd
                        allowfrom = workstation
                        upsmon slave

FIELDS

       password

              Set the password for this user.


       allowfrom

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


       actions

              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.

SEE ALSO

       upsd(8), upsd.conf(5)


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




                                Mon Jul 14 2003                  UPSD.USERS(5)