docs/116047: bsdlabel(8) manpage doesn't mention 'auto' type for
>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:
_______________________________________________
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"