xref: /freebsd/share/man/man4/ciss.4 (revision 4b2eaea43fec8e8792be611dea204071a10b655a)
1.\" $FreeBSD$
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
12For one or more adapters:
13.Cd device scbus
14.Cd device ciss
15.Sh DESCRIPTION
16.Pp
17The
18.Nm
19driver claims to provide a common interface between generic SCSI
20transports and intelligent host adapters.
21.Pp
22The
23.Nm
24driver supports
25.Em CISS
26as defined in the document entitled
27.Dq CISS Command Interface for SCSI-3 Support Open Specification ,
28Version 1.04,
29Valence Number 1, dated 20001127, produced by Compaq Computer
30Corporation.
31.Pp
32We provide a shim layer between the
33.Nm
34interface and CAM,
35offloading most of the queueing and being-a-disk chores onto CAM.
36Entry to the driver is via the PCI bus attachment
37.Fa ciss_probe ,
38.Fa ciss_attach ,
39etc and via the CAM interface
40.Fa ciss_cam_action ,
41and
42.Fa ciss_cam_poll .
43The Compaq
44.Nm
45adapters require faked responses to get reasonable
46behavior out of them.
47In addition, the
48.Nm
49command set is by no means adequate to support the functionality of a RAID controller,
50and thus the supported Compaq adapters utilize portions of the
51control protocol from earlier Compaq adapter families.
52.Pp
53Currently
54.Nm
55only supports the
56.Dq simple
57transport layer over PCI.
58This interface (ab)uses the I2O register set (specifically the post
59queues) to exchange commands with the adapter.
60Other interfaces are available, but we are not supposed to know about them,
61and it is dubious whether they would provide major performance improvements
62except under extreme load.
63.Sh COMPATIBILITY
64Non disk devices (such as internal DATs and devices
65attached to the external SCSI bus) are not yet supported.
66.Pp
67Supported controllers include:
68.Pp
69.Bl -tag -compact -width "Compaq Smart Array 5* series"
70.It Compaq Smart Array 5300
71.It Compaq Smart Array 532
72.It Compaq Smart Array 5i
73.El
74.Sh SEE ALSO
75.Xr cam 4 ,
76.Xr pass 4 ,
77.Xr xpt 4 ,
78.Xr camcontrol 8 ,
79.Pp
80.Dq CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04,
81Valence Number 1, dated 20001127, produced by Compaq Computer Corporation.
82.Sh AUTHORS
83The
84.Nm
85driver was written by
86.An Mike Smith Aq msmith@FreeBSD.org .
87This manual page is based on his comments and was written by
88.An Tom Rhodes Aq trhodes@FreeBSD.org .
89