2000-10-05 20:44:17 +00:00
|
|
|
.\" Copyright (c) 2000 Scott Long
|
|
|
|
|
.\" All rights reserved.
|
|
|
|
|
.\"
|
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
|
.\" are met:
|
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
|
|
|
.\"
|
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
|
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
|
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
|
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
|
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
|
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
|
|
|
.\" SUCH DAMAGE.
|
|
|
|
|
.\"
|
|
|
|
|
.\" $FreeBSD$
|
2008-06-27 19:34:47 +00:00
|
|
|
.Dd June 27, 2008
|
2000-10-05 20:44:17 +00:00
|
|
|
.Dt AAC 4
|
|
|
|
|
.Os
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm aac
|
|
|
|
|
.Nd Adaptec AdvancedRAID Controller driver
|
|
|
|
|
.Sh SYNOPSIS
|
2006-06-17 18:45:53 +00:00
|
|
|
To compile this driver into the kernel,
|
|
|
|
|
place the following lines in your
|
|
|
|
|
kernel configuration file:
|
|
|
|
|
.Bd -ragged -offset indent
|
2000-10-05 20:44:17 +00:00
|
|
|
.Cd device pci
|
|
|
|
|
.Cd device aac
|
2003-02-20 05:20:05 +00:00
|
|
|
.Cd device aacp
|
2006-06-17 18:45:53 +00:00
|
|
|
.Pp
|
|
|
|
|
To compile in debugging code:
|
|
|
|
|
.Cd options AAC_DEBUG=N
|
|
|
|
|
.Ed
|
|
|
|
|
.Pp
|
|
|
|
|
Alternatively, to load the driver as a
|
|
|
|
|
module at boot time, place the following line in
|
|
|
|
|
.Xr loader.conf 5 :
|
|
|
|
|
.Bd -literal -offset indent
|
|
|
|
|
aac_load="YES"
|
|
|
|
|
.Ed
|
2000-10-05 20:44:17 +00:00
|
|
|
.Sh DESCRIPTION
|
2001-07-14 19:41:16 +00:00
|
|
|
The
|
2000-10-05 20:44:17 +00:00
|
|
|
.Nm
|
2003-02-20 05:20:05 +00:00
|
|
|
driver provides support for the Adaptec AAC family of SCSI Ultra2, Ultra160,
|
2006-06-17 18:45:53 +00:00
|
|
|
and Ultra320, SATA and SAS RAID controllers.
|
2000-10-05 20:44:17 +00:00
|
|
|
.Pp
|
|
|
|
|
Access to RAID containers is available via the
|
|
|
|
|
.Pa /dev/aacd?
|
|
|
|
|
device nodes.
|
2004-08-13 03:55:35 +00:00
|
|
|
The
|
|
|
|
|
.Nm aacp
|
|
|
|
|
device enables the SCSI pass-thru interface and allows devices connected
|
2005-03-10 08:07:59 +00:00
|
|
|
to the card such as CD-ROMs to be available via the CAM
|
2004-08-13 03:55:35 +00:00
|
|
|
.Xr scsi 4
|
|
|
|
|
subsystem.
|
|
|
|
|
Note that not all cards allow this interface to be enabled.
|
2000-10-05 20:44:17 +00:00
|
|
|
.Pp
|
|
|
|
|
The
|
|
|
|
|
.Pa /dev/aac?
|
2001-07-25 22:36:17 +00:00
|
|
|
device nodes provide access to the management interface of the controller.
|
2001-08-07 13:00:43 +00:00
|
|
|
One node exists per installed card.
|
|
|
|
|
The aliases
|
2001-07-25 22:36:17 +00:00
|
|
|
.Pa /dev/afa?
|
|
|
|
|
and
|
|
|
|
|
.Pa /dev/hpn?
|
2006-12-14 11:57:39 +00:00
|
|
|
exist for compatibility with the Dell and HP versions of management tools,
|
2004-08-13 03:55:35 +00:00
|
|
|
respectively.
|
2003-02-20 05:20:05 +00:00
|
|
|
If the kernel is compiled with the
|
|
|
|
|
.Dv COMPAT_LINUX
|
2003-02-24 22:53:26 +00:00
|
|
|
option, or the
|
|
|
|
|
.Pa aac_linux.ko
|
|
|
|
|
and
|
|
|
|
|
.Pa linux.ko
|
|
|
|
|
modules are loaded, the
|
2003-02-20 05:20:05 +00:00
|
|
|
Linux-compatible
|
2001-07-14 19:41:16 +00:00
|
|
|
.Xr ioctl 2
|
2003-02-20 05:20:05 +00:00
|
|
|
interface for the management device will be enabled and will allow
|
|
|
|
|
Linux-based management applications to control the card.
|
2001-08-06 18:16:46 +00:00
|
|
|
.Ss Tuning
|
2001-08-07 13:00:43 +00:00
|
|
|
The read-only sysctl
|
2001-08-05 07:26:31 +00:00
|
|
|
.Va hw.aac.iosize_max
|
2001-08-05 11:15:23 +00:00
|
|
|
defaults to 65536 and may be set at boot time to another value via
|
2001-08-05 07:26:31 +00:00
|
|
|
.Xr loader 8 .
|
|
|
|
|
This value determines the maximum data transfer size allowed
|
2001-08-05 11:15:23 +00:00
|
|
|
to/from an array.
|
|
|
|
|
Setting it higher will result in better performance,
|
|
|
|
|
especially for large sequential access patterns.
|
|
|
|
|
.Em Beware :
|
|
|
|
|
internal limitations
|
|
|
|
|
of the card limit this value to 64K for arrays with many members.
|
|
|
|
|
While it may be safe to raise this value, this is done
|
|
|
|
|
.Em at the operator's own risk .
|
|
|
|
|
Note also that
|
|
|
|
|
performance peaks at a value of 96K,
|
|
|
|
|
and drops off dramatically at 128K,
|
|
|
|
|
due to other limitations of the card.
|
2004-07-04 14:17:41 +00:00
|
|
|
.Sh HARDWARE
|
|
|
|
|
Controllers supported by the
|
|
|
|
|
.Nm
|
|
|
|
|
driver include:
|
|
|
|
|
.Pp
|
|
|
|
|
.Bl -bullet -compact
|
|
|
|
|
.It
|
|
|
|
|
Adaptec AAC-364
|
|
|
|
|
.It
|
2008-06-27 19:34:47 +00:00
|
|
|
Adaptec RAID 2045
|
|
|
|
|
.It
|
|
|
|
|
Adaptec RAID 2405
|
|
|
|
|
.It
|
|
|
|
|
Adaptec RAID 2445
|
|
|
|
|
.It
|
|
|
|
|
Adaptec RAID 2805
|
|
|
|
|
.It
|
2007-11-29 17:56:55 +00:00
|
|
|
Adaptec RAID 3085
|
|
|
|
|
.It
|
|
|
|
|
Adaptec RAID 31205
|
|
|
|
|
.It
|
|
|
|
|
Adaptec RAID 31605
|
|
|
|
|
.It
|
|
|
|
|
Adaptec RAID 5085
|
|
|
|
|
.It
|
|
|
|
|
Adaptec RAID 51205
|
|
|
|
|
.It
|
2007-12-06 18:31:57 +00:00
|
|
|
Adaptec RAID 51245
|
|
|
|
|
.It
|
2007-11-29 17:56:55 +00:00
|
|
|
Adaptec RAID 51605
|
|
|
|
|
.It
|
2007-12-06 18:31:57 +00:00
|
|
|
Adaptec RAID 51645
|
|
|
|
|
.It
|
|
|
|
|
Adaptec RAID 52445
|
|
|
|
|
.It
|
|
|
|
|
Adaptec RAID 5405
|
|
|
|
|
.It
|
2007-11-29 17:56:55 +00:00
|
|
|
Adaptec RAID 5445
|
|
|
|
|
.It
|
|
|
|
|
Adaptec RAID 5805
|
|
|
|
|
.It
|
2007-08-23 20:12:40 +00:00
|
|
|
Adaptec SAS RAID 3405
|
|
|
|
|
.It
|
|
|
|
|
Adaptec SAS RAID 3805
|
|
|
|
|
.It
|
2006-06-17 18:45:53 +00:00
|
|
|
Adaptec SAS RAID 4000SAS
|
|
|
|
|
.It
|
|
|
|
|
Adaptec SAS RAID 4005SAS
|
|
|
|
|
.It
|
|
|
|
|
Adaptec SAS RAID 4800SAS
|
|
|
|
|
.It
|
|
|
|
|
Adaptec SAS RAID 4805SAS
|
|
|
|
|
.It
|
|
|
|
|
Adaptec SATA RAID 2020SA ZCR
|
|
|
|
|
.It
|
|
|
|
|
Adaptec SATA RAID 2025SA ZCR
|
|
|
|
|
.It
|
|
|
|
|
Adaptec SATA RAID 2026ZCR
|
|
|
|
|
.It
|
2005-01-04 15:59:00 +00:00
|
|
|
Adaptec SATA RAID 2410SA
|
|
|
|
|
.It
|
2006-06-17 18:45:53 +00:00
|
|
|
Adaptec SATA RAID 2420SA
|
|
|
|
|
.It
|
|
|
|
|
Adaptec SATA RAID 2610SA
|
|
|
|
|
.It
|
|
|
|
|
Adaptec SATA RAID 2620SA
|
|
|
|
|
.It
|
2005-01-04 15:59:00 +00:00
|
|
|
Adaptec SATA RAID 2810SA
|
|
|
|
|
.It
|
2006-06-17 18:45:53 +00:00
|
|
|
Adaptec SATA RAID 2820SA
|
|
|
|
|
.It
|
2005-01-04 15:59:00 +00:00
|
|
|
Adaptec SATA RAID 21610SA
|
|
|
|
|
.It
|
2006-06-17 18:45:53 +00:00
|
|
|
Adaptec SCSI RAID 2020ZCR
|
|
|
|
|
.It
|
|
|
|
|
Adaptec SCSI RAID 2025ZCR
|
|
|
|
|
.It
|
2004-07-04 14:17:41 +00:00
|
|
|
Adaptec SCSI RAID 2120S
|
|
|
|
|
.It
|
2004-08-13 03:55:35 +00:00
|
|
|
Adaptec SCSI RAID 2130S
|
|
|
|
|
.It
|
2004-12-23 08:05:40 +00:00
|
|
|
Adaptec SCSI RAID 2130SLP
|
|
|
|
|
.It
|
2004-12-15 09:29:47 +00:00
|
|
|
Adaptec SCSI RAID 2230SLP
|
|
|
|
|
.It
|
2006-06-17 18:45:53 +00:00
|
|
|
Adaptec SCSI RAID 2200S
|
|
|
|
|
.It
|
|
|
|
|
Adaptec SCSI RAID 2240S
|
|
|
|
|
.It
|
|
|
|
|
Adaptec SCSI RAID 3230S
|
|
|
|
|
.It
|
|
|
|
|
Adaptec SCSI RAID 3240S
|
|
|
|
|
.It
|
2004-07-04 14:17:41 +00:00
|
|
|
Adaptec SCSI RAID 5400S
|
|
|
|
|
.It
|
|
|
|
|
Dell CERC SATA RAID 2
|
|
|
|
|
.It
|
|
|
|
|
Dell PERC 2/Si
|
|
|
|
|
.It
|
|
|
|
|
Dell PERC 2/QC
|
|
|
|
|
.It
|
|
|
|
|
Dell PERC 3/Si
|
|
|
|
|
.It
|
|
|
|
|
Dell PERC 3/Di
|
|
|
|
|
.It
|
|
|
|
|
Dell PERC 320/DC
|
|
|
|
|
.It
|
2006-06-17 18:45:53 +00:00
|
|
|
HP ML110 G2 (Adaptec SATA RAID 2610SA)
|
|
|
|
|
.It
|
2004-07-04 14:17:41 +00:00
|
|
|
HP NetRAID 4M
|
2006-06-17 18:45:53 +00:00
|
|
|
.It
|
|
|
|
|
IBM ServeRAID 8i
|
|
|
|
|
.It
|
2006-11-03 06:50:03 +00:00
|
|
|
IBM ServeRAID 8k
|
|
|
|
|
.It
|
2007-11-29 17:56:55 +00:00
|
|
|
IBM ServeRAID 8s
|
|
|
|
|
.It
|
|
|
|
|
ICP RAID ICP5045BL
|
|
|
|
|
.It
|
|
|
|
|
ICP RAID ICP5085BL
|
|
|
|
|
.It
|
|
|
|
|
ICP RAID ICP5085SL
|
|
|
|
|
.It
|
|
|
|
|
ICP RAID ICP5125BR
|
|
|
|
|
.It
|
|
|
|
|
ICP RAID ICP5125SL
|
|
|
|
|
.It
|
|
|
|
|
ICP RAID ICP5165BR
|
|
|
|
|
.It
|
|
|
|
|
ICP RAID ICP5165SL
|
|
|
|
|
.It
|
|
|
|
|
ICP RAID ICP5445SL
|
|
|
|
|
.It
|
|
|
|
|
ICP RAID ICP5805BL
|
|
|
|
|
.It
|
|
|
|
|
ICP RAID ICP5805SL
|
|
|
|
|
.It
|
2006-06-17 18:45:53 +00:00
|
|
|
ICP ICP5085BR SAS RAID
|
|
|
|
|
.It
|
|
|
|
|
ICP ICP9085LI SAS RAID
|
|
|
|
|
.It
|
|
|
|
|
ICP ICP9047MA SATA RAID
|
|
|
|
|
.It
|
2007-11-29 17:56:55 +00:00
|
|
|
ICP ICP9067MA SATA RAID
|
|
|
|
|
.It
|
2006-06-17 18:45:53 +00:00
|
|
|
ICP ICP9087MA SATA RAID
|
|
|
|
|
.It
|
|
|
|
|
ICP ICP9014RO SCSI RAID
|
|
|
|
|
.It
|
|
|
|
|
ICP ICP9024RO SCSI RAID
|
|
|
|
|
.It
|
|
|
|
|
Legend S220
|
|
|
|
|
.It
|
|
|
|
|
Legend S230
|
2007-12-06 18:31:57 +00:00
|
|
|
.It
|
|
|
|
|
Sun STK RAID REM
|
|
|
|
|
.It
|
|
|
|
|
Sun STK RAID EM
|
|
|
|
|
.It
|
|
|
|
|
SG-XPCIESAS-R-IN
|
|
|
|
|
.It
|
|
|
|
|
SG-XPCIESAS-R-EX
|
|
|
|
|
.It
|
|
|
|
|
AOC-USAS-S4i
|
|
|
|
|
.It
|
|
|
|
|
AOC-USAS-S8i
|
|
|
|
|
.It
|
|
|
|
|
AOC-USAS-S4iR
|
|
|
|
|
.It
|
|
|
|
|
AOC-USAS-S8iR
|
|
|
|
|
.It
|
|
|
|
|
AOC-USAS-S8i-LP
|
|
|
|
|
.It
|
|
|
|
|
AOC-USAS-S8iR-LP
|
2004-07-04 14:17:41 +00:00
|
|
|
.El
|
2001-08-06 18:16:46 +00:00
|
|
|
.Sh FILES
|
|
|
|
|
.Bl -tag -width /boot/kernel/aac.ko -compact
|
|
|
|
|
.It Pa /dev/aac?
|
|
|
|
|
aac management interface
|
|
|
|
|
.It Pa /dev/aacd?
|
|
|
|
|
disk/container interface
|
|
|
|
|
.El
|
2000-10-05 20:44:17 +00:00
|
|
|
.Sh DIAGNOSTICS
|
|
|
|
|
Compiling with
|
|
|
|
|
.Dv AAC_DEBUG
|
2001-07-14 19:41:16 +00:00
|
|
|
set to a number between 0 and 3
|
2000-10-05 20:44:17 +00:00
|
|
|
will enable increasingly verbose debug messages.
|
|
|
|
|
.Pp
|
2001-07-14 19:41:16 +00:00
|
|
|
The adapter can send status and alert messages asynchronously
|
2001-08-07 13:00:43 +00:00
|
|
|
to the driver.
|
|
|
|
|
These messages are printed on the system console,
|
2000-10-05 20:44:17 +00:00
|
|
|
and are also queued for retrieval by a management application.
|
|
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr kld 4 ,
|
2001-02-01 16:38:02 +00:00
|
|
|
.Xr linux 4 ,
|
2003-02-20 05:20:05 +00:00
|
|
|
.Xr scsi 4 ,
|
2001-08-06 19:21:27 +00:00
|
|
|
.Xr kldload 8 ,
|
|
|
|
|
.Xr loader 8 ,
|
2001-08-06 18:16:46 +00:00
|
|
|
.Xr sysctl 8
|
2000-10-05 20:44:17 +00:00
|
|
|
.Sh HISTORY
|
|
|
|
|
The
|
|
|
|
|
.Nm
|
|
|
|
|
driver first appeared in
|
2001-09-27 21:52:42 +00:00
|
|
|
.Fx 4.3 .
|
2000-10-05 20:44:17 +00:00
|
|
|
.Sh AUTHORS
|
|
|
|
|
.An Mike Smith
|
2000-10-26 15:30:44 +00:00
|
|
|
.Aq msmith@FreeBSD.org
|
2000-10-05 20:44:17 +00:00
|
|
|
.An Scott Long
|
2000-10-26 15:30:44 +00:00
|
|
|
.Aq scottl@FreeBSD.org
|
2000-10-05 20:44:17 +00:00
|
|
|
.Sh BUGS
|
2003-02-20 05:20:05 +00:00
|
|
|
This driver is not compatible with Dell controllers that have version 1.x
|
|
|
|
|
firmware.
|
2001-09-25 22:33:53 +00:00
|
|
|
The firmware version is the same as the kernel version printed in the BIOS
|
|
|
|
|
POST and driver attach messages.
|
2001-09-22 04:26:35 +00:00
|
|
|
.Pp
|
2001-07-14 19:41:16 +00:00
|
|
|
The controller is not actually paused on suspend/resume.
|
