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