share/man/man4/ciss.4

   1 .\" Written by Tom Rhodes
   2 .\" This file is in the public domain.
   3 .\"
   4 .Dd January 26, 2012
   5 .Dt CISS 4
   6 .Os
   7 .Sh NAME
   8 .Nm ciss
   9 .Nd Common Interface for SCSI-3 Support driver
  10 .Sh SYNOPSIS
  11 To compile this driver into the kernel,
  12 place the following lines in your
  13 kernel configuration file:
  14 .Bd -ragged -offset indent
  15 .Cd "device scbus"
  16 .Cd "device ciss"
  17 .Ed
  18 .Pp
  19 Alternatively, to load the driver as a
  20 module at boot time, place the following line in
  21 .Xr loader.conf 5 :
  22 .Bd -literal -offset indent
  23 ciss_load="YES"
  24 .Ed
  25 .Sh DESCRIPTION
  26 The
  27 .Nm
  28 driver claims to provide a common interface between generic SCSI
  29 transports and intelligent host adapters.
  30 .Pp
  31 The
  32 .Nm
  33 driver supports
  34 .Em CISS
  35 as defined in the document entitled
  36 .%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1" ,
  37 dated 2000/11/27, produced by Compaq Computer Corporation.
  38 .Pp
  39 We provide a shim layer between the
  40 .Nm
  41 interface and
  42 .Xr CAM 4 ,
  43 offloading most of the queueing and being-a-disk chores onto CAM.
  44 Entry to the driver is via the PCI bus attachment
  45 .Fn ciss_probe ,
  46 .Fn ciss_attach ,
  47 etc.\& and via the CAM interface
  48 .Fn ciss_cam_action ,
  49 and
  50 .Fn ciss_cam_poll .
  51 The Compaq
  52 .Nm
  53 adapters require faked responses to get reasonable
  54 behavior out of them.
  55 In addition, the
  56 .Nm
  57 command set is by no means adequate to support the functionality
  58 of a RAID controller,
  59 and thus the supported Compaq adapters utilize portions of the
  60 control protocol from earlier Compaq adapter families.
  61 .Pp
  62 Currently
  63 .Nm
  64 supports the
  65 .Dq simple
  66 and
  67 .Dq performant
  68 transport layer.
  69 .Pp
  70 Non-disk devices (such as internal DATs and devices
  71 attached to the external SCSI bus) are supported as normal CAM devices
  72 provided that they are exported by the controller firmware and are not
  73 marked as being masked.
  74 Masked devices can be exposed by setting the
  75 .Va hw.ciss.expose_hidden_physical
  76 tunable to non-zero at boot time.
  77 Direct Access devices (such as disk
  78 drives) are only exposed as
  79 .Xr pass 4
  80 devices.
  81 Hot-insertion and removal of devices is supported and notification messages
  82 will be reported to the console and logs.
  83 .Pp
  84 The problem which adapter freezes with the message
  85 .Dq ADAPTER HEARTBEAT FAILED
  86 might be solved by updating the firmware and/or setting the
  87 .Va hw.ciss.nop_message_heartbeat
  88 tunable to non-zero at boot time.
  89 .Sh HARDWARE
  90 Controllers supported by the
  91 .Nm
  92 driver include:
  93 .Pp
  94 .Bl -bullet -compact
  95 .It
  96 Compaq Smart Array 5300 (simple mode only)
  97 .It
  98 Compaq Smart Array 532
  99 .It
 100 Compaq Smart Array 5i
 101 .It
 102 HP Smart Array 5312
 103 .It
 104 HP Smart Array 6i
 105 .It
 106 HP Smart Array 641
 107 .It
 108 HP Smart Array 642
 109 .It
 110 HP Smart Array 6400
 111 .It
 112 HP Smart Array 6400 EM
 113 .It
 114 HP Smart Array E200
 115 .It
 116 HP Smart Array E200i
 117 .It
 118 HP Smart Array P212
 119 .It
 120 HP Smart Array P220i
 121 .It
 122 HP Smart Array P222
 123 .It
 124 HP Smart Array P230i
 125 .It
 126 HP Smart Array P400
 127 .It
 128 HP Smart Array P400i
 129 .It
 130 HP Smart Array P410
 131 .It
 132 HP Smart Array P410i
 133 .It
 134 HP Smart Array P411
 135 .It
 136 HP Smart Array P420
 137 .It
 138 HP Smart Array P420i
 139 .It
 140 HP Smart Array P421
 141 .It
 142 HP Smart Array P430
 143 .It
 144 HP Smart Array P430i
 145 .It
 146 HP Smart Array P431
 147 .It
 148 HP Smart Array P530
 149 .It
 150 HP Smart Array P531
 151 .It
 152 HP Smart Array P600
 153 .It
 154 HP Smart Array P721m
 155 .It
 156 HP Smart Array P731m
 157 .It
 158 HP Smart Array P800
 159 .It
 160 HP Smart Array P812
 161 .It
 162 HP Smart Array P830
 163 .It
 164 HP Smart Array P830i
 165 .It
 166 HP Modular Smart Array 20 (MSA20)
 167 .It
 168 HP Modular Smart Array 500 (MSA500)
 169 .El
 170 .Sh SEE ALSO
 171 .Xr cam 4 ,
 172 .Xr pass 4 ,
 173 .Xr xpt 4 ,
 174 .Xr loader.conf 5 ,
 175 .Xr camcontrol 8
 176 .Rs
 177 .%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1"
 178 .%D 2000/11/27
 179 .%Q "Compaq Computer Corporation"
 180 .Re
 181 .Sh AUTHORS
 182 .An -nosplit
 183 The
 184 .Nm
 185 driver was written by
 186 .An Mike Smith Aq Mt msmith@FreeBSD.org .
 187 .Pp
 188 This manual page is based on his comments and was written by
 189 .An Tom Rhodes Aq Mt trhodes@FreeBSD.org .