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 4, 2004 27.Dt AAC 4 28.Os 29.Sh NAME 30.Nm aac 31.Nd Adaptec AdvancedRAID Controller driver 32.Sh SYNOPSIS 33.Cd options AAC_DEBUG=N 34.Cd device pci 35.Cd device aac 36.Cd device aacp 37.Sh DESCRIPTION 38The 39.Nm 40driver provides support for the Adaptec AAC family of SCSI Ultra2, Ultra160, 41and Ultra320 RAID controllers. 42.Pp 43Access to RAID containers is available via the 44.Pa /dev/aacd? 45device nodes. 46Individual drives cannot be accessed 47unless they are part of a container or volume set, 48and non-fixed disks cannot be accessed. 49Containers can be configured by using 50either the on-board BIOS utility of the card, 51or a command-line interface management application. 52.Pp 53The 54.Pa /dev/aac? 55device nodes provide access to the management interface of the controller. 56One node exists per installed card. 57The aliases 58.Pa /dev/afa? 59and 60.Pa /dev/hpn? 61exist for the Dell and HP flavors, respectively, and are required for 62the CLI management utility available from these vendors to work. 63If the kernel is compiled with the 64.Dv COMPAT_LINUX 65option, or the 66.Pa aac_linux.ko 67and 68.Pa linux.ko 69modules are loaded, the 70Linux-compatible 71.Xr ioctl 2 72interface for the management device will be enabled and will allow 73Linux-based management applications to control the card. 74.Pp 75The 76.Nm aacp 77device enables the SCSI pass-thru interface and allows devices connected 78to the card such as cdroms to be available via the CAM 79.Xr scsi 4 80subsystem. 81Note that not all cards allow this interface to be enabled. 82.Ss Tuning 83The read-only sysctl 84.Va hw.aac.iosize_max 85defaults to 65536 and may be set at boot time to another value via 86.Xr loader 8 . 87This value determines the maximum data transfer size allowed 88to/from an array. 89Setting it higher will result in better performance, 90especially for large sequential access patterns. 91.Em Beware : 92internal limitations 93of the card limit this value to 64K for arrays with many members. 94While it may be safe to raise this value, this is done 95.Em at the operator's own risk . 96Note also that 97performance peaks at a value of 96K, 98and drops off dramatically at 128K, 99due to other limitations of the card. 100.Sh HARDWARE 101Controllers supported by the 102.Nm 103driver include: 104.Pp 105.Bl -bullet -compact 106.It 107Adaptec AAC-364 108.It 109Adaptec SCSI RAID 2120S 110.It 111Adaptec SCSI RAID 2200S 112.It 113Adaptec SCSI RAID 2410SA 114.It 115Adaptec SCSI RAID 2810SA 116.It 117Adaptec SCSI RAID 5400S 118.It 119Dell CERC SATA RAID 2 120.It 121Dell PERC 2/Si 122.It 123Dell PERC 2/QC 124.It 125Dell PERC 3/Si 126.It 127Dell PERC 3/Di 128.It 129Dell PERC 320/DC 130.It 131HP NetRAID 4M 132.El 133.Sh FILES 134.Bl -tag -width /boot/kernel/aac.ko -compact 135.It Pa /dev/aac? 136aac management interface 137.It Pa /dev/aacd? 138disk/container interface 139.It Pa /boot/kernel/aac.ko 140aac loadable module 141.El 142.Sh DIAGNOSTICS 143Compiling with 144.Dv AAC_DEBUG 145set to a number between 0 and 3 146will enable increasingly verbose debug messages. 147.Pp 148The adapter can send status and alert messages asynchronously 149to the driver. 150These messages are printed on the system console, 151and are also queued for retrieval by a management application. 152.Sh SEE ALSO 153.Xr kld 4 , 154.Xr linux 4 , 155.Xr scsi 4 , 156.Xr kldload 8 , 157.Xr loader 8 , 158.Xr sysctl 8 159.Sh HISTORY 160The 161.Nm 162driver first appeared in 163.Fx 4.3 . 164.Sh AUTHORS 165.An Mike Smith 166.Aq msmith@FreeBSD.org 167.An Scott Long 168.Aq scottl@FreeBSD.org 169.Sh BUGS 170This driver is not compatible with Dell controllers that have version 1.x 171firmware. 172The firmware version is the same as the kernel version printed in the BIOS 173POST and driver attach messages. 174.Pp 175The controller is not actually paused on suspend/resume. 176.Pp 177