svn commit: r276434 - stable/9/share/man/man4

[Peter Jeremy]

Author: peterj
Date: Wed Dec 31 00:08:37 2014
New Revision: 276434
URL: https://svnweb.freebsd.org/changeset/base/276434

Log:
  MFH r230580:
  Don't mention no longer supported ioctl commands.
  
  MFH r274083:
  convert .Nm to proper .Xr's...
  
  MFH r275298:
  Cross reference tap(4) and tun(4) and include a short explanation as
  to how they differ.  This will assist users in selecting which interface
  is more appropriate for their purposes.
  
  No objection:	glebius (r230580), jmg (r274083)
  Approved by:	grog (co-mentor)

Modified:
  stable/9/share/man/man4/tap.4
  stable/9/share/man/man4/tun.4
Directory Properties:
  stable/9/share/man/man4/   (props changed)

Modified: stable/9/share/man/man4/tap.4
==============================================================================
--- stable/9/share/man/man4/tap.4	Tue Dec 30 23:52:48 2014	(r276433)
+++ stable/9/share/man/man4/tap.4	Wed Dec 31 00:08:37 2014	(r276434)
@@ -1,7 +1,7 @@
 .\" $FreeBSD$
 .\" Based on PR#2411
 .\"
-.Dd September 8, 2008
+.Dd November 30, 2014
 .Dt TAP 4
 .Os
 .Sh NAME
@@ -18,22 +18,33 @@ described as the network interface analo
 that is,
 .Nm
 does for network interfaces what the
-.Nm pty
+.Xr pty 4
 driver does for terminals.
 .Pp
 The
 .Nm
 driver, like the
-.Nm pty
+.Xr pty 4
 driver, provides two interfaces: an interface like the usual facility
 it is simulating
 (an Ethernet network interface in the case of
 .Nm ,
 or a terminal for
-.Nm pty ) ,
+.Xr pty 4 ) ,
 and a character-special device
 .Dq control
 interface.
+A client program transfers Ethernet frames to or from the 
+.Nm
+.Dq control
+interface.
+The
+.Xr tun 4
+interface provides similar functionality at the network layer:
+a client will transfer IP (by default) packets to or from a
+.Xr tun 4
+.Dq control
+interface.
 .Pp
 The network interfaces are named
 .Dq Li tap0 ,
@@ -89,11 +100,7 @@ Control devices (once successfully opene
 is unloaded or the interface is destroyed.
 .Pp
 Each interface supports the usual Ethernet network interface
-.Xr ioctl 2 Ns s ,
-such as
-.Dv SIOCSIFADDR
-and
-.Dv SIOCSIFNETMASK ,
+.Xr ioctl 2 Ns s
 and thus can be used with
 .Xr ifconfig 8
 like any other Ethernet interface.
@@ -318,4 +325,5 @@ VMware
 .El
 .Sh SEE ALSO
 .Xr inet 4 ,
-.Xr intro 4
+.Xr intro 4 ,
+.Xr tun 4

Modified: stable/9/share/man/man4/tun.4
==============================================================================
--- stable/9/share/man/man4/tun.4	Tue Dec 30 23:52:48 2014	(r276433)
+++ stable/9/share/man/man4/tun.4	Wed Dec 31 00:08:37 2014	(r276434)
@@ -2,7 +2,7 @@
 .\" $FreeBSD$
 .\" Based on PR#2411
 .\"
-.Dd February 4, 2007
+.Dd November 30, 2014
 .Dt TUN 4
 .Os
 .Sh NAME
@@ -35,6 +35,17 @@ or a terminal for
 and a character-special device
 .Dq control
 interface.
+A client program transfers IP (by default) packets to or from the 
+.Nm
+.Dq control
+interface.
+The
+.Xr tap 4
+interface provides similar functionality at the Ethernet layer:
+a client will transfer Ethernet frames to or from a
+.Xr tap 4
+.Dq control
+interface.
 .Pp
 The network interfaces are named
 .Dq Li tun0 ,
@@ -307,6 +318,7 @@ them pile up.
 .Xr inet 4 ,
 .Xr intro 4 ,
 .Xr pty 4 ,
+.Xr tap 4 ,
 .Xr ifconfig 8
 .Sh AUTHORS
 This manual page was originally obtained from