From modulus@xor.sqrt.ca  Wed Aug 28 19:55:16 2002
Return-Path: <modulus@xor.sqrt.ca>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 5A99F37B400
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 28 Aug 2002 19:55:16 -0700 (PDT)
Received: from xor.sqrt.ca (h24-82-193-97.wp.shawcable.net [24.82.193.97])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 46CE243E72
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 28 Aug 2002 19:55:10 -0700 (PDT)
	(envelope-from modulus@xor.sqrt.ca)
Received: from xor.sqrt.ca (smmsp@localhost [127.0.0.1])
	by xor.sqrt.ca (8.12.5/8.12.5) with ESMTP id g7T2t9wZ010077
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 28 Aug 2002 21:55:09 -0500 (CDT)
	(envelope-from modulus@xor.sqrt.ca)
Received: (from root@localhost)
	by xor.sqrt.ca (8.12.5/8.12.5/Submit) id g7T2t80D010076;
	Wed, 28 Aug 2002 21:55:08 -0500 (CDT)
Message-Id: <200208290255.g7T2t80D010076@xor.sqrt.ca>
Date: Wed, 28 Aug 2002 21:55:08 -0500 (CDT)
From: "Chris S.J. Peron" <maneo@bsdpro.com>
Reply-To: "Chris S.J. Peron" <maneo@bsdpro.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] growfs(8) manual fix
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         42148
>Category:       docs
>Synopsis:       [PATCH] growfs(8) manual fix
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Aug 28 20:00:08 PDT 2002
>Closed-Date:    Wed Nov 20 18:03:08 PST 2002
>Last-Modified:  Wed Nov 20 18:03:08 PST 2002
>Originator:     Chris S.J. Peron
>Release:        FreeBSD 4.6-STABLE i386
>Organization:
>Environment:
System: FreeBSD xor.sqrt.ca 4.6-STABLE FreeBSD 4.6-STABLE #3: Tue Aug 13 17:17:48 CDT 2002 cperon@xor.sqrt.ca:/usr/src/sys/compile/opcode i386


	
>Description:

The man page does not explicitly instruct the user that if
they wish to grow a filesystem beyond the boundary of the slice
the filesystem resides in, they will have to edit the size
of the slice using fdisk in addition to using disklabel.

	
>How-To-Repeat:

  Convert yourself into a not so clued user, man growfs and
	attempt to growfs your filesystem beyond the boundary of the
	slice as per the instructions in the manual.
	
	
>Fix:

--- growfs.8.bak	Wed Aug 28 20:59:58 2002
+++ growfs.8	Wed Aug 28 21:39:30 2002
@@ -57,6 +57,9 @@
 .Nm
 the disk must be labeled to a bigger size using
 .Xr disklabel 8 .
+If you wish to grow a filesystem beyound the boundary of
+the slice it resides in, you must re-size the slice using
+.Xr fdisk 8 .
 If you are using volumes you must enlarge them by using
 .Xr vinum 8 .
 .Nm
@@ -174,7 +177,8 @@
 .Xr fsck 8 ,
 .Xr newfs 8 ,
 .Xr tunefs 8 ,
-.Xr vinum 8
+.Xr vinum 8 ,
+.Xr fdisk 8
 .Sh AUTHORS
 .An Christoph Herrmann Aq chm@FreeBSD.org
 .An Thomas-Henning von Kamptz Aq tomsoft@FreeBSD.org

	


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: keramida 
State-Changed-When: Thu Aug 29 01:12:17 PDT 2002 
State-Changed-Why:  

The entries of the same section should be sorted alphabetically in SEE 
ALSO (and the sections sorted in numerical order: 1 first, then 2, etc.) 
I've committed a slightly different version of the diff to match this. 

In a few days, I'll merge this to STABLE, after I ask for RE approval 
since we're entering a code freeze for 4.7-RELEASE on September 1. 

Thanks. 


Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Thu Aug 29 01:12:17 PDT 2002 
Responsible-Changed-Why:  
My MFC reminder. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=42148 
State-Changed-From-To: patched->closed 
State-Changed-By: keramida 
State-Changed-When: Wed Nov 20 18:00:10 PST 2002 
State-Changed-Why:  
Merged to RELENG_4. 
Thanks for your contribution to making FreeBSD even better. 
It'd just have been nicer if I had worked a bit harder on PRs and 
managed to get this into 4.7-RELEASE too :/ 

http://www.freebsd.org/cgi/query-pr.cgi?pr=42148 
>Unformatted:
