xref: /dragonfly/share/man/man4/ciss.4 (revision f746689a)
1.\" $FreeBSD: src/share/man/man4/ciss.4,v 1.2.2.6 2008/06/10 18:51:05 ps 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 13, 2008
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 supported as normal CAM devices
65provided that they are exported by the controller firmware and are not
66marked as being masked.
67Masked devices can be exposed by setting the
68.Va hw.ciss.expose_hidden_physical
69tunable to non-zero at boot time.
70Direct Access devices (such as disk drives) are only exposed as
71.Xr pass 4
72devices.
73Hot-insertion and removal of devices is supported but a bus
74rescan might be necessary.
75.Pp
76Supported controllers include:
77.Pp
78.Bl -item -compact
79.It
80Compaq Smart Array 5300
81.It
82Compaq Smart Array 532
83.It
84Compaq Smart Array 5i
85.It
86HP Smart Array 5312
87.It
88HP Smart Array 6i
89.It
90HP Smart Array 641
91.It
92HP Smart Array 642
93.It
94HP Smart Array 6400
95.It
96HP Smart Array 6400 EM
97.It
98HP Smart Array E200
99.It
100HP Smart Array E200i
101.It
102HP Smart Array P212
103.It
104HP Smart Array P400
105.It
106HP Smart Array P400i
107.It
108HP Smart Array P410
109.It
110HP Smart Array P410i
111.It
112HP Smart Array P411
113.It
114HP Smart Array P600
115.It
116HP Smart Array P800
117.It
118HP Smart Array P812
119.It
120HP Modular Smart Array 20 (MSA20)
121.It
122HP Modular Smart Array 500 (MSA500)
123.El
124.Sh SEE ALSO
125.Xr cam 4 ,
126.Xr pass 4 ,
127.Xr xpt 4 ,
128.Xr camcontrol 8
129.Rs
130.%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1"
131.%D 2000/11/27
132.%Q "Compaq Computer Corporation"
133.Re
134.Sh AUTHORS
135.An -nosplit
136The
137.Nm
138driver was written by
139.An Mike Smith Aq msmith@FreeBSD.org .
140.Pp
141This manual page is based on his comments and was written by
142.An Tom Rhodes Aq trhodes@FreeBSD.org .
143