xref: /freebsd/share/man/man4/aacraid.4 (revision df21a004be237a1dccd03c7b47254625eea62fa9)
1.\"
2.\" SPDX-License-Identifier: BSD-2-Clause
3.\"
4.\" Copyright (c) 2013 Achim Leubner
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 AACRAID 4
29.Os
30.Sh NAME
31.Nm aacraid
32.Nd Adaptec Series 6/7/8 6G and 12G SAS+SATA RAID 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 aacraid
40.Pp
41To compile in debugging code:
42.Cd options AACRAID_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
49aacraid_load="YES"
50.Ed
51.Sh DESCRIPTION
52The
53.Nm
54driver provides support for the Adaptec by PMC RAID controllers,
55including Series 6/7/8 and upcoming families.
56.Pp
57The RAID containers are handled via the
58.Nm aacraidp0
59bus.
60The physical buses are represented by the
61.Nm aacraidp?
62devices (beginning with aacraidp1).
63These devices enable the
64SCSI pass-passthrough interface and allows devices connected
65to the card such as CD-ROMs to be available via the CAM
66.Xr scsi 4
67subsystem.
68Note that not all cards allow this interface to be enabled.
69.Pp
70The
71.Pa /dev/aacraid?
72device nodes provide access to the management interface of the controller.
73One node exists per installed card.
74If the
75.Pa aacraid_linux.ko
76and
77.Pa linux.ko
78modules are loaded, the
79Linux-compatible
80.Xr ioctl 2
81interface for the management device will be enabled and will allow
82Linux-based management applications to control the card.
83.Sh HARDWARE
84The
85.Nm
86driver supports the following
87Adaptec 6G and 12G SAS/SATA RAID controllers:
88.Pp
89.Bl -bullet -compact
90.It
91Adaptec ASR-6405(T|E)
92.It
93Adaptec ASR-6445
94.It
95Adaptec ASR-6805(T|E|Q|TQ)
96.It
97Adaptec ASR-7085
98.It
99Adaptec ASR-7805(Q)
100.It
101Adaptec ASR-70165
102.It
103Adaptec ASR-71605(E|Q)
104.It
105Adaptec ASR-71685
106.It
107Adaptec ASR-72405
108.It
109Adaptec Series 8 cards
110.El
111.Sh FILES
112.Bl -tag -width /boot/kernel/aacraid.ko -compact
113.It Pa /dev/aacraid?
114aacraid management interface
115.El
116.Sh DIAGNOSTICS
117Compiling with
118.Dv AACRAID_DEBUG
119set to a number between 0 and 3
120will enable increasingly verbose debug messages.
121.Pp
122The adapter can send status and alert messages asynchronously
123to the driver.
124These messages are printed on the system console,
125and are also queued for retrieval by a management application.
126.Sh SEE ALSO
127.Xr kld 4 ,
128.Xr linux 4 ,
129.Xr scsi 4 ,
130.Xr kldload 8
131.Sh AUTHORS
132.An Achim Leubner Aq Mt achim@FreeBSD.org
133.An \&Ed Maste Aq Mt emaste@FreeBSD.org
134.An Scott Long Aq Mt scottl@FreeBSD.org
135.Sh BUGS
136The controller is not actually paused on suspend/resume.
137