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