Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   17783 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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

	   [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. 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 "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		  08/07/2012			 UPSD.USERS(5)

Vote for polarhome