sbin/growfs/growfs.8

   1 .\" Copyright (c) 2000 Christoph Herrmann, Thomas-Henning von Kamptz
   2 .\" Copyright (c) 1980, 1989, 1993 The Regents of the University of California.
   3 .\" All rights reserved.
   4 .\"
   5 .\" This code is derived from software contributed to Berkeley by
   6 .\" Christoph Herrmann and Thomas-Henning von Kamptz, Munich and Frankfurt.
   7 .\"
   8 .\" Redistribution and use in source and binary forms, with or without
   9 .\" modification, are permitted provided that the following conditions
  10 .\" are met:
  11 .\" 1. Redistributions of source code must retain the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer.
  13 .\" 2. Redistributions in binary form must reproduce the above copyright
  14 .\"    notice, this list of conditions and the following disclaimer in the
  15 .\"    documentation and/or other materials provided with the distribution.
  16 .\" 3. All advertising materials mentioning features or use of this software
  17 .\"    must display the following acknowledgment:
  18 .\"      This product includes software developed by the University of
  19 .\"      California, Berkeley and its contributors, as well as Christoph
  20 .\"      Herrmann and Thomas-Henning von Kamptz.
  21 .\" 4. Neither the name of the University nor the names of its contributors
  22 .\"    may be used to endorse or promote products derived from this software
  23 .\"    without specific prior written permission.
  24 .\"
  25 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  26 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  27 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  28 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  29 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  30 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  31 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  32 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  33 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  34 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  35 .\" SUCH DAMAGE.
  36 .\"
  37 .\" $TSHeader: src/sbin/growfs/growfs.8,v 1.3 2000/12/12 19:31:00 tomsoft Exp $
  38 .\" $FreeBSD$
  39 .\"
  40 .Dd April 30, 2012
  41 .Dt GROWFS 8
  42 .Os
  43 .Sh NAME
  44 .Nm growfs
  45 .Nd expand an existing UFS file system
  46 .Sh SYNOPSIS
  47 .Nm
  48 .Op Fl Ny
  49 .Op Fl s Ar size
  50 .Ar special | filesystem
  51 .Sh DESCRIPTION
  52 The
  53 .Nm
  54 utility makes it possible to expand an UFS file system.
  55 Before running
  56 .Nm
  57 the partition or slice containing the file system must be extended using
  58 .Xr gpart 8 .
  59 If you are using volumes you must enlarge them by using
  60 .Xr gvinum 8 .
  61 The
  62 .Nm
  63 utility extends the size of the file system on the specified special file.
  64 The following options are available:
  65 .Bl -tag -width indent
  66 .It Fl N
  67 .Dq Test mode .
  68 Causes the new file system parameters to be printed out without actually
  69 enlarging the file system.
  70 .It Fl y
  71 .Dq Expert mode .
  72 Usually
  73 .Nm
  74 will ask you if you took a backup of your data before and will do some tests
  75 whether
  76 .Ar special
  77 is currently mounted or whether there are any active snapshots on the file
  78 system specified.
  79 This will be suppressed.
  80 So use this option with great care!
  81 .It Fl s Ar size
  82 Determines the
  83 .Ar size
  84 of the file system after enlarging in sectors.
  85 .Ar Size
  86 is the number of 512 byte sectors unless suffixed with a
  87 .Cm b , k , m , g ,
  88 or
  89 .Cm t
  90 which
  91 denotes byte, kilobyte, megabyte, gigabyte and terabyte respectively.
  92 This value defaults to the size of the raw partition specified in
  93 .Ar special
  94 (in other words,
  95 .Nm
  96 will enlarge the file system to the size of the entire partition).
  97 .El
  98 .Sh EXAMPLES
  99 .Dl growfs -s 2G /dev/ada0p1
 100 .Pp
 101 will enlarge
 102 .Pa /dev/ada0p1
 103 up to 2GB if there is enough space in
 104 .Pa /dev/ada0p1 .
 105 .Sh SEE ALSO
 106 .Xr dumpfs 8 ,
 107 .Xr ffsinfo 8 ,
 108 .Xr fsck 8 ,
 109 .Xr fsdb 8 ,
 110 .Xr gpart 8 ,
 111 .Xr newfs 8 ,
 112 .Xr tunefs 8
 113 .Sh HISTORY
 114 The
 115 .Nm
 116 utility first appeared in
 117 .Fx 4.4 .
 118 The ability to resize mounted filesystems was added in
 119 .Fx 10.0 .
 120 .Sh AUTHORS
 121 .An Christoph Herrmann Aq chm@FreeBSD.org
 122 .An Thomas-Henning von Kamptz Aq tomsoft@FreeBSD.org
 123 .An The GROWFS team Aq growfs@Tomsoft.COM
 124 .An Edward Tomasz Napierala Aq trasz@FreeBSD.org
 125 .Sh CAVEATS
 126 When expanding a file system mounted read-write, any writes to that file system
 127 will be temporarily suspended until the expansion is finished.
 128 .Sh BUGS
 129 Normally
 130 .Nm
 131 writes cylinder group summary to disk and reads it again later for doing more
 132 updates.
 133 This read operation will provide unexpected data when using
 134 .Fl N .
 135 Therefore, this part cannot really be simulated and will be skipped in test
 136 mode.