share/man/man4/fxp.4

   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 30, 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
  35 .Cd "device miibus"
  36 .Cd "device fxp"
  37 .Sh DESCRIPTION
  38 The
  39 .Nm
  40 driver provides support for Ethernet adapters based on the Intel
  41 i82557, i82558, i82559, i82550, and i82562 chips.
  42 .Pp
  43 The
  44 .Nm
  45 driver supports the following media types:
  46 .Pp
  47 .Bl -tag -width xxxxxxxxxxxxxxxxxxxx
  48 .It autoselect
  49 Enable autoselection of the media type and options
  50 .It 10baseT/UTP
  51 Set 10Mbps operation
  52 .It 100baseTX
  53 Set 100Mbps (Fast Ethernet) operation
  54 .El
  55 .Pp
  56 The
  57 .Nm
  58 driver supports the following media options:
  59 .Pp
  60 .Bl -tag -width xxxxxxxxxxxxxxxxxxxx
  61 .It full-duplex
  62 Set full duplex operation
  63 .El
  64 .Pp
  65 Note that 100baseTX media type is not available on the Pro/10.
  66 For further information on configuring this device, see
  67 .Xr ifconfig 8 .
  68 .Pp
  69 The
  70 .Nm
  71 driver supports reception and transmission of extended frames
  72 for
  73 .Xr vlan 4 .
  74 This capability of
  75 .Nm
  76 can be controlled by means of the
  77 .Cm vlanmtu
  78 parameter
  79 to
  80 .Xr ifconfig 8 .
  81 .Pp
  82 The
  83 .Nm
  84 driver also supports a special link option:
  85 .Bl -tag -width link0
  86 .It Cm link0
  87 Some chip revisions have loadable microcode which can be used to reduce the
  88 interrupt load on the host cpu.
  89 Not all boards have microcode support.
  90 Setting the
  91 .Cm link0
  92 flag with
  93 .Xr ifconfig 8
  94 will download the microcode to the chip if it is available.
  95 .El
  96 .Sh HARDWARE
  97 Adapters supported by the
  98 .Nm
  99 driver include:
 100 .Pp
 101 .Bl -bullet -compact
 102 .It
 103 Intel EtherExpress PRO/10
 104 .It
 105 Intel InBusiness 10/100
 106 .It
 107 Intel PRO/100B / EtherExpressPRO/100 B PCI Adapter
 108 .It
 109 Intel PRO/100+ Management Adapter
 110 .It
 111 Intel PRO/100 VE Desktop Adapter
 112 .It
 113 Intel PRO/100 M Desktop Adapter
 114 .It
 115 Intel PRO/100 S Desktop, Server and Dual-Port Server Adapters
 116 .It
 117 Contec C-NET(PI)-100TX (PC-98)
 118 .It
 119 NEC PC-9821Ra20, Rv20, Xv13, Xv20 internal 100Base-TX (PC-98)
 120 .It
 121 NEC PC-9821X-B06 (PC-98)
 122 .It
 123 Many on-board network interfaces on Intel motherboards
 124 .El
 125 .Sh DIAGNOSTICS
 126 .Bl -diag
 127 .It "fxp%d: couldn't map memory"
 128 A fatal initialization error has occurred.
 129 .It "fxp%d: couldn't map interrupt"
 130 A fatal initialization error has occurred.
 131 .It "fxp%d: Failed to malloc memory"
 132 There are not enough mbuf's available for allocation.
 133 .It "fxp%d: device timeout"
 134 The device has stopped responding to the network, or there is a problem with
 135 the network connection (cable).
 136 .It "fxp%d: Ethernet address ff:ff:ff:ff:ff:ff"
 137 In some Alpha's (AXPpci and Multia) you must tell the driver to use (slower)
 138 I/O rather than memory to access the card.
 139 Create, if it does not yet exist, and add to the file
 140 .Pa /boot/device.hints
 141 the line
 142 .Dq Li hint.fxp.0.prefer_iomap="0" .
 143 .It "fxp%d: Microcode loaded, int_delay: %d usec  bundle_max: %d"
 144 The chip has successfully downloaded the microcode, and changed the
 145 parameterized values to the given settings.
 146 .El
 147 .Sh SEE ALSO
 148 .Xr arp 4 ,
 149 .Xr miibus 4 ,
 150 .Xr netintro 4 ,
 151 .Xr ng_ether 4 ,
 152 .Xr polling 4 ,
 153 .Xr vlan 4 ,
 154 .Xr ifconfig 8
 155 .Sh HISTORY
 156 The
 157 .Nm
 158 device driver first appeared in
 159 .Fx 2.1 .
 160 .Sh AUTHORS
 161 .An -nosplit
 162 The
 163 .Nm
 164 device driver was written by
 165 .An David Greenman .
 166 It has then been updated to use the busdma API and made endian-clean by
 167 .An Maxime Henrion .
 168 This manual page was written by
 169 .An David E. O'Brien .