Add the AMD-766, Apple KeyLargo, and SiS 5571.
[dragonfly.git] / share / man / man4 / de.4
1 .\"
2 .\" Copyright (c) 1997 David E. O'Brien
3 .\"
4 .\" All rights reserved.
5 .\"
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
8 .\" are met:
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\"    notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\"    notice, this list of conditions and the following disclaimer in the
13 .\"    documentation and/or other materials provided with the distribution.
14 .\"
15 .\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
16 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18 .\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
19 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25 .\"
26 .\" $FreeBSD: src/share/man/man4/de.4,v 1.9.2.4 2001/08/17 13:08:37 ru Exp $
27 .\" $DragonFly: src/share/man/man4/de.4,v 1.2 2003/06/17 04:36:58 dillon Exp $
28 .\"
29 .Dd January 19, 1997
30 .Dt DE 4
31 .Os
32 .Sh NAME
33 .Nm de
34 .Nd DEC DC21x4x Ethernet device driver
35 .Sh SYNOPSIS
36 .Cd "device de"
37 .Sh DESCRIPTION
38 The
39 .Nm
40 driver provides support for the Ethernet adapters based on the Digital
41 Equipment DC21x4x based self-contained Ethernet chips.
42 .Pp
43 It supports the DEC PCI DE435 card, DEC EISA DE425, DEC DE450, DEC DE500,
44 SMC 8432, 9332 and 9334, Cogent EM100FX and EM440TX, Asante,
45 ZNYX ZX3xx, and others based on the 21040 and 21041 Ethernet controllers or
46 the 21140[A], 21141, 21142 and 21143 Fast 100Mbps Ethernet controllers.
47 .Pp
48 The
49 .Nm
50 driver supports the following media types:
51 .Pp
52 .Bl -tag -width xxxxxxxxxxxxxxx
53 .It autoselect
54 Enable autoselection of the media type and options
55 .It 10baseT/UTP
56 Set 10Mbps operation on the 10baseT port
57 .It 10base2/BNC
58 Set 10Mbps operation on the BNC port
59 .It 10base5/AUI
60 Set 10Mbps operation on the AUI port
61 .It 100baseTX
62 Set 100Mbps (fast ethernet) operation
63 .It 100baseFX
64 Set 100Mbps operation
65 .It 100baseT4
66 Set 100Mbps operation (4-pair cat-3 cable)
67 .El
68 .Pp
69 The
70 .Nm
71 driver supports the following media options:
72 .Pp
73 .Bl -tag -width xxxxxxxxxxxxxxx
74 .It full-duplex
75 Set full duplex operation
76 .El
77 .Pp
78 Note that the media types available depend on the particular card in use.
79 Some cards are explicitly programmed to a particular media type by a
80 setup utility and are not changeable.
81 .Pp
82 Use the
83 .Xr ifconfig 8
84 command an in particular the
85 .Fl m
86 flag to list the supported media types for your particular card.
87 .Pp
88 The old
89 .Dq ifconfig linkN
90 method of configuration is not supported.
91 .Sh DIAGNOSTICS
92 .Bl -diag
93 .It "de%d: waking device from sleep/snooze mode"
94 The 21041 and 21140A chips support suspending the operation of the card.
95 .It "de%d: error: desired IRQ of %d does not match device's actual IRQ of %d"
96 The device probe detected that the board is configured for a different
97 interrupt than the one specified in the kernel configuration file.
98 .It "de%d: not configured; limit of %d reached or exceeded"
99 There is a limit of 32
100 .Nm
101 devices allowed in a single machine.
102 .It "de%d: not configured; 21040 pass 2.0 required (%d.%d found)"
103 .It "de%d: not configured; 21140 pass 1.1 required (%d.%d found)"
104 Certain revisions of the chipset are not supported by this driver.
105 .El
106 .Sh CAVEATS
107 Since the 21040 is available on both EISA and PCI boards, one must be careful
108 in how defines the 21040 in the kernel config file.
109 .Sh SEE ALSO
110 .Xr arp 4 ,
111 .Xr netintro 4 ,
112 .Xr ng_ether 4 ,
113 .Xr ifconfig 8
114 .Sh AUTHORS
115 .An -nosplit
116 The
117 .Nm
118 device driver was written by
119 .An Matt Thomas .
120 This manual page was written by
121 .An David E. O'Brien .