sbin/atacontrol/atacontrol.8

   1 .\"
   2 .\" Copyright (c) 2000,2001,2002 Søren Schmidt <sos@FreeBSD.org>
   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 May 17, 2001
  29 .Dt ATACONTROL 8
  30 .Os
  31 .Sh NAME
  32 .Nm atacontrol
  33 .Nd ATA device driver control program
  34 .Sh SYNOPSIS
  35 .Nm
  36 .Aq Ar command
  37 .Ar args
  38 .Pp
  39 .Nm
  40 .Ic attach
  41 .Ar channel
  42 .Nm
  43 .Ic detach
  44 .Ar channel
  45 .Nm
  46 .Ic reinit
  47 .Ar channel
  48 .Nm
  49 .Ic create
  50 .Ar type [interleave] disk0 ... diskN
  51 .Nm
  52 .Ic delete
  53 .Ar raid
  54 .Nm
  55 .Ic rebuild
  56 .Ar raid
  57 .Nm
  58 .Ic status
  59 .Ar raid
  60 .Nm
  61 .Ic mode
  62 .Ar channel
  63 .Op Ar mastermode slavemode
  64 .Nm
  65 .Ic info
  66 .Ar channel
  67 .Nm
  68 .Ic cap
  69 .Ar channel device
  70 .Nm
  71 .Ic enclosure
  72 .Ar channel device
  73 .Nm
  74 .Ic list
  75 .Sh DESCRIPTION
  76 .Nm
  77 is a control program that provides the user access and control to the
  78 .Fx
  79 .Xr ata 4
  80 subsystem.
  81 .Pp
  82 .Nm
  83 can cause severe system crashes and loss of data if used improperly, please
  84 exercise caution when using this command!
  85 .Pp
  86 The
  87 .Ar channel
  88 argument is the number of the ATA channel on which to operate.
  89 The following commands are supported:
  90 .Bl -tag -width "rebuild"
  91 .It Ic attach
  92 Attach an ATA
  93 .Ar channel ,
  94 devices on the channel are probed and attached as
  95 is done on boot.
  96 .It Ic detach
  97 Detach an ATA
  98 .Ar channel ,
  99 devices on the channel are removed from the kernel,
 100 and all outstanding transfers etc. are returned back to the system marked
 101 as failed.
 102 .It Ic reinit
 103 Reinitialize an ATA
 104 .Ar channel .
 105 Both devices on the channel are reset and
 106 initialized to the parameters the ATA driver has stored internally.
 107 Devices that has gone bad and no longer responds to the probe, or devices
 108 that has physically been removed are removed from the kernel.
 109 Likewise are devices that show up during a reset, probed and attached.
 110 .It Ic create
 111 Create a
 112 .Ar type
 113 ATA RAID. The Type can be RAID0 (stripe), RAID1 (mirror), RAID0+1 or
 114 SPAN (JBOD). In case the RAID has a RAID0 component the
 115 .Ar interleave
 116 must be specified in number of sectors. The RAID will be created
 117 of the individual disks named
 118 .Ar disk0 ... diskN.
 119 .Pp
 120 Allthough the ATA driver allows for creating an ATA RAID on disks on any
 121 controller, there are restrictions. It is only possible to boot on
 122 an array if its either located on a "real" ATA RAID controller like
 123 the Promise or Highpoint controllers, or if the RAID declared is of
 124 RAID1 or SPAN type, in case of a SPAN the partition to boot must
 125 reside on the first disk in the SPAN.
 126 .It Ic delete
 127 Deletes a RAID array on a RAID capable ATA controller.
 128 .It Ic rebuild
 129 Rebuild a RAID1 array on a RAID capable ATA controller.
 130 .It Ic status
 131 Get the status of an ATA RAID.
 132 .It Ic mode
 133 Without the two mode arguments the current transfer modes of both
 134 devices are printed.
 135 If the mode arguments are given, the ATA driver
 136 is asked to change the transfer modes to those given.
 137 The ATA driver
 138 will reject modes that is not supported by the hardware.
 139 Modes are given like
 140 .Dq Li PIO3 ,
 141 .Dq Li udma2 ,
 142 .Dq Li udma100 ,
 143 case does not matter.
 144 If one of the devices mode should not be changed, use a nonexisting mode
 145 as argument (i.e.\&
 146 .Dq Li XXX ) ,
 147 and the mode will remain unchanged.
 148 .It Ic info
 149 Show info about the attached devices on the
 150 .Ar channel ,
 151 the device name and manufacture/version strings are shown.
 152 .It Ic cap
 153 Show detailed info about the device on
 154 .Ar channel device
 155 where device is 0 for master and 1 for slave.
 156 .It Ic enclosure
 157 Show detailed info about the encolsure on
 158 .Ar channel device
 159 where device is 0 for master and 1 for slave.
 160 Fan RPM speed, enclosure temperature, 5V and 12V levels are shown.
 161 .It Ic list
 162 Show info about all attached devices on all active controllers.
 163 .El
 164 .Sh SEE ALSO
 165 .Xr ata 4
 166 .Sh HISTORY
 167 The
 168 .Nm
 169 utility first appeared in
 170 .Fx 4.6 .
 171 .Sh AUTHORS
 172 .An -nosplit
 173 The
 174 .Nm
 175 utility was written by
 176 .An S\(/oren Schmidt
 177 .Aq sos@FreeBSD.org .
 178 .Pp
 179 This manual page was written by
 180 .An S\(/oren Schmidt
 181 .Aq sos@FreeBSD.org .