1 .TH USERNETCTL 8 "Red Hat, Inc." "RHS" \" -*- nroff -*-
3 usernetctl \- allow a user to manipulate a network interface if permitted
6 \fIinterface-name\fP up\fI|\fPdown\fI|\fPreport
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
16 is not really meant to be called directly by users, though it currently
17 works fine that way. It is used as a wrapper by the ifup and ifdown
18 scripts, so that users can do exactly the same thing as root:
20 ifup \fIinterface-name\fP
21 ifdown \fIinterface-name\fP
23 and \fBifup\fP and \fBifdown\fP will call usernetctl automatically to
24 allow the interface status change.
27 .I "\fIinterface-name"
28 The name of the network interface to check; for example, "ppp0". For
29 backwards compatibility, "ifcfg-ppp0" and
30 "/lib/rc-scripts/ifcfg-ppp0" are also supported.
33 Attempt to bring the interface up or down.
36 Report on whether users can bring the interface up or down.
38 Alternate device configurations may inherit the default configuration's