share/man/man4/mly.4

   1 .\"
   2 .\" Copyright (c) 2000 Michael Smith
   3 .\" Copyright (c) 2000 BSDi
   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: src/share/man/man4/mly.4,v 1.10 2006/05/20 09:39:28 brueffer Exp $
  26 .\" $DragonFly: src/share/man/man4/mly.4,v 1.4 2008/01/21 02:40:30 pavalos Exp $
  27 .\"
  28 .Dd August 10, 2004
  29 .Dt MLY 4
  30 .Os
  31 .Sh NAME
  32 .Nm mly
  33 .Nd Mylex AcceleRAID/eXtremeRAID family driver
  34 .Sh SYNOPSIS
  35 To compile this driver into the kernel,
  36 place the following lines in your
  37 kernel configuration file:
  38 .Bd -ragged -offset indent
  39 .Cd "device pci"
  40 .Cd "device scbus"
  41 .Cd "device da"
  42 .Cd "device mly"
  43 .Ed
  44 .Pp
  45 Alternatively, to load the driver as a
  46 module at boot time, place the following line in
  47 .Xr loader.conf 5 :
  48 .Bd -literal -offset indent
  49 mly_load="YES"
  50 .Ed
  51 .Sh DESCRIPTION
  52 The
  53 .Nm
  54 driver provides support for Mylex AcceleRAID and eXtremeRAID-family
  55 PCI to SCSI RAID controllers with version 6.00 and later
  56 firmware.
  57 .Pp
  58 Logical devices (array drives) attached to the controller are presented
  59 to the SCSI subsystem as though they were direct-access devices on a
  60 virtual SCSI bus.
  61 Physical devices which are not claimed by a logical
  62 device are presented on SCSI channels which match the physical channels
  63 on the controller.
  64 .Sh HARDWARE
  65 Controllers supported by the
  66 .Nm
  67 driver include:
  68 .Pp
  69 .Bl -bullet -compact
  70 .It
  71 Mylex AcceleRAID 160
  72 .It
  73 Mylex AcceleRAID 170
  74 .It
  75 Mylex AcceleRAID 352
  76 .It
  77 Mylex eXtremeRAID 2000
  78 .It
  79 Mylex eXtremeRAID 3000
  80 .El
  81 .Pp
  82 Compatible Mylex controllers not listed should work, but have not been
  83 verified.
  84 .Sh DIAGNOSTICS
  85 .Ss Controller initialisation phase
  86 .Bl -diag
  87 .It "mly%d: controller initialisation started"
  88 .It "mly%d: initialisation complete"
  89 .Pp
  90 The controller firmware has started initialisation.
  91 Normally this process is performed by the controller BIOS,
  92 but the driver may need
  93 to do this in cases where the BIOS has failed, or is not compatible
  94 (e.g.\& on non-x86 systems).
  95 .It "mly%d: drive spinup in progress"
  96 .Pp
  97 Drive startup is in progress; this may take several minutes.
  98 .It "mly%d: mirror race recovery failed, one or more drives offline"
  99 .It "mly%d: mirror race recovery in progress"
 100 .It "mly%d: mirror race recovery on a critical drive"
 101 .Pp
 102 These error codes are undocumented.
 103 .It "mly%d: FATAL MEMORY PARITY ERROR"
 104 .Pp
 105 Firmware detected a fatal memory error; the driver will not attempt to
 106 attach to this controller.
 107 .It "mly%d: unknown initialisation code %x"
 108 .Pp
 109 An unknown error occurred during initialisation; it will be ignored.
 110 .El
 111 .Ss Driver initialisation/shutdown phase
 112 .Bl -diag
 113 .It "mly%d: can't enable busmaster feature"
 114 .It "mly%d: memory window not available"
 115 .It "mly%d: can't allocate register window"
 116 .It "mly%d: can't allocate interrupt"
 117 .It "mly%d: can't set up interrupt"
 118 .Pp
 119 The system's PCI BIOS has not correctly configured the controller's
 120 PCI interface; initialisation has failed and the driver will not
 121 attach to this controller.
 122 .It "mly%d: can't allocate parent DMA tag"
 123 .It "mly%d: can't allocate buffer DMA tag"
 124 .It "mly%d: can't allocate command packet DMA tag"
 125 .It "mly%d: can't allocate scatter/gather DMA tag"
 126 .It "mly%d: can't allocate s/g table"
 127 .It "mly%d: can't allocate memory mailbox DMA tag"
 128 .It "mly%d: can't allocate memory mailbox"
 129 .Pp
 130 A resource allocation error occurred while initialising the driver;
 131 initialisation has failed and the driver will not attach to this
 132 controller.
 133 .It "mly%d: BTL rescan result corrupted"
 134 .Pp
 135 The results of a scan for an attached device were corrupted.
 136 One or more devices may not be correctly reported.
 137 .It "mly%d: flushing cache..."
 138 .Pp
 139 The controller cache is being flushed prior to detach or shutdown.
 140 .El
 141 .Ss Operational diagnostics
 142 .Bl -diag
 143 .It "mly%d: physical device %d:%d online"
 144 .It "mly%d: physical device %d:%d standby"
 145 .It "mly%d: physical device %d:%d automatic rebuild started"
 146 .It "mly%d: physical device %d:%d manual rebuild started"
 147 .It "mly%d: physical device %d:%d rebuild completed"
 148 .It "mly%d: physical device %d:%d rebuild cancelled"
 149 .It "mly%d: physical device %d:%d rebuild failed for unknown reasons"
 150 .It "mly%d: physical device %d:%d rebuild failed due to new physical device"
 151 .It "mly%d: physical device %d:%d rebuild failed due to logical drive failure"
 152 .It "mly%d: physical device %d:%d found"
 153 .It "mly%d: physical device %d:%d gone"
 154 .It "mly%d: physical device %d:%d unconfigured"
 155 .It "mly%d: physical device %d:%d expand capacity started"
 156 .It "mly%d: physical device %d:%d expand capacity completed"
 157 .It "mly%d: physical device %d:%d expand capacity failed"
 158 .It "mly%d: physical device %d:%d parity error"
 159 .It "mly%d: physical device %d:%d soft error"
 160 .It "mly%d: physical device %d:%d miscellaneous error"
 161 .It "mly%d: physical device %d:%d reset"
 162 .It "mly%d: physical device %d:%d active spare found"
 163 .It "mly%d: physical device %d:%d warm spare found"
 164 .It "mly%d: physical device %d:%d initialization started"
 165 .It "mly%d: physical device %d:%d initialization completed"
 166 .It "mly%d: physical device %d:%d initialization failed"
 167 .It "mly%d: physical device %d:%d initialization cancelled"
 168 .It "mly%d: physical device %d:%d write recovery failed"
 169 .It "mly%d: physical device %d:%d scsi bus reset failed"
 170 .It "mly%d: physical device %d:%d double check condition"
 171 .It "mly%d: physical device %d:%d device cannot be accessed"
 172 .It "mly%d: physical device %d:%d gross error on scsi processor"
 173 .It "mly%d: physical device %d:%d bad tag from device"
 174 .It "mly%d: physical device %d:%d command timeout"
 175 .It "mly%d: physical device %d:%d system reset"
 176 .It "mly%d: physical device %d:%d busy status or parity error"
 177 .It "mly%d: physical device %d:%d host set device to failed state"
 178 .It "mly%d: physical device %d:%d selection timeout"
 179 .It "mly%d: physical device %d:%d scsi bus phase error"
 180 .It "mly%d: physical device %d:%d device returned unknown status"
 181 .It "mly%d: physical device %d:%d device not ready"
 182 .It "mly%d: physical device %d:%d device not found at startup"
 183 .It "mly%d: physical device %d:%d COD write operation failed"
 184 .It "mly%d: physical device %d:%d BDT write operation failed"
 185 .It "mly%d: physical device %d:%d missing at startup"
 186 .It "mly%d: physical device %d:%d start rebuild failed due to physical drive too small"
 187 .It "mly%d: physical device %d:%d sense data received"
 188 .It "mly%d:   sense key %d  asc %02x  ascq %02x"
 189 .It "mly%d:   info %4D  csi %4D"
 190 .It "mly%d: physical device %d:%d offline"
 191 .It "mly%d:   sense key %d  asc %02x  ascq %02x"
 192 .It "mly%d:   info %4D  csi %4D"
 193 .Pp
 194 The reported event refers to the physical device at the given channel:target
 195 address.
 196 .It "mly%d: logical device %d (%s) consistency check started"
 197 .It "mly%d: logical device %d (%s) consistency check completed"
 198 .It "mly%d: logical device %d (%s) consistency check cancelled"
 199 .It "mly%d: logical device %d (%s) consistency check completed with errors"
 200 .It "mly%d: logical device %d (%s) consistency check failed due to logical drive failure"
 201 .It "mly%d: logical device %d (%s) consistency check failed due to physical device failure"
 202 .It "mly%d: logical device %d (%s) automatic rebuild started"
 203 .It "mly%d: logical device %d (%s) manual rebuild started"
 204 .It "mly%d: logical device %d (%s) rebuild completed"
 205 .It "mly%d: logical device %d (%s) rebuild cancelled"
 206 .It "mly%d: logical device %d (%s) rebuild failed for unknown reasons"
 207 .It "mly%d: logical device %d (%s) rebuild failed due to new physical device"
 208 .It "mly%d: logical device %d (%s) rebuild failed due to logical drive failure"
 209 .It "mly%d: logical device %d (%s) offline"
 210 .It "mly%d: logical device %d (%s) critical"
 211 .It "mly%d: logical device %d (%s) online"
 212 .It "mly%d: logical device %d (%s) initialization started"
 213 .It "mly%d: logical device %d (%s) initialization completed"
 214 .It "mly%d: logical device %d (%s) initialization cancelled"
 215 .It "mly%d: logical device %d (%s) initialization failed"
 216 .It "mly%d: logical device %d (%s) found"
 217 .It "mly%d: logical device %d (%s) gone"
 218 .It "mly%d: logical device %d (%s) expand capacity started"
 219 .It "mly%d: logical device %d (%s) expand capacity completed"
 220 .It "mly%d: logical device %d (%s) expand capacity failed"
 221 .It "mly%d: logical device %d (%s) bad block found"
 222 .It "mly%d: logical device %d (%s) size changed"
 223 .It "mly%d: logical device %d (%s) type changed"
 224 .It "mly%d: logical device %d (%s) bad data block found"
 225 .It "mly%d: logical device %d (%s) read of data block in bdt"
 226 .It "mly%d: logical device %d (%s) write back data for disk block lost"
 227 .Pp
 228 The event report will include the name of the SCSI device which has
 229 attached to the device if possible.
 230 .It "mly%d: enclosure %d fan %d failed"
 231 .It "mly%d: enclosure %d fan %d ok"
 232 .It "mly%d: enclosure %d fan %d not present"
 233 .It "mly%d: enclosure %d power supply %d failed"
 234 .It "mly%d: enclosure %d power supply %d ok"
 235 .It "mly%d: enclosure %d power supply %d not present"
 236 .It "mly%d: enclosure %d temperature sensor %d failed"
 237 .It "mly%d: enclosure %d temperature sensor %d critical"
 238 .It "mly%d: enclosure %d temperature sensor %d ok"
 239 .It "mly%d: enclosure %d temperature sensor %d not present"
 240 .It "mly%d: enclosure %d unit %d access critical"
 241 .It "mly%d: enclosure %d unit %d access ok"
 242 .It "mly%d: enclosure %d unit %d access offline"
 243 .Pp
 244 These events refer to external enclosures by number.
 245 The driver does not attempt to name the enclosures.
 246 .It "mly%d: controller cache write back error"
 247 .It "mly%d: controller battery backup unit found"
 248 .It "mly%d: controller battery backup unit charge level low"
 249 .It "mly%d: controller battery backup unit charge level ok"
 250 .It "mly%d: controller installation aborted"
 251 .It "mly%d: controller mirror race recovery in progress"
 252 .It "mly%d: controller mirror race on critical drive"
 253 .It "mly%d: controller memory soft ecc error"
 254 .It "mly%d: controller memory hard ecc error"
 255 .It "mly%d: controller battery backup unit failed"
 256 .Pp
 257 These events report controller status changes.
 258 .El
 259 .Sh AUTHORS
 260 .An -nosplit
 261 The
 262 .Nm
 263 driver was written by
 264 .An Michael Smith
 265 .Aq msmith@FreeBSD.org .
 266 .Pp
 267 This manual page was written by
 268 .An Michael Smith
 269 .Aq msmith@FreeBSD.org .
 270 .Sh BUGS
 271 The driver does not yet provide an external management interface.
 272 .Pp
 273 Enclosures are not named or otherwise identified in event messages.