xref: /freebsd/share/man/man4/ciss.4 (revision 2357939bc239bd5334a169b62313806178dd8f30)
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
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.It
75HP Smart Array 5312
76.It
77HP Smart Array 6i
78.It
79HP Smart Array 641
80.It
81HP Smart Array 642
82.It
83HP Smart Array 6400
84.It
85HP Smart Array 6400 EM
86.It
87HP Modular Smart Array 20 (MSA20)
88.It
89HP Modular Smart Array 500 (MSA500)
90.El
91.Sh SEE ALSO
92.Xr cam 4 ,
93.Xr pass 4 ,
94.Xr xpt 4 ,
95.Xr camcontrol 8
96.Rs
97.%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1"
98.%D 2000/11/27
99.%Q "Compaq Computer Corporation"
100.Re
101.Sh AUTHORS
102.An -nosplit
103The
104.Nm
105driver was written by
106.An Mike Smith Aq msmith@FreeBSD.org .
107.Pp
108This manual page is based on his comments and was written by
109.An Tom Rhodes Aq trhodes@FreeBSD.org .
110