Add the DragonFly cvs id and perform general cleanups on cvs/rcs/sccs ids. Most
[dragonfly.git] / share / man / man4 / man4.i386 / en.4
1 .\" $FreeBSD: src/share/man/man4/man4.i386/en.4,v 1.7.2.5 2001/10/10 11:46:52 murray Exp $
2 .\" $DragonFly: src/share/man/man4/man4.i386/en.4,v 1.2 2003/06/17 04:36:59 dillon Exp $
3 .\"
4 .Dd December 29, 1997
5 .Dt EN 4 i386
6 .Os
7 .Sh NAME
8 .Nm en
9 .Nd device driver for Midway-based ATM interfaces
10 .Sh SYNOPSIS
11 .Cd "device en"
12 .Cd "pseudo-device atm"
13 .Sh DESCRIPTION
14 The
15 .Nm
16 device driver supports Midway-based ATM interfaces including the
17 Efficient Networks, Inc. ENI-155 and Adaptec ANA-59x0.
18 Midway is an ALL5 SAR (Segmentation and Reassenbly) chip.
19 .Pp
20 The driver only supports ATM PVCs.  SVC or ATM-ARP is not supported.
21 .Pp
22 To configure the card for IP, use something like:
23 .Dl # ifconfig en0 128.252.200.1 netmask 0xffffff00 up
24 To add a PVC to a host you must use the ``route'' command:
25 .Dl # route add -iface <remote IP address> -link en0:z.0.x.y
26 where x and y are the byte encoding of the VCI to use, and z is the
27 byte encoding of the following flags.
28 .Dl 0x01 (use AAL5),
29 .Dl 0x02 (if using AAL5, use a LLCSNAP header)
30 Thus, parameter 3 means AAL5 and LLC/SNAP encapsulation.
31 Note that BPF works only with LLC/SNAP encapsulation.
32 .Sh EXAMPLES
33 Suppose you have 2 hosts 128.252.200.1 and 128.252.200.2 connected
34 by ATM through PVC # 201 (0xc9).
35 To enable the link use the following commands:
36 .Dl on host 128.252.200.1:
37 .Dl     # ifconfig en0 128.252.200.1 netmask 0xffffff00 up
38 .Dl     # route add -iface 128.252.200.2 -link en0:3.0.0.c9
39 .Pp
40 .Dl on host 128.252.200.2:
41 .Dl     # ifconfig en0 128.252.200.2 netmask 0xffffff00 up
42 .Dl     # route add -iface 128.252.200.1 -link en0:3.0.0.c9
43 .Sh DIAGNOSTICS
44 .Bd -literal
45 en0 <Efficient Networks ENI-155p> rev 0 int a irq 5 on pci0:16
46 en0: ATM midway v0, board IDs 6.0, Utopia (pipelined), 512KB on-board RAM
47 en0: maximum DMA burst length = 64 bytes
48 en0: 7 32KB receive buffers, 8 32KB transmit buffers allocated
49 .Ed
50 .Sh CAVEATS
51 The driver extensively uses DMA on PCI.
52 The first
53 generation PCI chipsets do not work or exhibit poor performance.
54 .Sh SEE ALSO
55 .Xr ifconfig 8 ,
56 .Xr route 8
57 .Sh AUTHORS
58 .An Chuck Cranor
59 of Washington University implemented EN driver
60 in 1996 for
61 .Nx .