Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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
		   actions = fsd
		   instcmds = all

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

	   [upswired]
		   password = blah
		   upsmon primary

	   [observer]
		   password = abcd
		   upsmon secondary

FIELDS
       password
	   Set the password for	this user.

       actions
	   Allow the user to do	certain	things with upsd. To specify multiple
	   actions, use	multiple instances of the actions field. 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 "primary" or "secondary".

	   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 2.8.0.	  01/23/2023			 UPSD.USERS(5)
NAME | DESCRIPTION | FIELDS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=upsd.users&manpath=FreeBSD+13.1-RELEASE+and+Ports>

home | help