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. Here are some examples to get you started:

    	[admin]
    		password = mypass
    		allowfrom = workstation admhome
    		actions = set
    		instcmds = all
    	[pfy]
    		password = duh
    		allowfrom = gameosbox
    		instcmds = fptest
    	[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 ups.conf(5).

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. Here are a few instant commands. For the full list, see include/shared-tables.h or check with "upscmd -l".
        FPTEST - Front panel test
        BTEST0 - Stop battery test
        BTEST1 - Start battery test
        CAL0 - Stop calibration
        CAL1 - Start calibration

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.exploits.org/nut/ NUT mailing list archives and information: http://lists.exploits.org/