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