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