Welcome the ata(4) manpage. This will be highly used for 4.x.
(I hope) Submitted by: sos Reviewed by: sos, Dan Langille <reviews@freebsddiary.org>
This commit is contained in:
Jeroen Ruigrok van der Werven
parent
2f522c9084
commit
7a90a5f1cb
@ -1,6 +1,6 @@
|
||||
# $FreeBSD$
|
||||
|
||||
MAN4= adv.4 adw.4 aha.4 ahb.4 aic.4 alpm.4 apm.4 ar.4 asc.4 \
|
||||
MAN4= adv.4 adw.4 aha.4 ahb.4 aic.4 alpm.4 apm.4 ar.4 asc.4 ata.4 \
|
||||
bktr.4 bt.4 cs.4 cx.4 cy.4 \
|
||||
dgb.4 dpt.4 ed.4 el.4 en.4 ep.4 ex.4 fe.4 gsc.4 \
|
||||
ie.4 io.4 joy.4 labpc.4 le.4 lnc.4 matcd.4 mcd.4 \
|
||||
@ -20,6 +20,7 @@ MLINKS+= alpm.4 ../alpm.4
|
||||
MLINKS+= apm.4 ../apm.4
|
||||
MLINKS+= ar.4 ../ar.4
|
||||
MLINKS+= asc.4 ../asc.4
|
||||
MLINKS+= ata.4 ../ata.4
|
||||
MLINKS+= bktr.4 ../bktr.4
|
||||
MLINKS+= bt.4 ../bt.4
|
||||
MLINKS+= cs.4 ../cs.4
|
||||
|
||||
179
share/man/man4/man4.i386/ata.4
Normal file
179
share/man/man4/man4.i386/ata.4
Normal file
@ -0,0 +1,179 @@
|
||||
.\"
|
||||
.\" Copyright (c) 2000 Jeroen Ruigrok van der Werven
|
||||
.\" Copyright (c) 2000 Søren Schmidt
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\" 1. Redistributions of source code must retain the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer.
|
||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer in the
|
||||
.\" documentation and/or other materials provided with the distribution.
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
||||
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
||||
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\" $FreeBSD$
|
||||
.\"
|
||||
.Dd January 27, 2000
|
||||
.Dt ATA 4 i386
|
||||
.Os FreeBSD 4.0
|
||||
.Sh NAME
|
||||
.Nm ata
|
||||
.Nd
|
||||
Generic ATA/ATAPI disk controller driver
|
||||
.Sh SYNOPSIS
|
||||
For ISA based ATA/ATAPI support:
|
||||
.Cd device isa
|
||||
.Cd device ata0 at isa? port IO_WD1 irq 14
|
||||
.Cd device ata1 at isa? port IO_WD2 irq 15
|
||||
.Pp
|
||||
For PCI based ATA/ATAPI support:
|
||||
.Cd device pci
|
||||
.Cd device ata
|
||||
.Pp
|
||||
To support ATA compliant disk drives:
|
||||
.Cd device atadisk
|
||||
.Pp
|
||||
To support ATAPI CD-ROM, CDR, CDRW or DVD drives:
|
||||
.Cd device atapicd
|
||||
.Pp
|
||||
To support ATAPI floppy drives,
|
||||
such as the ZIP and LS120:
|
||||
.Cd device atapifd
|
||||
.Pp
|
||||
To support ATAPI tape drives:
|
||||
.Cd device atapist
|
||||
.Pp
|
||||
To set the controller numbering to static,
|
||||
just like the
|
||||
.Xr wd 4
|
||||
driver:
|
||||
.Cd options ATA_STATIC_ID
|
||||
.Pp
|
||||
To enable DMA on an ATAPI device:
|
||||
.Cd options ATA_ENABLE_ATAPI_DMA
|
||||
.Sh DESCRIPTION
|
||||
This driver provides access to disk drives, CD-ROM drives,
|
||||
ZIP drives and tape streamers connected to controllers
|
||||
according to the ATA and ATAPI standards.
|
||||
These devices are also commonly known as IDE or EIDE devices.
|
||||
.Pp
|
||||
The currently supported controllers with their maximum speed include:
|
||||
.Pp
|
||||
.Bl -tag -width "Promise Fasttrak-33 " -compact
|
||||
.It Acerlabs Aladdin
|
||||
Ultra DMA 33 (UDMA2), 33 MB/sec
|
||||
.It AMD 756
|
||||
Ultra DMA 66 (UDMA4), 66 MB/sec
|
||||
.It HighPoint HPT366
|
||||
Ultra DMA 66 (UDMA4), 66 MB/sec
|
||||
.It Intel PIIX
|
||||
DMA 2 (WDMA2), 16 MB/sec
|
||||
.It Intel PIIX3
|
||||
DMA 2 (WDMA2), 16 MB/sec
|
||||
.It Intel PIIX4
|
||||
Ultra DMA 33 (UDMA2), 33 MB/sec
|
||||
.It Intel ICH
|
||||
Ultra DMA 33 (UDMA2), 33 MB/sec
|
||||
.It Promise Fasttrak-33
|
||||
Ultra DMA 33 (UDMA2), 33 MB/sec
|
||||
.It Promise Fasttrak-66
|
||||
Ultra DMA 66 (UDMA4), 66 MB/sec
|
||||
.It Promise Ultra-33
|
||||
Ultra DMA 33 (UDMA2), 33 MB/sec
|
||||
.It Promise Ultra-66
|
||||
Ultra DMA 66 (UDMA4), 66 MB/sec
|
||||
.It SiS 5591
|
||||
Ultra DMA 33 (UDMA2), 33 MB/sec
|
||||
.It VIA 82C586
|
||||
Ultra DMA 33 (UDMA2), 33 MB/sec
|
||||
.It VIA 82C686
|
||||
Ultra DMA 66 (UDMA4), 66 MB/sec
|
||||
.El
|
||||
.Pp
|
||||
All unknown chipsets can be supported at the maximum speed of 16 MB/sec.
|
||||
.Pp
|
||||
The ata driver also allows for changes to the transfer mode of the devices
|
||||
at a later time when the system is up and running.
|
||||
.Pp
|
||||
The driver attempts to set the maximum performance transfer mode on your disk
|
||||
drives by selecting the highest possible DMA mode.
|
||||
ATAPI devices are left in PIO mode because DMA problems are common despite the
|
||||
device specifications.
|
||||
You can always try to set DMA mode on an ATAPI device using the sysctl
|
||||
method described here,
|
||||
but be aware that your hardware might
|
||||
.Em not
|
||||
support it and can
|
||||
.Em hang
|
||||
the system.
|
||||
.Pp
|
||||
To see the devices' current access modes, use the command line:
|
||||
.Pp
|
||||
.Dl sysctl hw.atamodes
|
||||
.Pp
|
||||
which results in the modes of the devices being displayed as a string
|
||||
like this:
|
||||
.Pp
|
||||
.Dl hw.atamodes: dma,pio,---,pio,dma,---,dma,---, (--- = no device)
|
||||
.Pp
|
||||
This means that ata0-master is in DMA mode,
|
||||
ata0-slave is in PIO mode,
|
||||
and so forth.
|
||||
You can set the mode with sysctl -w and a string like the above,
|
||||
for example:
|
||||
.Pp
|
||||
.Dl sysctl -w hw.atamodes=pio,pio,---,dma,pio,---,dma,---,
|
||||
.Pp
|
||||
The new modes are set as soon as the sysctl command returns.
|
||||
.Pp
|
||||
.Sh FILES
|
||||
.Bl -tag -width "/sys/i386/conf/GENERIC " -compact
|
||||
.It Pa /dev/ad*
|
||||
ATA disk device nodes
|
||||
.It Pa /dev/acd*
|
||||
ATAPI CD-ROM device nodes
|
||||
.It Pa /dev/afd*
|
||||
ATAPI floppy drive device nodes
|
||||
.It Pa /dev/ast*
|
||||
ATAPI tape drive device nodes
|
||||
.It Pa /sys/i386/conf/GENERIC
|
||||
sample generic kernel config file for ata based systems
|
||||
.El
|
||||
.Sh NOTES
|
||||
The ata driver does not support MFM/RLL/ESDI (ST-506) style disks.
|
||||
.Pp
|
||||
Remember that in order to use UDMA4 mode you
|
||||
.Em have
|
||||
to use a special 80 conductor cable,
|
||||
and the driver tries to determine if you have such a cable
|
||||
attached before setting UDMA4 mode.
|
||||
.Pp
|
||||
The use of UDMA4(66MHz) and non-UDMA4 devices on the same ATA channel is not
|
||||
recommended,
|
||||
unless they are run at the non-UDMA4 device's lower speed.
|
||||
The driver has been designed to handle this but some older devices do
|
||||
not like this.
|
||||
.Sh AUTHORS
|
||||
The ata driver was written by
|
||||
.An Søren Schmidt
|
||||
.Aq sos@freebsd.org .
|
||||
.Pp
|
||||
This manual page was written by
|
||||
.An Jeroen Ruigrok van der Werven
|
||||
.Aq asmodai@freebsd.org
|
||||
and
|
||||
.An Søren Schmidt
|
||||
.Aq sos@freebsd.org .
|
||||
Loading…
x
Reference in New Issue
Block a user