xref: /freebsd/share/man/man4/ciss.4 (revision cad572c41bb54ba8726dcb46db489e5e21990519)
1.\" $FreeBSD$
2.\" Written by Tom Rhodes
3.\" This file is in the public domain.
4.\"
5.Dd November 3, 2005
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 supported as normal CAM devices
64provided that they are exported by the controller firmware and are not
65marked as being masked.
66Masked devices can be exposed by setting the
67.Va hw.ciss.expose_hidden_physical
68tunable to non-zero at boot time.
69Direct Access devices (such as disk
70drives) 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.Sh HARDWARE
76Controllers supported by the
77.Nm
78driver include:
79.Pp
80.Bl -bullet -compact
81.It
82Compaq Smart Array 5300
83.It
84Compaq Smart Array 532
85.It
86Compaq Smart Array 5i
87.It
88HP Smart Array 5312
89.It
90HP Smart Array 6i
91.It
92HP Smart Array 641
93.It
94HP Smart Array 642
95.It
96HP Smart Array 6400
97.It
98HP Smart Array 6400 EM
99.It
100HP Smart Array E200
101.It
102HP Smart Array E200i
103.It
104HP Smart Array P400
105.It
106HP Smart Array P400i
107.It
108HP Smart Array P600
109.It
110HP Smart Array P800
111.It
112HP Modular Smart Array 20 (MSA20)
113.It
114HP Modular Smart Array 500 (MSA500)
115.El
116.Sh SEE ALSO
117.Xr cam 4 ,
118.Xr pass 4 ,
119.Xr xpt 4 ,
120.Xr loader.conf 5 ,
121.Xr camcontrol 8
122.Rs
123.%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1"
124.%D 2000/11/27
125.%Q "Compaq Computer Corporation"
126.Re
127.Sh AUTHORS
128.An -nosplit
129The
130.Nm
131driver was written by
132.An Mike Smith Aq msmith@FreeBSD.org .
133.Pp
134This manual page is based on his comments and was written by
135.An Tom Rhodes Aq trhodes@FreeBSD.org .
136