add en ATM driver manual.

3 files changed, 119 insertions, 2 deletions

diff --git a/share/man/man4/en.4 b/share/man/man4/en.4
new file mode 100644
index 0000000..3310e62
--- /dev/null
+++ b/share/man/man4/en.4
@@ -0,0 +1,58 @@
+.Dd December 29, 1997
+.Dt EN 4
+.Os BSD
+.Sh NAME
+.Nm en
+.Nd
+device driver for Midway-based ATM interfaces
+.Sh SYNOPSIS
+.Cd "device en0"
+.Cd "pseudo-device atm"
+.Sh DESCRIPTION
+The 
+.Nm
+device driver supports Midway-based ATM interfaces including the
+Efficient Networks, Inc. ENI-155 and Adaptec ANA-59x0.
+Midway is an ALL5 SAR (Segmentation and Reassenbly) chip.
+.Pp
+The driver only supports ATM PVCs.  SVC or ATM-ARP is not supported.
+.Pp
+To configure the card for IP, use something like:
+.Dl # ifconfig en0 128.252.200.1 netmask 0xffffff00 up
+To add a PVC to a host you must use the ``route'' command:
+.Dl # route add -iface <remote IP address> -link en0:z.0.x.y
+where x and y are the byte encoding of the VCI to use, and z is the
+byte encoding of the following flags.
+.Dl 0x01 (use AAL5), 
+.Dl 0x02 (if using AAL5, use a LLCSNAP header)
+Thus, parameter 3 means AAL5 and LLC/SNAP encapsulation.
+Note that BPF works only with LLC/SNAP encapsulation.
+.Sh EXAMPLES
+Suppose you have 2 hosts 128.252.200.1 and 128.252.200.2 connected
+by ATM through PVC # 201 (0xc9).    
+To enable the link use the following commands:
+.Dl on host 128.252.200.1:
+.Dl	# ifconfig en0 128.252.200.1 netmask 0xffffff00 up
+.Dl	# route add -iface 128.252.200.2 -link en0:3.0.0.c9
+.Pp
+.Dl on host 128.252.200.2:
+.Dl	# ifconfig en0 128.252.200.2 netmask 0xffffff00 up
+.Dl	# route add -iface 128.252.200.1 -link en0:3.0.0.c9
+.Sh DIAGNOSTICS
+.Bl -diag
+.It	"en0 <Efficient Networks ENI-155p> rev 0 int a irq 5 on pci0:16"
+.It	"en0: ATM midway v0, board IDs 6.0, Utopia (pipelined), 512KB on-board RAM"
+.It	"en0: maximum DMA burst length = 64 bytes"
+.It	"en0: 7 32KB receive buffers, 8 32KB transmit buffers allocated"
+.El
+.Sh CAVEATS
+The driver extensively uses DMA on PCI. The first
+generation PCI chipsets do not work or exhibit poor performance.
+.Sh SEE ALSO
+.Xr ifconfig 8 , 
+.Xr route 8 , 
+.Xr pvcsif 8 , 
+.Xr pvctxctl 8
+.Sh AUTHORS
+Chuck Cranor of Washington University implemented EN driver
+in 1996 for NetBSD.
diff --git a/share/man/man4/man4.i386/Makefile b/share/man/man4/man4.i386/Makefile
index 16041d9..05c77e7 100644
--- a/share/man/man4/man4.i386/Makefile
+++ b/share/man/man4/man4.i386/Makefile
@@ -1,8 +1,8 @@
-#	$Id: Makefile,v 1.74 1998/05/21 03:20:38 wpaul Exp $
+#	$Id: Makefile,v 1.75 1998/07/20 20:02:32 msmith Exp $
 
 MAN4=   aha.4 ahb.4 ahc.4 aic.4 alog.4 apm.4 ar.4 asc.4 bktr.4 bt.4 \
 	cs.4 cx.4 cy.4 de.4 \
-        dgb.4 ed.4 eg.4 el.4 ep.4 ex.4 gsc.4 fdc.4 fe.4 fxp.4 ie.4 io.4 \
+        dgb.4 ed.4 eg.4 el.4 en.4 ep.4 ex.4 gsc.4 fdc.4 fe.4 fxp.4 ie.4 io.4 \
 	joy.4 keyboard.4 labpc.4 le.4 lnc.4 lp.4 lpt.4 matcd.4 mcd.4 mem.4 \
         meteor.4 mouse.4 mse.4 mtio.4 nca.4 ncr.4 npx.4 \
         pcvt.4 perfmon.4 pnp.4 psm.4 \
@@ -28,6 +28,7 @@ MLINKS+=	dgb.4 ../dgb.4
 MLINKS+=	ed.4 ../ed.4
 MLINKS+=	eg.4 ../eg.4
 MLINKS+=	el.4 ../el.4
+MLINKS+=	en.4 ../en.4
 MLINKS+=	ep.4 ../ep.4
 MLINKS+=	ex.4 ../ex.4
 MLINKS+=	fdc.4 ../fdc.4
diff --git a/share/man/man4/man4.i386/en.4 b/share/man/man4/man4.i386/en.4
new file mode 100644
index 0000000..3310e62
--- /dev/null
+++ b/share/man/man4/man4.i386/en.4
@@ -0,0 +1,58 @@
+.Dd December 29, 1997
+.Dt EN 4
+.Os BSD
+.Sh NAME
+.Nm en
+.Nd
+device driver for Midway-based ATM interfaces
+.Sh SYNOPSIS
+.Cd "device en0"
+.Cd "pseudo-device atm"
+.Sh DESCRIPTION
+The 
+.Nm
+device driver supports Midway-based ATM interfaces including the
+Efficient Networks, Inc. ENI-155 and Adaptec ANA-59x0.
+Midway is an ALL5 SAR (Segmentation and Reassenbly) chip.
+.Pp
+The driver only supports ATM PVCs.  SVC or ATM-ARP is not supported.
+.Pp
+To configure the card for IP, use something like:
+.Dl # ifconfig en0 128.252.200.1 netmask 0xffffff00 up
+To add a PVC to a host you must use the ``route'' command:
+.Dl # route add -iface <remote IP address> -link en0:z.0.x.y
+where x and y are the byte encoding of the VCI to use, and z is the
+byte encoding of the following flags.
+.Dl 0x01 (use AAL5), 
+.Dl 0x02 (if using AAL5, use a LLCSNAP header)
+Thus, parameter 3 means AAL5 and LLC/SNAP encapsulation.
+Note that BPF works only with LLC/SNAP encapsulation.
+.Sh EXAMPLES
+Suppose you have 2 hosts 128.252.200.1 and 128.252.200.2 connected
+by ATM through PVC # 201 (0xc9).    
+To enable the link use the following commands:
+.Dl on host 128.252.200.1:
+.Dl	# ifconfig en0 128.252.200.1 netmask 0xffffff00 up
+.Dl	# route add -iface 128.252.200.2 -link en0:3.0.0.c9
+.Pp
+.Dl on host 128.252.200.2:
+.Dl	# ifconfig en0 128.252.200.2 netmask 0xffffff00 up
+.Dl	# route add -iface 128.252.200.1 -link en0:3.0.0.c9
+.Sh DIAGNOSTICS
+.Bl -diag
+.It	"en0 <Efficient Networks ENI-155p> rev 0 int a irq 5 on pci0:16"
+.It	"en0: ATM midway v0, board IDs 6.0, Utopia (pipelined), 512KB on-board RAM"
+.It	"en0: maximum DMA burst length = 64 bytes"
+.It	"en0: 7 32KB receive buffers, 8 32KB transmit buffers allocated"
+.El
+.Sh CAVEATS
+The driver extensively uses DMA on PCI. The first
+generation PCI chipsets do not work or exhibit poor performance.
+.Sh SEE ALSO
+.Xr ifconfig 8 , 
+.Xr route 8 , 
+.Xr pvcsif 8 , 
+.Xr pvctxctl 8
+.Sh AUTHORS
+Chuck Cranor of Washington University implemented EN driver
+in 1996 for NetBSD.