1
2xfs_growfs(8)               System Manager's Manual              xfs_growfs(8)
3
4
5

NAME

7       xfs_growfs - expand an XFS filesystem
8

SYNOPSIS

10       xfs_growfs  [  -dilnrx  ] [ -D size ] [ -e rtextsize ] [ -L size ] [ -m
11       maxpct ] [ -t mtab ] [ -R size ] mount-point
12       xfs_growfs -V
13

DESCRIPTION

15       xfs_growfs expands an existing XFS filesystem (see xfs(5)).  The mount-
16       point argument is the pathname of the directory where the filesystem is
17       mounted. The filesystem must be mounted to  be  grown  (see  mount(8)).
18       The  existing contents of the filesystem are undisturbed, and the added
19       space becomes available for additional file storage.
20

OPTIONS

22       -d | -D size
23              Specifies that the data section  of  the  filesystem  should  be
24              grown. If the -D size option is given, the data section is grown
25              to that size, otherwise the data section is grown to the largest
26              size  possible  with  the  -d  option.  The size is expressed in
27              filesystem blocks.
28
29       -e     Allows the real-time extent size to be specified. In mkfs.xfs(8)
30              this is specified with -r extsize=nnnn.
31
32       -i     The  new  log  is  an  internal  log  (inside the data section).
33              [NOTE: This option is not implemented]
34
35       -l | -L size
36              Specifies that the log  section  of  the  filesystem  should  be
37              grown, shrunk, or moved. If the -L size option is given, the log
38              section is changed to be that size, if  possible.  The  size  is
39              expressed  in  filesystem  blocks.   The size of an internal log
40              must be smaller than the size of an allocation group (this value
41              is  printed at mkfs(8) time). If neither -i nor -x is given with
42              -l, the log continues to be  internal  or  external  as  it  was
43              before.  [NOTE: These options are not implemented]
44
45       -m     Specify  a  new value for the maximum percentage of space in the
46              filesystem that can be allocated as inodes. In mkfs.xfs(8)  this
47              is specified with -i maxpct=nn.
48
49       -n     Specifies  that  no change to the filesystem is to be made.  The
50              filesystem geometry is printed, and argument  checking  is  per‐
51              formed, but no growth occurs.  See output examples below.
52
53       -r | -R size
54              Specifies that the real-time section of the filesystem should be
55              grown. If the -R size option is given, the real-time section  is
56              grown  to that size, otherwise the real-time section is grown to
57              the largest size possible  with  the  -r  option.  The  size  is
58              expressed in filesystem blocks.  The filesystem does not need to
59              have contained a real-time section before the xfs_growfs  opera‐
60              tion.
61
62       -t     Specifies an alternate mount table file (default is /proc/mounts
63              if it exists, else /etc/mtab).  This is used when  working  with
64              filesystems mounted without writing to /etc/mtab file - refer to
65              mount(8) for further details.
66
67       -V     Prints the version number and exits. The mount-point argument is
68              not required with -V.
69
70       xfs_growfs  is most often used in conjunction with logical volumes (see
71       md(4) and lvm(8) on Linux).  However, it can also be used on a  regular
72       disk  partition,  for  example  if  a partition has been enlarged while
73       retaining the same starting block.
74

PRACTICAL USE

76       Filesystems normally occupy all of the space on the device  where  they
77       reside. In order to grow a filesystem, it is necessary to provide added
78       space for it to occupy. Therefore there must be at least one spare  new
79       disk  partition  available.  Adding the space is often done through the
80       use of a logical volume manager.
81

SEE ALSO

83       mkfs.xfs(8), xfs_info(8), md(4), lvm(8), mount(8).
84
85
86
87                                                                 xfs_growfs(8)
Impressum