UPSD.USERS

UPSD.USERS

NAME DESCRIPTION FIELDS NEW FORMAT SEE ALSO

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.

Two example entries might look like this

[admin?

password = mypass allowfrom = admworkstation admhome actions = set instcmds = all [pfy? password = duh allowfrom = gameosbox instcmds = fptest

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

The list of actions is expected to grow in the future.

instcmds

Let a user initiate specific instant commands. Use

FPTEST - Front panel test

BTEST0 - Stop battery test

BTEST1 - Start battery test

CAL0 - Stop calibration

CAL1 - Start calibration

NEW FORMAT

This file's format had to be forcibly changed to dump an evil and confusing scheme that required duplicating elements far too often.

upsd(8) doesn't know how to parse the old format. Once you install the new upsd, you must rewrite this file to use the new section-based style as documented above.

SEE ALSO

upsd(8)

Internet resources:

The NUT (Network UPS Tools) home page: http://www.exploits.org/nut/

NUT mailing list archives and information: http://lists.exploits.org/