docs/75021: hw.ata.atapi_dma patch for ata(4) man page

[Joel Dahl]

The following reply was made to PR docs/75021; it has been noted by GNATS.

From: Joel Dahl <joel at automatvapen.se>
To: Craig Rodrigues <rodrigc at crodrigues.org>
Cc: FreeBSD-gnats-submit at FreeBSD.org
Subject: Re: docs/75021: hw.ata.atapi_dma patch for ata(4) man page
Date: Sun, 19 Dec 2004 12:32:27 +0100

 On Mon, 2004-12-13 at 10:50 -0500, Craig Rodrigues wrote:	
 > >Description:
 > 
 > In ata(4), it states:
 > 
 >  hw.ata.atapi_dma
 >      set to 1 for DMA access, 0 for PIO (default is PIO).
 > 
 > In src/sys/dev/ata/ata-all.c, this sysctl is by default
 > set to 1 (on -CURRENT, and also on 5.3-RELEASE).
 > 
 > Perhaps this patch is in order?
 > 	
 > >Fix:
 > 
 > --- share/man/man4/ata.4.orig   Thu Dec  9 19:07:53 2004
 > +++ share/man/man4/ata.4        Thu Dec  9 19:08:08 2004
 > @@ -86,7 +86,7 @@
 >  .It Va hw.ata.ata_dma
 >  set to 1 for DMA access, 0 for PIO (default is DMA).
 >  .It Va hw.ata.atapi_dma
 > -set to 1 for DMA access, 0 for PIO (default is PIO).
 > +set to 1 for DMA access, 0 for PIO (default is DMA).
 >  .It Va hw.ata.wc
 >  set to 1 to enable Write Caching, 0 to disable (default is enabled).
 >  .Em WARNING :
 
 There is another part in ata(4) that also requires a correction,
 (assuming Craig's patch is correct):
 
 "
 ATAPI devices are set to PIO mode by default because severe DMA problems
 are common even if the device capabilities indicate support.
 "
 
 ATAPI devices are set to DMA mode by default (as Craig mentions), so
 someone should probably reword this part a bit.