xref: /freebsd-12.1/share/man/man4/de.4 (revision 68742e0d)
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$
27.\"
28.Dd October 24, 2018
29.Dt DE 4
30.Os
31.Sh NAME
32.Nm de
33.Nd "DEC DC21x4x Ethernet device driver"
34.Sh SYNOPSIS
35To compile this driver into the kernel,
36place the following line in your
37kernel configuration file:
38.Bd -ragged -offset indent
39.Cd "device de"
40.Ed
41.Pp
42Alternatively, to load the driver as a
43module at boot time, place the following line in
44.Xr loader.conf 5 :
45.Bd -literal -offset indent
46if_de_load="YES"
47.Ed
48.Sh DEPRECATION NOTICE
49The
50.Nm
51driver is not present in
52.Fx 13.0
53and later.
54See https://github.com/freebsd/fcp/blob/master/fcp-0101.md for more
55information.
56.Sh DESCRIPTION
57The
58.Nm
59driver provides support for the Ethernet adapters based on the Digital
60Equipment DC21x4x based self-contained Ethernet and Fast Ethernet
61chips.
62.Pp
63The
64.Nm
65driver supports the following media types:
66.Bl -tag -width xxxxxxxxxxxxxxx
67.It autoselect
68Enable autoselection of the media type and options
69.It 10baseT/UTP
70Set 10Mbps operation on the 10baseT port
71.It 10base2/BNC
72Set 10Mbps operation on the BNC port
73.It 10base5/AUI
74Set 10Mbps operation on the AUI port
75.It 100baseTX
76Set 100Mbps (Fast Ethernet) operation
77.It 100baseFX
78Set 100Mbps operation
79.It 100baseT4
80Set 100Mbps operation (4-pair cat-3 cable)
81.El
82.Pp
83The
84.Nm
85driver supports the following media options:
86.Bl -tag -width xxxxxxxxxxxxxxx
87.It full-duplex
88Set full duplex operation
89.El
90.Pp
91Note that the media types available depend on the particular card in use.
92Some cards are explicitly programmed to a particular media type by a
93setup utility and are not changeable.
94.Pp
95Use the
96.Xr ifconfig 8
97command and in particular the
98.Fl m
99flag to list the supported media types for your particular card.
100.Pp
101The old
102.Dq ifconfig linkN
103method of configuration is not supported.
104.Sh HARDWARE
105Adapters supported by the
106.Nm
107driver include:
108.Pp
109.Bl -bullet -compact
110.It
111Adaptec ANA-6944/TX
112.It
113Cogent EM100FX and EM440TX
114.It
115Corega FastEther PCI-TX
116.It
117D-Link DFE-500TX
118.It
119DEC DE435, DEC DE450, and DEC DE500
120.It
121ELECOM LD-PCI2T, LD-PCITS
122.It
123I-O DATA LA2/T-PCI
124.It
125SMC Etherpower 8432, 9332 and 9334
126.It
127ZNYX ZX3xx
128.El
129.Sh DIAGNOSTICS
130.Bl -diag
131.It "de%d: waking device from sleep/snooze mode"
132The 21041 and 21140A chips support suspending the operation of the card.
133.It "de%d: error: desired IRQ of %d does not match device's actual IRQ of %d"
134The device probe detected that the board is configured for a different
135interrupt than the one specified in the kernel configuration file.
136.It "de%d: not configured; limit of %d reached or exceeded"
137There is a limit of 32
138.Nm
139devices allowed in a single machine.
140.It "de%d: not configured; 21040 pass 2.0 required (%d.%d found)"
141.It "de%d: not configured; 21140 pass 1.1 required (%d.%d found)"
142Certain revisions of the chipset are not supported by this driver.
143.El
144.Sh SEE ALSO
145.Xr altq 4 ,
146.Xr arp 4 ,
147.Xr netintro 4 ,
148.Xr ng_ether 4 ,
149.Xr ifconfig 8
150.Sh AUTHORS
151.An -nosplit
152The
153.Nm
154device driver was written by
155.An Matt Thomas .
156This manual page was written by
157.An David E. O'Brien .
158