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