Date: Sat, 19 Jan 2002 22:08:58 -0800 (PST) From: Cameron Watters <cameron@toolhouse.com> To: freebsd-gnats-submit@freebsd.org Subject: docs/34074: Handbook section 12.3 -- Adding Disks incomplete instructions for using disklabel Message-ID: <200201200608.g0K68wm55312@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 34074
>Category: docs
>Synopsis: Handbook section 12.3 -- Adding Disks incomplete instructions for using disklabel
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: sw-bug
>Submitter-Id: current-users
>Arrival-Date: Sat Jan 19 22:10:02 PST 2002
>Closed-Date:
>Last-Modified:
>Originator: Cameron Watters
>Release: 4.4-RELEASE
>Organization:
Toolhouse Design Company
>Environment:
N/A
>Description:
In section 12.3 Adding Disks, there is no mention of the fact that one must run disklabel -W prior to attempting either method of labeling the disk one is adding. While this is mentioned in the manpage for disklabel, the instructions in the handbook give the impression of being a complete step by step to performing this task. However, as according to the man page for disklabel, the disk's driver will simply quietly ignore any requests to write to the disklabel until the above command is performed. So, until one does run disklabel -W, all disklabels fail (even the ones from /stand/sysinstall) and therefor all newfs commands fail...and no where are you told this. The only indicator that there MIGHT be a problem is the fact that the disklabel sequence in /stand/sysinstall will tell you it can't mount your new partition(s) when you attempt to write out the config, HOWEVER, you are specifically instructed to ignore this message in the handbook.
>How-To-Repeat:
>Fix:
Add a sentence or two explaining the above and instruct the user to run disklabel -W prior to attempting to use either of the two methods given.
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200201200608.g0K68wm55312>