[projects/rc-scripts.git] / src / usernetctl.1

.TH USERNETCTL 1 "Red Hat Software" "RHS" \" -*- nroff -*-
.SH NAME
usernetctl \- allow a user to manipulate a network interface if permitted
.SH SYNOPSIS
.B usernetctl
\fIinterface-name\fP up\fI|\fPdown\fI|\fPreport
.SH DESCRIPTION
.B usernetctl
checks to see if users are allowed to manipulate the network interface
specified by \fIinterface-name\fP, and then tries to bring the network
interface up or down, if up or down was specified on the command line,
or returns true or false status (respectively) if the report option was
specified.
.SH OPTIONS
.TP
.I "\fIinterface-name"
The name of the network interface to check; for example, "ppp0".  For
backwards compatibility, "ifcfg-ppp0" and
"/etc/sysconfig/network-scripts/ifcfg-ppp0" are also supported.
.TP
up\fI|\fPdown
Attempt to bring the interface up or down.
.TP
report
Report on whether users can bring the interface up or down.
.SH NOTES
Alternate device configurations may inherit the default configuration's
permissions.
Commit	Line	Data
7742e157 AF	1	.TH USERNETCTL 1 "Red Hat Software" "RHS" \" -- nroff --
	2	.SH NAME
	3	usernetctl \- allow a user to manipulate a network interface if permitted
	4	.SH SYNOPSIS
	5	.B usernetctl
	6	\fIinterface-name\fP up\fI\|\fPdown\fI\|\fPreport
	7	.SH DESCRIPTION
	8	.B usernetctl
	9	checks to see if users are allowed to manipulate the network interface
	10	specified by \fIinterface-name\fP, and then tries to bring the network
	11	interface up or down, if up or down was specified on the command line,
	12	or returns true or false status (respectively) if the report option was
	13	specified.
	14	.SH OPTIONS
	15	.TP
	16	.I "\fIinterface-name"
	17	The name of the network interface to check; for example, "ppp0". For
	18	backwards compatibility, "ifcfg-ppp0" and
	19	"/etc/sysconfig/network-scripts/ifcfg-ppp0" are also supported.
	20	.TP
	21	up\fI\|\fPdown
	22	Attempt to bring the interface up or down.
	23	.TP
	24	report
	25	Report on whether users can bring the interface up or down.
	26	.SH NOTES
	27	Alternate device configurations may inherit the default configuration's
	28	permissions.