diff options
author | trhodes <trhodes@FreeBSD.org> | 2003-11-11 18:47:01 +0000 |
---|---|---|
committer | trhodes <trhodes@FreeBSD.org> | 2003-11-11 18:47:01 +0000 |
commit | eaa937bb8e64c1dd132f80a2d72c42a4c43c97de (patch) | |
tree | a0cc2611951c1dade10b7dfed75b98f0bf864a7d | |
parent | af4ffb5550f0a4d7d69305d9b05d886cc1696c26 (diff) | |
download | FreeBSD-src-eaa937bb8e64c1dd132f80a2d72c42a4c43c97de.zip FreeBSD-src-eaa937bb8e64c1dd132f80a2d72c42a4c43c97de.tar.gz |
Add a manual page for the ips(4) driver.
Requested by: obrien
Reviewed by: scottl (older version)
-rw-r--r-- | share/man/man4/ips.4 | 181 |
1 files changed, 181 insertions, 0 deletions
diff --git a/share/man/man4/ips.4 b/share/man/man4/ips.4 new file mode 100644 index 0000000..e294260 --- /dev/null +++ b/share/man/man4/ips.4 @@ -0,0 +1,181 @@ +.\" +.\" Copyright (c) 2003 Tom Rhodes +.\" 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$ +.\" +.Dd November 11, 2003 +.Dt IPS 4 +.Os +.Sh NAME +.Nm ips +.Nd IBM/Adaptec ServeRAID controller driver +.Sh SYNOPSIS +.Cd device scbus +.Cd device ips +.Sh DESCRIPTION +The +.Nm +driver claims to support the +.Tn IBM +(now Adaptec) ServeRAID series +.Tn SCSI +controller cards. +Some supported devices include: +.Pp +.Bl -item -compact +.It +IBM ServeRAID 3H +.It +ServeRAID 4L/4M/4H +.It +ServeRAID Series 5 +.It +ServeRAID 6i/6M +.El +.Pp +These cards come with a built in configuration utility stored in +the firmware known as the +.Tn ISPR . +This utility is accessed with the +.Em CTRL + I +key combination during the initial card +.Tn POST . +.Pp +It is highly recommended that this be used to configure the card +before attempting to diagnose the below error messages. +.Pp +In some cases, the +.Nm +driver can have difficulties attaching during +the system initialization period. +To avoid these difficulties, set the +.Pp +.Dl hw.ips.0.disable=1 +.Pp +.Xr sysctl +.Dq MIB +to prevent the driver from attaching. +.Sh DIAGNOSTICS +Several error codes may be shown when the card initializes the +.Tn IBM +.Tn ISPR +utility and are independent of +.Fx . +.Pp +.Bl -diag +.It ips%d: failed to get adapter configuration data from device +.It ips%d: failed to get drive configuration data from device +.Pp +Unable to obtain adapter or drive configuration. +.It ips%d iobuf error +.Pp +A buffer input/output error has occurred. +.Op ENXIO +.El +.Ss General adapter errors: +.Bl -diag +.It Attaching bus failed +.Pp +This message is undocumented. +.It WARNING: command timeout. Adapter is in toaster mode, resetting +.Pp +A command timeout has caused the adapter to be reset. +.It AIEE! adapter reset failed, giving up and going home! Have a nice day +.Pp +An error occurred while attempting to reset the adapter. +.It unable to get adapter configuration +.It unable to get drive configuration +.Pp +There was an error when attempting to get configuration information. +.It Adapter error during initialization. +.It adapter initialization failed +.Pp +There was an error while attempting to initialize the adapter. +.It adapter failed config check +.It adapter clear failed +.Pp +There was an error while checking the adapter. +.It device is disabled +.Pp +The adapter is disabled. +.It resource allocation failed +.It irq allocation failed +.It irq setup failed +.Pp +The driver was unable to allocate resources for the device. +.El +.Ss Error messages due to DMA: +.Bl -diag +.It can't alloc command dma tag +.It can't alloc SG dma tag +.It can't alloc dma tag for statue queue +.It dmamap failed +.Pp +Failure to map or allocate DMA resources. +.El +.Ss Cache, buffer, and command errors: +.Bl -diag +.It failed to initialize command buffers +.It no mem for command slots! +.Pp +The +.Nm +driver will return +.Op ENOMEM +in such cases. +.It ERROR: unable to get a command! can't flush cache! +.It ERROR: cache flush command failed! +.It ERROR: unable to get a command! can't update nvram +.It ERROR: nvram update command failed! +.It ERROR: unable to get a command! can't sync cache! +.It ERROR: cache sync command failed! +.It ERROR: unable to get a command! can't sync cache! +.It ERROR: etable command failed! +.El +.Sh COMPATIBILITY +Unlike many of the other +.Tn SCSI +devices in +.Fx , +the +.Nm +driver does not use the +.Xr cam 4 +.Tn SCSI +subsystem. +.Sh SEE ALSO +.Xr ch 4 , +.Xr da 4 , +.Xr sysctl 8 +.Sh AUTHORS +The +.Nm +driver was written by +.An -nosplit +.An David Jefferys +and +.An Scott Long Aq scottl@FreeBSD.org . +This manual page was written by +.An Tom Rhodes Aq trhodes@FreeBSD.org . |