From nobody@FreeBSD.org  Sat Jan 19 22:08:58 2002
Return-Path: <nobody@FreeBSD.org>
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 15AE437B417
	for <freebsd-gnats-submit@FreeBSD.org>; 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 <cameron@toolhouse.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Handbook section 12.3 -- Adding Disks incomplete instructions for using disklabel
X-Send-Pr-Version: www-1.0

>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:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Jan 19 22:10:02 PST 2002
>Closed-Date:    Fri Feb 15 12:40:17 PST 2002
>Last-Modified:  Fri Feb 15 12:40:46 PST 2002
>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:

From: Hiten Pandya <hitmaster2k@yahoo.com>
To: freebsd-gnats-submit@FreeBSD.org
Cc: cameron@toolhouse.com
Subject: Re: docs/34074: Handbook section 12.3 -- Adding Disks incomplete instructions for using disklabel
Date: Tue, 22 Jan 2002 03:29:46 -0800 (PST)

 Sorry for the bluntness, but, AFAIK, all requests by
 /stand/sysinstall are normally completed without any
 errors.
 
 The man page, does mention about the -W option, and 
 its actions, but I've never found the need to apply
 this parameter to disklabel(8).
 
 Does this disklabel(8) issue arise only in certain
 conditions?
 
 __________________________________________________
 Do You Yahoo!?
 Send FREE video emails in Yahoo! Mail!
 http://promo.yahoo.com/videomail/

From: Cameron Watters <toolhouse12@web0.toolhouse.com>
To: Hiten Pandya <hitmaster2k@yahoo.com>
Cc: <freebsd-gnats-submit@FreeBSD.org>, <cameron@toolhouse.com>
Subject: Re: docs/34074: Handbook section 12.3 -- Adding Disks incomplete
 instructions for using disklabel
Date: Tue, 22 Jan 2002 09:24:28 -0800 (PST)

 HP> Sorry for the bluntness, but, AFAIK, all requests by
 HP> /stand/sysinstall are normally completed without any
 HP> errors.
 
 Quoting from the handbook:
 
 "Ignore any errors from Sysinstall  that it could not mount the new
 partition."
 
 This, in fact, is exactly what happens. Further, when I actually ran
 disklablel -W and THEN ran sysinstall, it didn't give me this error
 message.
 
 HP> The man page, does mention about the -W option, and
 HP> its actions, but I've never found the need to apply
 HP> this parameter to disklabel(8).
 
 I wouldn't have submitted this unless I hadn't tried for an hour to get
 the Handbook's instructions to work correctly.
 
 HP> Does this disklabel(8) issue arise only in certain
 HP> conditions?
 
 I should clarify that this only happens when using sysinstall on a system
 that has already been setup once. As the handbook directs, I was using it
 to add additional disks to an existing installation of FreeBSD.
 
 However, that is exactly the activity this portion of the handbook is
 trying to cover.
 
 --cameron
 

From: Tom Rhodes <darklogik@pittgoth.com>
To: freebsd-gnats-submit@FreeBSD.org,
	Cameron Watters <cameron@toolhouse.com>,
	Hiten Pandya <hitmaster2k@yahoo.com>
Cc:  
Subject: Re: docs/34074: adding disks, incorrect
Date: Mon, 11 Feb 2002 22:52:59 -0500

 Hello to all involved in this pr, fellow members of the doc team, anyone 
 else who is interested  ;)
 
 Tonight, I threw an extra hard disk into my system (4.5) and ran 
 sysinstall(8) to configure the drive.  On my 4.5 system, however, the 
 'Partition' option is not there.  At least, under the Configure option. 
  I also want to note that, I used:
 
 Configure > Fdisk > Label
 
 although Label fed me some error messages, a simple exit and restart of 
 sysinstall(8) and I was back into the label editor.  (Handbook is 
 incorrect about the "ignore any errors from sysinstall" because it in 
 fact does not write the label, and spits "DEBUG: MakeDev: Unknown 
 major/minor for devtype" during the attempted w process, and if you 
 ignore, you will not get labels at all)  This time, I obtained no error 
 messages when doing the write operation.  After a few diags, I have 
 noticed that using the disklabel(8) utility is not required, however, 
 you seem to be required to exit sysinstall(8) before you can use the 
 Label editor.  The point in case is not that disklabel is required, nor 
 that if you use sysinstall(8) apperently you are required to restart 
 before using the Label editor, but that the Handbook apperently has 
 incorrect information and a patch is required.  When I submit a patch, I 
 will also try to accomplish a grammer cleanup on more parts of the 
 handbook...  Anyone who has noticed a difference in their use of 
 sysinstall(8) for adding drives is requested to come forward and talk 
 with me ;)
 

From: Tom Rhodes <darklogik@pittgoth.com>
To: Freebsd-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/34074: More information on disks
Date: Mon, 11 Feb 2002 23:45:35 -0500

 --------------040600070706040708090204
 Content-Type: text/plain; charset=us-ascii; format=flowed
 Content-Transfer-Encoding: 7bit
 
 Hello to all involved in this pr, fellow members of the doc team, anyone 
 else who is interested  [;)]
 
 
 Tonight, I threw an extra hard disk into my system (4.5) and ran 
 sysinstall(8) to configure the drive.  On my 4.5 system, however, the 
 'Partition' option is not there.  At least, under the Configure option. 
 I also want to note that, I used:
 
 Configure > Fdisk > Label
 
 although Label fed me some error messages, a simple exit and restart of 
 sysinstall(8) and I was back into the label editor.  (Handbook is 
 incorrect about the "ignore any errors from sysinstall" because it in 
 fact does not write the label, and spits "DEBUG: MakeDev: Unknown 
 major/minor for devtype" during the attempted w process, and if you 
 ignore, you will not get labels at all)  This time, I obtained no error 
 messages when doing the write operation.  After a few diags, I have 
 noticed that using the disklabel(8) utility is not required, however, 
 you seem to be required to exit sysinstall(8) before you can use the 
 Label editor.  The point in case is not that disklabel is required, nor 
 that if you use sysinstall(8) apperently you are required to restart 
 before using the Label editor, but that the Handbook apperently has 
 incorrect information and a patch is required.  When I submit a patch, I 
 will also try to accomplish a grammer cleanup on more parts of the 
 handbook...  Anyone who has noticed a difference in their use of 
 sysinstall(8) for adding drives is requested to come forward and talk 
 with me please.
 
 --
 Tom Rhodes
 
 --------------040600070706040708090204--
 
State-Changed-From-To: open->closed 
State-Changed-By: jim 
State-Changed-When: Fri Feb 15 12:40:17 PST 2002 
State-Changed-Why:  
Merged with and closed by 34953.  Thanks! 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=34074 
>Unformatted:
