xref: /dragonfly/share/man/man4/fxp.4 (revision cc93b0eb)
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: src/share/man/man4/fxp.4,v 1.11.2.8 2003/02/17 21:20:39 trhodes Exp $
27.\" $DragonFly: src/share/man/man4/fxp.4,v 1.5 2008/05/02 02:05:05 swildner Exp $
28.\"
29.Dd January 19, 1997
30.Dt FXP 4
31.Os
32.Sh NAME
33.Nm fxp
34.Nd Intel EtherExpress Pro/100B ethernet device driver
35.Sh SYNOPSIS
36.Cd "device miibus"
37.Cd "device fxp"
38.Sh DESCRIPTION
39The
40.Nm
41driver provides support for the EtherExpress Pro/10, InBusiness
4210/100, Pro/100 B, Pro/100+, Pro/100 VE, Pro/100 M, and Pro/100 S
43PCI Fast Ethernet adapters based on the Intel i82557, i82558, i82559,
44i82550, or i82562 Ethernet chips.
45Many on-board network interfaces on Intel motherboards use these chips
46and are also supported.
47.Pp
48The
49.Nm
50driver supports the following media types:
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.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
64.It full-duplex
65Set full duplex operation
66.El
67.Pp
68Note that 100baseTX media type is not available on the Pro/10.
69For further information on configuring this device, see
70.Xr ifconfig 8 .
71.Pp
72The
73.Nm
74driver also supports a special link option:
75.Bl -tag -width link0
76.It Cm link0
77Some chip revisions have loadable microcode which can be used to reduce the
78interrupt load on the host cpu.
79Not all boards have support microcode support.
80Setting the
81.Cm link0
82flag with
83.Xr ifconfig 8
84will download the microcode to the chip if it is available.
85.El
86.Sh DIAGNOSTICS
87.Bl -diag
88.It "fxp%d: couldn't map memory"
89A fatal initialization error has occurred.
90.It "fxp%d: couldn't map interrupt"
91A fatal initialization error has occurred.
92.It "fxp%d: Failed to malloc memory"
93There are not enough mbuf's available for allocation.
94.It "fxp%d: device timeout"
95The device has stopped responding to the network, or there is a problem with
96the network connection (cable).
97.It "fxp%d: Microcode loaded, int_delay: %d usec  bundle_max: %d"
98The chip has successfully downloaded the microcode, and changed the
99parameterized values to the given settings.
100.El
101.Sh SEE ALSO
102.Xr arp 4 ,
103.Xr ifmedia 4 ,
104.Xr miibus 4 ,
105.Xr netintro 4 ,
106.Xr ng_ether 4 ,
107.Xr polling 4 ,
108.Xr ifconfig 8
109.Sh HISTORY
110The
111.Nm
112device driver first appeared in
113.Fx 2.1 .
114.Sh AUTHORS
115.An -nosplit
116The
117.Nm
118device driver was written by
119.An David Greenman .
120This manual page was written by
121.An David E. O'Brien .
122