share/man/man4/man4.i386/ie.4

   1 .\"
   2 .\" Copyright (c) 1994, Wilko Bulte
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\"
  14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24 .\" SUCH DAMAGE.
  25 .\"
  26 .\" $FreeBSD$
  27 .\"
  28 .Dd July 16, 2005
  29 .Dt IE 4 i386
  30 .Os
  31 .Sh NAME
  32 .Nm ie
  33 .Nd "Ethernet device driver"
  34 .Sh SYNOPSIS
  35 To compile this driver into the kernel,
  36 place the following line in your
  37 kernel configuration file:
  38 .Bd -ragged -offset indent
  39 .Cd "device ie"
  40 .Ed
  41 .Pp
  42 Alternatively, to load the driver as a
  43 module at boot time, place the following line in
  44 .Xr loader.conf 5 :
  45 .Bd -literal -offset indent
  46 if_ie_load="YES"
  47 .Ed
  48 .Pp
  49 In
  50 .Pa /boot/device.hints :
  51 .Cd hint.ie.0.at="isa"
  52 .Cd hint.ie.0.port="0x300"
  53 .Cd hint.ie.0.irq="5"
  54 .Cd hint.ie.0.maddr="0xd0000"
  55 .Sh HARDWARE
  56 The
  57 .Nm
  58 driver provides supports the following 8 and 16bit ISA Ethernet cards
  59 that are based on the Intel i82586 chip:
  60 .Pp
  61 .Bl -bullet -compact
  62 .It
  63 3COM 3C507
  64 .It
  65 AT&T EN100
  66 .It
  67 AT&T Starlan 10
  68 .It
  69 AT&T Starlan Fiber
  70 .It
  71 Intel EtherExpress 16
  72 .It
  73 RACAL Interlan NI5210
  74 .El
  75 .Sh DIAGNOSTICS
  76 .Bl -diag
  77 .It "ie%d: unknown board type code %d"
  78 An i82586 chip was found, but the driver was unable to determine the actual
  79 board type during the probe.
  80 .It "ie%d: kernel configured maddr %x doesn't match board configured maddr %x"
  81 The device probe detected a different maddr than the one specified in the
  82 kernel configuration file.
  83 .It "ie%d: can't find shared memory"
  84 The device probe could not access the shared memory to determine its size.
  85 .It "ie%d: kernel configured msize %d doesn't match board configured msize %d"
  86 The device probe found a different size for the shared memory than the one
  87 specified in the kernel configuration file.
  88 .It "ie%d: kernel configured irq %d doesn't match board configured irq %d"
  89 The device probe detected that the board is configured for a different
  90 interrupt than the one specified in the kernel configuration file.
  91 .It "ie%d: reset"
  92 The Intel i82586 had to be reset by the driver.
  93 .It "ie%d: transceiver problem"
  94 The driver has detected a problem with the Ethernet transceiver.
  95 This is
  96 usually due to a loose or broken transceiver cable when using an external
  97 transceiver.
  98 When you experience this problem with an on-card transceiver
  99 your card may be incorrectly jumpered for to use an external transceiver.
 100 Worst case your on-board transceiver may be broken.
 101 .It "ie%d: TDR detected an open %d clocks away"
 102 The driver detected an open circuit in the Ethernet cable.
 103 Check your
 104 coax cable and terminator resistors.
 105 .It "ie%d: TDR detected a short %d clocks away"
 106 The driver detected a short circuit in the Ethernet cable.
 107 Check your
 108 coax cable and terminator resistors.
 109 .It "ie%d: TDR returned unknown status %x"
 110 The driver got an unknown status from the card during the Ethernet cable
 111 test.
 112 .It "ie%d: multicast address setup command failed"
 113 The card could not be put into multicast mode.
 114 .It "ie%d: configure command failed"
 115 The card refused to respond correctly during configuration.
 116 .It "ie%d: individual address setup command failed"
 117 The programming of the Ethernet (MAC) address failed.
 118 .El
 119 .Sh SEE ALSO
 120 .Xr arp 4 ,
 121 .Xr netintro 4 ,
 122 .Xr ng_ether 4 ,
 123 .Xr ifconfig 8
 124 .Sh AUTHORS
 125 .An -nosplit
 126 The
 127 .Nm
 128 device driver was written by
 129 .An Garrett A. Wollman ,
 130 based on code by
 131 .An William F. Jolitz
 132 and Lawrence Berkeley Laboratories.
 133 .Tn 3C507
 134 support was written by
 135 .An Charles M. Hannum .
 136 This manual page was written by
 137 .An Wilko C. Bulte .
 138 .Sh CAVEATS
 139 The Racal Interlan NI5210 comes in variants with 8 and 16 kbytes of
 140 shared memory.
 141 It is strongly advisable to use the 16 kbyte variant.
 142 You can upgrade your 8 kbyte card to 16 kbyte by adding an additional
 143 RAM chip.