share/man/man4/ips.4

   1 .\"
   2 .\" Copyright (c) 2003 Tom Rhodes
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\"
  14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24 .\" SUCH DAMAGE.
  25 .\"
  26 .\" $FreeBSD$
  27 .\"
  28 .Dd August 8, 2004
  29 .Dt IPS 4
  30 .Os
  31 .Sh NAME
  32 .Nm ips
  33 .Nd IBM/Adaptec ServeRAID controller driver
  34 .Sh SYNOPSIS
  35 .Cd device scbus
  36 .Cd device ips
  37 .Sh DESCRIPTION
  38 The
  39 .Nm
  40 driver claims to support the
  41 .Tn IBM
  42 (now Adaptec) ServeRAID series
  43 .Tn SCSI
  44 controller cards.
  45 .Pp
  46 These cards come with a built in configuration utility stored in
  47 the firmware known as the
  48 .Tn ISPR .
  49 This utility is accessed with the
  50 .Aq Em Ctrl+I
  51 key combination during the initial card
  52 .Tn POST .
  53 .Pp
  54 It is highly recommended that this utility be used to configure the card
  55 before attempting to diagnose the below error messages.
  56 .Pp
  57 In some cases, the
  58 .Nm
  59 driver can have difficulties attaching during
  60 the system initialization period.
  61 To avoid these difficulties, set the
  62 .Va hw.ips.0.disable
  63 tunable to 1.
  64 It will prevent the driver from attaching.
  65 .Sh HARDWARE
  66 Controllers supported by the
  67 .Nm
  68 driver include:
  69 .Pp
  70 .Bl -bullet -compact
  71 .It
  72 IBM ServeRAID 3H
  73 .It
  74 ServeRAID 4L/4M/4H
  75 .It
  76 ServeRAID Series 5
  77 .It
  78 ServeRAID 6i/6M
  79 .El
  80 .Sh DIAGNOSTICS
  81 Several error codes may be shown when the card initializes the
  82 .Tn IBM
  83 .Tn ISPR
  84 utility and are independent of
  85 .Fx .
  86 .Bl -diag
  87 .It ips%d: failed to get adapter configuration data from device
  88 .It ips%d: failed to get drive configuration data from device
  89 .Pp
  90 Unable to obtain adapter or drive configuration.
  91 .It ips%d iobuf error
  92 .Pp
  93 A buffer input/output error has occurred.
  94 .Bq Er ENXIO
  95 .El
  96 .Ss General adapter errors:
  97 .Bl -diag
  98 .It Attaching bus failed
  99 .Pp
 100 This message is undocumented.
 101 .It WARNING: command timeout. Adapter is in toaster mode, resetting
 102 .Pp
 103 A command timeout has caused the adapter to be reset.
 104 .It AIEE! adapter reset failed, giving up and going home! Have a nice day
 105 .Pp
 106 An error occurred while attempting to reset the adapter.
 107 .It unable to get adapter configuration
 108 .It unable to get drive configuration
 109 .Pp
 110 There was an error when attempting to get configuration information.
 111 .It Adapter error during initialization.
 112 .It adapter initialization failed
 113 .Pp
 114 There was an error while attempting to initialize the adapter.
 115 .It adapter failed config check
 116 .It adapter clear failed
 117 .Pp
 118 There was an error while checking the adapter.
 119 .It device is disabled
 120 .Pp
 121 The adapter is disabled.
 122 .It resource allocation failed
 123 .It irq allocation failed
 124 .It irq setup failed
 125 .Pp
 126 The driver was unable to allocate resources for the device.
 127 .El
 128 .Ss Error messages due to DMA:
 129 .Bl -diag
 130 .It can't alloc command dma tag
 131 .It can't alloc SG dma tag
 132 .It can't alloc dma tag for statue queue
 133 .It dmamap failed
 134 .Pp
 135 Failure to map or allocate DMA resources.
 136 .El
 137 .Ss Cache, buffer, and command errors:
 138 .Bl -diag
 139 .It failed to initialize command buffers
 140 .It no mem for command slots!
 141 .Pp
 142 The
 143 .Nm
 144 driver will return
 145 .Bq Er ENOMEM
 146 in such cases.
 147 .It ERROR: unable to get a command! can't flush cache!
 148 .It ERROR: cache flush command failed!
 149 .It ERROR: unable to get a command! can't update nvram
 150 .It ERROR: nvram update command failed!
 151 .It ERROR: unable to get a command! can't sync cache!
 152 .It ERROR: cache sync command failed!
 153 .It ERROR: unable to get a command! can't sync cache!
 154 .It ERROR: etable command failed!
 155 .El
 156 .Sh COMPATIBILITY
 157 Unlike many of the other
 158 .Tn SCSI
 159 devices in
 160 .Fx ,
 161 the
 162 .Nm
 163 driver does not use the
 164 .Xr cam 4
 165 .Tn SCSI
 166 subsystem.
 167 .Sh SEE ALSO
 168 .Xr ch 4 ,
 169 .Xr da 4 ,
 170 .Xr sysctl 8
 171 .Sh AUTHORS
 172 The
 173 .Nm
 174 driver was written by
 175 .An -nosplit
 176 .An David Jefferys
 177 and
 178 .An Scott Long Aq scottl@FreeBSD.org .
 179 .Pp
 180 This manual page was written by
 181 .An Tom Rhodes Aq trhodes@FreeBSD.org .