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. Masked devices can be exposed by setting the 66.Va hw.ciss.expose_hidden_physical 67tunable to non-zero at boot time. Direct Access devices (such as disk 68drives) are only exposed as 69.Xr pass 4 70devices. Hot-insertion and removal of devices is supported but a bus 71rescan might be necessary. 72.Pp 73Supported controllers include: 74.Pp 75.Bl -item -compact 76.It 77Compaq Smart Array 5300 78.It 79Compaq Smart Array 532 80.It 81Compaq Smart Array 5i 82.It 83HP Smart Array 5312 84.It 85HP Smart Array 6i 86.It 87HP Smart Array 641 88.It 89HP Smart Array 642 90.It 91HP Smart Array 6400 92.It 93HP Smart Array 6400 EM 94.It 95HP Smart Array 6422 96.It 97HP Smart Array V100 98.It 99HP Modular Smart Array 20 (MSA20) 100.It 101HP Modular Smart Array 500 (MSA500) 102.El 103.Sh SEE ALSO 104.Xr cam 4 , 105.Xr pass 4 , 106.Xr xpt 4 , 107.Xr loader.conf 5 , 108.Xr camcontrol 8 109.Rs 110.%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1" 111.%D 2000/11/27 112.%Q "Compaq Computer Corporation" 113.Re 114.Sh AUTHORS 115.An -nosplit 116The 117.Nm 118driver was written by 119.An Mike Smith Aq msmith@FreeBSD.org . 120.Pp 121This manual page is based on his comments and was written by 122.An Tom Rhodes Aq trhodes@FreeBSD.org . 123