share/man/man4/dpt.4

   1 .\"
   2 .\" Copyright (c) 1998 Justin T. Gibbs
   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. The name of the author may not be used to endorse or promote products
  11 .\"    derived from this software without specific prior written permission
  12 .\"
  13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  14 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  15 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  16 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  17 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  18 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  19 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  20 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  21 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  22 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  23 .\"
  24 .\" $FreeBSD$
  25 .\"
  26 .Dd July 4, 2004
  27 .Dt DPT 4
  28 .Os
  29 .Sh NAME
  30 .Nm dpt
  31 .Nd DPT RAID Controller SCSI driver
  32 .Sh SYNOPSIS
  33 To compile this driver into the kernel,
  34 place the following lines in your
  35 kernel configuration file:
  36 .Bd -ragged -offset indent
  37 .Cd "device scbus"
  38 .Cd "device dpt"
  39 .Pp
  40 For one or more EISA cards:
  41 .Cd "device eisa"
  42 .Pp
  43 For one or more ISA cards:
  44 .Cd "device isa"
  45 .Pp
  46 For one or more PCI cards:
  47 .Cd "device pci"
  48 .Pp
  49 To allow PCI adapters to use memory mapped I/O if enabled:
  50 .Cd options DPT_ALLOW_MEMIO
  51 .Ed
  52 .Pp
  53 Alternatively, to load the driver as a
  54 module at boot time, place the following line in
  55 .Xr loader.conf 5 :
  56 .Bd -literal -offset indent
  57 dpt_load="YES"
  58 .Ed
  59 .Sh DESCRIPTION
  60 The
  61 .Nm
  62 driver supports DPT RAID SCSI controllers.
  63 .Pp
  64 SmartRAID (PM3???) are "Enterprise" class cards,
  65 and SmartCache (PM2???) cards are in the "Workstation" class.
  66 The Gen 4 Smart Cache IV products were a re-issue of the Gen 3 utilizing
  67 upgraded (and cheaper to produce) silicon.
  68 The PM3334 (Smart RAID III) was not revamped as there was no upgraded silicon
  69 (68040 processor) and it was using the best DPT made.
  70 Note there has been customer confusion over the faster enterprise class card
  71 supported by this driver being an older generation.
  72 The Gen5 cards are supported by the
  73 .Xr asr 4
  74 driver.
  75 .Sh HARDWARE
  76 The
  77 .Nm
  78 driver provides support for the following RAID adapters:
  79 .Pp
  80 .Bl -bullet -compact
  81 .It
  82 DPT Smart Cache Plus
  83 .It
  84 Smart Cache II (PM2?2?, PM2022 [EISA], PM2024/PM2124 [PCI]) (Gen2)
  85 .It
  86 Smart RAID II (PM3?2?, PM3021, PM3222)
  87 .It
  88 Smart Cache III (PM2?3?)
  89 .It
  90 Smart RAID III (PM3?3?, PM3332 [EISA], PM3334UW [PCI]) (Gen3)
  91 .It
  92 Smart Cache IV (PM2?4?, PM2042 [EISA], PM2044/PM2144 [PCI]) (Gen4)
  93 .It
  94 Smart RAID IV
  95 .El
  96 .Sh FILES
  97 .Bl -tag -width /usr/share/man0/template.doc -compact
  98 .It Pa sys/dev/dpt/dpt_scsi.c
  99 Core Driver Implementation
 100 .It Pa sys/dev/dpt/dpt.h
 101 Register Set and Core Driver Data Structures
 102 .It Pa sys/dev/dpt/dpt_pci.c
 103 PCI Bus Driver Attachment
 104 .It Pa sys/dev/dpt/dpt_eisa.c
 105 EISA Bus Driver Attachment
 106 .El
 107 .Sh SEE ALSO
 108 .Xr cd 4 ,
 109 .Xr ch 4 ,
 110 .Xr da 4 ,
 111 .Xr sa 4 ,
 112 .Xr scsi 4
 113 .Sh HISTORY
 114 The
 115 .Nm
 116 driver first appeared in
 117 .Fx 2.2.6 .
 118 .Sh AUTHORS
 119 .An -nosplit
 120 The
 121 .Nm
 122 driver was written by
 123 .An Simon Shapiro
 124 and ported to the CAM SCSI system by
 125 .An Justin T. Gibbs .