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