1.\" $FreeBSD$ 2.\" Written by Tom Rhodes 3.\" This file is in the public domain. 4.\" 5.Dd December 29, 2002 6.Dd August 3, 2004 7.Dt CISS 4 8.Os 9.Sh NAME 10.Nm ciss 11.Nd Common Interface for SCSI-3 Support driver 12.Sh SYNOPSIS 13.Cd "device scbus" 14.Cd "device ciss" 15.Sh DESCRIPTION 16The 17.Nm 18driver claims to provide a common interface between generic SCSI 19transports and intelligent host adapters. 20.Pp 21The 22.Nm 23driver supports 24.Em CISS 25as defined in the document entitled 26.%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1" , 27dated 2000/11/27, produced by Compaq Computer Corporation. 28.Pp 29We provide a shim layer between the 30.Nm 31interface and 32.Xr CAM 4 , 33offloading most of the queueing and being-a-disk chores onto CAM. 34Entry to the driver is via the PCI bus attachment 35.Fn ciss_probe , 36.Fn ciss_attach , 37etc.\& and via the CAM interface 38.Fn ciss_cam_action , 39and 40.Fn ciss_cam_poll . 41The Compaq 42.Nm 43adapters require faked responses to get reasonable 44behavior out of them. 45In addition, the 46.Nm 47command set is by no means adequate to support the functionality 48of a RAID controller, 49and thus the supported Compaq adapters utilize portions of the 50control protocol from earlier Compaq adapter families. 51.Pp 52Currently 53.Nm 54only supports the 55.Dq simple 56transport layer over PCI. 57This interface (ab)uses the I2O register set (specifically the post 58queues) to exchange commands with the adapter. 59Other interfaces are available, but we are not supposed to know about them, 60and it is dubious whether they would provide major performance improvements 61except under extreme load. 62.Pp 63Non-disk devices (such as internal DATs and devices 64attached to the external SCSI bus) are supported as normal CAM devices 65provided that they are exported by the controller firmware and are not 66marked as being masked. 67Masked devices can be exposed by setting the 68.Va hw.ciss.expose_hidden_physical 69tunable to non-zero at boot time. 70Direct Access devices (such as disk 71drives) are only exposed as 72.Xr pass 4 73devices. 74Hot-insertion and removal of devices is supported but a bus 75rescan might be necessary. 76.Sh HARDWARE 77Controllers supported by the 78.Nm 79driver include: 80.Pp 81.Bl -bullet -compact 82.It 83Compaq Smart Array 5300 84.It 85Compaq Smart Array 532 86.It 87Compaq Smart Array 5i 88.It 89HP Smart Array 5312 90.It 91HP Smart Array 6i 92.It 93HP Smart Array 641 94.It 95HP Smart Array 642 96.It 97HP Smart Array 6400 98.It 99HP Smart Array 6400 EM 100.It 101HP Smart Array 6422 102.It 103HP Smart Array V100 104.It 105HP Modular Smart Array 20 (MSA20) 106.It 107HP Modular Smart Array 500 (MSA500) 108.El 109.Sh SEE ALSO 110.Xr cam 4 , 111.Xr pass 4 , 112.Xr xpt 4 , 113.Xr loader.conf 5 , 114.Xr camcontrol 8 115.Rs 116.%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1" 117.%D 2000/11/27 118.%Q "Compaq Computer Corporation" 119.Re 120.Sh AUTHORS 121.An -nosplit 122The 123.Nm 124driver was written by 125.An Mike Smith Aq msmith@FreeBSD.org . 126.Pp 127This manual page is based on his comments and was written by 128.An Tom Rhodes Aq trhodes@FreeBSD.org . 129