1.\" $OpenBSD: fxp.4,v 1.42 2007/08/31 22:06:26 deraadt Exp $ 2.\" 3.\" Copyright (c) 1997 David E. O'Brien 4.\" 5.\" All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 16.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR 17.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 18.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 19.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, 20.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 21.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 22.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 23.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 24.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 25.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26.\" 27.Dd $Mdocdate: August 31 2007 $ 28.Dt FXP 4 29.Os 30.Sh NAME 31.Nm fxp 32.Nd Intel EtherExpress PRO/100 10/100 Ethernet device 33.Sh SYNOPSIS 34.Cd "fxp* at pci?" 35.Cd "fxp* at cardbus?" 36.Cd "icsphy* at mii?" 37.Cd "inphy* at mii?" 38.Cd "iophy* at mii?" 39.Cd "nsphy* at mii?" 40.Sh DESCRIPTION 41The 42.Nm 43device driver supports the Intel EtherExpress 100 family of Ethernet cards 44based on various revisions of the i82557, i82558, i82559, i82559S, 45i82550, i82551, and i82562 chipsets. 46These come in several different varieties, including dual-port cards, and 47as built-in Ethernet solutions on certain motherboards. 48This includes, among others, the following models: 49.Pp 50.Bl -item -offset indent -compact 51.It 52Intel EtherExpress PRO/100 PCI 53.It 54Intel EtherExpress PRO/100B PCI 55.It 56Intel EtherExpress PRO/100+ PCI 57.It 58Intel EtherExpress PRO/100 Dual-Port PCI 59.It 60Intel PRO/100 CardBus II PC Card 61.It 62Intel PRO/100 VE 63.It 64Intel PRO/100 VM 65.It 66Intel PRO/100 M 67.It 68Intel PRO/100 S 69.El 70.Pp 71This list is not exhaustive. 72In particular, the 73.Nm 74driver should support any card by any manufacturer which is based on one of the 75aforementioned chipsets. 76.Pp 77The following media types and options (as given to 78.Xr ifconfig 8 ) 79are supported: 80.Bl -tag -width xxx -offset indent 81.It Cm media No autoselect 82Enable autoselection of the media type and options (default). 83.It Cm media No 100baseTX Cm mediaopt No full-duplex 84Set 100Mbps (Fast Ethernet) operation and force full-duplex mode. 85.It Cm media No 100baseTX Cm mediaopt No half-duplex 86Set 100Mbps (Fast Ethernet) operation and force half-duplex mode. 87.It Cm media No 10baseT Cm mediaopt No full-duplex 88Set 10Mbps operation and force full-duplex. 89.It Cm media No 10baseT Cm mediaopt No half-duplex 90Set 10Mbps operation and force half-duplex. 91.El 92.Pp 93If no media options are present, the 94.Nm 95driver places the card into autoselect mode. 96.Sh FILES 97Some devices are able to do interrupt coalescing but it requires firmware 98updating. 99The following firmware files are potentially loaded on demand when an 100interface is brought up: 101.Pp 102.Bl -tag -width Ds -offset indent -compact 103.It Pa /etc/firmware/fxp-d101a 104.It Pa /etc/firmware/fxp-d101b0 105.It Pa /etc/firmware/fxp-d101ma 106.It Pa /etc/firmware/fxp-d101s 107.It Pa /etc/firmware/fxp-d102 108.It Pa /etc/firmware/fxp-d102c 109.It Pa /etc/firmware/fxp-d102e 110.El 111.Pp 112If a file is missing, the driver attempts to operate anyway. 113.Sh DIAGNOSTICS 114.Bl -diag 115.It "fxp%d: couldn't map memory" 116A fatal initialization error has occurred. 117.It "fxp%d: couldn't map interrupt" 118A fatal initialization error has occurred. 119.It "fxp%d: Failed to malloc memory" 120There are not enough mbufs available for allocation. 121.It "fxp%d: device timeout" 122The device has stopped responding to the network, or there is a problem with 123the network connection (cable). 124.It "fxp%d: error %d, could not read firmware %s" 125The device is able to do interrupt coalescing but required firmware file 126is missing. 127.El 128.Sh SEE ALSO 129.Xr arp 4 , 130.Xr cardbus 4 , 131.Xr icsphy 4 , 132.Xr ifmedia 4 , 133.Xr inphy 4 , 134.Xr intro 4 , 135.Xr iophy 4 , 136.Xr netintro 4 , 137.Xr nsphy 4 , 138.Xr pci 4 , 139.Xr hostname.if 5 , 140.Xr ifconfig 8 141.Sh HISTORY 142The 143.Nm 144device driver first appeared in 145.Ox 2.2 . 146.Sh AUTHORS 147The 148.Nm 149device driver was written by David Greenman. 150This manual page was written by David E. O'Brien. 151