From owner-freebsd-doc@FreeBSD.ORG Mon Aug 8 18:50:11 2005 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5A2EF16A41F for ; Mon, 8 Aug 2005 18:50:11 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 88E3143D49 for ; Mon, 8 Aug 2005 18:50:10 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j78IoAA7068805 for ; Mon, 8 Aug 2005 18:50:10 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j78IoAFD068801; Mon, 8 Aug 2005 18:50:10 GMT (envelope-from gnats) Resent-Date: Mon, 8 Aug 2005 18:50:10 GMT Resent-Message-Id: <200508081850.j78IoAFD068801@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Kevin Oberman Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A30B616A41F for ; Mon, 8 Aug 2005 18:42:35 +0000 (GMT) (envelope-from oberman@es.net) Received: from postal2.es.net (postal2.es.net [198.128.3.206]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6B76F43D46 for ; Mon, 8 Aug 2005 18:42:35 +0000 (GMT) (envelope-from oberman@es.net) Received: from ptavv.es.net ([198.128.4.29]) by postal2.es.net (Postal Node 2) with ESMTP (SSL) id IBA74465 for ; Mon, 08 Aug 2005 11:42:34 -0700 Received: by ptavv.es.net (Tachyon Server, from userid 9381) id 1E0485D08; Mon, 8 Aug 2005 11:42:34 -0700 (PDT) Message-Id: <20050808184234.1E0485D08@ptavv.es.net> Date: Mon, 8 Aug 2005 11:42:34 -0700 (PDT) From: Kevin Oberman To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/84676: atacontrol manpage not current for V5, V6, and -current X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Kevin Oberman List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Aug 2005 18:50:11 -0000 >Number: 84676 >Category: docs >Synopsis: atacontrol manpage not current for V5, V6, and -current >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Aug 08 18:50:10 GMT 2005 >Closed-Date: >Last-Modified: >Originator: Kevin Oberman >Release: FreeBSD 5.4-STABLE i386 >Organization: >Environment: System: FreeBSD ptavv.es.net 5.4-STABLE FreeBSD 5.4-STABLE #37: Fri Jan 28 11:48:02 PST 2005 oberman@ptavv.es.net:/usr/obj/usr/src/sys/PTAVV i386 >Description: The man page for atacontrol(8) does not reflect the current syntax of the command. The argumnets for several commands have changed from simply the controller number to the controller name, but the man pages don't reflect this. >How-To-Repeat: N/A >Fix: --- atacontrol.8 Mon May 16 08:09:13 2005 +++ atacontrol.8.new Fri May 20 09:27:35 2005 @@ -38,13 +38,13 @@ .Pp .Nm .Ic attach -.Ar channel +.Ar controller .Nm .Ic detach -.Ar channel +.Ar controller .Nm .Ic reinit -.Ar channel +.Ar controller .Nm .Ic create .Ar type Oo Ar interleave Oc Ar disk0 ... diskN @@ -65,7 +65,7 @@ .Ar device .Nm .Ic info -.Ar channel +.Ar controller .Nm .Ic cap .Ar device @@ -87,25 +87,26 @@ exercise caution when using this command! .Pp The -.Ar channel -argument is the number of the ATA channel on which to operate. +.Ar controller +argument is the name of the ATA controller on which to operate. Ususally +'ataN'. The following commands are supported: .Bl -tag -width "rebuild" .It Ic attach Attach an ATA -.Ar channel . -Devices on the channel are probed and attached as +Ar controller . +Devices on the controller are probed and attached as is done on boot. .It Ic detach Detach an ATA -.Ar channel . -Devices on the channel are removed from the kernel, +.Ar controller . +Devices on the controlller are removed from the kernel, and all outstanding transfers etc.\& are returned back to the system marked as failed. .It Ic reinit Reinitialize an ATA -.Ar channel . -Both devices on the channel are reset and +.Ar controller . +Both devices on the controller are reset and initialized to the parameters the ATA driver has stored internally. Devices that have gone bad and no longer respond to the probe, or devices that have physically been removed, are removed from the kernel. @@ -192,7 +193,7 @@ .Ar device . .It Ic info Show info about the attached devices on the -.Ar channel . +.Ar controller . .It Ic list Show info about all attached devices on all active controllers. .El >Release-Note: >Audit-Trail: >Unformatted: