From owner-freebsd-doc@FreeBSD.ORG Mon Sep 3 11:20:16 2007 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0621A16A41B for ; Mon, 3 Sep 2007 11:20:16 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id D55EB13C4A6 for ; Mon, 3 Sep 2007 11:20:15 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.1/8.14.1) with ESMTP id l83BKF7K082344 for ; Mon, 3 Sep 2007 11:20:15 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.1/8.14.1/Submit) id l83BKFwx082343; Mon, 3 Sep 2007 11:20:15 GMT (envelope-from gnats) Resent-Date: Mon, 3 Sep 2007 11:20:15 GMT Resent-Message-Id: <200709031120.l83BKFwx082343@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, Ian Smith Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 215E716A420 for ; Mon, 3 Sep 2007 11:13:56 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id F1C0E13C48D for ; Mon, 3 Sep 2007 11:13:55 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.1/8.14.1) with ESMTP id l83BDtsM036231 for ; Mon, 3 Sep 2007 11:13:55 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.1/8.14.1/Submit) id l83BDtcQ036230; Mon, 3 Sep 2007 11:13:55 GMT (envelope-from nobody) Message-Id: <200709031113.l83BDtcQ036230@www.freebsd.org> Date: Mon, 3 Sep 2007 11:13:55 GMT From: Ian Smith To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/116047: bsdlabel(8) manpage doesn't mention 'auto' type for -w X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 03 Sep 2007 11:20:16 -0000 >Number: 116047 >Category: docs >Synopsis: bsdlabel(8) manpage doesn't mention 'auto' type for -w >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Sep 03 11:20:13 GMT 2007 >Closed-Date: >Last-Modified: >Originator: Ian Smith >Release: 5.5-STABLE and 6.1-RELEASE >Organization: Nimbin Network Association >Environment: FreeBSD paqi.nimnet.asn.au 5.5-STABLE FreeBSD 5.5-STABLE #0: Sat Mar 3 03:14:13 EST 2007 root@paqi.nimnet.asn.au:/usr/obj/usr/src/sys/PAQI5S_3 i386 >Description: This applies equally to the 7-CURRENT manpage (footer: FreeBSD 6.2) at http://www.freebsd.org/cgi/man.cgi?query=bsdlabel&apropos=0&sektion=0&manpath=FreeBSD+7-current&format=html bsdlabel(8) fails to mention that type 'auto' may be used instead of not specifying any type. mdconfig(8), at least, uses 'bsdlabel -w md0 auto' in an example, which is why I found it missing. > Writing a Standard Label > To write a standard label, use the form > > bsdlabel -w [-An] [-m machine] disk [type] > > If the drive type is specified, the entry of that name in the disktab(5) > file is used; otherwise a default layout is used. 'auto' is the value adopted if no type is specified anyway. bsdlabel.c: case WRITE: if (argc == 2) name = argv[1]; else if (argc == 1) name = "auto"; else usage(); readlabel(0); makelabel(name, &lab); makelabel() then uses type 'auto' to call getvirginlabel() rather than to getdiskbyname(type) from /etc/disktab Bit trivial for a first docs PR, but Kris said I should :) >How-To-Repeat: man mdconfig # second last example man bsdlabel # search for 'auto' >Fix: A proper patch would only be against my 5.5-STABLE (Mar07) but suggested: If the drive type is specified, the entry of that name in the disktab(5) - file is used; otherwise a default layout is used. If the drive type is specified, the entry of that name in the disktab(5) + file is used; otherwise - or if specified as 'auto' - a default layout + is used. >Release-Note: >Audit-Trail: >Unformatted: