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 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.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 6422 99.It 100HP Smart Array V100 101.It 102HP Modular Smart Array 20 (MSA20) 103.It 104HP Modular Smart Array 500 (MSA500) 105.El 106.Sh SEE ALSO 107.Xr cam 4 , 108.Xr pass 4 , 109.Xr xpt 4 , 110.Xr loader.conf 5 , 111.Xr camcontrol 8 112.Rs 113.%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1" 114.%D 2000/11/27 115.%Q "Compaq Computer Corporation" 116.Re 117.Sh AUTHORS 118.An -nosplit 119The 120.Nm 121driver was written by 122.An Mike Smith Aq msmith@FreeBSD.org . 123.Pp 124This manual page is based on his comments and was written by 125.An Tom Rhodes Aq trhodes@FreeBSD.org . 126