share/man/man4/dpt.4

   1 .\"     $NetBSD: dpt.4,v 1.23 2006/11/13 16:33:57 ad Exp $
   2 .\"
   3 .\" Copyright (c) 1999, 2000, 2002 Andrew Doran <ad@NetBSD.org>
   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. The name of the author may not be used to endorse or promote products
  12 .\"    derived from this software without specific prior written permission
  13 .\"
  14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  15 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  16 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  17 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  18 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  19 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  20 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  21 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  22 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  23 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  24 .\"
  25 .Dd December 7, 2002
  26 .Dt DPT 4
  27 .Os
  28 .Sh NAME
  29 .Nm dpt
  30 .Nd
  31 DPT EATA
  32 .Tn SCSI
  33 adapter driver
  34 .Sh SYNOPSIS
  35 .Cd "dpt* at isa? port ? irq ? dma ?"
  36 .Cd "dpt* at eisa? slot ?"
  37 .Cd "dpt* at pci? dev ? function ?"
  38 .Cd "scsibus* at dpt?"
  39 .Sh DESCRIPTION
  40 The
  41 .Nm
  42 driver provides support for third and fourth generation DPT
  43 .Tn SCSI
  44 controllers.  All communication with the controllers is conducted via the
  45 EATA (Enhanced AT Bus Attachment) protocol.
  46 .Pp
  47 DPT adapters examine and interpret all
  48 .Tn SCSI
  49 commands received before passing them to any underlying physical device(s).
  50 In this way, caching, RAID and other transformations are achieved while
  51 remaining transparent to the host operating system.
  52 .Sh HARDWARE
  53 The
  54 .Nm
  55 driver provides support for the adapters listed below.  Later models are
  56 supported by the
  57 .Nm iop
  58 driver.
  59 .Pp
  60 .Bl -tag -width Dv -offset indent -compact
  61 .It Tn DPT SmartCache III
  62 .It Tn DPT SmartCache IV
  63 .It Tn DPT SmartRAID III
  64 .It Tn DPT SmartRAID IV
  65 .El
  66 .Sh FILES
  67 .Bl -tag -width /dev/dptn -compact
  68 .It Pa /dev/dpt Ns Ar u
  69 control device for unit
  70 .Ar u
  71 .El
  72 .Sh DIAGNOSTICS
  73 None of these messages should be encountered under normal circumstances.  It
  74 should be noted that the list below is not complete.
  75 .Pp
  76 .Bl -tag -width indent
  77 .It dpt%d: readcfg failed - see dpt(4)
  78 The EATA configuration data did not appear upon request.  This may be caused
  79 by older firmware.  Generally the solution is to power-cycle the affected
  80 machine.
  81 .It dpt%d: spurious intr
  82 A spurious interrupt was received from the HBA.
  83 .It dpt%d: bogus status (returned CCB id NNNN)
  84 A corrupt or incomplete status packet was received from the HBA.
  85 .El
  86 .Sh SEE ALSO
  87 .Xr cd 4 ,
  88 .Xr ch 4 ,
  89 .Xr dpti 4 ,
  90 .Xr intro 4 ,
  91 .Xr iop 4 ,
  92 .Xr scsi 4 ,
  93 .Xr sd 4 ,
  94 .Xr st 4
  95 .Pp
  96 The
  97 .Pa sysutils/dptutil
  98 package.
  99 .Pp
 100 CAM committee standard CAM/89-004 - the EATA (Enhanced AT Bus Attachment)
 101 protocol.
 102 .Sh HISTORY
 103 The
 104 .Nm dpt
 105 driver first appeared in
 106 .Nx 1.4.2 .
 107 .Sh BUGS
 108 EATA adapters other than listed may function correctly with the
 109 .Nm
 110 driver, however a definitive list is not available.
 111 .Pp
 112 Older boards that do not support scatter-gather I/O or DMA are not supported.
 113 .Pp
 114 ECC formatted disk and arrays (i.e. with a sector size of 528 bytes) do not
 115 work correctly with the PM2041 and certain firmware revisions of the PM3334.