From root@gits.dyndns.org  Wed Jun 12 13:30:14 2002
Return-Path: <root@gits.dyndns.org>
Received: from smtp.noos.fr (verlaine.noos.net [212.198.2.73])
	by hub.freebsd.org (Postfix) with ESMTP id 6EDFB37B400
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 12 Jun 2002 13:30:02 -0700 (PDT)
Received: (qmail 17767845 invoked by uid 0); 12 Jun 2002 20:30:00 -0000
Received: from unknown (HELO gits.gits.dyndns.org) ([212.198.230.194]) (envelope-sender <root@gits.dyndns.org>)
          by 212.198.2.73 (qmail-ldap-1.03) with SMTP
          for <FreeBSD-gnats-submit@freebsd.org>; 12 Jun 2002 20:30:00 -0000
Received: from gits.gits.dyndns.org (mquaslh5eoyz22g5@localhost [127.0.0.1])
	by gits.gits.dyndns.org (8.12.3/8.12.3) with ESMTP id g5CKTxa6033540
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 12 Jun 2002 22:29:59 +0200 (CEST)
	(envelope-from root@gits.dyndns.org)
Received: (from root@localhost)
	by gits.gits.dyndns.org (8.12.3/8.12.3/Submit) id g5CKTxEE033539;
	Wed, 12 Jun 2002 22:29:59 +0200 (CEST)
	(envelope-from root)
Message-Id: <200206122029.g5CKTxEE033539@gits.gits.dyndns.org>
Date: Wed, 12 Jun 2002 22:29:59 +0200 (CEST)
From: Cyrille Lefevre <cyrille.lefevre@laposte.net>
Reply-To: Cyrille Lefevre <cyrille.lefevre@laposte.net>
To: FreeBSD-gnats-submit@freebsd.org
Subject: ata(4) refer to sysctl(8) instead of atacontrol(8).
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         39202
>Category:       misc
>Synopsis:       ata(4) refer to sysctl(8) instead of atacontrol(8).
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-bugs
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jun 12 13:40:01 PDT 2002
>Closed-Date:    Mon Jul 01 19:08:53 PDT 2002
>Last-Modified:  Mon Jul 01 19:08:53 PDT 2002
>Originator:     Cyrille Lefevre
>Release:        FreeBSD 4.6-RC i386
>Organization:
ACME
>Environment:
System: FreeBSD gits 4.6-RC FreeBSD 4.6-RC #11: Sun Jun 9 19:48:37 CEST 2002 root@gits:/disk2/freebsd/src/sys/compile/CUSTOM i386

>Description:
	ata(4) says :

     To see the devices' current access modes, use the command line:
           sysctl hw.atamodes
     which results in the modes of the devices being displayed as a string
     like this:
           hw.atamodes: dma,pio,---,pio,dma,---,dma,---, (--- = no device)
     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 and a string like the
     above, for example:
           sysctl hw.atamodes=pio,pio,---,dma,pio,---,dma,---,
     The new modes are set as soon as the sysctl command returns.

	while it should refer to atacontrol(8) to change ata modes
	since the sysctl hw.atamodes doesn't exists anymore.
>How-To-Repeat:
	man 4 ata
>Fix:
Index: ata.4
===================================================================
RCS file: /home/ncvs/src/share/man/man4/ata.4,v
retrieving revision 1.3.2.14
diff -u -r1.3.2.14 ata.4
--- ata.4	10 Feb 2002 07:24:08 -0000	1.3.2.14
+++ ata.4	12 Jun 2002 20:24:44 -0000
@@ -160,22 +160,23 @@
 .Pp
 To see the devices' current access modes, use the command line:
 .Pp
-.Dl sysctl hw.atamodes
+.Dl atacontrol mode 0
 .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)
+.Dl Master = WDMA2
+.Dl Slave  = PIO4
 .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 and a string like the above,
+You can set the mode with atacontrol and a string like the above,
 for example:
 .Pp
-.Dl sysctl hw.atamodes=pio,pio,---,dma,pio,---,dma,---,
+.Dl atacontrol mode 0 PIO4 PIO4
 .Pp
-The new modes are set as soon as the sysctl command returns.
+The new modes are set as soon as the atacontrol command returns.
 .Sh FILES
 .Bl -tag -width "/sys/i386/conf/GENERIC " -compact
 .It Pa /dev/ad*
@@ -219,6 +220,8 @@
 unless they are run at the non-UDMA4 device's lower speed.
 The driver has been designed to handle that kind of setup but lots of
 older devices do not like this.
+.Sh SEE ALSO
+.Xr atacontrol 8
 .Sh HISTORY
 The
 .Nm
>Release-Note:
>Audit-Trail:

From: David Malone <dwmalone@maths.tcd.ie>
To: Cyrille Lefevre <cyrille.lefevre@laposte.net>
Cc: FreeBSD-gnats-submit@FreeBSD.org, sos@FreeBSD.org
Subject: Re: misc/39202: ata(4) refer to sysctl(8) instead of atacontrol(8).
Date: Sat, 15 Jun 2002 01:47:55 +0100

 On Wed, Jun 12, 2002 at 10:29:59PM +0200, Cyrille Lefevre wrote:
 > 	while it should refer to atacontrol(8) to change ata modes
 > 	since the sysctl hw.atamodes doesn't exists anymore.
 
 I think the ata(4) man page has missed a few MFCs. The following
 diff would sync it with -current (leaving out the bits which relate
 to -current only device stuff).
 
 Soren - would you like me to commit this when the code freeze is
 over, or would you like to do it on your next MFC?
 
 	David.
 
 
 --- src/share/man/man4/ata.4:1.3.2.14	Sun Feb 10 07:24:08 2002
 +++ src/share/man/man4/ata.4	Fri Nov  2 12:22:17 2001
 @@ -72,11 +74,11 @@
  .It Va hw.ata.atapi_dma
  set to 1 for DMA access, 0 for PIO (default is PIO).
  .It Va hw.ata.wc
 -set to 1 to enable Write Caching, 0 to disable (default is enabled)
 -(WARNING might cause data loss on power failures)
 +set to 1 to enable Write Caching, 0 to disable (default is disabled).
 +(WARNING: might cause data loss on power failures.)
  .It Va hw.ata.tags
 -set to 1 to enable Tagged Queuing support, 0 to disable (default is disabled)
 -(only IBM DPTA and DTLA drives support that)
 +set to 1 to enable Tagged Queuing support, 0 to disable (default is disabled).
 +(Only IBM DPTA and DTLA drives support that.)
  .El
  .Sh DESCRIPTION
  This driver provides access to disk drives, ATAPI CD-ROM and DVD drives,
 @@ -86,9 +88,9 @@
  .Pp
  The currently supported controllers with their maximum speed include:
  .Pp
 -.Bl -tag -width "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -compact
 +.Bl -tag -width "Promise Ultra/Fasttrak-100 TX2/TX4" -compact
  .It Acerlabs Aladdin
 -Ultra DMA 33 (UDMA2), 33 MB/sec
 +Ultra DMA 100 (UDMA5), 100 MB/sec (depending on model, max stated at boot)
  .It AMD 756
  Ultra DMA 66 (UDMA4), 66 MB/sec
  .It AMD 766
 @@ -101,10 +103,14 @@
  Ultra DMA 100 (UDMA5), 100 MB/sec
  .It Cypress 82C693
  DMA 2 (WDMA2), 16 MB/sec
 +.It Cyrix 5530
 +Ultra DMA 33 (UDMA2), 33 MB/sec
  .It HighPoint HPT366
  Ultra DMA 66 (UDMA4), 66 MB/sec
  .It HighPoint HPT370
  Ultra DMA 100 (UDMA5), 100 MB/sec
 +.It HighPoint HPT372
 +Ultra DMA 133 (UDMA6), 133 MB/sec
  .It Intel PIIX
  DMA 2 (WDMA2), 16 MB/sec
  .It Intel PIIX3
 @@ -125,57 +131,41 @@
  Ultra DMA 66 (UDMA4), 66 MB/sec
  .It Promise Ultra/Fasttrak-100
  Ultra DMA 100 (UDMA5), 100 MB/sec
 +.It Promise Ultra/Fasttrak-100 TX2/TX4
 +Ultra DMA 100 (UDMA5), 100 MB/sec
  .It ServerWorks ROSB4
  Ultra DMA 33 (UDMA2), 33 MB/sec
  .It SiS 5591
  Ultra DMA 33 (UDMA2), 33 MB/sec
 -.It Cyrix 5530
 -Ultra DMA 33 (UDMA2), 33 MB/sec
  .It VIA 82C586
  Ultra DMA 33 (UDMA2), 33 MB/sec
 +.It VIA 82C596
 +Ultra DMA 66 (UDMA4), 66 MB/sec (depending on model, max stated at boot)
  .It VIA 82C686a
  Ultra DMA 66 (UDMA4), 66 MB/sec
  .It VIA 82C686b
  Ultra DMA 100 (UDMA5), 100 MB/sec
  .El
  .Pp
 -All unknown chipsets can be supported at the maximum speed of 16 MB/sec.
 +All unknown chipsets are supported at the maximum speed of 16 MB/sec.
  .Pp
  The
  .Nm
  driver also allows for changes to the transfer mode of the devices
 -at a later time when the system is up and running.
 +at a later time when the system is up and running, see
 +.Xr atacontrol 8 .
  .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,
 +You can always try to set DMA mode on an ATAPI device using
 +.Xr atacontrol 8 ,
  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 and a string like the above,
 -for example:
 -.Pp
 -.Dl sysctl hw.atamodes=pio,pio,---,dma,pio,---,dma,---,
 -.Pp
 -The new modes are set as soon as the sysctl command returns.
  .Sh FILES
  .Bl -tag -width "/sys/i386/conf/GENERIC " -compact
  .It Pa /dev/ad*
 @@ -219,6 +209,9 @@
  unless they are run at the non-UDMA4 device's lower speed.
  The driver has been designed to handle that kind of setup but lots of
  older devices do not like this.
 +.Sh SEE ALSO
 +.Xr atacontrol 8 ,
 +.Xr burncd 8
  .Sh HISTORY
  The
  .Nm

From: Cyrille Lefevre <cyrille.lefevre@laposte.net>
To: David Malone <dwmalone@maths.tcd.ie>
Cc: FreeBSD-gnats-submit@FreeBSD.org, sos@FreeBSD.org
Subject: Re: misc/39202: ata(4) refer to sysctl(8) instead of atacontrol(8).
Date: Sat, 15 Jun 2002 06:25:25 +0200

 On Sat, Jun 15, 2002 at 01:47:55AM +0100, David Malone wrote:
 > -.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 and a string like the above,
 > -for example:
 > -.Pp
 > -.Dl sysctl hw.atamodes=pio,pio,---,dma,pio,---,dma,---,
 > -.Pp
 > -The new modes are set as soon as the sysctl command returns.
 >  .Sh FILES
 >  .Bl -tag -width "/sys/i386/conf/GENERIC " -compact
 >  .It Pa /dev/ad*
 
 why do you get rid of this sample section, that I've translated to
 atacontrol(8) equivalents, which may help many people having troubles
 w/ ATA modes ?
 
 an alternative would be to move it to a true EXAMPLES section in
 atacontrol(8) ?
 
 Cyrille.
 -- 
 Cyrille Lefevre                 mailto:cyrille.lefevre@laposte.net

From: David Malone <dwmalone@maths.tcd.ie>
To: Cyrille Lefevre <cyrille.lefevre@laposte.net>
Cc: FreeBSD-gnats-submit@FreeBSD.org, sos@FreeBSD.org
Subject: Re: misc/39202: ata(4) refer to sysctl(8) instead of atacontrol(8). 
Date: Sat, 15 Jun 2002 05:32:59 +0100

 > why do you get rid of this sample section, that I've translated to
 > atacontrol(8) equivalents, which may help many people having troubles
 > w/ ATA modes ?
 
 I was really just suggesting that we sync up ata(4) with -current.
 
 > an alternative would be to move it to a true EXAMPLES section in
 > atacontrol(8) ?
 
 I think adding them to the examples section of atacontrol would
 probably be a better idea, though Soren might have a better informed
 opinion.
 
 	David.

From: Soeren Schmidt <sos@freebsd.dk>
To: David Malone <dwmalone@maths.tcd.ie>
Cc: Cyrille Lefevre <cyrille.lefevre@laposte.net>,
	FreeBSD-gnats-submit@FreeBSD.org, sos@FreeBSD.org
Subject: Re: misc/39202: ata(4) refer to sysctl(8) instead of atacontrol(8).
Date: Sat, 15 Jun 2002 09:59:41 +0200 (CEST)

 It seems David Malone wrote:
 > On Wed, Jun 12, 2002 at 10:29:59PM +0200, Cyrille Lefevre wrote:
 > > 	while it should refer to atacontrol(8) to change ata modes
 > > 	since the sysctl hw.atamodes doesn't exists anymore.
 > 
 > I think the ata(4) man page has missed a few MFCs. The following
 > diff would sync it with -current (leaving out the bits which relate
 > to -current only device stuff).
 > 
 > Soren - would you like me to commit this when the code freeze is
 > over, or would you like to do it on your next MFC?
 
 Uhm I hashed out the changes with the RE@ and the agreement was
 made that they should commit it, apparently that newer happend :(
 
 -Sren

From: bmah@acm.org (Bruce A. Mah)
To: Soeren Schmidt <sos@freebsd.dk>
Cc: freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: misc/39202: ata(4) refer to sysctl(8) instead of atacontrol(8). 
Date: Fri, 21 Jun 2002 13:28:10 -0700

 --==_Exmh_231804730P
 Content-Type: text/plain; charset=us-ascii
 
 If memory serves me right, Soeren Schmidt wrote:
 
 >  > Soren - would you like me to commit this when the code freeze is
 >  > over, or would you like to do it on your next MFC?
 >  
 >  Uhm I hashed out the changes with the RE@ and the agreement was
 >  made that they should commit it, apparently that newer happend :(
 
 That's not the way I remember things.  :-p
 
 On 30 May, I sent you a diff which would sync up ata(4) in RELENG_4 with
 its counterpart in -CURRENT.  Later that day, you sent me back a
 complete manpage, with the comment:  "Actually this is more like it, but
 I [haven't] even gotten to commit it to -current yet :)"
 
 To me, this meant "hold off, I'm need to commit a new manpage to
 -CURRENT".  I was waiting for your commit so I could do a MFC.
 Sorry we had "crossed wires" on this one.
 
 Since the code freeze is over, RE has no objections to updates of the 
 ata(4) manpage.
 
 Bruce.
 
 
 
 --==_Exmh_231804730P
 Content-Type: application/pgp-signature
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.0.7 (FreeBSD)
 Comment: Exmh version 2.5+ 20020506
 
 iD8DBQE9E4xa2MoxcVugUsMRAporAJwJlOheFiwaJqm1Qaeodvkwbpn3lQCguZ+S
 6zV82eySfvdiGiKrW59sm5c=
 =0kb6
 -----END PGP SIGNATURE-----
 
 --==_Exmh_231804730P--
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Mon Jul 1 19:08:30 PDT 2002 
State-Changed-Why:  
Committed!  Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=39202 
>Unformatted:
