Subject: Re: control tool for amr(4)
To: None <tech-kern@netbsd.org>
From: Manuel Bouyer <bouyer@antioche.eu.org>
List: tech-kern
Date: 06/25/2006 00:13:17
--nFreZHaLTZJo0R7j
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
[ Cross-posted to tech-kern and tech-userlevel because this adds a new tool
to base, please keep only the appropriate list for replies ]
On Sat, Jun 24, 2006 at 01:17:46AM +0200, Manuel Bouyer wrote:
> Hi,
> attached are diffs to support basic ioctl interface to the amr(4) driver,
> and a port of the FreeBSD amrstat tool (diff against netbsd-3).
Attached is the complete diff (including amrstat in the base system with man
page) against current. If noone objects I'll commit this in the next few
days.
--
Manuel Bouyer <bouyer@antioche.eu.org>
NetBSD: 26 ans d'experience feront toujours la difference
--
--nFreZHaLTZJo0R7j
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="amr.diff"
Index: distrib/sets/lists/base/mi
===================================================================
RCS file: /cvsroot/src/distrib/sets/lists/base/mi,v
retrieving revision 1.633
diff -u -r1.633 mi
--- distrib/sets/lists/base/mi 24 Jun 2006 05:11:40 -0000 1.633
+++ distrib/sets/lists/base/mi 24 Jun 2006 22:01:44 -0000
@@ -111,6 +111,7 @@
./rescue base-sys-root
./root base-sys-root
./sbin base-sys-root
+./sbin/amrstat base-sysutil-root
./sbin/atactl base-sysutil-root
./sbin/badsect base-sysutil-root
./sbin/brconfig base-netutil-root
Index: distrib/sets/lists/comp/mi
===================================================================
RCS file: /cvsroot/src/distrib/sets/lists/comp/mi,v
retrieving revision 1.892
diff -u -r1.892 mi
--- distrib/sets/lists/comp/mi 24 Jun 2006 12:37:36 -0000 1.892
+++ distrib/sets/lists/comp/mi 24 Jun 2006 22:01:44 -0000
@@ -370,6 +370,8 @@
./usr/include/dev/ofw/ofw_pci.h comp-obsolete obsolete
./usr/include/dev/ofw/openfirm.h comp-obsolete obsolete
./usr/include/dev/ofw/openfirmio.h comp-c-include
+./usr/include/dev/pci/amrio.h comp-c-include
+./usr/include/dev/pci/amrreg.h comp-c-include
./usr/include/dev/pci/if_devar.h comp-obsolete obsolete
./usr/include/dev/pci/if_fxpreg.h comp-obsolete obsolete
./usr/include/dev/pci/if_fxpvar.h comp-obsolete obsolete
Index: distrib/sets/lists/man/mi
===================================================================
RCS file: /cvsroot/src/distrib/sets/lists/man/mi,v
retrieving revision 1.900
diff -u -r1.900 mi
--- distrib/sets/lists/man/mi 24 Jun 2006 12:38:29 -0000 1.900
+++ distrib/sets/lists/man/mi 24 Jun 2006 22:01:44 -0000
@@ -1712,6 +1712,7 @@
./usr/share/man/cat8/amiga/installboot.0 man-sysutil-catman .cat
./usr/share/man/cat8/amiga/makedev.0 man-obsolete obsolete
./usr/share/man/cat8/amq.0 man-amd-catman .cat
+./usr/share/man/cat8/amrstat.0 man-sysutil-man .cat
./usr/share/man/cat8/anvil.0 man-postfix-catman postfix,.cat
./usr/share/man/cat8/apm.0 man-sysutil-catman .cat
./usr/share/man/cat8/apmd.0 man-sysutil-catman .cat
@@ -4065,6 +4066,7 @@
./usr/share/man/man8/amiga/installboot.8 man-sysutil-man .man
./usr/share/man/man8/amiga/makedev.8 man-obsolete obsolete
./usr/share/man/man8/amq.8 man-amd-man .man
+./usr/share/man/man8/amrstat.8 man-sysutil-man .man
./usr/share/man/man8/anvil.8 man-postfix-man postfix,.man
./usr/share/man/man8/apm.8 man-sysutil-man .man
./usr/share/man/man8/apmd.8 man-sysutil-man .man
Index: etc/MAKEDEV.tmpl
===================================================================
RCS file: /cvsroot/src/etc/MAKEDEV.tmpl,v
retrieving revision 1.53
diff -u -r1.53 MAKEDEV.tmpl
--- etc/MAKEDEV.tmpl 19 Jun 2006 15:44:35 -0000 1.53
+++ etc/MAKEDEV.tmpl 24 Jun 2006 22:01:46 -0000
@@ -223,6 +223,7 @@
# ad* UNIBUS interface to Data Translation A/D converter
# agp* AGP GART devices
# altq ALTQ control interface
+# amr* AMI MegaRaid control device
# apm power management device
# audio* audio devices
# bell* OPM bell device (x68k)
@@ -1007,6 +1008,11 @@
mkdev radio$unit c %radio_chr% $unit 666
;;
+amr*)
+ unit=${i#amr}
+ mkdev amr$unit c %amr_chr% $unit
+ ;;
+
apm)
mkdev apm c %apm_chr% 0 644
mkdev apmctl c %apm_chr% 8 644
Index: etc/etc.amd64/MAKEDEV.conf
===================================================================
RCS file: /cvsroot/src/etc/etc.amd64/MAKEDEV.conf,v
retrieving revision 1.6
diff -u -r1.6 MAKEDEV.conf
--- etc/etc.amd64/MAKEDEV.conf 2 Dec 2004 16:44:28 -0000 1.6
+++ etc/etc.amd64/MAKEDEV.conf 24 Jun 2006 22:01:46 -0000
@@ -8,7 +8,7 @@
makedev bpf
makedev ccd0 md0 ch0 random
makedev cgd0 cgd1
- makedev iop0 mlx0 mly0 dpti0 dpt0 twe0
+ makedev amr0 iop0 mlx0 mly0 dpti0 dpt0 twe0
makedev raid0
makedev ld0 ld1 ld2 ld3
makedev usbs
Index: etc/etc.i386/MAKEDEV.conf
===================================================================
RCS file: /cvsroot/src/etc/etc.i386/MAKEDEV.conf,v
retrieving revision 1.7
diff -u -r1.7 MAKEDEV.conf
--- etc/etc.i386/MAKEDEV.conf 19 Jun 2006 15:44:35 -0000 1.7
+++ etc/etc.i386/MAKEDEV.conf 24 Jun 2006 22:01:46 -0000
@@ -8,7 +8,7 @@
makedev bpf
makedev ccd0 md0 ch0 random
makedev cgd0 cgd1
- makedev iop0 mlx0 mly0 dpti0 dpt0 twe0 icp0
+ makedev amr0 iop0 mlx0 mly0 dpti0 dpt0 twe0 icp0
makedev ed0 ed1
makedev raid0
makedev ld0 ld1 ld2 ld3
Index: sbin/Makefile
===================================================================
RCS file: /cvsroot/src/sbin/Makefile,v
retrieving revision 1.99
diff -u -r1.99 Makefile
--- sbin/Makefile 25 Feb 2006 01:34:16 -0000 1.99
+++ sbin/Makefile 24 Jun 2006 22:02:32 -0000
@@ -6,7 +6,7 @@
.include <bsd.own.mk>
-SUBDIR= atactl badsect bim brconfig ccdconfig disklabel dkctl dmesg \
+SUBDIR= amrstat atactl badsect bim brconfig ccdconfig disklabel dkctl dmesg \
drvctl edlabel fastboot fdisk fsck fsirand ifconfig init ldconfig \
mbrlabel mknod modload modunload mount newbtconf nologin \
pdisk ping pppoectl raidctl reboot rcorder rndctl route routed \
Index: sys/conf/majors
===================================================================
RCS file: /cvsroot/src/sys/conf/majors,v
retrieving revision 1.22
diff -u -r1.22 majors
--- sys/conf/majors 14 May 2006 21:25:21 -0000 1.22
+++ sys/conf/majors 24 Jun 2006 22:02:46 -0000
@@ -24,3 +24,4 @@
device-major ucycom char 172 ucycom
device-major gpio char 173 gpio
device-major utoppy char 174 utoppy
+device-major amr char 175 amr
Index: sys/dev/pci/Makefile
===================================================================
RCS file: /cvsroot/src/sys/dev/pci/Makefile,v
retrieving revision 1.11
diff -u -r1.11 Makefile
--- sys/dev/pci/Makefile 6 Dec 2005 11:53:56 -0000 1.11
+++ sys/dev/pci/Makefile 24 Jun 2006 22:02:47 -0000
@@ -5,7 +5,7 @@
INCSDIR= /usr/include/dev/pci
# Only install includes which are used by userland
-INCS= if_lmc.h mlyio.h mlyreg.h \
+INCS= amrreg.h amrio.h if_lmc.h mlyio.h mlyreg.h \
pcidevs.h pcidevs_data.h pciio.h pcireg.h \
tgareg.h twereg.h tweio.h
Index: sys/dev/pci/amr.c
===================================================================
RCS file: /cvsroot/src/sys/dev/pci/amr.c,v
retrieving revision 1.35
diff -u -r1.35 amr.c
--- sys/dev/pci/amr.c 7 Jun 2006 22:33:36 -0000 1.35
+++ sys/dev/pci/amr.c 24 Jun 2006 22:02:47 -0000
@@ -81,6 +81,7 @@
#include <sys/proc.h>
#include <sys/buf.h>
#include <sys/malloc.h>
+#include <sys/conf.h>
#include <sys/kthread.h>
#include <uvm/uvm_extern.h>
@@ -92,6 +93,7 @@
#include <dev/pci/pcivar.h>
#include <dev/pci/amrreg.h>
#include <dev/pci/amrvar.h>
+#include <dev/pci/amrio.h>
#include "locators.h"
@@ -115,9 +117,20 @@
static int amr_std_get_work(struct amr_softc *, struct amr_mailbox_resp *);
static int amr_std_submit(struct amr_softc *, struct amr_ccb *);
+static dev_type_open(amropen);
+static dev_type_close(amrclose);
+static dev_type_ioctl(amrioctl);
+
CFATTACH_DECL(amr, sizeof(struct amr_softc),
amr_match, amr_attach, NULL, NULL);
+const struct cdevsw amr_cdevsw = {
+ amropen, amrclose, noread, nowrite, amrioctl,
+ nostop, notty, nopoll, nommap,
+};
+
+extern struct cfdriver amr_cd;
+
#define AT_QUARTZ 0x01 /* `Quartz' chipset */
#define AT_SIG 0x02 /* Check for signature */
@@ -260,7 +273,7 @@
const char *intrstr;
pcireg_t reg;
int rseg, i, j, size, rv, memreg, ioreg;
- struct amr_ccb *ac;
+ struct amr_ccb *ac;
int locs[AMRCF_NLOCS];
aprint_naive(": RAID controller\n");
@@ -719,7 +732,7 @@
static void
amr_shutdown(void *cookie)
{
- extern struct cfdriver amr_cd;
+ extern struct cfdriver amr_cd;
struct amr_softc *amr;
struct amr_ccb *ac;
int i, rv, s;
@@ -1305,3 +1318,110 @@
printf("%08x ", ((u_int32_t *)&ac->ac_cmd)[i]);
printf("\n");
}
+
+static int
+amropen(dev_t dev, int flag, int mode, struct lwp *l)
+{
+ struct amr_softc *amr;
+
+ if ((amr = device_lookup(&amr_cd, minor(dev))) == NULL)
+ return (ENXIO);
+ if ((amr->amr_flags & AMRF_OPEN) != 0)
+ return (EBUSY);
+
+ amr->amr_flags |= AMRF_OPEN;
+ return (0);
+}
+
+static int
+amrclose(dev_t dev, int flag, int mode, struct lwp *l)
+{
+ struct amr_softc *amr;
+
+ amr = device_lookup(&amr_cd, minor(dev));
+ amr->amr_flags &= ~AMRF_OPEN;
+ return (0);
+}
+
+static int
+amrioctl(dev_t dev, u_long cmd, caddr_t data, int flag, struct lwp *l)
+{
+ struct amr_softc *amr;
+ struct amr_user_ioctl *au;
+ int *versionp;
+ struct amr_ccb *ac;
+ struct amr_mailbox_ioctl *mbi;
+ void *dp = NULL, *au_buffer;
+ unsigned long au_length;
+ unsigned char*au_cmd;
+ int error, s;
+
+ if (securelevel >= 2)
+ return (EPERM);
+
+ amr = device_lookup(&amr_cd, minor(dev));
+
+ /* This should be compatible with the FreeBSD interface */
+
+ switch(cmd) {
+ case AMR_IO_VERSION:
+ versionp = (void *)data;
+ *versionp = AMR_IO_VERSION_NUMBER;
+ return 0;
+ case AMR_IO_COMMAND:
+ au = (void *)data;
+ au_cmd = au->au_cmd;
+ au_buffer = au->au_buffer;
+ au_length = au->au_length;
+ break;
+ default:
+ return EINVAL;
+ }
+
+ if (au_cmd[0] == AMR_CMD_PASS) {
+ /* not yet */
+ return EOPNOTSUPP;
+ }
+
+ if (au_length != 0 && au_cmd[0] != 0x06) {
+ dp = malloc(au_length, M_DEVBUF, M_WAITOK|M_ZERO);
+ if (dp == NULL)
+ return ENOMEM;
+ if ((error = copyin(au_buffer, dp, au_length)) != 0) {
+ free(dp, M_DEVBUF);
+ return (error);
+ }
+ }
+ /* direct command to controller */
+ s = splbio();
+ while (amr_ccb_alloc(amr, &ac) != 0) {
+ error = tsleep(NULL, PRIBIO | PCATCH, "armmbx", hz);
+ if (error == EINTR)
+ goto out;
+ }
+
+ mbi = (struct amr_mailbox_ioctl *)&ac->ac_cmd;
+ /* copy pertinent mailbox items */
+ mbi->mb_command = au_cmd[0];
+ mbi->mb_channel = au_cmd[1];
+ mbi->mb_param = au_cmd[2];
+ mbi->mb_pad[0] = au_cmd[3];
+ mbi->mb_drive = au_cmd[4];
+ /* build the command */
+ error = amr_ccb_map(amr, ac, dp, au_length, 0);
+ if (error)
+ goto out;
+ error = amr_ccb_wait(amr, ac);
+ amr_ccb_unmap(amr, ac);
+ amr_ccb_free(amr, ac);
+ if (error)
+ goto out;
+ if (au_length != 0) {
+ error = copyout(dp, au_buffer, au_length);
+ }
+out:
+ splx(s);
+ if (dp)
+ free(dp, M_DEVBUF);
+ return error;
+}
Index: sys/dev/pci/amrreg.h
===================================================================
RCS file: /cvsroot/src/sys/dev/pci/amrreg.h,v
retrieving revision 1.2
diff -u -r1.2 amrreg.h
--- sys/dev/pci/amrreg.h 4 May 2003 16:15:36 -0000 1.2
+++ sys/dev/pci/amrreg.h 24 Jun 2006 22:02:47 -0000
@@ -319,6 +319,7 @@
u_int32_t ae_drivesize[AMR_40LD_MAXDRIVES]; /* logical drive size */
u_int8_t ae_driveprop[AMR_40LD_MAXDRIVES]; /* logical drive properties */
u_int8_t ae_drivestate[AMR_40LD_MAXDRIVES]; /* physical drive state */
+ u_int8_t ae_pdrivestate[AMR_40LD_MAXPHYSDRIVES]; /* physical drive state */
u_int16_t ae_driveformat[AMR_40LD_MAXPHYSDRIVES];
u_int8_t ae_targxfer[80]; /* physical drive transfer rates */
Index: sys/dev/pci/amrvar.h
===================================================================
RCS file: /cvsroot/src/sys/dev/pci/amrvar.h,v
retrieving revision 1.5
diff -u -r1.5 amrvar.h
--- sys/dev/pci/amrvar.h 11 Dec 2005 12:22:48 -0000 1.5
+++ sys/dev/pci/amrvar.h 24 Jun 2006 22:02:47 -0000
@@ -107,6 +107,7 @@
/* General flags. */
#define AMRF_THREAD_EXIT 0x00010000
+#define AMRF_OPEN 0x00020000
/*
* Command control block.
--- /dev/null Sun Jun 25 00:07:56 2006
+++ sys/dev/pci/amrio.h Sat Jun 24 16:45:00 2006
@@ -0,0 +1,124 @@
+/* $NetBSD: $ */
+
+/*-
+ * Copyright (c) 1999 Michael Smith
+ * 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.
+ *
+ * Copyright (c) 2002 Eric Moore
+ * Copyright (c) 2002 LSI Logic Corporation
+ * 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.
+ * 3. The party using or redistributing the source code and binary forms
+ * agrees to the disclaimer below and the terms and conditions set forth
+ * herein.
+ *
+ * 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: src/sys/dev/amr/amrio.h,v 1.7 2005/12/14 03:26:49 scottl Exp
+ */
+
+/*
+ * ioctl interface
+ */
+
+#include <sys/ioccom.h>
+#include <sys/param.h>
+
+/*
+ * Fetch the driver's interface version.
+ */
+#define AMR_IO_VERSION_NUMBER 153
+#define AMR_IO_VERSION _IOR('A', 0x200, int)
+
+/*
+ * Pass a command from userspace through to the adapter.
+ *
+ * Note that in order to be code-compatible with the Linux
+ * interface where possible, the formatting of the au_cmd field is
+ * somewhat Interesting.
+ *
+ * For normal commands, the layout is (fields from struct amr_mailbox_ioctl):
+ *
+ * 0 mb_command
+ * 1 mb_channel
+ * 2 mb_param
+ * 3 mb_pad[0]
+ * 4 mb_drive
+ *
+ * For SCSI passthrough commands, the layout is:
+ *
+ * 0 AMR_CMD_PASS (0x3)
+ * 1 reserved, 0
+ * 2 cdb length
+ * 3 cdb data
+ * 3+cdb_len passthrough control byte (timeout, ars, islogical)
+ * 4+cdb_len reserved, 0
+ * 5+cdb_len channel
+ * 6+cdb_len target
+ */
+
+struct amr_user_ioctl {
+ unsigned char au_cmd[32]; /* command text from userspace */
+ void *au_buffer; /* data buffer in userspace */
+ unsigned long au_length; /* data buffer size (0 == no data) */
+ int au_direction; /* data transfer direction */
+#define AMR_IO_NODATA 0
+#define AMR_IO_READ 1
+#define AMR_IO_WRITE 2
+ int au_status; /* command status returned by adapter */
+};
+
+#define AMR_IO_COMMAND _IOWR('A', 0x201, struct amr_user_ioctl)
+
+#if 0 /* defined(__amd64__) || defined(__ia64__) */
+
+struct amr_user_ioctl32 {
+ unsigned char au_cmd[32]; /* command text from userspace */
+ u_int32_t au_buffer; /* 32-bit pointer to uspace buf */
+ u_int32_t au_length; /* length of the uspace buffer */
+ int32_t au_direction; /* data transfer direction */
+ int32_t au_status; /* command status returned by adapter */
+};
+
+# define AMR_IO_COMMAND32 _IOWR('A', 0x201, struct amr_user_ioctl32)
+#endif
--- /dev/null Sun Jun 25 00:07:56 2006
+++ sbin/amrstat/Makefile Sat Jun 24 16:41:21 2006
@@ -0,0 +1,6 @@
+# $NetBSD: Makefile,v 1.1 2000/11/04 18:53:30 thorpej Exp $
+
+PROG= amrstat
+MAN= amrstat.8
+
+.include <bsd.prog.mk>
--- /dev/null Sun Jun 25 00:07:56 2006
+++ sbin/amrstat/amrstat.c Sat Jun 24 19:00:07 2006
@@ -0,0 +1,678 @@
+/*-
+ * Copyright (c) 2002, Pierre David <Pierre.David@crc.u-strasbg.fr>
+ * Copyright (c) 2006, Jung-uk Kim <jkim@FreeBSD.org>
+ * 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 unmodified, 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 ``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.
+ */
+
+#include <sys/cdefs.h>
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <fcntl.h>
+#include <errno.h>
+#include <unistd.h>
+
+#include <sys/ioctl.h>
+
+#include <machine/param.h>
+
+#include <dev/pci/amrio.h>
+#include <dev/pci/amrreg.h>
+
+#define NATTEMPTS 5
+#define SLEEPTIME 100000 /* microseconds */
+
+int nattempts = NATTEMPTS; /* # of attempts before giving up */
+int sleeptime = SLEEPTIME; /* between attempts, in ms */
+
+#define AMR_BUFSIZE 1024
+
+int enq_result = AMR_STATUS_FAILED;
+char enq_buffer[AMR_BUFSIZE];
+
+#define AMR_MAX_NCTRLS 16
+#define AMR_MAX_NSDEVS 16
+
+u_int8_t nschan = 0;
+
+/*
+ * Include lookup tables, and a function to match a code to a string.
+ *
+ * XXX Lookup tables cannot be included, since they require symbols from
+ * amrreg.h which need in turn the _KERNEL define.
+ */
+
+/* #define AMR_DEFINE_TABLES */
+/* #include "amr_tables.h" */
+
+int amr_ioctl_enquiry(int, u_int8_t, u_int8_t, u_int8_t);
+void usage(char *);
+int describe_card(int, int, int);
+char * describe_property(u_int8_t, char *);
+const char * describe_state(int, u_int8_t);
+void describe_battery(int, int, int, int, int);
+void describe_one_volume(int, int, u_int32_t, u_int8_t, u_int8_t);
+void describe_one_drive(int, int, u_int8_t);
+void describe_drive(int, int, int, int, int);
+
+/*
+ * Offsets in an amr_user_ioctl.au_cmd [] array See amrio.h
+ */
+
+#define MB_COMMAND 0
+#define MB_CHANNEL 1
+#define MB_PARAM 2
+#define MB_PAD 3
+#define MB_DRIVE 4
+
+#define FIRMWARE_40LD 1
+#define FIRMWARE_8LD 2
+
+static struct {
+ const char *product;
+ const int signature;
+} prodtable[] = {
+ { "Series 431", AMR_SIG_431 },
+ { "Series 438", AMR_SIG_438 },
+ { "Series 762", AMR_SIG_762 },
+ { "Integrated HP NetRAID (T5)", AMR_SIG_T5 },
+ { "Series 466", AMR_SIG_466 },
+ { "Series 467", AMR_SIG_467 },
+ { "Integrated HP NetRAID (T7)", AMR_SIG_T7 },
+ { "Series 490", AMR_SIG_490 }
+};
+
+static struct {
+ const int code;
+ const char *ifyes, *ifno;
+} proptable[] = {
+ { AMR_DRV_WRITEBACK,
+ "writeback", "write-through" },
+ { AMR_DRV_READHEAD,
+ "read-ahead", "no-read-ahead" },
+ { AMR_DRV_ADAPTIVE,
+ "adaptative-io", "no-adaptative-io" }
+};
+
+static struct {
+ const int code;
+ const char *status;
+} statetable[] = {
+ { AMR_DRV_OFFLINE, "offline" },
+ { AMR_DRV_DEGRADED, "degraded" },
+ { AMR_DRV_OPTIMAL, "optimal" },
+ { AMR_DRV_ONLINE, "online" },
+ { AMR_DRV_FAILED, "failed" },
+ { AMR_DRV_REBUILD, "rebuild" },
+ { AMR_DRV_HOTSPARE, "hotspare" }
+};
+
+static struct {
+ const u_int8_t code;
+ const char *status;
+} battable[] = {
+ { AMR_BATT_MODULE_MISSING, "not present" },
+ { AMR_BATT_LOW_VOLTAGE, "low voltage" },
+ { AMR_BATT_TEMP_HIGH, "high temperature" },
+ { AMR_BATT_PACK_MISSING, "pack missing" },
+ { AMR_BATT_CYCLES_EXCEEDED, "cycle exceeded" }
+};
+
+static struct {
+ const u_int8_t code;
+ const char *status;
+} bcstatble[] = {
+ { AMR_BATT_CHARGE_DONE, "charge done" },
+ { AMR_BATT_CHARGE_INPROG, "charge in progress" },
+ { AMR_BATT_CHARGE_FAIL, "charge failed" }
+};
+
+#define NTAB(tab) (sizeof tab / sizeof tab [0])
+
+int
+amr_ioctl_enquiry(int fd, u_int8_t cmd, u_int8_t cmdsub, u_int8_t cmdqual)
+{
+ struct amr_user_ioctl am;
+ int r, i;
+
+ am.au_cmd[MB_COMMAND] = cmd;
+ am.au_cmd[MB_CHANNEL] = cmdsub;
+ am.au_cmd[MB_PARAM] = cmdqual;
+ am.au_cmd[MB_PAD] = 0;
+ am.au_cmd[MB_DRIVE] = 0;
+
+ am.au_buffer = enq_buffer;
+ am.au_length = AMR_BUFSIZE;
+ am.au_direction = AMR_IO_READ;
+ am.au_status = 0;
+
+ i = 0;
+ r = -1;
+ while (i < nattempts && r == -1) {
+ r = ioctl(fd, AMR_IO_COMMAND, &am);
+ if (r == -1) {
+ if (errno != EBUSY) {
+ perror("ioctl enquiry");
+ exit(1);
+ } else
+ usleep(sleeptime);
+ }
+ i++;
+ }
+ return am.au_status;
+}
+
+void
+usage(char *prog)
+{
+ fprintf(stderr, "usage: %s [-a num] [-b] "
+ "[-c ctlr|-f dev] [-g] [-l vol]\n\t\t"
+ "[-p drive|-s bus[:target]] [-t usec] [-v]\n\n\t"
+ "-a num\t\tnumber of retries\n\t"
+ "-b\t\tbattery status\n\t"
+ "-c ctrl\t\tcontroller ID\n\t"
+ "-f dev\t\tdevice path\n\t"
+ "-g\t\tprint global parameters\n\t"
+ "-l vol\t\tlogical volume ID\n\t"
+ "-p drive\tphysical drive ID\n\t"
+ "-s bus[:target]\tSCSI bus (and optinal target)\n\t"
+ "-t usec\t\tsleep time between retries\n\t"
+ "-v\t\tverbose output\n",
+ prog);
+ exit(1);
+}
+
+/******************************************************************************
+ * Card description
+ */
+
+int
+describe_card(int fd, int verbosity, int globalparam)
+{
+ struct amr_enquiry *ae;
+ int cardtype;
+
+ /*
+ * Try the 40LD firmware interface
+ */
+
+ enq_result = amr_ioctl_enquiry(fd, AMR_CMD_CONFIG,
+ AMR_CONFIG_PRODUCT_INFO, 0);
+ if (enq_result == AMR_STATUS_SUCCESS) {
+ struct amr_prodinfo *ap;
+
+ ap = (struct amr_prodinfo *)enq_buffer;
+ nschan = ap->ap_nschan;
+ if (globalparam) {
+ printf("Product\t\t\t<%.80s>\n", ap->ap_product);
+ printf("Firmware\t\t%.16s\n", ap->ap_firmware);
+ printf("BIOS\t\t\t%.16s\n", ap->ap_bios);
+ printf("SCSI channels\t\t%d\n", ap->ap_nschan);
+ printf("Fibre loops\t\t%d\n", ap->ap_fcloops);
+ printf("Memory size\t\t%d MB\n", ap->ap_memsize);
+ if (verbosity >= 1) {
+ printf("Ioctl\t\t\t%d (%s)\n", FIRMWARE_40LD,
+ "40LD");
+ printf("Signature\t\t0x%08x\n",
+ ap->ap_signature);
+ printf("Configsig\t\t0x%08x\n",
+ ap->ap_configsig);
+ printf("Subsystem\t\t0x%04x\n",
+ ap->ap_subsystem);
+ printf("Subvendor\t\t0x%04x\n",
+ ap->ap_subvendor);
+ printf("Notify counters\t\t%d\n",
+ ap->ap_numnotifyctr);
+ }
+ }
+ return FIRMWARE_40LD;
+ }
+ /*
+ * Try the 8LD firmware interface
+ */
+
+ enq_result = amr_ioctl_enquiry(fd, AMR_CMD_EXT_ENQUIRY2, 0, 0);
+ ae = (struct amr_enquiry *)enq_buffer;
+ if (enq_result == AMR_STATUS_SUCCESS) {
+ cardtype = ae->ae_signature;
+ } else {
+ enq_result = amr_ioctl_enquiry(fd, AMR_CMD_ENQUIRY, 0, 0);
+ cardtype = 0;
+ }
+
+ if (enq_result == AMR_STATUS_SUCCESS) {
+
+ if (globalparam) {
+ const char *product = NULL;
+ char bios[100], firmware[100];
+ int i;
+
+ for (i = 0; i < NTAB(prodtable); i++) {
+ if (cardtype == prodtable[i].signature) {
+ product = prodtable[i].product;
+ break;
+ }
+ }
+ if (product == NULL)
+ product = "unknown card signature";
+
+ /*
+ * HP NetRaid controllers have a special encoding of
+ * the firmware and BIOS versions. The AMI version
+ * seems to have it as strings whereas the HP version
+ * does it with a leading uppercase character and two
+ * binary numbers.
+ */
+
+ if (ae->ae_adapter.aa_firmware[2] >= 'A' &&
+ ae->ae_adapter.aa_firmware[2] <= 'Z' &&
+ ae->ae_adapter.aa_firmware[1] < ' ' &&
+ ae->ae_adapter.aa_firmware[0] < ' ' &&
+ ae->ae_adapter.aa_bios[2] >= 'A' &&
+ ae->ae_adapter.aa_bios[2] <= 'Z' &&
+ ae->ae_adapter.aa_bios[1] < ' ' &&
+ ae->ae_adapter.aa_bios[0] < ' ') {
+
+ /*
+ * looks like we have an HP NetRaid version
+ * of the MegaRaid
+ */
+
+ if (cardtype == AMR_SIG_438) {
+ /*
+ * the AMI 438 is a NetRaid 3si in
+ * HP-land
+ */
+ product = "HP NetRaid 3si";
+ }
+ sprintf(firmware, "%c.%02d.%02d",
+ ae->ae_adapter.aa_firmware[2],
+ ae->ae_adapter.aa_firmware[1],
+ ae->ae_adapter.aa_firmware[0]);
+ sprintf(bios, "%c.%02d.%02d",
+ ae->ae_adapter.aa_bios[2],
+ ae->ae_adapter.aa_bios[1],
+ ae->ae_adapter.aa_bios[0]);
+ } else {
+ sprintf(firmware, "%.4s",
+ ae->ae_adapter.aa_firmware);
+ sprintf(bios, "%.4s", ae->ae_adapter.aa_bios);
+ }
+
+ printf("Ioctl = %d (%s)\n", FIRMWARE_8LD, "8LD");
+ printf("Product =\t<%s>\n", product);
+ printf("Firmware =\t%s\n", firmware);
+ printf("BIOS =\t%s\n", bios);
+ /* printf ("SCSI Channels =\t%d\n", ae->ae_nschan); */
+ /* printf ("Fibre Loops =\t%d\n", ae->ae_fcloops); */
+ printf("Memory size =\t%d MB\n",
+ ae->ae_adapter.aa_memorysize);
+ /*
+ * printf ("Notify counters =\t%d\n",
+ * ae->ae_numnotifyctr) ;
+ */
+ }
+ return FIRMWARE_8LD;
+ }
+ /*
+ * Neither firmware interface succeeded. Abort.
+ */
+
+ fprintf(stderr, "Firmware interface not supported\n");
+ exit(1);
+
+}
+
+char *
+describe_property(u_int8_t prop, char *buffer)
+{
+ int i;
+
+ strcpy(buffer, "<");
+ for (i = 0; i < NTAB(proptable); i++) {
+ if (i > 0)
+ strcat(buffer, ",");
+ if (prop & proptable[i].code)
+ strcat(buffer, proptable[i].ifyes);
+ else
+ strcat(buffer, proptable[i].ifno);
+ }
+ strcat(buffer, ">");
+
+ return buffer;
+}
+
+const char *
+describe_state(int verbosity, u_int8_t state)
+{
+ int i;
+
+ if ((AMR_DRV_PREVSTATE(state) == AMR_DRV_CURSTATE(state)) &&
+ (AMR_DRV_CURSTATE(state) == AMR_DRV_OFFLINE) && verbosity == 0)
+ return NULL;
+
+ for (i = 0; i < NTAB(statetable); i++)
+ if (AMR_DRV_CURSTATE(state) == statetable[i].code)
+ return (statetable[i].status);
+
+ return NULL;
+}
+
+/******************************************************************************
+ * Battery status
+ */
+void
+describe_battery(int fd, int verbosity, int fwint, int bflags, int globalparam)
+{
+ u_int8_t batt_status;
+ int i;
+
+ if (fwint == FIRMWARE_40LD) {
+ enq_result = amr_ioctl_enquiry(fd, AMR_CMD_CONFIG,
+ AMR_CONFIG_ENQ3, AMR_CONFIG_ENQ3_SOLICITED_FULL);
+ if (enq_result == AMR_STATUS_SUCCESS) {
+ struct amr_enquiry3 *ae3;
+
+ ae3 = (struct amr_enquiry3 *)enq_buffer;
+ if (bflags || globalparam) {
+ batt_status = ae3->ae_batterystatus;
+ printf("Battery status\t\t");
+ for (i = 0; i < NTAB(battable); i++) {
+ if (batt_status & battable[i].code)
+ printf("%s, ", battable[i].status);
+ }
+ if (!(batt_status &
+ (AMR_BATT_MODULE_MISSING|AMR_BATT_PACK_MISSING))) {
+ for (i = 0; i < NTAB(bcstatble); i++)
+ if (bcstatble[i].code ==
+ (batt_status & AMR_BATT_CHARGE_MASK))
+ printf("%s", bcstatble[i].status);
+ } else
+ printf("charge unknown");
+ if (verbosity)
+ printf(" (0x%02x)", batt_status);
+ printf("\n");
+ }
+ }
+ } else if (fwint == FIRMWARE_8LD) {
+ /* Nothing to do here. */
+ return;
+ } else {
+ fprintf(stderr, "Firmware interface not supported.\n");
+ exit(1);
+ }
+
+ return;
+}
+
+/******************************************************************************
+ * Logical volumes
+ */
+
+void
+describe_one_volume(int ldrv, int verbosity,
+ u_int32_t size, u_int8_t state, u_int8_t prop)
+{
+ float szgb;
+ int raid_level;
+ char propstr[MAXPATHLEN];
+ const char *statestr;
+
+ szgb = ((float)size) / (1024 * 1024 * 2); /* size in GB */
+
+ raid_level = prop & AMR_DRV_RAID_MASK;
+
+ printf("Logical volume %d\t", ldrv);
+ statestr = describe_state(verbosity, state);
+ printf("%s ", statestr);
+ printf("(%.2f GB, RAID%d", szgb, raid_level);
+ if (verbosity >= 1) {
+ describe_property(prop, propstr);
+ printf(" %s", propstr);
+ }
+ printf(")\n");
+}
+
+/******************************************************************************
+ * Physical drives
+ */
+
+void
+describe_one_drive(int pdrv, int verbosity, u_int8_t state)
+{
+ const char *statestr;
+
+ statestr = describe_state(verbosity, state);
+ if (statestr) {
+ if (nschan > 0)
+ printf("Physical drive %d:%d\t%s\n",
+ pdrv / AMR_MAX_NSDEVS, pdrv % AMR_MAX_NSDEVS,
+ statestr);
+ else
+ printf("Physical drive %d:\t%s\n", pdrv, statestr);
+ }
+}
+
+void
+describe_drive(int verbosity, int fwint, int ldrv, int sbus, int sdev)
+{
+ int drv, pdrv = -1;
+
+ if (sbus > -1 && sdev > -1)
+ pdrv = (sbus * AMR_MAX_NSDEVS) + sdev;
+ if (nschan != 0) {
+ if (sbus > -1 && sbus >= nschan) {
+ fprintf(stderr, "SCSI channel %d does not exist.\n", sbus);
+ exit(1);
+ } else if (sdev > -1 && sdev >= AMR_MAX_NSDEVS) {
+ fprintf(stderr, "SCSI device %d:%d does not exist.\n",
+ sbus, sdev);
+ exit(1);
+ }
+ }
+ if (fwint == FIRMWARE_40LD) {
+ if (enq_result == AMR_STATUS_SUCCESS) {
+ struct amr_enquiry3 *ae3;
+
+ ae3 = (struct amr_enquiry3 *)enq_buffer;
+ if ((ldrv < 0 && sbus < 0) || ldrv >= 0) {
+ if (ldrv >= ae3->ae_numldrives) {
+ fprintf(stderr, "Logical volume %d "
+ "does not exist.\n", ldrv);
+ exit(1);
+ }
+ if (ldrv < 0) {
+ for (drv = 0;
+ drv < ae3->ae_numldrives;
+ drv++)
+ describe_one_volume(drv,
+ verbosity,
+ ae3->ae_drivesize[drv],
+ ae3->ae_drivestate[drv],
+ ae3->ae_driveprop[drv]);
+ } else {
+ describe_one_volume(ldrv,
+ verbosity,
+ ae3->ae_drivesize[ldrv],
+ ae3->ae_drivestate[ldrv],
+ ae3->ae_driveprop[ldrv]);
+ }
+ }
+ if ((ldrv < 0 && sbus < 0) || sbus >= 0) {
+ if (pdrv >= AMR_40LD_MAXPHYSDRIVES ||
+ (nschan != 0 && pdrv >= (nschan * AMR_MAX_NSDEVS))) {
+ fprintf(stderr, "Physical drive %d "
+ "is out of range.\n", pdrv);
+ exit(1);
+ }
+ if (sbus < 0) {
+ for (drv = 0;
+ drv < AMR_40LD_MAXPHYSDRIVES;
+ drv++) {
+ if (nschan != 0 &&
+ drv >= (nschan * AMR_MAX_NSDEVS))
+ break;
+ describe_one_drive(drv,
+ verbosity,
+ ae3->ae_pdrivestate[drv]);
+ }
+ } else if (sdev < 0) {
+ for (drv = sbus * AMR_MAX_NSDEVS;
+ drv < ((sbus + 1) * AMR_MAX_NSDEVS);
+ drv++) {
+ if (nschan != 0 &&
+ drv >= (nschan * AMR_MAX_NSDEVS))
+ break;
+ describe_one_drive(drv,
+ verbosity,
+ ae3->ae_pdrivestate[drv]);
+ }
+ } else {
+ if (nschan != 0 &&
+ pdrv < (nschan * AMR_MAX_NSDEVS))
+ describe_one_drive(pdrv, 1,
+ ae3->ae_pdrivestate[pdrv]);
+ }
+ }
+ }
+ } else if (fwint == FIRMWARE_8LD) {
+ /* Nothing to do here. */
+ return;
+ } else {
+ fprintf(stderr, "Firmware interface not supported.\n");
+ exit(1);
+ }
+}
+
+/******************************************************************************
+ * Main function
+ */
+
+int
+main(int argc, char *argv[])
+{
+ int i;
+ int fd = -1;
+ int globalparam = 0, verbosity = 0;
+ int bflags = 0, fflags = 0, sflags = 0;
+ int lvolno = -1, physno = -1;
+ int sbusno = -1, targetno = -1;
+ char filename[MAXPATHLEN];
+ char sdev[MAXPATHLEN];
+ char *pdev;
+
+ extern char *optarg;
+ extern int optind;
+
+ /*
+ * Parse arguments
+ */
+
+ while ((i = getopt(argc, argv, "a:bc:f:gl:p:s:t:v")) != -1)
+ switch (i) {
+ case 'a':
+ nattempts = atoi(optarg);
+ break;
+ case 'b':
+ bflags++;
+ break;
+ case 'f':
+ snprintf(filename, MAXPATHLEN, "%s", optarg);
+ filename[MAXPATHLEN - 1] = '\0';
+ fflags++;
+ break;
+ case 'g':
+ globalparam = 1;
+ break;
+ case 'l':
+ lvolno = atoi(optarg);
+ break;
+ case 'p':
+ physno = atoi(optarg);
+ break;
+ case 's':
+ snprintf(sdev, MAXPATHLEN, "%s", optarg);
+ sdev[MAXPATHLEN - 1] = '\0';
+ sflags++;
+ break;
+ case 't':
+ sleeptime = atoi(optarg);
+ break;
+ case 'v':
+ verbosity++;
+ break;
+ case '?':
+ default:
+ usage(argv[0]);
+ }
+ argc -= optind;
+ argv += optind;
+
+ if (argc != 0)
+ usage(argv[0]);
+
+ if (!fflags) {
+ snprintf(filename, MAXPATHLEN, "/dev/amr0");
+ }
+
+ fd = open(filename, O_RDONLY);
+ if (fd == -1) {
+ perror("open");
+ exit(1);
+ }
+ if (ioctl(fd, AMR_IO_VERSION, &i) == -1) {
+ perror("ioctl version");
+ exit(1);
+ }
+
+ if (sflags) {
+ if(physno > -1)
+ usage(argv[0]);
+ else {
+ sbusno = atoi(sdev);
+ if ((pdev = index(sdev, ':')))
+ targetno = atoi(++pdev);
+ }
+ } else if (physno > -1) {
+ sbusno = physno / AMR_MAX_NSDEVS;
+ targetno = physno % AMR_MAX_NSDEVS;
+ }
+
+ if (globalparam && verbosity >= 1)
+ printf("Version\t\t\t%d\n", i);
+#if 0
+ if (i != 1) {
+ fprintf(stderr, "Driver version (%d) not supported\n", i);
+ exit(1);
+ }
+#endif
+
+ i = describe_card(fd, verbosity, globalparam);
+ describe_battery(fd, verbosity, i, bflags, globalparam);
+ if (!bflags || lvolno > -1 || physno > -1 || sbusno > -1 || targetno > -1)
+ describe_drive(verbosity, i, lvolno, sbusno, targetno);
+
+ return 0;
+}
--- /dev/null Sun Jun 25 00:07:56 2006
+++ sbin/amrstat/amrstat.8 Sat Jun 24 17:48:55 2006
@@ -0,0 +1,96 @@
+.\" $NetBSD: $
+.\"
+.\" Copyright (c) 2006 Manuel Bouyer.
+.\"
+.\" 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.
+.\" 3. All advertising materials mentioning features or use of this software
+.\" must display the following acknowledgement:
+.\" This product includes software developed by Manuel Bouyer.
+.\" 4. 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.
+.\"
+.Dd June 24, 2006
+.Dt AMRSTAT 8
+.Os
+.Sh NAME
+.Nm amrstat
+.Nd Status report utility for AMI MegaRaid controllers
+.Sh SYNOPSIS
+.Nm
+.Op Fl bgv
+.Op Fl a Ar attempts
+.Op Fl f Ar device
+.Op Fl l Ar volno
+.Op Fl p Ar driveno
+.Op Fl s Ar busno
+.Op Fl s Ar busno:driveno
+.Op Fl t Ar microseconds
+.Sh DESCRIPTION
+.Nm
+reports various parameters from AMI MegaRaid controllers supported
+by the
+.Xr amr 4
+driver.
+.Pp
+The options are as follows:
+.Bl -tag -offset indent -width XpXperiodXX
+.It Fl a Ar attempts
+Number of retries for a command before giving up.
+Default 5.
+.It Fl b
+Report battery status.
+.It Fl f Ar device
+Device to use.
+Default to
+.Pa /dev/amr0 .
+.It Fl g
+Report global paramters for the controller.
+.It Fl l Ar volno
+Report status of a logical drive.
+.It Fl p Ar driveno
+Report status of a physical drive.
+.It Fl s Ar busno
+Report status of all physical drives on the specified bus.
+.It Fl s Ar busno:driveno
+Report status of the specified physical drive on the specified bus.
+.It Fl t Ar microseconds
+Delay between retries for a command.
+.It Fl v
+Increase verbosity level by one.
+.El
+.Sh SEE ALSO
+.Xr amr 4
+.Sh HISTORY
+The
+.Nm
+command first appeared in
+.Nx 4.0 .
+.Sh AUTHORS
+The
+.Nm
+command was written by
+.An Pierre David
+.Aq Pierre.David@crc.u-strasbg.fr
+and
+.An Jung-uk Kim
+.Aq jkim@FreeBSD.org
+for
+.Fx .
--nFreZHaLTZJo0R7j--