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