xref: /freebsd/share/man/man4/fxp.4 (revision c98323078dede7579020518ec84cdcb478e5c142)
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 July 4, 2004
29.Dt FXP 4
30.Os
31.Sh NAME
32.Nm fxp
33.Nd Intel EtherExpress PRO/100 Ethernet device driver
34.Sh SYNOPSIS
35.Cd "device miibus"
36.Cd "device fxp"
37.Sh DESCRIPTION
38The
39.Nm
40driver provides support for Ethernet adapters based on the Intel
41i82557, i82558, i82559, i82550, and i82562 chips.
42.Pp
43The
44.Nm
45driver supports the following media types:
46.Pp
47.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
48.It autoselect
49Enable autoselection of the media type and options
50.It 10baseT/UTP
51Set 10Mbps operation
52.It 100baseTX
53Set 100Mbps (Fast Ethernet) operation
54.El
55.Pp
56The
57.Nm
58driver supports the following media options:
59.Pp
60.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
61.It full-duplex
62Set full duplex operation
63.El
64.Pp
65Note that 100baseTX media type is not available on the Pro/10.
66For further information on configuring this device, see
67.Xr ifconfig 8 .
68.Pp
69The
70.Nm
71driver also supports a special link option:
72.Bl -tag -width link0
73.It Cm link0
74Some chip revisions have loadable microcode which can be used to reduce the
75interrupt load on the host cpu.
76Not all boards have microcode support.
77Setting the
78.Cm link0
79flag with
80.Xr ifconfig 8
81will download the microcode to the chip if it is available.
82.El
83.Sh HARDWARE
84Adapters supported by the
85.Nm
86driver include:
87.Pp
88.Bl -bullet -compact
89.It
90Intel EtherExpress PRO/10
91.It
92Intel InBusiness 10/100
93.It
94Intel PRO/100B / EtherExpressPRO/100 B PCI Adapter
95.It
96Intel PRO/100+ Management Adapter
97.It
98Intel PRO/100 VE Desktop Adapter
99.It
100Intel PRO/100 M Desktop Adapter
101.It
102Intel PRO/100 S Desktop, Server and Dual-Port Server Adapters
103.It
104Contec C-NET(PI)-100TX (PC-98)
105.It
106NEC PC-9821Ra20, Rv20, Xv13, Xv20 internal 100Base-TX (PC-98)
107.It
108NEC PC-9821X-B06 (PC-98)
109.It
110Many on-board network interfaces on Intel motherboards
111.El
112.Sh DIAGNOSTICS
113.Bl -diag
114.It "fxp%d: couldn't map memory"
115A fatal initialization error has occurred.
116.It "fxp%d: couldn't map interrupt"
117A fatal initialization error has occurred.
118.It "fxp%d: Failed to malloc memory"
119There are not enough mbuf's available for allocation.
120.It "fxp%d: device timeout"
121The device has stopped responding to the network, or there is a problem with
122the network connection (cable).
123.It "fxp%d: Ethernet address ff:ff:ff:ff:ff:ff"
124In some Alpha's (AXPpci and Multia) you must tell the driver to use (slower)
125I/O rather than memory to access the card.
126Create, if it does not yet exist, and add to the file
127.Pa /boot/device.hints
128the line
129.Dq Li hint.fxp.0.prefer_iomap="0" .
130.It "fxp%d: Microcode loaded, int_delay: %d usec  bundle_max: %d"
131The chip has successfully downloaded the microcode, and changed the
132parameterized values to the given settings.
133.El
134.Sh SEE ALSO
135.Xr arp 4 ,
136.Xr miibus 4 ,
137.Xr netintro 4 ,
138.Xr ng_ether 4 ,
139.Xr ifconfig 8
140.Sh HISTORY
141The
142.Nm
143device driver first appeared in
144.Fx 2.1 .
145.Sh AUTHORS
146.An -nosplit
147The
148.Nm
149device driver was written by
150.An David Greenman .
151It has then been updated to use the busdma API and made endian-clean by
152.An Maxime Henrion .
153This manual page was written by
154.An David E. O'Brien .
155