share/man/man4/ciss.4

   1 .\" $FreeBSD: src/share/man/man4/ciss.4,v 1.2.2.3 2003/03/03 18:51:16 trhodes Exp $
   2 .\" Written by Tom Rhodes
   3 .\" This file is in the public domain.
   4 .\"
   5 .Dd December 29, 2002
   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 not yet supported.
  64 .Pp
  65 Supported controllers include:
  66 .Pp
  67 .Bl -item -compact
  68 .It
  69 Compaq Smart Array 5300
  70 .It
  71 Compaq Smart Array 532
  72 .It
  73 Compaq Smart Array 5i
  74 .El
  75 .Sh SEE ALSO
  76 .Xr cam 4 ,
  77 .Xr pass 4 ,
  78 .Xr xpt 4 ,
  79 .Xr camcontrol 8
  80 .Rs
  81 .%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1"
  82 .%D 2000/11/27
  83 .%Q "Compaq Computer Corporation"
  84 .Re
  85 .Sh AUTHORS
  86 .An -nosplit
  87 The
  88 .Nm
  89 driver was written by
  90 .An Mike Smith Aq msmith@FreeBSD.org .
  91 .Pp
  92 This manual page is based on his comments and was written by
  93 .An Tom Rhodes Aq trhodes@FreeBSD.org .