1 .\" $FreeBSD: src/share/man/man4/ciss.4,v 1.19 2012/01/26 17:04:17 sbruno Exp $
2 .\" Written by Tom Rhodes
3 .\" This file is in the public domain.
10 .Nd Common Interface for SCSI-3 Support driver
12 To compile this driver into the kernel,
13 place the following lines in your
14 kernel configuration file:
15 .Bd -ragged -offset indent
20 Alternatively, to load the driver as a
21 module at boot time, place the following line in
23 .Bd -literal -offset indent
29 driver claims to provide a common interface between generic SCSI
30 transports and intelligent host adapters.
36 as defined in the document entitled
37 .%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1" ,
38 dated 2000/11/27, produced by Compaq Computer Corporation.
40 We provide a shim layer between the
44 offloading most of the queueing and being-a-disk chores onto CAM.
45 Entry to the driver is via the PCI bus attachment
48 etc.\& and via the CAM interface
54 adapters require faked responses to get reasonable
58 command set is by no means adequate to support the functionality
60 and thus the supported Compaq adapters utilize portions of the
61 control protocol from earlier Compaq adapter families.
67 transport layer over PCI.
68 This interface (ab)uses the I2O register set (specifically the post
69 queues) to exchange commands with the adapter.
70 Other interfaces are available, but we are not supposed to know about them,
71 and it is dubious whether they would provide major performance improvements
72 except under extreme load.
74 Non-disk devices (such as internal DATs and devices
75 attached to the external SCSI bus) are supported as normal CAM devices
76 provided that they are exported by the controller firmware and are not
77 marked as being masked.
78 Masked devices can be exposed by setting the
79 .Va hw.ciss.expose_hidden_physical
80 tunable to non-zero at boot time.
81 Direct Access devices (such as disk drives) are only exposed as
84 Hot-insertion and removal of devices is supported but a bus
85 rescan might be necessary.
87 The problem which adapter freezes with the message
88 .Dq ADAPTER HEARTBEAT FAILED
89 might be solved by updating the firmware and/or setting the
90 .Va hw.ciss.nop_message_heartbeat
91 tunable to non-zero at boot time.
94 .Va hw.ciss.nop_message_heartbeat ,
97 driver supports a number of loader tunables:
98 .Bl -tag -width indent
99 .It Va hw.ciss.expose_hidden_physical
100 This tunable controls whether physical devices that are marked hidden
101 by the firmware should be exposed anyways.
102 The default is 0 (to not expose hidden physical devices).
103 .It Va hw.ciss.force_transport
104 This tunable forces a particular transport to be used.
105 Values are 0 (use hardware specific default), 1 (forces simple transport)
106 and 2 (forces performant transport).
107 The default is 0 (to let the driver decide based on hardware).
108 .It Va hw.ciss.force_interrupt
109 This tunable forces a particular interrupt delivery method to be used.
110 Values are 0 (use hardware specific default), 1 (forces INTx) and
112 The default is 0 (to let the driver decide based on hardware).
115 Controllers supported by the
121 Compaq Smart Array 5300
123 Compaq Smart Array 532
125 Compaq Smart Array 5i
137 HP Smart Array 6400 EM
173 HP Modular Smart Array 20 (MSA20)
175 HP Modular Smart Array 500 (MSA500)
184 .%T "CISS Command Interface for SCSI-3 Support Open Specification, Version 1.04, Valence Number 1"
186 .%Q "Compaq Computer Corporation"
192 driver was written by
193 .An Mike Smith Aq Mt msmith@FreeBSD.org .
195 This manual page is based on his comments and was written by
196 .An Tom Rhodes Aq Mt trhodes@FreeBSD.org .