From root@gits.dyndns.org  Thu Jul 11 17:07:47 2002
Return-Path: <root@gits.dyndns.org>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 29E5B37B400
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 11 Jul 2002 17:07:47 -0700 (PDT)
Received: from smtp.noos.fr (racine.noos.net [212.198.2.71])
	by mx1.FreeBSD.org (Postfix) with ESMTP id E728F43E4A
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 11 Jul 2002 17:07:45 -0700 (PDT)
	(envelope-from root@gits.dyndns.org)
Received: (qmail 25115336 invoked by uid 0); 12 Jul 2002 00:07:44 -0000
Received: from unknown (HELO gits.gits.dyndns.org) ([212.198.229.153]) (envelope-sender <root@gits.dyndns.org>)
          by 212.198.2.71 (qmail-ldap-1.03) with SMTP
          for <FreeBSD-gnats-submit@freebsd.org>; 12 Jul 2002 00:07:44 -0000
Received: from gits.gits.dyndns.org (7cajl0qsywq4n5dn@localhost [127.0.0.1])
	by gits.gits.dyndns.org (8.12.5/8.12.5) with ESMTP id g6C07hTL025985;
	Fri, 12 Jul 2002 02:07:43 +0200 (CEST)
	(envelope-from root@gits.dyndns.org)
Received: (from root@localhost)
	by gits.gits.dyndns.org (8.12.5/8.12.5/Submit) id g6C07g3f025984;
	Fri, 12 Jul 2002 02:07:42 +0200 (CEST)
	(envelope-from root)
Message-Id: <200207120007.g6C07g3f025984@gits.gits.dyndns.org>
Date: Fri, 12 Jul 2002 02:07:42 +0200 (CEST)
From: Cyrille Lefevre <cyrille.lefevre@laposte.net>
Reply-To: Cyrille Lefevre <cyrille.lefevre@laposte.net>
To: FreeBSD-gnats-submit@freebsd.org
Cc: Tom Rhodes <trhodes@freebsd.org>
Subject: ata(4) samples moved to atacontrol(4).
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         40465
>Category:       docs
>Synopsis:       ata(4) samples moved to atacontrol(4).
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jul 11 17:10:01 PDT 2002
>Closed-Date:    Mon Dec 16 09:00:27 PST 2002
>Last-Modified:  Mon Dec 16 09:00:27 PST 2002
>Originator:     Cyrille Lefevre
>Release:        FreeBSD 4.6-STABLE i386
>Organization:
ACME
>Environment:
System: FreeBSD gits 4.6-STABLE FreeBSD 4.6-STABLE #16: Sat Jul  6 19:06:54 CEST 2002     root@gits:/disk2/freebsd/stable/src/sys/compile/CUSTOM  i386

>Description:
	this patch moves atacontrol (formerly sysctl) samples from ata(4)
	to atacontrol(4). also, currently supported modes are added.
>How-To-Repeat:
	man 4 atacontrol
>Fix:
Index: atacontrol.8
===================================================================
RCS file: /home/ncvs/src/sbin/atacontrol/atacontrol.8,v
retrieving revision 1.13.2.3
diff -u -r1.13.2.3 atacontrol.8
--- atacontrol.8	2 Apr 2002 14:49:24 -0000	1.13.2.3
+++ atacontrol.8	12 Jul 2002 00:03:09 -0000
@@ -145,6 +145,20 @@
 as argument (i.e.\&
 .Dq Li XXX ) ,
 and the mode will remain unchanged.
+.Pp
+Currently supported modes are :
+.Dq Li BIOSDMA ,
+.Dq Li PIO0 (alias BIOSPIO) ,
+.Dq Li PIO1 ,
+.Dq Li PIO2 ,
+.Dq Li PIO3 ,
+.Dq Li PIO4 ,
+.Dq Li WDMA2 ,
+.Dq Li UDMA2 (alias UDMA33) ,
+.Dq Li UDMA4 (alias UDMA66) ,
+.Dq Li UDMA5 (alias UDMA100)
+and
+.Dq Li UDMA6 (alias UDMA133) .
 .It Ic info
 Show info about the attached devices on the
 .Ar channel ,
@@ -161,6 +175,26 @@
 .It Ic list
 Show info about all attached devices on all active controllers.
 .El
+.Sh EXAMPLES
+To see the devices' current access modes, use the command line:
+.Pp
+.Dl atacontrol mode 0
+.Pp
+which results in the modes of the devices being displayed as a string
+like this:
+.Pp
+.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 atacontrol and a string like the above,
+for example:
+.Pp
+.Dl atacontrol mode 0 PIO4 PIO4
+.Pp
+The new modes are set as soon as the atacontrol command returns.
 .Sh SEE ALSO
 .Xr ata 4
 .Sh HISTORY
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: gnats-admin->freebsd-doc 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Sat Jul 13 14:46:53 PDT 2002 
Responsible-Changed-Why:  
Documentation PR. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=40465 
Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Mon Jul 15 08:36:33 PDT 2002 
Responsible-Changed-Why:  
I was working on this originally.  Thanks. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=40465 
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Sat Dec 14 10:38:43 PST 2002 
State-Changed-Why:  
Patched at HEAD and I'll MFC soon.  Thanks for the submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=40465 
State-Changed-From-To: patched->closed 
State-Changed-By: trhodes 
State-Changed-When: Mon Dec 16 09:00:03 PST 2002 
State-Changed-Why:  
MFC Completed this morning.  Thanks for the submission! 

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