---

Manual Reference Pages  - USERNETCTL (8)

---

usernetctl - allow a user to manipulate a network interface if permitted

CONTENTS

Synopsis
Description
Options
Notes

usernetctl interface-name up|down|report

usernetctl checks to see if users are allowed to manipulate the network interface specified by interface-name, and then tries to bring the network interface up or down, if up or down was specified on the command line, or returns true or false status (respectively) if the report option was specified.

usernetctl is not really meant to be called directly by users, though it currently works fine that way. It is used as a wrapper by the ifup and ifdown scripts, so that users can do exactly the same thing as root:

ifup interface-name
ifdown interface-name

and ifup and ifdown will call usernetctl automatically to allow the interface status change.

interface-name
	The name of the network interface to check; for example, "ppp0". For backwards compatibility, "ifcfg-ppp0" and "/etc/sysconfig/network-scripts/ifcfg-ppp0" are also supported.
up|down
	Attempt to bring the interface up or down.
report	Report on whether users can bring the interface up or down.

Alternate device configurations may inherit the default configuration’s permissions.

Jump to page    or go to Top of page |  Section 8 |  Main Index.