share/man/man4/man4.i386/snc.4

   1 .\"
   2 .\" Copyright (c) 2004 Tom Rhodes
   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 .\"
  14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24 .\" SUCH DAMAGE.
  25 .\"
  26 .\" $FreeBSD$
  27 .\"
  28 .Dd September 4, 2004
  29 .Dt SNC 4 i386
  30 .Os
  31 .Sh NAME
  32 .Nm snc
  33 .Nd National Semiconductor DP8393X SONIC Ethernet adapter driver
  34 .Sh SYNOPSIS
  35 .Cd device isa
  36 .Cd device snc
  37 .Sh DESCRIPTION
  38 The
  39 .Nm
  40 driver provides support for the
  41 .Tn National
  42 .Tn Semiconductor
  43 .Tn SONIC
  44 Ethernet adapters.
  45 .Sh HARDWARE
  46 The
  47 .Nm
  48 driver supports the following cards:
  49 .Pp
  50 .Bl -bullet -compact
  51 .It
  52 National Semiconductor DP83934AVQB
  53 .It
  54 NEC PC-9801-83
  55 .It
  56 NEC PC-9801-84
  57 .It
  58 NEC PC-9801-103
  59 .It
  60 NEC PC-9801-104
  61 .It
  62 NEC PC-9801N-15
  63 .It
  64 NEC PC-9801N-25
  65 .It
  66 NEC PC-9801N-J02 PCMCIA
  67 .It
  68 NEC PC-9801N-J02R PCMCIA
  69 .El
  70 .Pp
  71 The
  72 .Nm
  73 driver also includes support for the
  74 .Tn National
  75 .Tn Semiconductor
  76 .Tn NS46C46
  77 as
  78 64 * 16 bits Microwave Serial
  79 .Tn EEPROM .
  80 .Sh IMPLEMENTATION NOTES
  81 Accessing
  82 .Tn SONIC
  83 card data structures and registers as 32 bit values
  84 makes code endianness independent.
  85 The
  86 .Tn SONIC
  87 is however always in big-endian mode so it is necessary to
  88 ensure that data structures shared
  89 between the
  90 .Tn CPU
  91 and the
  92 .Tn SONIC
  93 card are always in big-endian order.
  94 The
  95 .Nm
  96 driver supports the
  97 .Tn PC-98
  98 C-Bus,
  99 and
 100 .Tn PnP
 101 buses.
 102 Support is also provided for the legacy C-Bus.
 103 .Sh DIAGNOSTICS
 104 The following driver specific error messages
 105 may be reported:
 106 .Bl -diag
 107 .It "snc%d: snc_nec16_register_irq: unsupported irq (%d)"
 108 The card returned an
 109 .Tn IRQ
 110 which is not supported by the driver.
 111 .It "snc%d: invalid packet length %d bytes"
 112 An attempt to transfer a data packet failed due to an
 113 invalid packet length.
 114 .El
 115 .Sh SEE ALSO
 116 .Xr netintro 4 ,
 117 .Xr bus_alloc_resource_any 9
 118 .Sh HISTORY
 119 The
 120 .Nm
 121 driver was ported from
 122 .Nx
 123 by
 124 .An -nosplit
 125 .An Motomichi Matsuzaki Aq mzaki@e-mail.ne.jp
 126 and
 127 .An Hiroshi Yamashita Aq bluemoon@msj.biglobe.ne.jp .
 128 It first appeared in
 129 .Fx 4.2 .
 130 This manual page first appeared in
 131 .Fx 5.3 .
 132 .Sh AUTHORS
 133 This manual page was written by
 134 .An Tom Rhodes Aq trhodes@FreeBSD.org .
 135 .Sh BUGS
 136 Currently the
 137 .Nm
 138 driver only works on the
 139 .Tn PC-98
 140 architecture.
 141 It should probably work on the i386 architecture
 142 as well.