Merge branch 'vendor/BINUTILS220'
[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.4 2008/05/02 02:05:05 swildner 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 .Bl -tag -width xxxxxxxxxxxxxxx
52 .It autoselect
53 Enable autoselection of the media type and options
54 .It 10baseT/UTP
55 Set 10Mbps operation on the 10baseT port
56 .It 10base2/BNC
57 Set 10Mbps operation on the BNC port
58 .It 10base5/AUI
59 Set 10Mbps operation on the AUI port
60 .It 100baseTX
61 Set 100Mbps (fast ethernet) operation
62 .It 100baseFX
63 Set 100Mbps operation
64 .It 100baseT4
65 Set 100Mbps operation (4-pair cat-3 cable)
66 .El
67 .Pp
68 The
69 .Nm
70 driver supports the following media options:
71 .Bl -tag -width xxxxxxxxxxxxxxx
72 .It full-duplex
73 Set full duplex operation
74 .El
75 .Pp
76 Note that the media types available depend on the particular card in use.
77 Some cards are explicitly programmed to a particular media type by a
78 setup utility and are not changeable.
79 .Pp
80 Use the
81 .Xr ifconfig 8
82 command an in particular the
83 .Fl m
84 flag to list the supported media types for your particular card.
85 .Pp
86 The old
87 .Dq ifconfig linkN
88 method of configuration is not supported.
89 .Sh DIAGNOSTICS
90 .Bl -diag
91 .It "de%d: waking device from sleep/snooze mode"
92 The 21041 and 21140A chips support suspending the operation of the card.
93 .It "de%d: error: desired IRQ of %d does not match device's actual IRQ of %d"
94 The device probe detected that the board is configured for a different
95 interrupt than the one specified in the kernel configuration file.
96 .It "de%d: not configured; limit of %d reached or exceeded"
97 There is a limit of 32
98 .Nm
99 devices allowed in a single machine.
100 .It "de%d: not configured; 21040 pass 2.0 required (%d.%d found)"
101 .It "de%d: not configured; 21140 pass 1.1 required (%d.%d found)"
102 Certain revisions of the chipset are not supported by this driver.
103 .El
104 .Sh CAVEATS
105 Since the 21040 is available on both EISA and PCI boards, one must be careful
106 in how defines the 21040 in the kernel config file.
107 .Sh SEE ALSO
108 .Xr arp 4 ,
109 .Xr ifmedia 4 ,
110 .Xr netintro 4 ,
111 .Xr ng_ether 4 ,
112 .Xr ifconfig 8
113 .Sh AUTHORS
114 .An -nosplit
115 The
116 .Nm
117 device driver was written by
118 .An Matt Thomas .
119 This manual page was written by
120 .An David E. O'Brien .