share/man/man4/man4.i386/ex.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 October 24, 2018
  29 .Dt EX 4 i386
  30 .Os
  31 .Sh NAME
  32 .Nm ex
  33 .Nd "Ethernet device driver for the Intel EtherExpress Pro/10 and Pro/10+"
  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 ex"
  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_ex_load="YES"
  47 .Ed
  48 .Sh DEPRECATION NOTICE
  49 The
  50 .Nm
  51 driver is not present in
  52 .Fx 13.0
  53 and later.
  54 See https://github.com/freebsd/fcp/blob/master/fcp-0101.md for more
  55 information.
  56 .Sh DESCRIPTION
  57 The
  58 .Nm
  59 driver provides support for Ethernet adapters based on the Intel
  60 i82595 chip.
  61 .Pp
  62 On the ISA bus, the card will be searched for in the
  63 I/O address range 0x200 - 0x3a0.
  64 The IRQ will be read from the EEPROM on the card.
  65 For correct operation Plug-N-Play support should be disabled.
  66 .Pp
  67 On the PC Card bus, the card will be automatically recognized and
  68 configured.
  69 .Sh HARDWARE
  70 The
  71 .Nm
  72 driver supports the following Ethernet adapters:
  73 .Pp
  74 .Bl -bullet -compact
  75 .It
  76 Intel EtherExpress Pro/10 ISA
  77 .It
  78 Intel EtherExpress Pro/10+ ISA
  79 .It
  80 Olicom OC2220 Ethernet PC Card
  81 .It
  82 Olicom OC2232 Ethernet/Modem PC Card
  83 .It
  84 Silicom Ethernet LAN PC Card
  85 .It
  86 Silicom EtherSerial LAN PC Card
  87 .El
  88 .Sh DIAGNOSTICS
  89 .Bl -diag
  90 .It "ex%d: Intel EtherExpress Pro/10, address %6D, connector %s"
  91 The device probe found an installed card, and was able to correctly install
  92 the device driver.
  93 .It "ex%d: WARNING: board's EEPROM is configured for IRQ %d, using %d"
  94 The device probe detected that the board is configured for a different
  95 interrupt than the one specified in the kernel configuration file.
  96 .It "ex%d: invalid IRQ."
  97 The device probe detected an invalid IRQ setting.
  98 .El
  99 .Sh SEE ALSO
 100 .Xr arp 4 ,
 101 .Xr netintro 4 ,
 102 .Xr ng_ether 4 ,
 103 .Xr ifconfig 8
 104 .Sh HISTORY
 105 The
 106 .Nm
 107 device driver first appeared in
 108 .Fx 2.2 .
 109 .Sh AUTHORS
 110 .An -nosplit
 111 The
 112 .Nm
 113 device driver was written by
 114 .An Javier Mart\('in Rueda .
 115 The PC Card attachment was written by
 116 .An Mitsuru ISAWAKI
 117 and
 118 .An Warner Losh .
 119 This manual page was written by
 120 .An David E. O'Brien .
 121 .Sh BUGS
 122 Currently the driver does not support multicast.
 123 .Pp
 124 The Silicom EtherSerial card's serial port does not currently work.
 125 The Olicom OC2232 PC Card should work with the
 126 .Nm
 127 driver, but is currently completely broken.