introduce SIOCSIFDESCR and SIOCGIFDESCR to maintain interface

descriptions, configurable with ifconfig

help from various, ok deraadt@

1 files changed, 10 insertions, 1 deletions

diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8
index 618e11de1cc..dc7a9681257 100644
--- a/sbin/ifconfig/ifconfig.8
+++ b/sbin/ifconfig/ifconfig.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: ifconfig.8,v 1.81 2004/05/18 10:54:07 otto Exp $
+.\"	$OpenBSD: ifconfig.8,v 1.82 2004/05/29 17:54:46 jcs Exp $
 .\"	$NetBSD: ifconfig.8,v 1.11 1996/01/04 21:27:29 pk Exp $
 .\"     $FreeBSD: ifconfig.8,v 1.16 1998/02/01 07:03:29 steve Exp $
 .\"
@@ -314,6 +314,11 @@ allow you to respecify the host portion.
 .It Cm deletetunnel
 Removes the source and destination tunnel addresses,
 configured onto a tunnel interface.
+.It Cm description Ar value
+Specify a description of the interface.
+This can be used to label interfaces in situations where they may
+otherwise be difficult to identify
+.Pq e.g. machines with many active interfaces .
 .It Ar dest_address
 Specify the address of the correspondent on the other end
 of a point-to-point link.
@@ -692,6 +697,10 @@ Configure the xl0 interface to use 100baseTX, full duplex:
 .Pp
 .Dl # ifconfig xl0 media 100baseTX mediaopt full-duplex
 .Pp
+Label the em0 interface as an uplink:
+.Pp
+.Dl # ifconfig em0 description \&"Uplink to Gigabit Switch 2\&"
+.Pp
 Configure the vlan0 interface for IP address 192.168.254.1, vlan tag 4,
 and vlan parent device fxp0:
 .Pp