share/man/man4/man4.i386/lnc.4

   1 .\"     $NetBSD: le.4,v 1.22 2004/10/04 19:12:52 rumble Exp $
   2 .\"
   3 .\"-
   4 .\" Copyright (c) 1992, 1993
   5 .\"     The Regents of the University of California.  All rights reserved.
   6 .\"
   7 .\" This software was developed by the Computer Systems Engineering group
   8 .\" at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
   9 .\" contributed to Berkeley.
  10 .\"
  11 .\" Redistribution and use in source and binary forms, with or without
  12 .\" modification, are permitted provided that the following conditions
  13 .\" are met:
  14 .\" 1. Redistributions of source code must retain the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer.
  16 .\" 2. Redistributions in binary form must reproduce the above copyright
  17 .\"    notice, this list of conditions and the following disclaimer in the
  18 .\"    documentation and/or other materials provided with the distribution.
  19 .\" 3. Neither the name of the University nor the names of its contributors
  20 .\"    may be used to endorse or promote products derived from this software
  21 .\"    without specific prior written permission.
  22 .\"
  23 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  24 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  25 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  26 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  27 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  28 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  29 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  30 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  31 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  32 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  33 .\" SUCH DAMAGE.
  34 .\"
  35 .\"     from: Header: le.4,v 1.2 92/10/13 05:31:33 leres Exp
  36 .\"     from: @(#)le.4  8.1 (Berkeley) 6/9/93
  37 .\" $FreeBSD: /repoman/r/ncvs/src/share/man/man4/le.4,v 1.2 2006/02/02 14:57:00 marius Exp $
  38 .\" $DragonFly: src/share/man/man4/man4.i386/lnc.4,v 1.7 2008/05/02 02:05:06 swildner Exp $
  39 .\"
  40 .Dd July 7, 2006
  41 .Dt LNC 4 i386
  42 .Os
  43 .Sh NAME
  44 .Nm lnc
  45 .Nd AMD Am7900 LANCE and Am79C9xx PCnet Ethernet interface driver
  46 .Sh SYNOPSIS
  47 .Cd "device lnc"
  48 .Sh DESCRIPTION
  49 The
  50 .Nm
  51 driver provides support for the AMD family of Lance/PCnet Ethernet NICs
  52 including the Am7990 and Am79C960.
  53 .Pp
  54 The
  55 .Nm
  56 driver also supports PCnet adapters based on the
  57 .Tn AMD 79C9xx
  58 family of chips, which are single-chip implementations of a
  59 .Tn LANCE
  60 chip and a DMA engine.
  61 This includes a superset of the
  62 .Tn PCI
  63 bus Ethernet chip sets supported by the
  64 .Xr pcn 4
  65 driver.
  66 The
  67 .Nm
  68 driver treats all of these
  69 .Tn PCI
  70 bus Ethernet chip sets as an
  71 .Tn AMD Am79C970 PCnet-PCI
  72 and does not support the additional features like the MII bus and burst mode of
  73 .Tn AMD Am79C971 PCnet-FAST
  74 and greater chip sets.
  75 Thus the
  76 .Xr pcn 4
  77 driver should be preferred for the latter.
  78 .Pp
  79 The
  80 .Nm
  81 driver supports reception and transmission of extended frames for
  82 .Xr vlan 4 .
  83 Selective reception of multicast Ethernet frames is provided by a 64-bit mask;
  84 multicast destination addresses are hashed to a bit entry using the Ethernet
  85 CRC function.
  86 .Sh HARDWARE
  87 .\" .Ss ISA
  88 .\" The
  89 .\" .Tn ISA
  90 .\" bus Ethernet cards supported by the
  91 .\" .Nm
  92 .\" driver are:
  93 .\" .Pp
  94 .\" .Bl -bullet -compact
  95 .\" .It
  96 .\" .Tn BICC Isolan
  97 .\" .It
  98 .\" .Tn Novell NE2100
  99 .\" .It
 100 .\" .Tn Digital DEPCA
 101 .\" .El
 102 .\" .Ss EISA
 103 .\" The
 104 .\" .Tn EISA
 105 .\" bus Ethernet cards supported by the
 106 .\" .Nm
 107 .\" driver are:
 108 .\" .Pp
 109 .\" .Bl -bullet -compact
 110 .\" .It
 111 .\" .Tn DEC DE422
 112 .\" .El
 113 .\" .Ss MCA
 114 .\" The
 115 .\" .Tn MCA
 116 .\" bus Ethernet cards supported by the
 117 .\" .Nm
 118 .\" driver are:
 119 .\" .Pp
 120 .\" .Bl -bullet -compact
 121 .\" .It
 122 .\" .Tn SKNET Personal MC2
 123 .\" .It
 124 .\" .Tn SKNET MC2+
 125 .\" .El
 126 .Ss PCI
 127 The
 128 .Tn PCI
 129 bus Ethernet chip sets supported by the
 130 .Nm
 131 driver are:
 132 .Pp
 133 .Bl -bullet -compact
 134 .It
 135 .Tn AMD Am53C974/Am79C970/Am79C974 PCnet-PCI
 136 .It
 137 .Tn AMD Am79C970A PCnet-PCI II
 138 .It
 139 .Tn AMD Am79C971 PCnet-FAST
 140 .It
 141 .Tn AMD Am79C972 PCnet-FAST+
 142 .It
 143 .Tn AMD Am79C973/Am79C975 PCnet-FAST III
 144 .It
 145 .Tn AMD Am79C976 PCnet-PRO
 146 .It
 147 .Tn AMD Am79C978 PCnet-Home
 148 .El
 149 .Pp
 150 The
 151 .Nm
 152 driver supports the following media types with these chip sets:
 153 .Bl -tag -width xxxxxxxxxxxxxxxxxxxx
 154 .It autoselect
 155 Enable autoselection of the media type.
 156 .It 10baseT/UTP
 157 Select UTP media.
 158 .It 10base5/AUI
 159 Select AUI/BNC media.
 160 .El
 161 .Pp
 162 The following media option is supported with these media types:
 163 .Bl -tag -width xxxxxxxxxxxxxxxxxxxx
 164 .It full-duplex
 165 Select full duplex operation.
 166 .El
 167 .Pp
 168 Note that unlike the
 169 .Xr pcn 4
 170 driver, the
 171 .Nm
 172 driver does not support selecting 100Mbps (Fast Ethernet) media types.
 173 .Pp
 174 For further information on configuring media types and options, see
 175 .Xr ifconfig 8 .
 176 .Sh DIAGNOSTICS
 177 .Bl -diag
 178 .It "lnc%d: overflow"
 179 More packets came in from the Ethernet than there was space in the
 180 .Tn LANCE
 181 receive buffers.
 182 Packets were missed.
 183 .It "lnc%d: receive buffer error"
 184 The
 185 .Tn LANCE
 186 ran out of buffer space, packet dropped.
 187 .It "lnc%d: lost carrier"
 188 The Ethernet carrier disappeared during an attempt to transmit.
 189 The
 190 .Tn LANCE
 191 will finish transmitting the current packet,
 192 but will not automatically retry transmission if there is a collision.
 193 .It "lnc%d: excessive collisions, tdr %d"
 194 The Ethernet was extremely busy or jammed,
 195 outbound packets were dropped after 16 attempts to retransmit.
 196 .Pp
 197 TDR
 198 is the abbreviation of
 199 .Qq Time Domain Reflectometry .
 200 The optionally reported TDR value is an internal counter of the interval
 201 between the start of a transmission and the occurrence of a collision.
 202 This value can be used to determine the distance from the Ethernet tap to
 203 the point on the Ethernet cable that is shorted or open (unterminated).
 204 .It "lnc%d: dropping chained buffer"
 205 A packet did not fit into a single receive buffer and was dropped.
 206 Since the
 207 .Nm
 208 driver allocates buffers large enough to receive maximum sized Ethernet
 209 packets, this means some other station on the LAN transmitted a packet
 210 larger than allowed by the Ethernet standard.
 211 .It "lnc%d: transmit buffer error"
 212 The
 213 .Tn LANCE
 214 ran out of buffer space before finishing the transmission of a packet.
 215 If this error occurs, the driver software has a bug.
 216 .It "lnc%d: underflow"
 217 The
 218 .Tn LANCE
 219 ran out of buffer space before finishing the transmission of a packet.
 220 If this error occurs, the driver software has a bug.
 221 .It "lnc%d: controller failed to initialize"
 222 Driver failed to start the
 223 .Tn LANCE .
 224 This is potentially a hardware failure.
 225 .It "lnc%d: memory error"
 226 RAM failed to respond within the timeout when the
 227 .Tn LANCE
 228 wanted to read or write it.
 229 This is potentially a hardware failure.
 230 .It "lnc%d: receiver disabled"
 231 The receiver of the
 232 .Tn LANCE
 233 was turned off due to an error.
 234 .It "lnc%d: transmitter disabled"
 235 The transmitter of the
 236 .Tn LANCE
 237 was turned off due to an error.
 238 .El
 239 .Sh SEE ALSO
 240 .Xr arp 4 ,
 241 .Xr ifmedia 4 ,
 242 .Xr intro 4 ,
 243 .Xr netintro 4 ,
 244 .Xr pcn 4 ,
 245 .Xr vlan 4 ,
 246 .Xr ifconfig 8
 247 .Sh HISTORY
 248 The
 249 .Nm
 250 driver first appeared in
 251 .Fx 2.2 ,
 252 it was replaced in
 253 .Dx 1.5
 254 with the
 255 .Xr le 4
 256 driver from
 257 .Fx 6.1
 258 which was in turn ported from
 259 .Nx .
 260 The
 261 .Nx
 262 driver was derived from the
 263 .Xr le 4 driver in
 264 .Bx 4.4 .
 265 .Sh AUTHORS
 266 .An -nosplit
 267 The
 268 .Nm
 269 driver was ported to
 270 .Fx
 271 by
 272 .An "Marius Strobl" Aq marius@FreeBSD.org
 273 and later ported to
 274 .Dx
 275 by
 276 .An "Bill Marquette" Aq bill.marquette@gmail.com .
 277 .\" .Sh BUGS
 278 .\" The Am7990 Revision C chips have a bug which causes garbage to be inserted
 279 .\" in front of the received packet occasionally.
 280 .\" The work-around is to ignore packets with an invalid destination address
 281 .\" (garbage will usually not match), by double-checking the destination
 282 .\" address of every packet in the driver.
 283 .\" This work-around can be enabled with the
 284 .\" .Dv LANCE_REVC_BUG
 285 .\" kernel option.
 286 .\" .Pp
 287 .\" When
 288 .\" .Dv LANCE_REVC_BUG
 289 .\" is enabled, the
 290 .\" .Nm
 291 .\" driver executes one or two calls to an inline Ethernet address comparison
 292 .\" function for every received packet.
 293 .\" There is one comparison for each unicast packet, and two comparisons for
 294 .\" each broadcast packet.
 295 .\" .Pp
 296 .\" In summary, the cost of the LANCE_REVC_BUG option is:
 297 .\" .Bl -enum -compact
 298 .\" .It
 299 .\" loss of multicast support, and
 300 .\" .It
 301 .\" eight extra
 302 .\" .Tn CPU
 303 .\" instructions per received packet, sometimes sixteen, depending on both the
 304 .\" processor, and the type of packet.
 305 .\" .El
 306 .\" .Pp
 307 .\" Alas, the Am7990 chip is so old that
 308 .\" .Tn AMD
 309 .\" has
 310 .\" .Qq de-archived
 311 .\" the production information about it; pending a search elsewhere, we do not
 312 .\" know how to identify the revision C chip from the date codes.