2 .\" Copyright (c) 2000,2001,2002 Søren Schmidt <sos@FreeBSD.org>
3 .\" All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
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.
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
33 .Nd ATA device driver control program
50 .Ar type Oo Ar interleave Oc Ar disk0 ... diskN
77 utility is a control program that provides the user access and control to the
85 can cause severe system crashes and loss of data if used improperly.
87 exercise caution when using this command!
91 argument is the ATA channel device (e.g., ata0) on which to operate.
92 The following commands are supported:
93 .Bl -tag -width "rebuild"
97 Devices on the channel are probed and attached as
102 Devices on the channel are removed from the kernel,
103 and all outstanding transfers etc.\& are returned back to the system marked
108 Both devices on the channel are reset and
109 initialized to the parameters the ATA driver has stored internally.
110 Devices that have gone bad and no longer respond to the probe, or devices
111 that have physically been removed, are removed from the kernel.
112 Likewise are devices that show up during a reset, probed and attached.
126 In case the RAID has a
131 must be specified in number of sectors.
132 The RAID will be created
133 of the individual disks named
135 .Ar disk0 ... diskN .
138 Although the ATA driver allows for creating an ATA RAID on disks with any
139 controller, there are restrictions.
140 It is only possible to boot on
141 an array if it is either located on a
143 ATA RAID controller like
144 the Promise or Highpoint controllers, or if the RAID declared is of
150 the partition to boot must
151 reside on the first disk in the SPAN.
153 Delete a RAID array on a RAID capable ATA controller.
155 Add a spare disk to an existing RAID.
157 Rebuild a RAID1 array on a RAID capable ATA controller.
159 Get the status of an ATA RAID.
161 Without the mode argument, the current transfer modes of the
163 If the mode argument is given, the ATA driver
164 is asked to change the transfer mode to the one given.
166 will reject modes that are not supported by the hardware.
171 case does not matter.
173 Currently supported modes are:
174 .Cm PIO0 , PIO1 , PIO2 , PIO3 , PIO4 ,
189 The device name and manufacture/version strings are shown.
191 Show detailed info about the device on
194 Show info about the attached devices on the
197 Show info about all attached devices on all active controllers.
200 To get information on devices attached to a channel,
201 use the command line:
203 .Dl "atacontrol info ata0"
205 To see the devices' current access modes, use the command line:
207 .Dl "atacontrol mode ad0"
209 which results in the modes of the devices being displayed as a string
212 .Dl "current mode = UDMA100"
214 You can set the mode with
216 and a string like the above,
219 .Dl "atacontrol mode ad0 PIO4"
221 The new modes are set as soon as the
229 utility first appeared in
235 utility was written by
237 .Aq sos@FreeBSD.org .
239 This manual page was written by
241 .Aq sos@FreeBSD.org .