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   31559 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

UPSD.USERS(5)	     Network UPS Tools (NUT)	    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  sec-
       tion set the parameters associated with that user's privi-
       leges.  The section begins with the name of  the	 user  in
       brackets, and continues until the next user name in brack-
       ets 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/

			 Fri Sep  6 2002	    UPSD.USERS(5)

Vote for polarhome