Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GROWFS(8)		  BSD System Manager's Manual		     GROWFS(8)

NAME
     growfs -- expand an existing UFS file system

SYNOPSIS
     growfs [-Ny] [-s size] special | filesystem

DESCRIPTION
     The growfs	utility	makes it possible to expand an UFS file	system.	 Be-
     fore running growfs the partition or slice	containing the file system
     must be extended using gpart(8).  If you are using	volumes	you must en-
     large them	by using gvinum(8).  The growfs	utility	extends	the size of
     the file system on	the specified special file.  The following options are
     available:

     -N	     "Test mode".  Causes the new file system parameters to be printed
	     out without actually enlarging the	file system.

     -y	     "Expert mode".  Usually growfs will ask you if you	took a backup
	     of	your data before and will do some tests	whether	special	is
	     currently mounted or whether there	are any	active snapshots on
	     the file system specified.	 This will be suppressed.  So use this
	     option with great care!

     -s	size
	     Determines	the size of the	file system after enlarging in sec-
	     tors.  Size is the	number of 512 byte sectors unless suffixed
	     with a b, k, m, g,	or t which denotes byte, kilobyte, megabyte,
	     gigabyte and terabyte respectively.  This value defaults to the
	     size of the raw partition specified in special (in	other words,
	     growfs will enlarge the file system to the	size of	the entire
	     partition).

EXAMPLES
     Expand root file system to	fill up	available space:
	   growfs /

     Resize /dev/ada0p1	partition to 2GB and expand the	file system:
	   gpart resize	-i 1 -s	2G ada0
	   growfs -s 2G	/dev/ada0p1

SEE ALSO
     dumpfs(8),	ffsinfo(8), fsck(8), fsdb(8), gpart(8),	newfs(8), tunefs(8)

HISTORY
     The growfs	utility	first appeared in FreeBSD 4.4.	The ability to resize
     mounted file systems was added in FreeBSD 10.0.

AUTHORS
     Christoph Herrmann	<chm@FreeBSD.org>
     Thomas-Henning von	Kamptz <tomsoft@FreeBSD.org>
     The GROWFS	team <growfs@Tomsoft.COM>
     Edward Tomasz Napierala <trasz@FreeBSD.org>

CAVEATS
     When expanding a file system mounted read-write, any writes to that file
     system will be temporarily	suspended until	the expansion is finished.

BUGS
     Normally growfs writes cylinder group summary to disk and reads it	again
     later for doing more updates.  This read operation	will provide unex-
     pected data when using -N.	 Therefore, this part cannot really be simu-
     lated and will be skipped in test mode.

BSD			       November	20, 2014			   BSD

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | HISTORY | AUTHORS | CAVEATS | BUGS

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=growfs&sektion=8&manpath=FreeBSD+10.2-RELEASE>

home | help