Debian Codegraph @

upstream/debian-unstable/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 .B [NOTE: Only shrinking the last AG without removing it is implemented]
74 .TP
75 .B \-e
76 Allows the real-time extent size to be specified. In
77 .BR mkfs.xfs (8)
78 this is specified with
79 .B \-r extsize=\c
80 .IR nnnn .
81 .TP
82 .B \-i
83 The new log is an internal log (inside the data section).
84 .B [NOTE: This option is not implemented]
85 .TP
86 .BI "\-l | \-L " size
87 Specifies that the log section of the filesystem should be grown,
88 shrunk, or moved. If the
89 .B \-L
90 .I size
91 option is given, the log section is changed to be that
92 .IR size ,
93 if possible. The size is expressed in filesystem blocks.
94 The size of an internal log must be smaller than the size
95 of an allocation group (this value is printed at
96 .BR mkfs (8)
97 time). If neither
98 .B \-i
99 nor
100 .B \-x
101 is given with
102 .BR \-l ,
103 the log continues to be internal or external as it was before.
104 .B [NOTE: These options are not implemented]
105 .TP
106 .B \-m
107 Specify a new value for the maximum percentage
108 of space in the filesystem that can be allocated as inodes. In
109 .BR mkfs.xfs (8)
110 this is specified with
111 .B -i maxpct=\c
112 .IR nn .
113 .TP
114 .B \-n
115 Specifies that no change to the filesystem is to be made.
116 The filesystem geometry is printed, and argument checking is performed,
117 but no growth occurs.
118 .B See output examples below.
119 .TP
120 .BI "\-r | \-R " size
121 Specifies that the real-time section of the filesystem should be grown. If the
122 .B \-R
123 .I size
124 option is given, the real-time section is grown to that size, otherwise
125 the real-time section is grown to the largest size possible with the
126 .B \-r
127 option. The size is expressed in filesystem blocks.
128 The filesystem does not need to have contained a real-time section before
129 the
130 .B xfs_growfs
131 operation.
132 .TP
133 .B \-t
134 Specifies an alternate mount table file (default is
135 .I /proc/mounts
136 if it exists, else
137 .IR /etc/mtab ).
138 This is used when working with filesystems mounted without writing to
139 .I /etc/mtab
140 file - refer to
141 .BR mount (8)
142 for further details.
143 .TP
144 .B \-V
145 Prints the version number and exits. The
146 .I mount-point
147 argument is not required with
148 .BR \-V .
149 .PP
150 .B xfs_growfs
151 is most often used in conjunction with
152 logical volumes
153 (see
154 .BR md (4)
155 and
156 .BR lvm (8)
157 on Linux).
158 However, it can also be used on a regular disk partition, for example if a
159 partition has been enlarged while retaining the same starting block.
160 .SH PRACTICAL USE
161 Filesystems normally occupy all of the space on the device where they
162 reside. In order to grow a filesystem, it is necessary to provide added
163 space for it to occupy. Therefore there must be at least one spare new
164 disk partition available. Adding the space is often done through the use
165 of a logical volume manager.
166 .SH SEE ALSO
167 .BR mkfs.xfs (8),
168 .BR xfs_info (8),
169 .BR md (4),
170 .BR lvm (8),
171 .BR mount (8).