man/usernetctl.8

   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 "/lib/rc-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.