Debian Codegraph @

upstream/debian-trixie/man8/xfs_growfs.8

raw
1 .\" Verbatim blocks taken from openssl req manpage content
2 .de Vb \" Begin verbatim text
3 .ft CW
4 .nf
5 .ne \\$1
6 ..
7 .de Ve \" End verbatim text
8 .ft R
9 .fi
10 ..
11
12 .TH xfs_growfs 8
13 .SH NAME
14 xfs_growfs \- expand an XFS filesystem
15 .SH SYNOPSIS
16 .B xfs_growfs
17 [
18 .B \-dilnrx
19 ] [
20 .B \-D
21 .I size
22 ] [
23 .B \-e
24 .I rtextsize
25 ] [
26 .B \-L
27 .I size
28 ] [
29 .B \-m
30 .I maxpct
31 ] [
32 .B \-t
33 .I mtab
34 ] [
35 .B \-R
36 .I size
37 ]
38 [
39 .I mount-point
40 |
41 .I block-device
42 ]
43
44 .br
45 .B xfs_growfs \-V
46 .SH DESCRIPTION
47 .B xfs_growfs
48 expands an existing XFS filesystem (see
49 .BR xfs (5)).
50 The
51 .I mount-point
52 argument is the pathname of the directory where the filesystem
53 is mounted. The
54 .I block-device
55 argument is the device name of a mounted XFS filesystem.
56 The filesystem must be mounted to be grown (see
57 .BR mount (8)).
58 The existing contents of the filesystem are undisturbed, and the added space
59 becomes available for additional file storage.
60 .SH OPTIONS
61 .TP
62 .BI "\-d | \-D " size
63 Specifies that the data section of the filesystem should be resized. If the
64 .B \-D
65 .I size
66 option is given, the data section is changed to that
67 .IR size ,
68 otherwise the data section is grown to the largest size possible with the
69 .B \-d
70 option. The size is expressed in filesystem blocks. A filesystem with only
71 1 AG cannot be shrunk further, and a filesystem cannot be shrunk to the point
72 where it would only have 1 AG.
73 .TP
74 .B \-e
75 Allows the real-time extent size to be specified. In
76 .BR mkfs.xfs (8)
77 this is specified with
78 .B \-r extsize=\c
79 .IR nnnn .
80 .TP
81 .B \-i
82 The new log is an internal log (inside the data section).
83 .B [NOTE: This option is not implemented]
84 .TP
85 .BI "\-l | \-L " size
86 Specifies that the log section of the filesystem should be grown,
87 shrunk, or moved. If the
88 .B \-L
89 .I size
90 option is given, the log section is changed to be that
91 .IR size ,
92 if possible. The size is expressed in filesystem blocks.
93 The size of an internal log must be smaller than the size
94 of an allocation group (this value is printed at
95 .BR mkfs (8)
96 time). If neither
97 .B \-i
98 nor
99 .B \-x
100 is given with
101 .BR \-l ,
102 the log continues to be internal or external as it was before.
103 .B [NOTE: These options are not implemented]
104 .TP
105 .B \-m
106 Specify a new value for the maximum percentage
107 of space in the filesystem that can be allocated as inodes. In
108 .BR mkfs.xfs (8)
109 this is specified with
110 .B -i maxpct=\c
111 .IR nn .
112 .TP
113 .B \-n
114 Specifies that no change to the filesystem is to be made.
115 The filesystem geometry is printed, and argument checking is performed,
116 but no growth occurs.
117 .B See output examples below.
118 .TP
119 .BI "\-r | \-R " size
120 Specifies that the real-time section of the filesystem should be grown. If the
121 .B \-R
122 .I size
123 option is given, the real-time section is grown to that size, otherwise
124 the real-time section is grown to the largest size possible with the
125 .B \-r
126 option. The size is expressed in filesystem blocks.
127 The filesystem does not need to have contained a real-time section before
128 the
129 .B xfs_growfs
130 operation.
131 .TP
132 .B \-t
133 Specifies an alternate mount table file (default is
134 .I /proc/mounts
135 if it exists, else
136 .IR /etc/mtab ).
137 This is used when working with filesystems mounted without writing to
138 .I /etc/mtab
139 file - refer to
140 .BR mount (8)
141 for further details.
142 .TP
143 .B \-V
144 Prints the version number and exits. The
145 .I mount-point
146 argument is not required with
147 .BR \-V .
148 .PP
149 .B xfs_growfs
150 is most often used in conjunction with
151 logical volumes
152 (see
153 .BR md (4)
154 and
155 .BR lvm (8)
156 on Linux).
157 However, it can also be used on a regular disk partition, for example if a
158 partition has been enlarged while retaining the same starting block.
159 .SH PRACTICAL USE
160 Filesystems normally occupy all of the space on the device where they
161 reside. In order to grow a filesystem, it is necessary to provide added
162 space for it to occupy. Therefore there must be at least one spare new
163 disk partition available. Adding the space is often done through the use
164 of a logical volume manager.
165 .SH SEE ALSO
166 .BR mkfs.xfs (8),
167 .BR xfs_info (8),
168 .BR md (4),
169 .BR lvm (8),
170 .BR mount (8).