1.\" $NetBSD: iee.4,v 1.2 2004/03/13 20:37:18 wiz Exp $ 2.\" Copyright (c) 2002 Jochen Kunz. 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.\" 3. The name of Jochen Kunz may not be used to endorse or promote 14.\" products derived from this software without specific prior 15.\" written permission. 16.\" 17.\" THIS SOFTWARE IS PROVIDED BY JOCHEN KUNZ 18.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 19.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 20.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JOCHEN KUNZ 21.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27.\" POSSIBILITY OF SUCH DAMAGE. 28.Dd February 20, 2004 29.Dt IEE 4 30.Os 31.Sh NAME 32.Nm iee 33.Nd 34.Tn Intel 35.Tn i82596 3610MBit/s 37.Tn Ethernet 38interface 39.Sh SYNOPSIS 40.Ss hp700 41.Cd iee* at gsc? 42.Sh DESCRIPTION 43The 44.Nm 45device provides access to the 46.Tn Intel 47.Tn i82596 4810MBit/s 49.Tn Ethernet 50interface. 51.Nm 52supports IEEE 802.1Q Virtual LANs. 53.Nm 54operates the 55.Tn i82596 56in 32-Bit Linear Mode, opposed to 57.Xr ie 4 58that drives the 59.Tn i82596 60only in 61.Tn i82586 62compatibility mode. 63.Sh HARDWARE 64There is currently only an MD frontend for the hp700 GSC bus. 65.Ss hp700 66The 67.Nm 68interface suports 69.Tn Intel 70.Tn i82596DX 71on ASP/ASP2 based machines and the 72.Tn i82596CA 73macrocell in LASI based machines. 74GSC expansion cards may work, but are not tested. 75Media selection on hp700 is done either manually via hardware 76jumper or automatically depending on machine model. 77.Sh DIAGNOSTICS 78.Bl -diag 79.It "iee%d: iee_intr: receive error %d, rfd_status=0x%.4x, rfd_count=0x%.4x." 80An error during frame reception occured. 81The frame was dropped. 82.It "iee%d: iee_intr: can't allocate mbuf." 83.It "iee%d: iee_intr: can't alloc mbuf cluster." 84A frame was received, but dropped due to lack of memory. 85.It "iee%d: iee_intr: receive ring buffer overrun" 86Many frames where received under high load and the receive ring buffer 87was to small to store them all. 88Frame reception was restarted from scratch. 89Most likely there where frames lost. 90.It "iee%d: iee_intr: scb_status=0x%x scb_cmd=0x%x faild command %d: cb_status[%d]=0x%.4x cb_cmd[%d]=0x%.4x" 91A transmit or setup command was not executed successfully. 92.It "iee%d: iee_intr: crc_err=%d" 93Number of frames with a CRC error received. 94.It "iee%d: iee_intr: align_err=%d" 95Number of unaligned frames received. 96.It "iee%d: iee_intr: resource_err=%d" 97Number of good frames dropped because the receive ring buffer was full. 98.It "iee%d: iee_intr: overrun_err=%d" 99Number of frames lost because the system bus was not available for DMA. 100.It "iee%d: iee_intr: rcvcdt_err=%d" 101Number of collisions detected during frame reception. 102.It "iee%d: iee_intr: short_fr_err=%d" 103Number of frames received that where shorter then the minimum frame length. 104.It "iee%d: iee_start: failed to load DMA map" 105A 106.Xr mbuf 9 107chain with too many elements could not be setup for transmission. 108The 109.Xr mbuf 9 110chain will be merged into a single 111.Xr mbuf 9 112cluster and retransmitted. 113.It "iee%d: iee_start: can't allocate mbuf." 114.It "iee%d: iee_start: can't load TX DMA map. 115Said error occurred during merging the 116.Xr mbuf 9 117chain into a 118.Xr mbuf 9 119cluster. 120The frame was dropped. 121.It "iee%d: iee_init: can't create TX DMA map" 122.It "iee%d: iee_init: can't allocate mbuf" 123.It "iee%d: iee_init: can't allocate mbuf cluster" 124.It "iee%d: iee_init: can't create RX DMA map" 125.It "iee%d: iee_init: can't load RX DMA map" 126There was no memory free to allocate resources when the operator 127tried to bring the interface up. 128The interface will not come up. 129Try again later. 130.It "iee%d: iee_watchdog: transmit timeout %d" 131.It "iee%d: iee_watchdog: setup timeout %d" 132The hardware didn't respond to a transmit or setup command within five seconds. 133The interface will be reset and restarted. 134.It "iee%d: iee_gsc_cmd: timeout n=%d" 135Timeout at sending a channel attention command to the chip. 136.It "iee%d: iee_gsc_reset timeout bussy=0x%x" 137Timeout at resetting the chip. 138Possible errors during 139.Xr autoconf 4 . 140.It "iee%d: iee_gsc_attach: can't map I/O space" 141The driver failed to map the I/O ports of the chip. 142The device will not be attached. 143.It "iee%d: iee_gsc_attach: can't allocate %d bytes of DMA memory" 144.It "iee%d: iee_gsc_attach: can't map DMA memory" 145.It "iee%d: iee_gsc_attach: can't create DMA map" 146.It "iee%d: iee_gsc_attach: can't load DMA map" 147The driver failed to get the shared DMA memory for the chip. 148The device will not be attached. 149.El 150.Sh SEE ALSO 151.Xr arp 4 , 152.Xr ifmedia 4 , 153.Xr inet 4 , 154.Xr intro 4 , 155.Xr vlan 4 , 156.Xr ifconfig 8 157.Sh HISTORY 158The 159.Nm 160driver appeared in 161.Nx 2.0 . 162.Sh AUTHORS 163.An Jochen Kunz 164.Sh BUGS 165None. ;-) 166