share/man/man4/arcmsr.4

   1 .\"     $NetBSD: arcmsr.4,v 1.7 2008/03/03 15:35:22 xtraeme Exp $
   2 .\"     $OpenBSD: arc.4,v 1.10 2007/11/04 08:18:17 dlg Exp $
   3 .\"
   4 .\" Copyright (c) 2007, 2008 Juan Romero Pardines <xtraeme@netbsd.org>
   5 .\" Copyright (c) 2006 David Gwynne <dlg@openbsd.org>
   6 .\"
   7 .\" Permission to use, copy, modify, and distribute this software for any
   8 .\" purpose with or without fee is hereby granted, provided that the above
   9 .\" copyright notice and this permission notice appear in all copies.
  10 .\"
  11 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  12 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  13 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  14 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  15 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  16 .\" TORTIOUS ACTION, ARISING OUT OF
  17 .\" PERFORMANCE OF THIS SOFTWARE.
  18 .\"
  19 .Dd March 3, 2008
  20 .Dt ARCMSR 4
  21 .Os
  22 .Sh NAME
  23 .Nm arcmsr
  24 .Nd Areca Technology Corporation SATA/SAS RAID controller
  25 .Sh SYNOPSIS
  26 .Cd "arcmsr* at pci? dev ? function ?"
  27 .Sh DESCRIPTION
  28 The
  29 .Nm
  30 driver provides support for the PCI-X and PCI Express RAID controllers from
  31 Areca Technology Corporation:
  32 .Pp
  33 .Bl -dash -offset indent -compact
  34 .It
  35 ARC-1110 PCI-X 4 Port SATA RAID Controller
  36 .It
  37 ARC-1110ML PCI-X 4 Port SATA RAID Controller
  38 .It
  39 ARC-1120 PCI-X 8 Port SATA RAID Controller
  40 .It
  41 ARC-1120ML PCI-X 8 Port SATA RAID Controller
  42 .It
  43 ARC-1130 PCI-X 12 Port SATA RAID Controller
  44 .It
  45 ARC-1130ML PCI-X 12 Port SATA RAID Controller
  46 .It
  47 ARC-1160 PCI-X 16 Port SATA RAID Controller
  48 .It
  49 ARC-1160ML PCI-X 16 Port SATA RAID Controller
  50 .It
  51 ARC-1170 PCI-X 24 Port SATA RAID Controller
  52 .It
  53 ARC-1200 Rev A PCI Express 2 Port SATA RAID Controller
  54 .It
  55 ARC-1202 PCI Express 2 Port SATA RAID Controller
  56 .It
  57 ARC-1210 PCI Express 4 Port SATA RAID Controller
  58 .It
  59 ARC-1220 PCI Express 8 Port SATA RAID Controller
  60 .It
  61 ARC-1230 PCI Express 12 Port SATA RAID Controller
  62 .It
  63 ARC-1230ML PCI Express 12 Port SATA RAID Controller
  64 .It
  65 ARC-1231ML PCI Express 12 Port SATA RAID Controller
  66 .It
  67 ARC-1260 PCI Express 16 Port SATA RAID Controller
  68 .It
  69 ARC-1260ML PCI Express 16 Port SATA RAID Controller
  70 .It
  71 ARC-1261ML PCI Express 16 Port SATA RAID Controller
  72 .It
  73 ARC-1280 PCI Express 24 Port SATA RAID Controller
  74 .It
  75 ARC-1280ML PCI Express 24 Port SATA RAID Controller
  76 .It
  77 ARC-1680 PCI Express 8 Port SAS RAID Controller
  78 .It
  79 ARC-1680LP PCI Express 8 Port SAS RAID Controller
  80 .It
  81 ARC-1680i PCI Express 8 Port SAS RAID Controller
  82 .It
  83 ARC-1680x PCI Express 8 Port SAS RAID Controller
  84 .It
  85 ARC-1681 PCI-X 8 Port SAS RAID Controller
  86 .El
  87 .Pp
  88 These controllers support RAID levels 0, 1, 1E, 3, 5, 6, and JBOD
  89 using either SAS or SATA II drives.
  90 .Pp
  91 .Nm
  92 supports management and monitoring of the controller through the
  93 .Xr bioctl 8
  94 and
  95 .Xr envstat 8
  96 commands.
  97 .Pp
  98 Please note, however, that to use some features that require special
  99 privileges, such as creating/removing hot-spares, pass-through disks
 100 or RAID volumes will require to have the
 101 .Em password
 102 disabled in the firmware; otherwise a
 103 .Em Permission denied
 104 error will be reported by
 105 .Xr bioctl 8 .
 106 .Pp
 107 When a RAID 1 or 1+0 volume is created, either through the
 108 .Xr bioctl 8
 109 command or controller's firmware, the volume won't be accessible until
 110 the initialization is done.
 111 A way to get access to the
 112 .Xr sd 4
 113 device that corresponds to that volume without rebooting, is to issue
 114 the following command (once the initialization is finished):
 115 .Bd -literal
 116 $ scsictl scsibus0 scan any any
 117 .Ed
 118 .Pp
 119 The
 120 .Nm
 121 driver will also report to the kernel log buffer any error that might
 122 appear when handling firmware commands, such as used by the
 123 .Xr bioctl 8
 124 command.
 125 .Sh EVENTS
 126 The
 127 .Nm
 128 driver is able to send events to
 129 .Xr powerd 8
 130 if a volume or any drive connected to the volume is not online.
 131 The
 132 .Em state-changed
 133 event will be sent to the
 134 .Pa /etc/powerd/scripts/sensor_drive
 135 script when such condition happens.
 136 .Sh SEE ALSO
 137 .Xr intro 4 ,
 138 .Xr pci 4 ,
 139 .Xr scsi 4 ,
 140 .Xr sd 4 ,
 141 .Xr bioctl 8 ,
 142 .Xr envstat 8 ,
 143 .Xr powerd 8 ,
 144 .Xr scsictl 8
 145 .Sh HISTORY
 146 The
 147 .Nm
 148 driver first appeared in
 149 .Nx 5.0 .
 150 .Sh AUTHORS
 151 .An -nosplit
 152 The
 153 .Nm
 154 driver was originally written for
 155 .Ox
 156 by
 157 .An David Gwynne .
 158 It was ported to
 159 .Nx
 160 and extended by
 161 .An Juan Romero Pardines .