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