share/man/man4/ciss.4

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