]>
Commit | Line | Data |
---|---|---|
458f14b7 | 1 | .TH USERNETCTL 8 "Red Hat, Inc." "RHS" \" -*- nroff -*- |
7e04fe0e | 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. | |
458f14b7 AM |
14 | |
15 | .B usernetctl | |
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: | |
19 | .nf | |
20 | ifup \fIinterface-name\fP | |
21 | ifdown \fIinterface-name\fP | |
22 | .fi | |
23 | and \fBifup\fP and \fBifdown\fP will call usernetctl automatically to | |
24 | allow the interface status change. | |
7e04fe0e | 25 | .SH OPTIONS |
26 | .TP | |
27 | .I "\fIinterface-name" | |
28 | The name of the network interface to check; for example, "ppp0". For | |
29 | backwards compatibility, "ifcfg-ppp0" and | |
f67ce454 | 30 | "/lib/rc-scripts/ifcfg-ppp0" are also supported. |
7e04fe0e | 31 | .TP |
32 | up\fI|\fPdown | |
33 | Attempt to bring the interface up or down. | |
34 | .TP | |
35 | report | |
36 | Report on whether users can bring the interface up or down. | |
37 | .SH NOTES | |
38 | Alternate device configurations may inherit the default configuration's | |
39 | permissions. |