xref: /freebsd/share/man/man4/aac.4 (revision e0c4386e) 
1.\" Copyright (c) 2000 Scott Long
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.Dd July 10, 2009
25.Dt AAC 4
26.Os
27.Sh NAME
28.Nm aac
29.Nd Adaptec AdvancedRAID Controller driver
30.Sh SYNOPSIS
31To compile this driver into the kernel,
32place the following lines in your
33kernel configuration file:
34.Bd -ragged -offset indent
35.Cd device pci
36.Cd device aac
37.Cd device aacp
38.Pp
39To compile in debugging code:
40.Cd options AAC_DEBUG=N
41.Ed
42.Pp
43Alternatively, to load the driver as a
44module at boot time, place the following line in
45.Xr loader.conf 5 :
46.Bd -literal -offset indent
47aac_load="YES"
48.Ed
49.Sh DESCRIPTION
50The
51.Nm
52driver provides support for the Adaptec AAC family of SCSI Ultra2, Ultra160,
53and Ultra320, SATA and SAS RAID controllers.
54.Pp
55Access to RAID containers is available via the
56.Pa /dev/aacd?
57device nodes.
58The
59.Nm aacp
60device enables the SCSI pass-thru interface and allows devices connected
61to the card such as CD-ROMs to be available via the CAM
62.Xr scsi 4
63subsystem.
64Note that not all cards allow this interface to be enabled.
65.Pp
66The
67.Pa /dev/aac?
68device nodes provide access to the management interface of the controller.
69One node exists per installed card.
70The aliases
71.Pa /dev/afa?
72and
73.Pa /dev/hpn?
74exist for compatibility with the Dell and HP versions of management tools,
75respectively.
76If the
77.Pa aac_linux.ko
78and
79.Pa linux.ko
80modules are loaded, the
81Linux-compatible
82.Xr ioctl 2
83interface for the management device will be enabled and will allow
84Linux-based management applications to control the card.
85.Sh HARDWARE
86Controllers supported by the
87.Nm
88driver include:
89.Pp
90.Bl -bullet -compact
91.It
92Adaptec AAC-364
93.It
94Adaptec RAID 2045
95.It
96Adaptec RAID 2405
97.It
98Adaptec RAID 2445
99.It
100Adaptec RAID 2805
101.It
102Adaptec RAID 3085
103.It
104Adaptec RAID 31205
105.It
106Adaptec RAID 31605
107.It
108Adaptec RAID 5085
109.It
110Adaptec RAID 51205
111.It
112Adaptec RAID 51245
113.It
114Adaptec RAID 51605
115.It
116Adaptec RAID 51645
117.It
118Adaptec RAID 52445
119.It
120Adaptec RAID 5405
121.It
122Adaptec RAID 5445
123.It
124Adaptec RAID 5805
125.It
126Adaptec SAS RAID 3405
127.It
128Adaptec SAS RAID 3805
129.It
130Adaptec SAS RAID 4000SAS
131.It
132Adaptec SAS RAID 4005SAS
133.It
134Adaptec SAS RAID 4800SAS
135.It
136Adaptec SAS RAID 4805SAS
137.It
138Adaptec SATA RAID 2020SA ZCR
139.It
140Adaptec SATA RAID 2025SA ZCR
141.It
142Adaptec SATA RAID 2026ZCR
143.It
144Adaptec SATA RAID 2410SA
145.It
146Adaptec SATA RAID 2420SA
147.It
148Adaptec SATA RAID 2610SA
149.It
150Adaptec SATA RAID 2620SA
151.It
152Adaptec SATA RAID 2810SA
153.It
154Adaptec SATA RAID 2820SA
155.It
156Adaptec SATA RAID 21610SA
157.It
158Adaptec SCSI RAID 2020ZCR
159.It
160Adaptec SCSI RAID 2025ZCR
161.It
162Adaptec SCSI RAID 2120S
163.It
164Adaptec SCSI RAID 2130S
165.It
166Adaptec SCSI RAID 2130SLP
167.It
168Adaptec SCSI RAID 2230SLP
169.It
170Adaptec SCSI RAID 2200S
171.It
172Adaptec SCSI RAID 2240S
173.It
174Adaptec SCSI RAID 3230S
175.It
176Adaptec SCSI RAID 3240S
177.It
178Adaptec SCSI RAID 5400S
179.It
180Dell CERC SATA RAID 2
181.It
182Dell PERC 2/Si
183.It
184Dell PERC 2/QC
185.It
186Dell PERC 3/Si
187.It
188Dell PERC 3/Di
189.It
190Dell PERC 320/DC
191.It
192HP ML110 G2 (Adaptec SATA RAID 2610SA)
193.It
194HP NetRAID 4M
195.It
196IBM ServeRAID 8i
197.It
198IBM ServeRAID 8k
199.It
200IBM ServeRAID 8s
201.It
202ICP RAID ICP5045BL
203.It
204ICP RAID ICP5085BL
205.It
206ICP RAID ICP5085SL
207.It
208ICP RAID ICP5125BR
209.It
210ICP RAID ICP5125SL
211.It
212ICP RAID ICP5165BR
213.It
214ICP RAID ICP5165SL
215.It
216ICP RAID ICP5445SL
217.It
218ICP RAID ICP5805BL
219.It
220ICP RAID ICP5805SL
221.It
222ICP ICP5085BR SAS RAID
223.It
224ICP ICP9085LI SAS RAID
225.It
226ICP ICP9047MA SATA RAID
227.It
228ICP ICP9067MA SATA RAID
229.It
230ICP ICP9087MA SATA RAID
231.It
232ICP ICP9014RO SCSI RAID
233.It
234ICP ICP9024RO SCSI RAID
235.It
236Legend S220
237.It
238Legend S230
239.It
240Sun STK RAID REM
241.It
242Sun STK RAID EM
243.It
244SG-XPCIESAS-R-IN
245.It
246SG-XPCIESAS-R-EX
247.It
248AOC-USAS-S4i
249.It
250AOC-USAS-S8i
251.It
252AOC-USAS-S4iR
253.It
254AOC-USAS-S8iR
255.It
256AOC-USAS-S8i-LP
257.It
258AOC-USAS-S8iR-LP
259.El
260.Sh FILES
261.Bl -tag -width /boot/kernel/aac.ko -compact
262.It Pa /dev/aac?
263aac management interface
264.It Pa /dev/aacd?
265disk/container interface
266.El
267.Sh DIAGNOSTICS
268Compiling with
269.Dv AAC_DEBUG
270set to a number between 0 and 3
271will enable increasingly verbose debug messages.
272.Pp
273The adapter can send status and alert messages asynchronously
274to the driver.
275These messages are printed on the system console,
276and are also queued for retrieval by a management application.
277.Sh SEE ALSO
278.Xr kld 4 ,
279.Xr linux 4 ,
280.Xr scsi 4 ,
281.Xr kldload 8
282.Sh HISTORY
283The
284.Nm
285driver first appeared in
286.Fx 4.3 .
287.Sh AUTHORS
288.An Mike Smith Aq Mt msmith@FreeBSD.org
289.An Scott Long Aq Mt scottl@FreeBSD.org
290.Sh BUGS
291This driver is not compatible with Dell controllers that have version 1.x
292firmware.
293The firmware version is the same as the kernel version printed in the BIOS
294POST and driver attach messages.
295.Pp
296The controller is not actually paused on suspend/resume.
297