2002-12-30 22:54:29 +00:00
|
|
|
.\" $FreeBSD$
|
|
|
|
.\" Written by Tom Rhodes
|
|
|
|
.\" This file is in the public domain.
|
|
|
|
.\"
|
|
|
|
.Dd December 29, 2002
|
|
|
|
.Dt CISS 4
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm ciss
|
2003-02-24 22:53:26 +00:00
|
|
|
.Nd Common Interface for SCSI-3 Support driver
|
2002-12-30 22:54:29 +00:00
|
|
|
.Sh SYNOPSIS
|
2003-02-24 22:53:26 +00:00
|
|
|
.Cd "device scbus"
|
|
|
|
.Cd "device ciss"
|
2002-12-30 22:54:29 +00:00
|
|
|
.Sh DESCRIPTION
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
driver claims to provide a common interface between generic SCSI
|
|
|
|
transports and intelligent host adapters.
|
|
|
|
.Pp
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
driver supports
|
|
|
|
.Em CISS
|
|
|
|
as defined in the document entitled
|
2003-02-24 22:53:26 +00:00
|
|
|
.%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1" ,
|
|
|
|
dated 2000/11/27, produced by Compaq Computer Corporation.
|
2002-12-30 22:54:29 +00:00
|
|
|
.Pp
|
|
|
|
We provide a shim layer between the
|
|
|
|
.Nm
|
2003-02-24 22:53:26 +00:00
|
|
|
interface and
|
|
|
|
.Xr CAM 4 ,
|
2002-12-30 22:54:29 +00:00
|
|
|
offloading most of the queueing and being-a-disk chores onto CAM.
|
|
|
|
Entry to the driver is via the PCI bus attachment
|
2003-02-24 22:53:26 +00:00
|
|
|
.Fn ciss_probe ,
|
|
|
|
.Fn ciss_attach ,
|
|
|
|
etc. and via the CAM interface
|
|
|
|
.Fn ciss_cam_action ,
|
2002-12-30 22:54:29 +00:00
|
|
|
and
|
2003-02-24 22:53:26 +00:00
|
|
|
.Fn ciss_cam_poll .
|
2002-12-30 22:54:29 +00:00
|
|
|
The Compaq
|
|
|
|
.Nm
|
|
|
|
adapters require faked responses to get reasonable
|
|
|
|
behavior out of them.
|
|
|
|
In addition, the
|
|
|
|
.Nm
|
2003-02-24 22:53:26 +00:00
|
|
|
command set is by no means adequate to support the functionality
|
|
|
|
of a RAID controller,
|
2002-12-30 22:54:29 +00:00
|
|
|
and thus the supported Compaq adapters utilize portions of the
|
|
|
|
control protocol from earlier Compaq adapter families.
|
|
|
|
.Pp
|
|
|
|
Currently
|
|
|
|
.Nm
|
|
|
|
only supports the
|
|
|
|
.Dq simple
|
|
|
|
transport layer over PCI.
|
|
|
|
This interface (ab)uses the I2O register set (specifically the post
|
|
|
|
queues) to exchange commands with the adapter.
|
2002-12-31 17:53:04 +00:00
|
|
|
Other interfaces are available, but we are not supposed to know about them,
|
2002-12-30 22:54:29 +00:00
|
|
|
and it is dubious whether they would provide major performance improvements
|
|
|
|
except under extreme load.
|
2003-02-24 22:53:26 +00:00
|
|
|
.Pp
|
|
|
|
Non-disk devices (such as internal DATs and devices
|
2002-12-31 20:09:31 +00:00
|
|
|
attached to the external SCSI bus) are not yet supported.
|
2002-12-30 22:54:29 +00:00
|
|
|
.Pp
|
2002-12-31 20:09:31 +00:00
|
|
|
Supported controllers include:
|
2002-12-30 22:54:29 +00:00
|
|
|
.Pp
|
2003-02-24 22:53:26 +00:00
|
|
|
.Bl -item -compact
|
|
|
|
.It
|
|
|
|
Compaq Smart Array 5300
|
|
|
|
.It
|
|
|
|
Compaq Smart Array 532
|
|
|
|
.It
|
|
|
|
Compaq Smart Array 5i
|
2002-12-30 22:54:29 +00:00
|
|
|
.El
|
|
|
|
.Sh SEE ALSO
|
|
|
|
.Xr cam 4 ,
|
|
|
|
.Xr pass 4 ,
|
|
|
|
.Xr xpt 4 ,
|
2003-02-24 22:53:26 +00:00
|
|
|
.Xr camcontrol 8
|
|
|
|
.Rs
|
|
|
|
.%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1"
|
|
|
|
.%D 2000/11/27
|
|
|
|
.%Q "Compaq Computer Corporation"
|
|
|
|
.Re
|
2002-12-30 22:54:29 +00:00
|
|
|
.Sh AUTHORS
|
2003-02-24 22:53:26 +00:00
|
|
|
.An -nosplit
|
2002-12-30 22:54:29 +00:00
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
driver was written by
|
|
|
|
.An Mike Smith Aq msmith@FreeBSD.org .
|
2003-02-24 22:53:26 +00:00
|
|
|
.Pp
|
2002-12-31 17:53:04 +00:00
|
|
|
This manual page is based on his comments and was written by
|
|
|
|
.An Tom Rhodes Aq trhodes@FreeBSD.org .
|