source: projects/initscripts/tags/initscripts-8.91.3/src/usernetctl.8 @ 1108

Revision 1108, 1.3 KB checked in by daisuke, 13 years ago (diff)

import initscripts-8.90.6 from internal cvs repository

Line 
1.TH USERNETCTL 8 "Red Hat, Inc." "RHS" \" -*- nroff -*-
2.SH NAME
3usernetctl \- 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
9checks to see if users are allowed to manipulate the network interface
10specified by \fIinterface-name\fP, and then tries to bring the network
11interface up or down, if up or down was specified on the command line,
12or returns true or false status (respectively) if the report option was
13specified.
14
15.B usernetctl
16is not really meant to be called directly by users, though it currently
17works fine that way.  It is used as a wrapper by the ifup and ifdown
18scripts, so that users can do exactly the same thing as root:
19.nf
20ifup \fIinterface-name\fP
21ifdown \fIinterface-name\fP
22.fi
23and \fBifup\fP and \fBifdown\fP will call usernetctl automatically to
24allow the interface status change.
25.SH OPTIONS
26.TP
27.I "\fIinterface-name"
28The name of the network interface to check; for example, "ppp0".  For
29backwards compatibility, "ifcfg-ppp0" and
30"/etc/sysconfig/network-scripts/ifcfg-ppp0" are also supported.
31.TP
32up\fI|\fPdown
33Attempt to bring the interface up or down.
34.TP
35report
36Report on whether users can bring the interface up or down.
37.SH NOTES
38Alternate device configurations may inherit the default configuration's
39permissions.
Note: See TracBrowser for help on using the repository browser.