lagertonne/nut
1
0
Fork 0
Code Issues Pull requests Projects Releases 2 Wiki Activity

Imported Upstream version 2.6.0

Browse source
This commit is contained in:
arnaud.quette@free.fr 2011-01-26 10:35:08 +01:00
parent 26fb71b504
commit 459aaf9392
510 changed files with 40508 additions and 18859 deletions
Download patch file Download diff file Expand all files Collapse all files

133
docs/man/upsd.users.5 Normal file
View file

@ -0,0 +1,133 @@
'\" t
.\" Title: upsd.users
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 12/24/2010
.\" Manual: NUT Manual
.\" Source: Network UPS Tools
.\" Language: English
.\"
.TH "UPSD\&.USERS" "5" "12/24/2010" "Network UPS Tools" "NUT Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
upsd.users \- Administrative user definitions for NUT upsd
.SH "DESCRIPTION"
.sp
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\&.
.sp
Each user gets its own section\&. The fields in that section set the parameters associated with that user\(cqs 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\&.
.sp
Here are some examples to get you started:
.sp
.if n \{\
.RS 4
.\}
.nf
[admin]
password = mypass
actions = set
instcmds = all
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
[pfy]
password = duh
instcmds = test\&.panel\&.start
instcmds = test\&.panel\&.stop
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
[monmaster]
password = blah
upsmon master
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
[monslave]
password = abcd
upsmon slave
.fi
.if n \{\
.RE
.\}
.SH "FIELDS"
.PP
\fBpassword\fR
.RS 4
Set the password for this user\&.
.RE
.PP
\fBactions\fR
.RS 4
Allow the user to do certain things with upsd\&. Valid actions are:
.PP
SET
.RS 4
change the value of certain variables in the UPS
.RE
.PP
FSD
.RS 4
set the forced shutdown flag in the UPS\&. This is equivalent to an "on battery + low battery" situation for the purposes of monitoring\&.
.sp
The list of actions is expected to grow in the future\&.
.RE
.RE
.PP
\fBinstcmds\fR
.RS 4
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"\&.
.sp
The
cmdvartab
file supplied with the distribution contains a list of most of the known command names\&.
.RE
.PP
\fBupsmon\fR
.RS 4
Add the necessary actions for a upsmon process to work\&. This is either set to "master" or "slave"\&.
.sp
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\&.
.RE
.SH "SEE ALSO"
.sp
\fBupsd\fR(8), \fBupsd.conf\fR(5)
.SH "INTERNET RESOURCES"
.sp
The NUT (Network UPS Tools) home page: http://www\&.networkupstools\&.org/