Merge branch 'vendor/OPENSSL'
[dragonfly.git] / share / man / man4 / ata.4
1 .\"
2 .\" Copyright (c) 2000,2004 Jeroen Ruigrok van der Werven
3 .\" Copyright (c) 2000,2001,2002 Søren Schmidt
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. Redistributions in binary form must reproduce the above copyright
12 .\"    notice, this list of conditions and the following disclaimer in the
13 .\"    documentation and/or other materials provided with the distribution.
14 .\"
15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25 .\" SUCH DAMAGE.
26 .\"
27 .\" $FreeBSD: src/share/man/man4/ata.4,v 1.3.2.18 2002/10/16 13:40:51 fjoe Exp $
28 .\" $DragonFly: src/share/man/man4/ata.4,v 1.9 2008/07/08 14:12:45 thomas Exp $
29 .\"
30 .Dd June 15, 2007
31 .Dt ATA 4
32 .Os
33 .Sh NAME
34 .Nm ata
35 .Nd deprecated (S)ATA/ATAPI disk controller driver
36 .Sh SYNOPSIS
37 For ISA based ATA/ATAPI support:
38 .Cd device isa
39 .Cd device ata0 at isa? port IO_WD1 irq 14
40 .Cd device ata1 at isa? port IO_WD2 irq 15
41 .Pp
42 For PCI based (S)ATA/ATAPI support:
43 .Cd device pci
44 .Cd device ata
45 .Pp
46 To support (S)ATA compliant disk drives:
47 .Cd device atadisk
48 .Pp
49 To support ATAPI CD-ROM, CDR, CDRW, DVD-ROM and DVD-RAM drives:
50 .Cd device atapicd
51 .Pp
52 To support ATAPI floppy drives,
53 such as the ZIP and LS120:
54 .Cd device atapifd
55 .Pp
56 To support ATAPI tape drives:
57 .Cd device atapist
58 .Pp
59 The following tunables are settable from the loader:
60 .Bl -ohang
61 .It Va hw.ata.ata_dma
62 set to 1 for DMA access, 0 for PIO (default is DMA).
63 .It Va hw.ata.atapi_dma
64 set to 1 for DMA access, 0 for PIO (default is PIO).
65 .It Va hw.ata.wc
66 set to 1 to enable Write Caching, 0 to disable (default is enabled).
67 (WARNING: might cause data loss on power failures.)
68 .It Va hw.ata.tags
69 set to 1 to enable Tagged Queuing support, 0 to disable (default is disabled).
70 (Only IBM DPTA, DTLA, ICxxxxxxAT, ICxxxxxxAV drives support that.)
71 .El
72 .Sh DESCRIPTION
73 The
74 .Nm
75 driver is the deprecated
76 .Fx 4.8
77 ATA driver.
78 .Dx Ap s
79 default ATA driver is
80 .Xr nata 4
81 which was ported from newer
82 .Fx
83 code.
84 .Pp
85 This driver provides access to disk drives, ATAPI CD-ROM and DVD drives,
86 ZIP drives and tape streamers connected to controllers
87 according to the ATA and ATAPI standards.
88 These devices are also commonly known as IDE or EIDE devices.
89 .Pp
90 The currently supported ATA controllers with their maximum speed include:
91 .Pp
92 .Bl -tag -width "Promise Ultra/Fasttrak-100 TX2/TX2000" -compact
93 .It Acerlabs Aladdin
94 Ultra DMA 100 (UDMA5), 100 MB/sec (depending on model, max stated at boot)
95 .It AMD 756
96 Ultra DMA 66 (UDMA4), 66 MB/sec
97 .It AMD 766
98 Ultra DMA 100 (UDMA5), 100 MB/sec
99 .It AMD 768
100 Ultra DMA 100 (UDMA5), 100 MB/sec
101 .It AMD 8111
102 Ultra DMA 133 (UDMA6), 133 MB/sec
103 .It Cenatek Rocket Drive
104 Ultra DMA 133 (UDMA6), 133 MB/sec
105 .It CMD 646
106 DMA 2 (WDMA2), 16 MB/sec
107 .It CMD 648
108 Ultra DMA 66 (UDMA4), 66 MB/sec
109 .It CMD 649
110 Ultra DMA 100 (UDMA5), 100 MB/sec
111 .It Cypress 82C693
112 DMA 2 (WDMA2), 16 MB/sec
113 .It Cyrix 5530
114 Ultra DMA 33 (UDMA2), 33 MB/sec
115 .It HighPoint HPT366
116 Ultra DMA 66 (UDMA4), 66 MB/sec
117 .It HighPoint HPT370
118 Ultra DMA 100 (UDMA5), 100 MB/sec
119 .It HighPoint HPT372/HPT374
120 Ultra DMA 133 (UDMA6), 133 MB/sec
121 .It Intel PIIX/PIIX3
122 DMA 2 (WDMA2), 16 MB/sec
123 .It Intel PIIX4
124 Ultra DMA 33 (UDMA2), 33 MB/sec
125 .It Intel ICH0
126 Ultra DMA 33 (UDMA2), 33 MB/sec
127 .It Intel ICH
128 Ultra DMA 66 (UDMA4), 66 MB/sec
129 .It Intel ICH2/ICH3/ICH4/ICH5
130 Ultra DMA 100 (UDMA5), 100 MB/sec
131 .It Intel ICH6R/RW
132 Ultra DMA 100 (UDMA5), 100 MB/sec
133 .It NVIDIA nForce ATA100
134 Ultra DMA 100 (UDMA5), 100 MB/sec
135 .It NVIDIA nForce2/nForce3 ATA133
136 Ultra DMA 133 (UDMA6), 133 MB/sec
137 .It Promise Ultra/Fasttrak-33
138 Ultra DMA 33 (UDMA2), 33 MB/sec
139 .It Promise Ultra/Fasttrak-66
140 Ultra DMA 66 (UDMA4), 66 MB/sec
141 .It Promise Ultra/Fasttrak-100 (TX2/TX4)
142 Ultra DMA 100 (UDMA5), 100 MB/sec
143 .It Promise Ultra/Fasttrak-133 TX2/TX2000
144 Ultra DMA 133 (UDMA6), 133 MB/sec
145 .It ServerWorks ROSB4
146 Ultra DMA 33 (UDMA2), 33 MB/sec
147 .It ServerWorks CSB5
148 Ultra DMA 100 (UDMA5), 100 MB/sec (depending on model, max stated at boot)
149 .It SiI 0680
150 Ultra DMA 133 (UDMA6), 133 MB/sec (depending on model, max stated at boot)
151 .It SiS 5591
152 Ultra DMA 133 (UDMA5), 133 MB/sec (depending on model, max stated at boot)
153 .It VIA 82C586
154 Ultra DMA 33 (UDMA2), 33 MB/sec
155 .It VIA 82C596
156 Ultra DMA 66 (UDMA4), 66 MB/sec (depending on model, max stated at boot)
157 .It VIA 82C686a
158 Ultra DMA 66 (UDMA4), 66 MB/sec
159 .It VIA 82C686b
160 Ultra DMA 100 (UDMA5), 100 MB/sec
161 .It VIA 8233/8235/8237
162 Ultra DMA 133 (UDMA6), 133 MB/sec (depending on model, max stated at boot)
163 .El
164 .Pp
165 The currently supported SATA controllers with their maximum speed include:
166 .Pp
167 .Bl -tag -width "SiI 3112/3114/3124/3512" -compact
168 .It Intel ICH5
169 Serial ATA 150, 150 MB/sec
170 .It Intel ICH6(R)/(R)W
171 Serial ATA 150, 150 MB/sec
172 .It SiI 3112/3114/3124/3512
173 Serial ATA 150, 150 MB/sec
174 .It VIA 8237
175 Serial ATA 150, 150 MB/sec
176 .El
177 .Pp
178 All unknown chipsets are supported at the maximum speed of 16 MB/sec.
179 .Pp
180 The
181 .Nm
182 driver also allows for changes to the transfer mode of the devices
183 at a later time when the system is up and running, see
184 .Xr atacontrol 8 .
185 .Pp
186 The driver attempts to set the maximum performance transfer mode on your disk
187 drives by selecting the highest possible DMA mode. However the
188 .Nm
189 driver sometimes issue the message
190 "DMA limited to UDMA33, non-ATA66 cable or device",
191 if the cable is ATA66 (or above) compliant, it is because the other device
192 on this channel states it can only accept up to UDMA2/ATA33 signals.
193 ATAPI devices are left in PIO mode because DMA problems are common despite the
194 device specifications.
195 You can always try to set DMA mode on an ATAPI device using
196 .Xr atacontrol 8 ,
197 but be aware that your hardware might
198 .Em not
199 support it and can
200 .Em hang
201 the system.
202 .Sh FILES
203 .Bl -tag -width "/dev/acd* " -compact
204 .It Pa /dev/ad*
205 ATA disk device nodes
206 .It Pa /dev/acd*
207 ATAPI CD-ROM device nodes
208 .It Pa /dev/afd*
209 ATAPI floppy drive device nodes
210 .It Pa /dev/ast*
211 ATAPI tape drive device nodes
212 .El
213 .Sh NOTES
214 Static numbering
215 (enabled with the
216 .Dv ATA_STATIC_ID
217 kernel option)
218 reserves a number for each possibly connected disk,
219 even when not present.
220 This may result in odd situations where,
221 for example,
222 ad0 and ad2 exist in the absence of ad1.
223 The advantage is that the addition of the formerly absent drive
224 does not cause the numbers of the other drives to change.
225 .Pp
226 The
227 .Nm
228 driver does not support MFM/RLL/ESDI (ST-506) style disks.
229 .Pp
230 Remember that in order to use UDMA4 (and above) mode you
231 .Em have
232 to use a special 80 conductor cable,
233 and the driver tries to determine if you have such a cable
234 attached before setting UDMA4 mode.
235 .Pp
236 The use of UDMA4(66MHz) and higher together with non-UDMA4 devices on
237 the same ATA channel is not recommended,
238 unless they are run at the non-UDMA4 device's lower speed.
239 The driver has been designed to handle that kind of setup but lots of
240 older devices do not like this.
241 .Sh SEE ALSO
242 .Xr nata 4 ,
243 .Xr atacontrol 8 ,
244 .Xr burncd 8
245 .Sh HISTORY
246 The
247 .Nm
248 driver first appeared in
249 .Fx 4.0 .
250 .Sh AUTHORS
251 .An -nosplit
252 The
253 .Nm
254 driver was written by
255 .An S\(/oren Schmidt
256 .Aq sos@FreeBSD.org .
257 .Pp
258 This manual page was written by
259 .An Jeroen Ruigrok van der Werven
260 .Aq asmodai@FreeBSD.org
261 and
262 .An S\(/oren Schmidt
263 .Aq sos@FreeBSD.org .