UPSD.USERS(5)                     NUT Manual                     UPSD.USERS(5)



NAME
       upsd.users - Administrative user definitions for NUT upsd

DESCRIPTION
       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. These users are independent of
       /etc/passwd.

       Here are some examples to get you started:

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

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

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

       instcmds
           Let a user initiate specific instant commands. Use "ALL" to grant
           all commands automatically. To specify multiple commands, use
           multiple instances of the instcmds field. 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/



Network UPS Tools                 10/09/2011                     UPSD.USERS(5)
