From owner-freebsd-doc Sat Jan 19 22:10: 8 2002 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 2366537B41C for ; Sat, 19 Jan 2002 22:10:02 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g0K6A2855386; Sat, 19 Jan 2002 22:10:02 -0800 (PST) (envelope-from gnats) Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 15AE437B417 for ; Sat, 19 Jan 2002 22:08:58 -0800 (PST) Received: (from nobody@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g0K68wm55312; Sat, 19 Jan 2002 22:08:58 -0800 (PST) (envelope-from nobody) Message-Id: <200201200608.g0K68wm55312@freefall.freebsd.org> Date: Sat, 19 Jan 2002 22:08:58 -0800 (PST) From: Cameron Watters To: freebsd-gnats-submit@freebsd.org X-Send-Pr-Version: www-1.0 Subject: docs/34074: Handbook section 12.3 -- Adding Disks incomplete instructions for using disklabel Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >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