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.

DIRECTIVES

USER username
    Create a new user called username. This must happen above any other directives that operate on this user. It's also case sensitive, so "admin", "Admin", and "ADMIN" are three different people. Example:
        USER admin

PASSWORD username password
    Set the password of user username to password. Example:
        PASSWORD admin mypass

ALLOW username acl1 acl2 acl3 acl4 acl5
    Grant access to the user from up to 5 locations defined by the ACLs in your upsd.conf. If you need more locations, use more ALLOW lines with the same username. Example:
        ALLOW admin admworkstation admhome

ACTIONS username act1 act2 act3 act4 act4
    Let a user do certain things with upsd. If you need more than 5, use another ACTIONS line with the same username. Valid actions are:
        SET - change the value of certain variables in the UPS The list of actions is expected to grow in the future. Example:
        ACTIONS admin SET

INSTCMDS username cmd1 cmd2 cmd3 cmd4 cmd5
    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". Repeat the INSTCMDS <username> line to add more than 5 to a given user.
        FPTEST - Front panel test
        BTEST0 - Stop battery test
        BTEST1 - Start battery test
        CAL0 - Stop calibration
        CAL1 - Start calibration Example:
        INSTCMDS admin all

BUGS
The "repeat the line if you want more than 5" scheme is evil, ugly, confusing and broken. This will disappear once the dynamic-allocating configuration parser replaces the current static version. This file makes you repeat the username way too often. Expect the format of this file to become more like ups.conf(5) which will logically arrange things in sections by user.

SEE ALSO
upsd(8)

  Internet resources:
The NUT (Network UPS Tools) home page: http://www.exploits.org/nut/ The user mailing list: ups@lists.exploits.org