17d84e4e12
Quote .Cd and .Nd text. Bump doc date. Requested by: some user through ru Supported by: ru, dwmalone, brueffer
184 lines
4.8 KiB
Groff
184 lines
4.8 KiB
Groff
.\"
|
|
.\" Copyright (c) 1997 David E. O'Brien
|
|
.\"
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd July 16, 2005
|
|
.Dt FXP 4
|
|
.Os
|
|
.Sh NAME
|
|
.Nm fxp
|
|
.Nd "Intel EtherExpress PRO/100 Ethernet device driver"
|
|
.Sh SYNOPSIS
|
|
To compile support for the
|
|
.Nm
|
|
driver into your kernel, place the following lines in your kernel configuration
|
|
file:
|
|
.Bd -ragged -offset indent
|
|
.Cd "device miibus"
|
|
.Cd "device fxp"
|
|
.Ed
|
|
.Pp
|
|
Alternatively, to load the
|
|
.Nm
|
|
driver at boot time, place the following line in
|
|
.Xr loader.conf 5 :
|
|
.Bd -literal -offset indent
|
|
if_fxp_load="YES"
|
|
.Ed
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
driver provides support for Ethernet adapters based on the Intel
|
|
i82557, i82558, i82559, i82550, and i82562 chips.
|
|
.Pp
|
|
The
|
|
.Nm
|
|
driver supports the following media types:
|
|
.Pp
|
|
.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
|
|
.It autoselect
|
|
Enable autoselection of the media type and options
|
|
.It 10baseT/UTP
|
|
Set 10Mbps operation
|
|
.It 100baseTX
|
|
Set 100Mbps (Fast Ethernet) operation
|
|
.El
|
|
.Pp
|
|
The
|
|
.Nm
|
|
driver supports the following media options:
|
|
.Pp
|
|
.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
|
|
.It full-duplex
|
|
Set full duplex operation
|
|
.El
|
|
.Pp
|
|
Note that 100baseTX media type is not available on the Pro/10.
|
|
For further information on configuring this device, see
|
|
.Xr ifconfig 8 .
|
|
.Pp
|
|
The
|
|
.Nm
|
|
driver supports reception and transmission of extended frames
|
|
for
|
|
.Xr vlan 4 .
|
|
This capability of
|
|
.Nm
|
|
can be controlled by means of the
|
|
.Cm vlanmtu
|
|
parameter
|
|
to
|
|
.Xr ifconfig 8 .
|
|
.Pp
|
|
The
|
|
.Nm
|
|
driver also supports a special link option:
|
|
.Bl -tag -width link0
|
|
.It Cm link0
|
|
Some chip revisions have loadable microcode which can be used to reduce the
|
|
interrupt load on the host cpu.
|
|
Not all boards have microcode support.
|
|
Setting the
|
|
.Cm link0
|
|
flag with
|
|
.Xr ifconfig 8
|
|
will download the microcode to the chip if it is available.
|
|
.El
|
|
.Sh HARDWARE
|
|
Adapters supported by the
|
|
.Nm
|
|
driver include:
|
|
.Pp
|
|
.Bl -bullet -compact
|
|
.It
|
|
Intel EtherExpress PRO/10
|
|
.It
|
|
Intel InBusiness 10/100
|
|
.It
|
|
Intel PRO/100B / EtherExpressPRO/100 B PCI Adapter
|
|
.It
|
|
Intel PRO/100+ Management Adapter
|
|
.It
|
|
Intel PRO/100 VE Desktop Adapter
|
|
.It
|
|
Intel PRO/100 M Desktop Adapter
|
|
.It
|
|
Intel PRO/100 S Desktop, Server and Dual-Port Server Adapters
|
|
.It
|
|
Contec C-NET(PI)-100TX (PC-98)
|
|
.It
|
|
NEC PC-9821Ra20, Rv20, Xv13, Xv20 internal 100Base-TX (PC-98)
|
|
.It
|
|
NEC PC-9821X-B06 (PC-98)
|
|
.It
|
|
Many on-board network interfaces on Intel motherboards
|
|
.El
|
|
.Sh DIAGNOSTICS
|
|
.Bl -diag
|
|
.It "fxp%d: couldn't map memory"
|
|
A fatal initialization error has occurred.
|
|
.It "fxp%d: couldn't map interrupt"
|
|
A fatal initialization error has occurred.
|
|
.It "fxp%d: Failed to malloc memory"
|
|
There are not enough mbuf's available for allocation.
|
|
.It "fxp%d: device timeout"
|
|
The device has stopped responding to the network, or there is a problem with
|
|
the network connection (cable).
|
|
.It "fxp%d: Ethernet address ff:ff:ff:ff:ff:ff"
|
|
In some Alpha's (AXPpci and Multia) you must tell the driver to use (slower)
|
|
I/O rather than memory to access the card.
|
|
Create, if it does not yet exist, and add to the file
|
|
.Pa /boot/device.hints
|
|
the line
|
|
.Dq Li hint.fxp.0.prefer_iomap="0" .
|
|
.It "fxp%d: Microcode loaded, int_delay: %d usec bundle_max: %d"
|
|
The chip has successfully downloaded the microcode, and changed the
|
|
parameterized values to the given settings.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr arp 4 ,
|
|
.Xr miibus 4 ,
|
|
.Xr netintro 4 ,
|
|
.Xr ng_ether 4 ,
|
|
.Xr polling 4 ,
|
|
.Xr vlan 4 ,
|
|
.Xr ifconfig 8
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
device driver first appeared in
|
|
.Fx 2.1 .
|
|
.Sh AUTHORS
|
|
.An -nosplit
|
|
The
|
|
.Nm
|
|
device driver was written by
|
|
.An David Greenman .
|
|
It has then been updated to use the busdma API and made endian-clean by
|
|
.An Maxime Henrion .
|
|
This manual page was written by
|
|
.An David E. O'Brien .
|