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