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 July 16, 2005 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 support for the 36.Nm 37driver into your kernel, place the following lines in your 38kernel configuration file: 39.Bd -ragged -offset indent 40.Cd "device miibus" 41.Cd "device fxp" 42.Ed 43.Pp 44Alternatively, to load the 45.Nm 46driver at boot time, place the following line in 47.Xr loader.conf 5 : 48.Bd -literal -offset indent 49if_fxp_load="YES" 50.Ed 51.Sh DESCRIPTION 52The 53.Nm 54driver provides support for Ethernet adapters based on the Intel 55i82557, i82558, i82559, i82550, and i82562 chips. 56.Pp 57The 58.Nm 59driver supports the following media types: 60.Pp 61.Bl -tag -width xxxxxxxxxxxxxxxxxxxx 62.It autoselect 63Enable autoselection of the media type and options 64.It 10baseT/UTP 65Set 10Mbps operation 66.It 100baseTX 67Set 100Mbps (Fast Ethernet) operation 68.El 69.Pp 70The 71.Nm 72driver supports the following media options: 73.Pp 74.Bl -tag -width xxxxxxxxxxxxxxxxxxxx 75.It full-duplex 76Set full duplex operation 77.El 78.Pp 79Note that 100baseTX media type is not available on the Pro/10. 80For further information on configuring this device, see 81.Xr ifconfig 8 . 82.Pp 83The 84.Nm 85driver supports reception and transmission of extended frames 86for 87.Xr vlan 4 . 88This capability of 89.Nm 90can be controlled by means of the 91.Cm vlanmtu 92parameter 93to 94.Xr ifconfig 8 . 95.Pp 96The 97.Nm 98driver also supports a special link option: 99.Bl -tag -width link0 100.It Cm link0 101Some chip revisions have loadable microcode which can be used to reduce the 102interrupt load on the host cpu. 103Not all boards have microcode support. 104Setting the 105.Cm link0 106flag with 107.Xr ifconfig 8 108will download the microcode to the chip if it is available. 109.El 110.Sh HARDWARE 111Adapters supported by the 112.Nm 113driver include: 114.Pp 115.Bl -bullet -compact 116.It 117Intel EtherExpress PRO/10 118.It 119Intel InBusiness 10/100 120.It 121Intel PRO/100B / EtherExpressPRO/100 B PCI Adapter 122.It 123Intel PRO/100+ Management Adapter 124.It 125Intel PRO/100 VE Desktop Adapter 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: Ethernet address ff:ff:ff:ff:ff:ff" 151In some Alpha's (AXPpci and Multia) you must tell the driver to use (slower) 152I/O rather than memory to access the card. 153Create, if it does not yet exist, and add to the file 154.Pa /boot/device.hints 155the line 156.Dq Li hint.fxp.0.prefer_iomap="0" . 157.It "fxp%d: Microcode loaded, int_delay: %d usec bundle_max: %d" 158The chip has successfully downloaded the microcode, and changed the 159parameterized values to the given settings. 160.El 161.Sh SEE ALSO 162.Xr arp 4 , 163.Xr miibus 4 , 164.Xr netintro 4 , 165.Xr ng_ether 4 , 166.Xr polling 4 , 167.Xr vlan 4 , 168.Xr ifconfig 8 169.Sh HISTORY 170The 171.Nm 172device driver first appeared in 173.Fx 2.1 . 174.Sh AUTHORS 175.An -nosplit 176The 177.Nm 178device driver was written by 179.An David Greenman . 180It has then been updated to use the busdma API and made endian-clean by 181.An Maxime Henrion . 182This manual page was written by 183.An David E. O'Brien . 184