1 | .TH USERNETCTL 8 "Red Hat, Inc." "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 | |
---|
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. |
---|
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 |
---|
30 | "/etc/sysconfig/network-scripts/ifcfg-ppp0" are also supported. |
---|
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. |
---|