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