xref: /netbsd-src/share/man/man4/amr.4 (revision 5b84b3983f71fd20a534cfa5d1556623a8aaa717)
1.\" $NetBSD: amr.4,v 1.10 2005/02/14 22:53:23 he Exp $
2.\"
3.\" Copyright (c) 2000 Jeroen Ruigrok van der Werven
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. The name of the author may not be used to endorse or promote products
12.\"    derived from this software without specific prior written permission
13.\"
14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
15.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
16.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
17.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
18.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
19.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
20.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
21.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
23.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24.\"
25.\" $FreeBSD: /repoman/r/ncvs/src/share/man/man4/amr.4,v 1.16 2003/03/26 01:34:23 keramida Exp $
26.\"
27.Dd October 28, 2004
28.Dt AMR 4
29.Os
30.Sh NAME
31.Nm amr
32.Nd AMI MegaRAID PCI-SCSI RAID driver
33.Sh SYNOPSIS
34.Cd "amr* at pci? dev ? function ?"
35.Cd scsibus* at amr?
36.Sh DESCRIPTION
37The
38.Nm
39driver provides support for American Megatrends MegaRAID Express,
40Elite and Enterprise family SCSI RAID controllers,
41including models relabeled and sold by Hewlett-Packard and Dell.
42Supported controllers include:
43.Pp
44.Bl -bullet -compact
45.It
46MegaRAID 320-1
47.It
48MegaRAID 320-2
49.It
50MegaRAID Series 418
51.It
52MegaRAID Enterprise 1200 (Series 428)
53.It
54MegaRAID Enterprise 1300 (Series 434)
55.It
56MegaRAID Enterprise 1400 (Series 438)
57.It
58MegaRAID Enterprise 1500 (Series 467)
59.It
60MegaRAID Enterprise 1600 (Series 471)
61.It
62MegaRAID Elite 1500 (Series 467)
63.It
64MegaRAID Elite 1600 (Series 493)
65.It
66MegaRAID Express 100 (Series 466WS)
67.It
68MegaRAID Express 200 (Series 466)
69.It
70MegaRAID Express 300 (Series 490)
71.It
72MegaRAID Express 500 (Series 475)
73.It
74Dell PERC
75.It
76Dell PERC 2/SC
77.It
78Dell PERC 2/DC
79.It
80Dell PERC 4/Di
81.It
82Dell PERC 4/SC
83.It
84Dell PERC 4e/Si
85.It
86HP NetRAID-1/Si
87.It
88HP NetRAID-3/Si
89.It
90HP Embedded NetRAID
91.El
92.Sh DIAGNOSTICS
93.Ss Driver initialisation/shutdown phase
94.Bl -diag
95.It amr%d: memory window not available
96.It amr%d: I/O window not available
97.Pp
98The PCI BIOS did not allocate resources necessary for the correct operation of
99the controller.
100The driver cannot attach to this controller.
101.It amr%d: busmaster bit not set, enabling
102.Pp
103The PCI BIOS did not enable busmaster DMA,
104which is required for the correct operation of the controller.
105The driver has enabled this bit and initialisation will proceed.
106.It amr%d: can't allocate register window
107.It amr%d: can't allocate interrupt
108.It amr%d: can't set up interrupt
109.It amr%d: can't allocate parent DMA tag
110.It amr%d: can't allocate buffer DMA tag
111.It amr%d: can't allocate scatter/gather DMA tag
112.It amr%d: can't allocate s/g table
113.It amr%d: can't allocate mailbox tag
114.It amr%d: can't allocate mailbox memory
115.Pp
116A resource allocation error occurred while initialising the driver;
117initialisation has failed and the driver will not attach to this controller.
118.It amr%d: can't obtain configuration data from controller
119.It amr%d: can't obtain product data from controller
120.Pp
121The driver was unable to obtain vital configuration data from the controller.
122Initialisation has failed and the driver will not attach to this controller.
123.It amr%d: can't establish configuration hook
124.It amr%d: can't scan controller for drives
125.Pp
126The scan for logical drives managed by the controller failed.
127No drives will be attached.
128.It amr%d: device_add_child failed
129.It amr%d: bus_generic_attach returned %d
130.Pp
131Creation of the logical drive instances failed;
132attachment of one or more logical drives may have been aborted.
133.It amr%d: flushing cache...
134.Pp
135The controller cache is being flushed prior to shutdown or detach.
136.El
137.Ss Operational diagnostics
138.Bl -diag
139.It amr%d: I/O beyond end of unit (%u,%d \*[Gt] %u)
140.Pp
141A partitioning error or disk corruption has caused an I/O request
142beyond the end of the logical drive.
143This may also occur if FlexRAID Virtual Sizing is enabled and
144an I/O operation is attempted on a portion of the virtual drive
145beyond the actual capacity available.
146.It amr%d: polled command timeout
147.Pp
148An initialisation command timed out.
149The initialisation process may fail as a result.
150.It amr%d: bad slot %d completed
151.Pp
152The controller reported completion of a command that the driver did not issue.
153This may result in data corruption,
154and suggests a hardware or firmware problem with the system or controller.
155.It amr%d: I/O error - %x
156.Pp
157An I/O error has occurred.
158.El
159.Sh SEE ALSO
160.Xr cd 4 ,
161.Xr ch 4 ,
162.Xr intro 4 ,
163.Xr pci 4 ,
164.Xr scsi 4 ,
165.Xr sd 4 ,
166.Xr st 4
167.Sh AUTHORS
168The
169.Nm
170driver was written by
171.An Mike Smith
172.Aq msmith@FreeBSD.org
173and
174.An Andrew Doran
175.Aq ad@NetBSD.org .
176