6/share/man/man4/man4.i386/lnc.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 September 3, 2006
  29 .Dt LNC 4 i386
  30 .Os
  31 .Sh NAME
  32 .Nm lnc
  33 .Nd "AMD Lance/PCnet 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 lnc"
  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_lnc_load="YES"
  47 .Ed
  48 .Pp
  49 In
  50 .Pa /boot/device.hints :
  51 .Cd hint.lnc.0.at="isa"
  52 .Cd hint.lnc.0.port="0x280"
  53 .Cd hint.lnc.0.irq="10"
  54 .Cd hint.lnc.0.drq="0"
  55 .Sh DESCRIPTION
  56 .Bf -symbolic
  57 This device driver is deprecated and was replaced by
  58 .Xr le 4
  59 in
  60 .Fx 7.0 .
  61 .Ef
  62 .Pp
  63 The
  64 .Nm
  65 driver provides support for the AMD family of Lance/PCnet Ethernet NICs
  66 including the Am7990 and Am79C960.
  67 .Sh HARDWARE
  68 The
  69 .Nm
  70 driver supports the following adapters:
  71 .Pp
  72 .Bl -bullet -compact
  73 .It
  74 Diamond HomeFree
  75 .It
  76 Hewlett Packard Vectra 486/66XM
  77 .It
  78 Hewlett Packard Vectra XU
  79 .It
  80 Isolan AT 4141-0 (16 bit)
  81 .It
  82 Isolan BICC
  83 .It
  84 Isolink 4110 (8 bit)
  85 .It
  86 Novell NE2100
  87 .It
  88 Novell NE32-VL
  89 .El
  90 .Pp
  91 Also supported are adapters working with the
  92 .Xr pcn 4
  93 driver.
  94 The
  95 .Nm
  96 driver runs these in compatibility mode, thus the
  97 .Xr pcn 4
  98 driver should be preferred.
  99 .Sh DIAGNOSTICS
 100 .Bl -diag
 101 .It "lnc%d: Framing error"
 102 A framing error occurred.
 103 This means a CRC error also occurred.
 104 This caused the driver to drop the packet that contained the framing error.
 105 .It "lnc%d: Receive CRC error
 106 The received Ethernet frame failed the CRC checksum.
 107 This caused the driver to drop the packet that failed the checksum.
 108 .It "lnc%d: Packet dropped, no mbufs"
 109 The driver ran out of mbuf's.
 110 This may suggest a resource problem.
 111 .It "lnc%d: Couldn't allocate memory for NIC"
 112 This is a fatal error.
 113 The driver will not attach to the card under this
 114 circumstance.
 115 .It "lnc%d: Memory allocated above 16Mb limit"
 116 ISA and ESIA cards require bounce buffers for DMA transfers above 16mb.
 117 The Am7990 and Am79C960 only have 24 address lines and so can only access
 118 the lower 16Mb of physical memory.
 119 The
 120 .Nm
 121 driver assumes the memory it allocates is within the lower 16Mb range.
 122 This is not a very valid assumption but there is nothing that can be done
 123 about it yet.
 124 For shared memory NICs this is not relevant.
 125 .It "lnc%d: Device timeout -- Resetting"
 126 The device has stopped responding to the network, or there is a problem with
 127 the network connection (cable).
 128 Make sure the network connection in use
 129 is the same one the card is configured for.
 130 .It "lnc%d: Transmit late collision  -- Net error?"
 131 .It "lnc%d: Loss of carrier during transmit -- Net error?"
 132 .It "lnc%d: Transmit of packet failed after 16 attempts -- TDR = %d"
 133 .It "lnc%d: Heartbeat error -- SQE test failed"
 134 .It "lnc%d: Babble error - more than 1519 bytes transmitted"
 135 .It "lnc%d: Missed packet -- no receive buffer"
 136 .It "lnc%d: Memory error  -- Resetting"
 137 .It "lnc%d: Couldn't get mbuf for transmit packet -- Resetting"
 138 .It "lnc%d: Receive buffer error"
 139 .It "lnc%d: Receive overflow error"
 140 .It "lnc%d: Receive interrupt with buffer still owned by controller -- Resetting"
 141 .It "lnc%d: Receive interrupt but not start of packet -- Resetting"
 142 .It "lnc%d: Start of packet found before end of previous in receive ring -- Resetting"
 143 .It "lnc%d: End of received packet not found -- Resetting"
 144 .It "lnc%d: Transmit interrupt with buffer still owned by controller -- Resetting"
 145 .It "lnc%d: Transmit interrupt but not start of packet -- Resetting"
 146 .It "lnc%d: Start of packet found before end of previous in transmit ring -- Resetting"
 147 .It "lnc%d: End of transmitted packet not found -- Resetting"
 148 .It "lnc%d: Transmit buffer error -- Resetting"
 149 .It "lnc%d: Transmit underflow error -- Resetting"
 150 .El
 151 .Sh SEE ALSO
 152 .Xr altq 4 ,
 153 .Xr arp 4 ,
 154 .Xr netintro 4 ,
 155 .Xr ng_ether 4 ,
 156 .Xr ifconfig 8
 157 .Sh HISTORY
 158 The
 159 .Nm
 160 device driver first appeared in
 161 .Fx 2.2 .
 162 .Sh AUTHORS
 163 .An -nosplit
 164 The
 165 .Nm
 166 device driver was written by
 167 .An Paul Richards .
 168 Support for the AMD PCHome phone-line based network added by
 169 .An Robert Watson .
 170 This manual page was written by
 171 .An David E. O'Brien .
 172 .Sh BUGS
 173 This driver has the potential of being the most verbose of any of the
 174 Ethernet device drivers.