1.\" Written by Tom Rhodes 2.\" This file is in the public domain. 3.\" 4.Dd January 26, 2012 5.Dt CISS 4 6.Os 7.Sh NAME 8.Nm ciss 9.Nd Common Interface for SCSI-3 Support driver 10.Sh SYNOPSIS 11To compile this driver into the kernel, 12place the following lines in your 13kernel configuration file: 14.Bd -ragged -offset indent 15.Cd "device scbus" 16.Cd "device ciss" 17.Ed 18.Pp 19Alternatively, to load the driver as a 20module at boot time, place the following line in 21.Xr loader.conf 5 : 22.Bd -literal -offset indent 23ciss_load="YES" 24.Ed 25.Sh DESCRIPTION 26The 27.Nm 28driver claims to provide a common interface between generic SCSI 29transports and intelligent host adapters. 30.Pp 31The 32.Nm 33driver supports 34.Em CISS 35as defined in the document entitled 36.%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1" , 37dated 2000/11/27, produced by Compaq Computer Corporation. 38.Pp 39We provide a shim layer between the 40.Nm 41interface and 42.Xr CAM 4 , 43offloading most of the queueing and being-a-disk chores onto CAM. 44Entry to the driver is via the PCI bus attachment 45.Fn ciss_probe , 46.Fn ciss_attach , 47etc.\& and via the CAM interface 48.Fn ciss_cam_action , 49and 50.Fn ciss_cam_poll . 51The Compaq 52.Nm 53adapters require faked responses to get reasonable 54behavior out of them. 55In addition, the 56.Nm 57command set is by no means adequate to support the functionality 58of a RAID controller, 59and thus the supported Compaq adapters utilize portions of the 60control protocol from earlier Compaq adapter families. 61.Pp 62Currently 63.Nm 64supports the 65.Dq simple 66and 67.Dq performant 68transport layer. 69.Pp 70Non-disk devices (such as internal DATs and devices 71attached to the external SCSI bus) are supported as normal CAM devices 72provided that they are exported by the controller firmware and are not 73marked as being masked. 74Masked devices can be exposed by setting the 75.Va hw.ciss.expose_hidden_physical 76tunable to non-zero at boot time. 77Direct Access devices (such as disk 78drives) are only exposed as 79.Xr pass 4 80devices. 81Hot-insertion and removal of devices is supported and notification messages 82will be reported to the console and logs. 83.Pp 84The problem which adapter freezes with the message 85.Dq ADAPTER HEARTBEAT FAILED 86might be solved by updating the firmware and/or setting the 87.Va hw.ciss.nop_message_heartbeat 88tunable to non-zero at boot time. 89.Sh HARDWARE 90Controllers supported by the 91.Nm 92driver include: 93.Pp 94.Bl -bullet -compact 95.It 96Compaq Smart Array 5300 (simple mode only) 97.It 98Compaq Smart Array 532 99.It 100Compaq Smart Array 5i 101.It 102HP Smart Array 5312 103.It 104HP Smart Array 6i 105.It 106HP Smart Array 641 107.It 108HP Smart Array 642 109.It 110HP Smart Array 6400 111.It 112HP Smart Array 6400 EM 113.It 114HP Smart Array E200 115.It 116HP Smart Array E200i 117.It 118HP Smart Array P212 119.It 120HP Smart Array P220i 121.It 122HP Smart Array P222 123.It 124HP Smart Array P230i 125.It 126HP Smart Array P400 127.It 128HP Smart Array P400i 129.It 130HP Smart Array P410 131.It 132HP Smart Array P410i 133.It 134HP Smart Array P411 135.It 136HP Smart Array P420 137.It 138HP Smart Array P420i 139.It 140HP Smart Array P421 141.It 142HP Smart Array P430 143.It 144HP Smart Array P430i 145.It 146HP Smart Array P431 147.It 148HP Smart Array P530 149.It 150HP Smart Array P531 151.It 152HP Smart Array P600 153.It 154HP Smart Array P721m 155.It 156HP Smart Array P731m 157.It 158HP Smart Array P800 159.It 160HP Smart Array P812 161.It 162HP Smart Array P830 163.It 164HP Smart Array P830i 165.It 166HP Modular Smart Array 20 (MSA20) 167.It 168HP Modular Smart Array 500 (MSA500) 169.El 170.Sh SEE ALSO 171.Xr cam 4 , 172.Xr pass 4 , 173.Xr xpt 4 , 174.Xr loader.conf 5 , 175.Xr camcontrol 8 176.Rs 177.%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1" 178.%D 2000/11/27 179.%Q "Compaq Computer Corporation" 180.Re 181.Sh AUTHORS 182.An -nosplit 183The 184.Nm 185driver was written by 186.An Mike Smith Aq Mt msmith@FreeBSD.org . 187.Pp 188This manual page is based on his comments and was written by 189.An Tom Rhodes Aq Mt trhodes@FreeBSD.org . 190