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