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