xref: /freebsd/share/man/man4/fxp.4 (revision 6af83ee0d2941d18880b6aaa2b4facd1d30c6106)
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 January 30, 2005
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 supports reception and transmission of extended frames
72for
73.Xr vlan 4 .
74This capability of
75.Nm
76can be controlled by means of the
77.Cm vlanmtu
78parameter
79to
80.Xr ifconfig 8 .
81.Pp
82The
83.Nm
84driver also supports a special link option:
85.Bl -tag -width link0
86.It Cm link0
87Some chip revisions have loadable microcode which can be used to reduce the
88interrupt load on the host cpu.
89Not all boards have microcode support.
90Setting the
91.Cm link0
92flag with
93.Xr ifconfig 8
94will download the microcode to the chip if it is available.
95.El
96.Sh HARDWARE
97Adapters supported by the
98.Nm
99driver include:
100.Pp
101.Bl -bullet -compact
102.It
103Intel EtherExpress PRO/10
104.It
105Intel InBusiness 10/100
106.It
107Intel PRO/100B / EtherExpressPRO/100 B PCI Adapter
108.It
109Intel PRO/100+ Management Adapter
110.It
111Intel PRO/100 VE Desktop Adapter
112.It
113Intel PRO/100 M Desktop Adapter
114.It
115Intel PRO/100 S Desktop, Server and Dual-Port Server Adapters
116.It
117Contec C-NET(PI)-100TX (PC-98)
118.It
119NEC PC-9821Ra20, Rv20, Xv13, Xv20 internal 100Base-TX (PC-98)
120.It
121NEC PC-9821X-B06 (PC-98)
122.It
123Many on-board network interfaces on Intel motherboards
124.El
125.Sh DIAGNOSTICS
126.Bl -diag
127.It "fxp%d: couldn't map memory"
128A fatal initialization error has occurred.
129.It "fxp%d: couldn't map interrupt"
130A fatal initialization error has occurred.
131.It "fxp%d: Failed to malloc memory"
132There are not enough mbuf's available for allocation.
133.It "fxp%d: device timeout"
134The device has stopped responding to the network, or there is a problem with
135the network connection (cable).
136.It "fxp%d: Ethernet address ff:ff:ff:ff:ff:ff"
137In some Alpha's (AXPpci and Multia) you must tell the driver to use (slower)
138I/O rather than memory to access the card.
139Create, if it does not yet exist, and add to the file
140.Pa /boot/device.hints
141the line
142.Dq Li hint.fxp.0.prefer_iomap="0" .
143.It "fxp%d: Microcode loaded, int_delay: %d usec  bundle_max: %d"
144The chip has successfully downloaded the microcode, and changed the
145parameterized values to the given settings.
146.El
147.Sh SEE ALSO
148.Xr arp 4 ,
149.Xr miibus 4 ,
150.Xr netintro 4 ,
151.Xr ng_ether 4 ,
152.Xr polling 4 ,
153.Xr vlan 4 ,
154.Xr ifconfig 8
155.Sh HISTORY
156The
157.Nm
158device driver first appeared in
159.Fx 2.1 .
160.Sh AUTHORS
161.An -nosplit
162The
163.Nm
164device driver was written by
165.An David Greenman .
166It has then been updated to use the busdma API and made endian-clean by
167.An Maxime Henrion .
168This manual page was written by
169.An David E. O'Brien .
170