Date: Mon, 3 Sep 2007 11:13:55 GMT From: Ian Smith <smithi@nimnet.asn.au> To: freebsd-gnats-submit@FreeBSD.org Subject: docs/116047: bsdlabel(8) manpage doesn't mention 'auto' type for -w Message-ID: <200709031113.l83BDtcQ036230@www.freebsd.org> Resent-Message-ID: <200709031120.l83BKFwx082343@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200709031113.l83BDtcQ036230>