share/man/man4/sn.4

   1 .\"
   2 .\" Copyright (c) 1997 Colin Wood
   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. All advertising materials mentioning features or use of this software
  14 .\"    must display the following acknowledgement:
  15 .\"      This product includes software developed by Colin Wood.
  16 .\" 4. The name of the author may not be used to endorse or promote products
  17 .\"    derived from this software without specific prior written permission
  18 .\"
  19 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  20 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  21 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  22 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  23 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  24 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  25 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  26 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  27 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  28 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .\"     $NetBSD: sn.4,v 1.1 2007/06/20 13:31:55 tsutsui Exp $
  31 .\"
  32 .Dd May 16, 2009
  33 .Dt SN 4
  34 .Os
  35 .Sh NAME
  36 .Nm sn
  37 .Nd National Semiconductor DP83932 (SONIC) based Ethernet device driver
  38 .Sh SYNOPSIS
  39 .Ss arc
  40 .Cd "sn0 at jazzio?"
  41 .Ss mac68k
  42 .Cd "sn* at obio?"
  43 .Cd "sn* at nubus?"
  44 .Sh DESCRIPTION
  45 The
  46 .Nm
  47 interface provides access to a 10 Mb/s Ethernet network via the
  48 National Semiconductor DP83932
  49 .Pq Tn SONIC
  50 Ethernet chip set.
  51 .Pp
  52 Each of the host's network addresses is specified at boot time with an
  53 .Dv SIOCSIFADDR
  54 .Xr ioctl 2 .
  55 The
  56 .Nm
  57 interface employs the address resolution protocol described in
  58 .Xr arp 4
  59 to dynamically map between Internet and Ethernet addresses on the
  60 local network.
  61 .Sh HARDWARE
  62 .Ss arc
  63 The
  64 .Nm
  65 driver supports on-board JAZZ based SONIC interfaces found
  66 on Acer PICA and NEC machines.
  67 .Ss mac68k
  68 The
  69 .Nm
  70 driver is currently known to support the following NuBus cards:
  71 .Bl -bullet -offset indent -compact
  72 .It
  73 Apple LC Twisted-pair (part #820-0532-A) PDS card
  74 .It
  75 Cayman Gatorcard PDS
  76 .It
  77 Dayna DaynaPort/E30
  78 .El
  79 .Pp
  80 In addition, the
  81 .Nm
  82 interface supports the following interfaces:
  83 .Bl -bullet -offset indent -compact
  84 .It
  85 on-board Ethernet for non-AV Quadras
  86 .It
  87 on-board Ethernet for 500-series PowerBooks
  88 .It
  89 Apple CS Ethernet Twisted-pair card for Comm Slot found on
  90 LC575, Quadra 630, LC630, and Performa 580.
  91 .El
  92 .Sh DIAGNOSTICS
  93 .Bl -diag -compact
  94 .It sn%d: transmit FIFO underrun
  95 .It sn%d: receive FIFO overrun
  96 .It sn%d: receive buffer exceeded
  97 .It sn%d: receive buffers exhausted
  98 .It sn%d: receive descriptors exhausted
  99 These messages indicate that the interface gets errors
 100 (due to heavy load etc.) and reinitialized.
 101 .El
 102 .Sh SEE ALSO
 103 .Xr arp 4 ,
 104 .Xr inet 4 ,
 105 .Xr netintro 4 ,
 106 .Xr ifconfig 8
 107 .Sh HISTORY
 108 The
 109 .Nm
 110 interface for mac68k, which was derived from a driver for old
 111 .Nx Ns /pica
 112 port, first appeared in
 113 .Nx 1.3 .
 114 .Pp
 115 Jason Thorpe has rewritten a new machine independent SONIC driver which uses
 116 .Xr bus_dma 9
 117 and
 118 .Xr bus_space 9
 119 APIs after
 120 .Nx 1.5
 121 release, and
 122 .Nx Ns /arc
 123 has been switched to using the machine independent (MI) driver.
 124 .Pp
 125 .Nx Ns /mac68k
 126 has also been switched to using the MI driver after the
 127 .Nx 4.0
 128 release.