xref: /openbsd/share/man/man4/de.4 (revision 4bdff4be)
1.\"	$OpenBSD: de.4,v 1.24 2015/01/15 20:37:36 schwarze Exp $
2.\"
3.\" Copyright (c) 1997 David E. O'Brien
4.\"
5.\" All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
17.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
20.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26.\"
27.Dd $Mdocdate: January 15 2015 $
28.Dt DE 4
29.Os
30.Sh NAME
31.Nm de
32.Nd DEC DC21x4x (Tulip) 10/100 Ethernet device
33.Sh SYNOPSIS
34.Cd "de* at pci?"
35.Sh DESCRIPTION
36The
37.Nm
38device driver supports Ethernet adapters based on the Digital
39Equipment DC21x4x based self-contained Ethernet chips.
40This includes, among others, the following models:
41.Pp
42.Bl -tag -width Ds -offset indent -compact
43.It Asante
44.It Cogent EM100FX and EM440TX
45.It DEC PCI DE435, EISA DE425, DE450, DE500
46.It older Linksys 10, 10/100
47.It SMC 8432, 9332, 9334
48.It ZNYX ZX3xx
49.El
50.Pp
51This driver may support other cards based on the 21040 and 21041 Ethernet
52controllers, or the 21140[A], 21141, 21142, and 21143 Fast Ethernet
53controllers.
54.Pp
55The
56.Nm
57driver supports the following media types:
58.Bl -tag -width full-duplex -offset indent
59.It autoselect
60Enable autoselection of the media type and options.
61.It 10baseT
62Set 10Mbps operation on the 10baseT port.
63.It 10base2
64Set 10Mbps operation on the BNC port.
65.It 10base5
66Set 10Mbps operation on the AUI port.
67.It 100baseTX
68Set 100Mbps (Fast Ethernet) operation.
69.It 100baseFX
70Set 100Mbps operation.
71.It 100baseT4
72Set 100Mbps operation (4-pair cat-3 cable).
73.El
74.Pp
75The
76.Nm
77driver supports the following media options:
78.Pp
79.Bl -tag -width full-duplex -offset indent -compact
80.It full-duplex
81Set full duplex operation for UTP port.
82.El
83.Pp
84For more information on configuring this device, see
85.Xr ifconfig 8 .
86To view a list of media types and options supported by your card try
87.Ic ifconfig <device> media .
88For example,
89.Ic ifconfig de0 media .
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
95The old
96.Dq ifconfig linkN
97method of configuration is not supported.
98.Sh DIAGNOSTICS
99.Bl -diag
100.It "de0: waking device from sleep/snooze mode"
101The 21041 and 21140A chips support suspending the operation of the card.
102.It "de0: error: desired IRQ of X does not match device's actual IRQ of Y"
103The device probe detected that the board is configured for a different
104interrupt than the one specified in the kernel configuration file.
105.It "de0: not configured; limit of N reached or exceeded"
106There is a limit of 32
107.Nm
108devices allowed in a single machine.
109.It "de0: not configured; 21040 pass 2.0 required (X.Y found)"
110.It "de0: not configured; 21140 pass 1.1 required (X.Y found)"
111Certain revisions of the chipset are not supported by this driver.
112.El
113.Sh SEE ALSO
114.Xr arp 4 ,
115.Xr ifmedia 4 ,
116.Xr intro 4 ,
117.Xr netintro 4 ,
118.Xr pci 4 ,
119.Xr hostname.if 5 ,
120.Xr ifconfig 8
121.Sh AUTHORS
122.An -nosplit
123The
124.Nm
125device driver was written by
126.An Matt Thomas .
127This manual page was written by
128.An David E. O'Brien .
129.Sh CAVEATS
130Since the 21040 is available on both EISA and PCI boards, one must be careful
131in how one defines the 21040 in the kernel config file.
132