share/man/man4/ciss.4

   1 .\" $FreeBSD: src/share/man/man4/ciss.4,v 1.2.2.6 2008/06/10 18:51:05 ps Exp $
   2 .\" $DragonFly: src/share/man/man4/ciss.4,v 1.2 2003/06/17 04:36:58 dillon Exp $
   3 .\" Written by Tom Rhodes
   4 .\" This file is in the public domain.
   5 .\"
   6 .Dd December 13, 2008
   7 .Dt CISS 4
   8 .Os
   9 .Sh NAME
  10 .Nm ciss
  11 .Nd Common Interface for SCSI-3 Support driver
  12 .Sh SYNOPSIS
  13 .Cd "device scbus"
  14 .Cd "device ciss"
  15 .Sh DESCRIPTION
  16 The
  17 .Nm
  18 driver claims to provide a common interface between generic SCSI
  19 transports and intelligent host adapters.
  20 .Pp
  21 The
  22 .Nm
  23 driver supports
  24 .Em CISS
  25 as defined in the document entitled
  26 .%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1" ,
  27 dated 2000/11/27, produced by Compaq Computer Corporation.
  28 .Pp
  29 We provide a shim layer between the
  30 .Nm
  31 interface and
  32 .Xr CAM 4 ,
  33 offloading most of the queueing and being-a-disk chores onto CAM.
  34 Entry to the driver is via the PCI bus attachment
  35 .Fn ciss_probe ,
  36 .Fn ciss_attach ,
  37 etc. and via the CAM interface
  38 .Fn ciss_cam_action ,
  39 and
  40 .Fn ciss_cam_poll .
  41 The Compaq
  42 .Nm
  43 adapters require faked responses to get reasonable
  44 behavior out of them.
  45 In addition, the
  46 .Nm
  47 command set is by no means adequate to support the functionality
  48 of a RAID controller,
  49 and thus the supported Compaq adapters utilize portions of the
  50 control protocol from earlier Compaq adapter families.
  51 .Pp
  52 Currently
  53 .Nm
  54 only supports the
  55 .Dq simple
  56 transport layer over PCI.
  57 This interface (ab)uses the I2O register set (specifically the post
  58 queues) to exchange commands with the adapter.
  59 Other interfaces are available, but we are not supposed to know about them,
  60 and it is dubious whether they would provide major performance improvements
  61 except under extreme load.
  62 .Pp
  63 Non-disk devices (such as internal DATs and devices
  64 attached to the external SCSI bus) are supported as normal CAM devices
  65 provided that they are exported by the controller firmware and are not
  66 marked as being masked.
  67 Masked devices can be exposed by setting the
  68 .Va hw.ciss.expose_hidden_physical
  69 tunable to non-zero at boot time.
  70 Direct Access devices (such as disk drives) are only exposed as
  71 .Xr pass 4
  72 devices.
  73 Hot-insertion and removal of devices is supported but a bus
  74 rescan might be necessary.
  75 .Pp
  76 Supported controllers include:
  77 .Pp
  78 .Bl -item -compact
  79 .It
  80 Compaq Smart Array 5300
  81 .It
  82 Compaq Smart Array 532
  83 .It
  84 Compaq Smart Array 5i
  85 .It
  86 HP Smart Array 5312
  87 .It
  88 HP Smart Array 6i
  89 .It
  90 HP Smart Array 641
  91 .It
  92 HP Smart Array 642
  93 .It
  94 HP Smart Array 6400
  95 .It
  96 HP Smart Array 6400 EM
  97 .It
  98 HP Smart Array E200
  99 .It
 100 HP Smart Array E200i
 101 .It
 102 HP Smart Array P212
 103 .It
 104 HP Smart Array P400
 105 .It
 106 HP Smart Array P400i
 107 .It
 108 HP Smart Array P410
 109 .It
 110 HP Smart Array P410i
 111 .It
 112 HP Smart Array P411
 113 .It
 114 HP Smart Array P600
 115 .It
 116 HP Smart Array P800
 117 .It
 118 HP Smart Array P812
 119 .It
 120 HP Modular Smart Array 20 (MSA20)
 121 .It
 122 HP Modular Smart Array 500 (MSA500)
 123 .El
 124 .Sh SEE ALSO
 125 .Xr cam 4 ,
 126 .Xr pass 4 ,
 127 .Xr xpt 4 ,
 128 .Xr camcontrol 8
 129 .Rs
 130 .%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1"
 131 .%D 2000/11/27
 132 .%Q "Compaq Computer Corporation"
 133 .Re
 134 .Sh AUTHORS
 135 .An -nosplit
 136 The
 137 .Nm
 138 driver was written by
 139 .An Mike Smith Aq msmith@FreeBSD.org .
 140 .Pp
 141 This manual page is based on his comments and was written by
 142 .An Tom Rhodes Aq trhodes@FreeBSD.org .