]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - sbin/growfs/growfs.8
ident(1): Normalizing date format
[FreeBSD/FreeBSD.git] / 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 December 13, 2017
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 Causes
72 .Nm
73 to assume yes
74 as the answer to all operator questions.
75 .It Fl s Ar size
76 Determines the
77 .Ar size
78 of the file system after enlarging in sectors.
79 .Ar Size
80 is the number of 512 byte sectors unless suffixed with a
81 .Cm b , k , m , g ,
82 or
83 .Cm t
84 which
85 denotes byte, kilobyte, megabyte, gigabyte and terabyte respectively.
86 This value defaults to the size of the raw partition specified in
87 .Ar special
88 (in other words,
89 .Nm
90 will enlarge the file system to the size of the entire partition).
91 .El
92 .Sh EXAMPLES
93 Expand root file system to fill up available space:
94 .Dl growfs /
95 .Pp
96 Refresh the LUN size, resize the partition to use all available
97 capacity, and expand the filesystem accordingly:
98 .Dl camcontrol reprobe da0
99 .Dl gpart recover da0
100 .Dl gpart resize -i 1 da0
101 .Dl growfs /dev/da0p1
102 .Sh SEE ALSO
103 .Xr camcontrol 8 ,
104 .Xr fsck 8 ,
105 .Xr gpart 8 ,
106 .Xr newfs 8 ,
107 .Xr tunefs 8
108 .Sh HISTORY
109 The
110 .Nm
111 utility first appeared in
112 .Fx 4.4 .
113 The ability to resize mounted file systems was added in
114 .Fx 10.0 .
115 .Sh AUTHORS
116 .An Christoph Herrmann Aq Mt chm@FreeBSD.org
117 .An Thomas-Henning von Kamptz Aq Mt tomsoft@FreeBSD.org
118 .An The GROWFS team Aq Mt growfs@Tomsoft.COM
119 .An Edward Tomasz Napierala Aq Mt trasz@FreeBSD.org
120 .Sh CAVEATS
121 When expanding a file system mounted read-write, any writes to that file system
122 will be temporarily suspended until the expansion is finished.
123 .Sh BUGS
124 Normally
125 .Nm
126 writes cylinder group summary to disk and reads it again later for doing more
127 updates.
128 This read operation will provide unexpected data when using
129 .Fl N .
130 Therefore, this part cannot really be simulated and will be skipped in test
131 mode.