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.5 2006/10/24 17:09:45 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 setable 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 .