share/man/man4/ex.4

   1 .\"     $NetBSD: ex.4,v 1.17 2005/09/09 14:11:39 drochner Exp $
   2 .\"
   3 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .Dd October 30, 2007
   7 .Dt EX 4
   8 .Os
   9 .Sh NAME
  10 .Nm ex
  11 .Nd driver for
  12 .Tn 3Com
  13 Fast EtherLink XL (3c900, 3c905, 3c980) and similar
  14 .Tn PCI
  15 bus and
  16 .Tn cardbus
  17 .Tn Ethernet
  18 interfaces
  19 .Sh SYNOPSIS
  20 .Cd "ex* at cardbus? function ?"
  21 .Cd "ex* at pci? dev ? function ?"
  22 .Sh DESCRIPTION
  23 .Tn 3Com
  24 .Tn Ethernet
  25 and
  26 .Tn Fast Ethernet
  27 cards supported by the
  28 .Nm
  29 driver include:
  30 .Pp
  31 .Bl -tag -width "3c900B-COMBO" -compact
  32 .It 3c450-TX
  33 10/100 Ethernet
  34 .It 3c555
  35 MiniPCI 10/100 Ethernet
  36 .It 3c575-TX
  37 Ethernet
  38 .It 3c575B-TX
  39 Ethernet
  40 .It 3c575CT
  41 Ethernet
  42 .It 3c656
  43 MiniPCI 10/100 Ethernet
  44 .It 3c656B
  45 MiniPCI 10/100 Ethernet
  46 .It 3c656C
  47 MiniPCI 10/100 Ethernet
  48 .It 3c900-TPO
  49 Ethernet
  50 .It 3c900-COMBO
  51 Ethernet
  52 .It 3c900B-TPC
  53 Ethernet
  54 .It 3c900B-TPO
  55 Ethernet
  56 .It 3c900B-COMBO
  57 Ethernet
  58 .It 3c905-T4
  59 10/100 Ethernet
  60 .It 3c905-TX
  61 10/100 Ethernet
  62 .It 3c905B-COMBO
  63 10/100 Ethernet
  64 .It 3c905B-FX
  65 10/100 Ethernet
  66 .It 3c905B-T4
  67 10/100 Ethernet
  68 .It 3c905B-TX
  69 10/100 Ethernet
  70 .It 3c905CX-TX
  71 10/100 Ethernet
  72 .It 3c980
  73 Server Adapter 10/100 Ethernet
  74 .It 3c980C-TXM
  75 10/100 Ethernet
  76 .It 3cSOHO100-TX
  77 10/100 Ethernet
  78 .El
  79 .Pp
  80 All versions of the
  81 .Tn EtherLink XL
  82 .Pq except the older 3c900 and 3c905
  83 support IPv4/TCP/UDP checksumming in hardware.
  84 The
  85 .Nm
  86 driver supports this feature of the chip.
  87 See
  88 .Xr ifconfig 8
  89 for information on how to enable this feature.
  90 .Sh MEDIA SELECTION
  91 Some of these network interfaces support the Media Independent Interface
  92 .Pq Tn MII ,
  93 a bus which can have at least one arbitrary Physical interface
  94 .Pq Tn PHY
  95 chip on it.
  96 .Nx
  97 supports
  98 .Tn MII
  99 and has separate drivers for many different
 100 .Tn PHY
 101 chips, including
 102 .Xr ukphy 4 ,
 103 a generic
 104 .Tn PHY
 105 driver that can support many
 106 .Tn PHY
 107 chips that
 108 .Nx
 109 does not yet have a specific driver for.
 110 .Pp
 111 Support for the
 112 .Tn PHY
 113 found on a given
 114 .Tn NIC
 115 must be configured into a
 116 .Nx
 117 kernel
 118 .Xr config 1
 119 for this driver to work properly in those cases.
 120 .Pp
 121 See
 122 .Xr ifmedia 4 ,
 123 and
 124 .Xr mii 4 .
 125 .Sh DIAGNOSTICS
 126 .Bl -diag
 127 .It "%s: adapter failure (%x)"
 128 .It "%s: can't allocate download descriptors, error = %d"
 129 .It "%s: can't allocate or map rx buffers"
 130 .It "%s: can't allocate upload descriptors, error = %d"
 131 .It "%s: can't create download desc. DMA map, error = %d"
 132 .It "%s: can't create rx DMA map %d, error = %d"
 133 .It "%s: can't create tx DMA map %d, error = %d"
 134 .It "%s: can't create upload desc. DMA map, error = %d"
 135 .It "%s: can't load download desc. DMA map, error = %d"
 136 .It "%s: can't load mbuf chain, error = %d"
 137 .It "%s: can't load rx buffer, error = %d"
 138 .It "%s: can't load upload desc. DMA map, error = %d"
 139 .It "%s: can't map download descriptors, error = %d"
 140 .It "%s: can't map upload descriptors, error = %d"
 141 .It "%s: fifo underrun (%x) @%d"
 142 .It "%s: jabber (%x)"
 143 .It "%s: receive stalled"
 144 .It "%s: too many segments, "
 145 .It "%s: uplistptr was 0"
 146 host too slow to serve incoming packets
 147 .El
 148 .Sh SEE ALSO
 149 .Xr cardbus 4 ,
 150 .Xr exphy 4 ,
 151 .Xr ifmedia 4 ,
 152 .Xr intro 4 ,
 153 .Xr mii 4 ,
 154 .Xr pci 4 ,
 155 .Xr ifconfig 8
 156 .Pp
 157 .Pa http://www.3com.com/