misc/94625: growfs man page -- document "panic: not enough space" and mention gconcat

[Jeremy C. Reed]

>Number:         94625
>Category:       misc
>Synopsis:       growfs man page -- document "panic: not enough space" and mention gconcat
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Mar 17 23:50:21 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator:     Jeremy C. Reed
>Release:        6.0
>Organization:
>Environment:
>Description:
Please document "panic: not enough space" in growfs(8) manual so users of
growfs know how many bytes they need to be able to grow.

Also mention gconcat, maybe like:

--- /archive/FreeBSD-current/src/sbin/growfs/growfs.8   2005-01-18 02:09:34.000000000 -0800
+++ /home/reed/growfs.8 2006-03-17 15:41:38.000000000 -0800
@@ -64,7 +64,10 @@
 before running
 .Nm .
 If you are using volumes you must enlarge them by using
-.Xr vinum 8 .
+.Xr gconcat 8
+or
+.Xr vinum 8 ,
+as appropriate.
 The
 .Nm
 utility extends the size of the file system on the specified special file.


I don't know if ccd can "grow" a volume, if so mention ccdconfig(8) also.

>How-To-Repeat:
Use gconcat to add a /dev/md* memory disk. Then use growfs to grow file system. How do you know how much space is needed for growfs?

(I looked at code, but simplified explanation in man page would be appreciated.)
>Fix:

>Release-Note:
>Audit-Trail:
>Unformatted: