Support network device cloning via create and destroy options.

Reviewed by:	ru, ume
Obtained from:	NetBSD
MFC after:	1 week

1 files changed, 29 insertions, 0 deletions

diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8
index e4ef0f4..d564180 100644
--- a/sbin/ifconfig/ifconfig.8
+++ b/sbin/ifconfig/ifconfig.8
@@ -43,6 +43,7 @@
 .Op Fl L
 .Op Fl m
 .Ar interface
+.Op Cm create
 .Op Ar address_family
 .Oo
 .Ar address Ns Op Cm / Ns Ar prefixlength
@@ -50,6 +51,9 @@
 .Oc
 .Op Ar parameters
 .Nm
+.Ar interface
+.Cm destroy
+.Nm
 .Fl a
 .Op Fl L
 .Op Fl d
@@ -66,6 +70,7 @@
 .Op Fl d
 .Op Fl m
 .Op Fl u
+.Op Fl C
 .Sh DESCRIPTION
 .Nm Ifconfig
 is used to assign an address
@@ -269,6 +274,24 @@ IPv4/IPv6 header.
 Unconfigure the physical source and destination address for IP tunnel
 interfaces previously configured with
 .Cm tunnel .
+.It Cm create
+Create the specified network pseudo-device.
+If the interface is given without a unit number, try to create a new
+device with an arbitrary unit number.
+If creation of an arbitrary device is sucessful, the new device name is
+printed to stdout.
+.It Cm destroy
+Destroy the specified network pseudo-device.
+.It Cm plumb
+Another name for the
+.Fl create
+parameter.
+Included for Solaris compatibility.
+.It Cm unplumb
+Another name for the
+.Fl destroy
+parameter.
+Included for Solaris compatibility.
 .It Cm vlan Ar vlan_tag
 If the interface is a vlan pseudo interface, set the vlan tag value
 to
@@ -587,6 +610,12 @@ and
 .Fl u 
 (only list interfaces that are up).
 .Pp
+The
+.Fl C
+flag may be used to list all of the interface cloners available on
+the system, with no additional information.
+Use of this flag is mutually exclusive with all other flags and commands.
+.Pp
 Only the super-user may modify the configuration of a network interface.
 .Sh NOTES
 The media selection system is relatively new and only some drivers support