share/man/man4/sc.4

   1 .\"     $NetBSD: sc.4,v 1.6 2003/02/14 15:20:19 grant Exp $
   2 .\"
   3 .\" written from a reading of config files and driver source code
   4 .\" Erik E. Fair <fair@NetBSD.org>
   5 .\" Matt Fredette <fredette@NetBSD.org>
   6 .Dd June 28, 2001
   7 .Dt SC 4
   8 .Os
   9 .Sh NAME
  10 .Nm sc
  11 .Nd Sun Sun-2 SCSI bus host adaptor driver
  12 .Sh SYNOPSIS
  13 .Ss sun2
  14 .Cd "sc0 at mbmem0 addr 0x80000 ipl 2"
  15 .Cd "sc1 at mbmem0 addr 0x84000 ipl 2"
  16 .Ss sun2 and sun4
  17 .Cd "sc0 at vme0 addr 0x200000 irq 2 vec 0x40"
  18 .Sh DESCRIPTION
  19 The
  20 .Nm
  21 driver provides support for the
  22 Sun Microsystems
  23 .Qq Sun-2
  24 .Tn SCSI
  25 Bus Controller chipset found on various
  26 VME boards
  27 .Pq Sun part #s 501-1045, 501-1138, 501-1149, and 501-1167
  28 and on the
  29 .Qq Sun-2 SCSI/Serial
  30 .Pq Sun part # 501-1006
  31 Multibus board.
  32 .Pp
  33 All
  34 versions of this driver can be configured with a
  35 .Em flags
  36 directive in the
  37 .Xr config 1
  38 file.
  39 The values are bits in a bitfield, and are interpreted as follows:
  40 .Pp
  41 .Bl -tag -offset indent -compact -width 0x000ff
  42 .It 0x0ff
  43 Set bit (1\*[Lt]\*[Lt]target) to disable
  44 .Tn SCSI
  45 parity checking
  46 .It 0x100
  47 Set this bit to disable
  48 .Tn DMA
  49 interrupts (poll)
  50 .It 0x200
  51 Set this bit to disable
  52 .Tn DMA
  53 entirely (use PIO)
  54 .El
  55 .Pp
  56 For example:
  57 .Qq flags 0x1ff
  58 would disable
  59 .Tn DMA
  60 interrupts, and disable parity checking for targets 0-7.
  61 The
  62 .Qq target
  63 is the
  64 .Tn SCSI
  65 ID number of a particular device on a particular
  66 .Tn SCSI
  67 bus.
  68 .Sh SEE ALSO
  69 .Xr cd 4 ,
  70 .Xr ch 4 ,
  71 .Xr intro 4 ,
  72 .Xr scsi 4 ,
  73 .Xr sd 4 ,
  74 .Xr st 4
  75 .Sh AUTHORS
  76 .An Matt Fredette
  77 .Aq fredette@NetBSD.org ,
  78 .An David Jones,
  79 .An Gordon Ross
  80 .Aq gwr@NetBSD.org ,
  81 .An Adam Glass
  82 .Aq glass@NetBSD.org ,
  83 .An Jason R. Thorpe
  84 .Aq thorpej@NetBSD.org .
  85 .Sh BUGS
  86 This
  87 .Tn SCSI
  88 chipset is rumored to have bugs in its handling of
  89 .Tn SCSI
  90 parity, therefore it is recommended that you disable parity
  91 on all
  92 .Tn SCSI
  93 devices connected to this controller, and configure it with
  94 a
  95 0x0ff
  96 value for its
  97 .Em flags
  98 directive in the
  99 .Xr config 1
 100 file.
 101 .Pp
 102 This
 103 chipset has no support for raising the
 104 .Tn ATN
 105 signal, so there is no way to ever schedule a
 106 .Tn MSG_OUT
 107 phase on the bus.  Currently, the driver will ultimately
 108 reset the bus if this phase is ever requested by the upper
 109 layer
 110 .Tn SCSI
 111 driver.
 112 .Pp
 113 This chipset has no support for
 114 .Tn SCSI
 115 disconnect/reselect.  This means that slow devices,
 116 such as tape drives, can hog, or
 117 .Qq lock up
 118 the SCSI bus.
 119 .Pp
 120 This driver has not been tested in combination with
 121 non-SCSI devices behind
 122 .Tn Emulex
 123 or
 124 .Tn Adaptec
 125 bridges, which are common in
 126 .Tn Sun
 127 2s and in
 128 .Tn Sun
 129 Shoebox-type configurations.
 130 These devices pre-date the
 131 .Tn SCSI-I
 132 spec, and might not behave the way the chipset code currently expects.