xref: /dragonfly/share/man/man4/aac.4 (revision bf31779e) 
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: head/share/man/man4/aac.4 195614 2009-07-11 08:10:18Z jkim $
26.Dd March 19, 2014
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
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-through 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.
78.Sh LOADER TUNABLES
79.Bl -tag -width indent
80.It Va hw.aac.msi.enable
81By default, the driver will use MSI if it is supported.
82This behavior can be turned off by setting this tunable to 0.
83.El
84.Sh HARDWARE
85Controllers supported by the
86.Nm
87driver include:
88.Pp
89.Bl -bullet -compact
90.It
91Adaptec AAC-364
92.It
93Adaptec RAID 2045
94.It
95Adaptec RAID 2405
96.It
97Adaptec RAID 2445
98.It
99Adaptec RAID 2805
100.It
101Adaptec RAID 3085
102.It
103Adaptec RAID 31205
104.It
105Adaptec RAID 31605
106.It
107Adaptec RAID 5085
108.It
109Adaptec RAID 51205
110.It
111Adaptec RAID 51245
112.It
113Adaptec RAID 51605
114.It
115Adaptec RAID 51645
116.It
117Adaptec RAID 52445
118.It
119Adaptec RAID 5405
120.It
121Adaptec RAID 5445
122.It
123Adaptec RAID 5805
124.It
125Adaptec SAS RAID 3405
126.It
127Adaptec SAS RAID 3805
128.It
129Adaptec SAS RAID 4000SAS
130.It
131Adaptec SAS RAID 4005SAS
132.It
133Adaptec SAS RAID 4800SAS
134.It
135Adaptec SAS RAID 4805SAS
136.It
137Adaptec SATA RAID 2020SA ZCR
138.It
139Adaptec SATA RAID 2025SA ZCR
140.It
141Adaptec SATA RAID 2026ZCR
142.It
143Adaptec SATA RAID 2410SA
144.It
145Adaptec SATA RAID 2420SA
146.It
147Adaptec SATA RAID 2610SA
148.It
149Adaptec SATA RAID 2620SA
150.It
151Adaptec SATA RAID 2810SA
152.It
153Adaptec SATA RAID 2820SA
154.It
155Adaptec SATA RAID 21610SA
156.It
157Adaptec SCSI RAID 2020ZCR
158.It
159Adaptec SCSI RAID 2025ZCR
160.It
161Adaptec SCSI RAID 2120S
162.It
163Adaptec SCSI RAID 2130S
164.It
165Adaptec SCSI RAID 2130SLP
166.It
167Adaptec SCSI RAID 2230SLP
168.It
169Adaptec SCSI RAID 2200S
170.It
171Adaptec SCSI RAID 2240S
172.It
173Adaptec SCSI RAID 3230S
174.It
175Adaptec SCSI RAID 3240S
176.It
177Adaptec SCSI RAID 5400S
178.It
179Dell CERC SATA RAID 2
180.It
181Dell PERC 2/Si
182.It
183Dell PERC 2/QC
184.It
185Dell PERC 3/Si
186.It
187Dell PERC 3/Di
188.It
189Dell PERC 320/DC
190.It
191HP ML110 G2 (Adaptec SATA RAID 2610SA)
192.It
193HP NetRAID 4M
194.It
195IBM ServeRAID 8i
196.It
197IBM ServeRAID 8k
198.It
199IBM ServeRAID 8s
200.It
201ICP RAID ICP5045BL
202.It
203ICP RAID ICP5085BL
204.It
205ICP RAID ICP5085SL
206.It
207ICP RAID ICP5125BR
208.It
209ICP RAID ICP5125SL
210.It
211ICP RAID ICP5165BR
212.It
213ICP RAID ICP5165SL
214.It
215ICP RAID ICP5445SL
216.It
217ICP RAID ICP5805BL
218.It
219ICP RAID ICP5805SL
220.It
221ICP ICP5085BR SAS RAID
222.It
223ICP ICP9085LI SAS RAID
224.It
225ICP ICP9047MA SATA RAID
226.It
227ICP ICP9067MA SATA RAID
228.It
229ICP ICP9087MA SATA RAID
230.It
231ICP ICP9014RO SCSI RAID
232.It
233ICP ICP9024RO SCSI RAID
234.It
235Legend S220
236.It
237Legend S230
238.It
239Sun STK RAID REM
240.It
241Sun STK RAID EM
242.It
243SG-XPCIESAS-R-IN
244.It
245SG-XPCIESAS-R-EX
246.It
247AOC-USAS-S4i
248.It
249AOC-USAS-S8i
250.It
251AOC-USAS-S4iR
252.It
253AOC-USAS-S8iR
254.It
255AOC-USAS-S8i-LP
256.It
257AOC-USAS-S8iR-LP
258.El
259.Sh FILES
260.Bl -tag -width /boot/kernel/aac.ko -compact
261.It Pa /dev/aac?
262aac management interface
263.It Pa /dev/aacd?
264disk/container interface
265.El
266.Sh DIAGNOSTICS
267Compiling with
268.Dv AAC_DEBUG
269will enable debug messages.
270.Pp
271The adapter can send status and alert messages asynchronously
272to the driver.
273These messages are printed on the system console,
274and are also queued for retrieval by a management application.
275.Sh SEE ALSO
276.Xr kld 4 ,
277.Xr scsi 4 ,
278.Xr kldload 8
279.Sh HISTORY
280The
281.Nm
282driver first appeared in
283.Fx 4.3 .
284.Sh AUTHORS
285.An Mike Smith Aq Mt msmith@FreeBSD.org
286.An Scott Long Aq Mt scottl@FreeBSD.org
287.Sh BUGS
288This driver is not compatible with Dell controllers that have version 1.x
289firmware.
290The firmware version is the same as the kernel version printed in the BIOS
291POST and driver attach messages.
292.Pp
293The controller is not actually paused on suspend/resume.
294