1xfs_growfs(8) System Manager's Manual xfs_growfs(8)
2
6 xfs_growfs, xfs_info - expand an XFS filesystem
7
9 xfs_growfs [ -dilnrxV ] [ -D size ] [ -e rtextsize ] [ -L size ] [ -m
10 maxpct ] [ -t mtab ] [ -R size ] mount-point
11 xfs_info [ -t mtab ] mount-point
12
14 xfs_growfs expands an existing XFS filesystem (see xfs(5)). The mount-
15 point argument is the pathname of the directory where the filesystem is
16 mounted. The filesystem must be mounted to be grown (see mount(8)).
17 The existing contents of the filesystem are undisturbed, and the added
18 space becomes available for additional file storage.
19 xfs_info is equivalent to invoking xfs_growfs with the -n option (see
21 discussion below).
22
24 -d | -D size
25 Specifies that the data section of the filesystem should be
26 grown. If the -D size option is given, the data section is grown
27 to that size, otherwise the data section is grown to the largest
28 size possible with the -d option. The size is expressed in
29 filesystem blocks.
30 -e Allows the real-time extent size to be specified. In mkfs.xfs(8)
32 this is specified with -r extsize=nnnn.
33 -i The new log is an internal log (inside the data section).
35 [NOTE: This option is not implemented]
36 -l | -L size
38 Specifies that the log section of the filesystem should be
39 grown, shrunk, or moved. If the -L size option is given, the log
40 section is changed to be that size, if possible. The size is
41 expressed in filesystem blocks. The size of an internal log
42 must be smaller than the size of an allocation group (this value
43 is printed at mkfs(8) time). If neither -i nor -x is given with
44 -l, the log continues to be internal or external as it was
45 before. [NOTE: These options are not implemented]
46 -m Specify a new value for the maximum percentage of space in the
48 filesystem that can be allocated as inodes. In mkfs.xfs(8) this
49 is specified with -i maxpct=nn.
50 -n Specifies that no change to the filesystem is to be made. The
52 filesystem geometry is printed, and argument checking is per‐
53 formed, but no growth occurs.
54 -r | -R size
56 Specifies that the real-time section of the filesystem should be
57 grown. If the -R size option is given, the real-time section is
58 grown to that size, otherwise the real-time section is grown to
59 the largest size possible with the -r option. The size is
60 expressed in filesystem blocks. The filesystem does not need to
61 have contained a real-time section before the xfs_growfs opera‐
62 tion.
63 -t Specifies an alternate mount table file (default is /proc/mounts
65 if it exists, else /etc/mtab). This is used when working with
66 filesystems mounted without writing to /etc/mtab file - refer to
67 mount(8) for further details.
68 -V Prints the version number and exits. The mount-point argument is
70 not required with -V.
71 xfs_growfs is most often used in conjunction with logical volumes (see
73 md(4) and lvm(8) on Linux). However, it can also be used on a regular
74 disk partition, for example if a partition has been enlarged while
75 retaining the same starting block.
76
78 Filesystems normally occupy all of the space on the device where they
79 reside. In order to grow a filesystem, it is necessary to provide added
80 space for it to occupy. Therefore there must be at least one spare new
81 disk partition available. Adding the space is often done through the
82 use of a logical volume manager.
83
85 mkfs.xfs(8), md(4), lvm(8), mount(8).
86 xfs_growfs(8)