[src/trunk]: src/share/man/man4 Manpage for amr(4) from FreeBSD. Addresses P...

[gmcgarry <gmcgarry%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/663b426128c7
branches:  trunk
changeset: 546527:663b426128c7
user:      gmcgarry <gmcgarry%NetBSD.org@localhost>
date:      Thu May 01 08:36:50 2003 +0000

description:
Manpage for amr(4) from FreeBSD.  Addresses PR#17110.

diffstat:

 share/man/man4/Makefile |    4 +-
 share/man/man4/amr.4    |  168 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 170 insertions(+), 2 deletions(-)

diffs (186 lines):

diff -r 7ae3d080e43e -r 663b426128c7 share/man/man4/Makefile
--- a/share/man/man4/Makefile   Thu May 01 08:09:57 2003 +0000
+++ b/share/man/man4/Makefile   Thu May 01 08:36:50 2003 +0000
@@ -1,8 +1,8 @@
-#      $NetBSD: Makefile,v 1.283 2003/04/29 21:00:29 gmcgarry Exp $
+#      $NetBSD: Makefile,v 1.284 2003/05/01 08:36:50 gmcgarry Exp $
 #      @(#)Makefile    8.1 (Berkeley) 6/18/93
 
 MAN=   aac.4 acphy.4 adv.4 adw.4 agp.4 ahb.4 ahc.4 amdpm.4 \
-       amhphy.4 an.4 aria.4 \
+       amhphy.4 amr.4 an.4 aria.4 \
        atalk.4 audio.4 audiocs.4 auich.4 autri.4 \
        auvia.4 awi.4 bba.4 bge.4 bha.4 bktr.4 bpf.4 bmtphy.4 brgphy.4 \
        bridge.4 cac.4 cardbus.4 ccd.4 cd.4 cgd.4 cfb.4 ch.4 clcs.4 clct.4 \
diff -r 7ae3d080e43e -r 663b426128c7 share/man/man4/amr.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/amr.4      Thu May 01 08:36:50 2003 +0000
@@ -0,0 +1,168 @@
+.\" $NetBSD: amr.4,v 1.1 2003/05/01 08:36:50 gmcgarry Exp $
+.\"
+.\" Copyright (c) 2000 Jeroen Ruigrok van der Werven
+.\" 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. The name of the author may not be used to endorse or promote products
+.\"    derived from this software without specific prior written permission
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 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: /repoman/r/ncvs/src/share/man/man4/amr.4,v 1.16 2003/03/26 01:34:23 keramida Exp $
+.\"
+.Dd January 23, 2000
+.Dt AMR 4
+.Os
+.Sh NAME
+.Nm amr
+.Nd AMI MegaRAID PCI-SCSI RAID driver
+.Sh SYNOPSIS
+.Cd amr* at pci? dev ? function ?
+.Cd scsibus* at amr?
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for American Megatrends MegaRAID Express,
+Elite and Enterprise family SCSI RAID controllers,
+including models relabeled and sold by Hewlett-Packard and Dell.
+Supported controllers include:
+.Bl -bullet
+.It
+MegaRAID 320-1
+.It
+MegaRAID 320-2
+.It
+MegaRAID Series 418
+.It
+MegaRAID Enterprise 1200 (Series 428)
+.It
+MegaRAID Enterprise 1300 (Series 434)
+.It
+MegaRAID Enterprise 1400 (Series 438)
+.It
+MegaRAID Enterprise 1500 (Series 467)
+.It
+MegaRAID Enterprise 1600 (Series 471)
+.It
+MegaRAID Elite 1500 (Series 467)
+.It
+MegaRAID Elite 1600 (Series 493)
+.It
+MegaRAID Express 100 (Series 466WS)
+.It
+MegaRAID Express 200 (Series 466)
+.It
+MegaRAID Express 300 (Series 490)
+.It
+MegaRAID Express 500 (Series 475)
+.It
+Dell PERC
+.It
+Dell PERC 2/SC
+.It
+Dell PERC 2/DC
+.It
+HP NetRAID-1/Si
+.It
+HP NetRAID-3/Si
+.It
+HP Embedded NetRAID
+.El
+.Sh DIAGNOSTICS
+.Ss Driver initialisation/shutdown phase
+.Bl -diag
+.It amr%d: memory window not available
+.It amr%d: I/O window not available
+.Pp
+The PCI BIOS did not allocate resources necessary for the correct operation of
+the controller.
+The driver cannot attach to this controller.
+.It amr%d: busmaster bit not set, enabling
+.Pp
+The PCI BIOS did not enable busmaster DMA,
+which is required for the correct operation of the controller.
+The driver has enabled this bit and initialisation will proceed.
+.It amr%d: can't allocate register window
+.It amr%d: can't allocate interrupt
+.It amr%d: can't set up interrupt
+.It amr%d: can't allocate parent DMA tag
+.It amr%d: can't allocate buffer DMA tag
+.It amr%d: can't allocate scatter/gather DMA tag
+.It amr%d: can't allocate s/g table
+.It amr%d: can't allocate mailbox tag
+.It amr%d: can't allocate mailbox memory
+.Pp
+A resource allocation error occurred while initialising the driver;
+initialisation has failed and the driver will not attach to this controller.
+.It amr%d: can't obtain configuration data from controller
+.It amr%d: can't obtain product data from controller
+.Pp
+The driver was unable to obtain vital configuration data from the controller.
+Initialisation has failed and the driver will not attach to this controller.
+.It amr%d: can't establish configuration hook
+.It amr%d: can't scan controller for drives
+.Pp
+The scan for logical drives managed by the controller failed.
+No drives will be attached.
+.It amr%d: device_add_child failed
+.It amr%d: bus_generic_attach returned %d
+.Pp
+Creation of the logical drive instances failed;
+attachment of one or more logical drives may have been aborted.
+.It amr%d: flushing cache...
+.Pp
+The controller cache is being flushed prior to shutdown or detach.
+.El
+.Ss Operational diagnostics
+.Bl -diag
+.It amr%d: I/O beyond end of unit (%u,%d > %u)
+.Pp
+A partitioning error or disk corruption has caused an I/O request
+beyond the end of the logical drive.
+This may also occur if FlexRAID Virtual Sizing is enabled and
+an I/O operation is attempted on a portion of the virtual drive
+beyond the actual capacity available.
+.It amr%d: polled command timeout
+.Pp
+An initialisation command timed out.
+The initialisation process may fail as a result.
+.It amr%d: bad slot %d completed
+.Pp
+The controller reported completion of a command that the driver did not issue.
+This may result in data corruption,
+and suggests a hardware or firmware problem with the system or controller.
+.It amr%d: I/O error - %x
+.Pp
+An I/O error has occurred.
+.El
+.Sh SEE ALSO
+.Xr cd 4 ,
+.Xr ch 4 ,
+.Xr intro 4 ,
+.Xr pci 4 ,
+.Xr scsi 4 ,
+.Xr sd 4 ,
+.Xr st 4
+.Sh AUTHORS
+The
+.Nm
+driver was written by
+.An Mike Smith
+.Aq msmith%FreeBSD.org@localhost
+and
+.An Andrew Doran
+.Aq ad%netbsd.org@localhost .