man/man8/xfs_growfs.8

   1 .TH xfs_growfs 8
   2 .SH NAME
   3 xfs_growfs, xfs_info \- expand an XFS filesystem
   4 .SH SYNOPSIS
   5 .nf
   6 \f3xfs_growfs\f1 [ \f3\-dilnrxV\f1 ] [ \f3\-D\f1 size ] [ \f3\-e\f1 rtextsize ]
   7                 [ \f3\-L\f1 size ] [ \f3\-m\f1 maxpct ] [ \f3-t\f1 mtab ]
   8                 [ \f3\-R\f1 size ] mount-point
   9 \f3xfs_info\f1 [ \f3-t\f1 mtab ] mount-point
  10 .fi
  11 .SH DESCRIPTION
  12 .I xfs_growfs
  13 expands an existing XFS filesystem (see
  14 .IR xfs (5)).
  15 The
  16 .I mount-point
  17 argument is the pathname of the directory where the filesystem
  18 is mounted.
  19 The filesystem must be mounted to be grown (see
  20 .IR mount (8)).
  21 The existing contents of the filesystem are undisturbed, and the added space
  22 becomes available for additional file storage.
  23 .PP
  24 .I xfs_info
  25 is equivalent to invoking
  26 .I xfs_growfs
  27 with the
  28 .B \-n
  29 option (see discussion below).
  30 .PP
  31 The options to
  32 .I xfs_growfs
  33 are:
  34 .TP
  35 \f3\-d\f1, \f3\-D\f1 \f2size\f1
  36 Specifies that the data section of the filesystem should be grown.
  37 If the
  38 .B \-D
  39 .I size
  40 option is given, the data section is grown to that size, otherwise
  41 the data section is grown to the largest size possible.
  42 The size
  43 is expressed in
  44 filesystem blocks.
  45 .TP
  46 .B \-e
  47 Allows the real-time extent size to be specified.
  48 In
  49 .IR mkfs.xfs (8)
  50 this is specified with
  51 .B \-r
  52 .BI extsize= nnnn.
  53 .TP
  54 .B \-i
  55 The new log is an internal log
  56 (inside the data section).
  57 .TP
  58 \f3\-l\f1, \f3\-L\f1 \f2size\f1
  59 Specifies that the log section of the filesystem should be grown,
  60 shrunk, or moved.
  61 If the
  62 .B \-L
  63 .I size
  64 option is given, the log section is changed to be that size,
  65 if possible.
  66 The size is expressed in
  67 filesystem blocks.
  68 The size of an internal log must be smaller than the size
  69 of an allocation group (this value is printed at \f2mkfs\f1(8) time).
  70 If neither
  71 .B \-i
  72 nor
  73 .B \-x
  74 is given with
  75 .BR \-l ,
  76 the log continues to be internal or external as it was before.
  77 .TP
  78 .B \-m
  79 Specify a new value for the maximum percentage
  80 of space in the filesystem that can be allocated as inodes.
  81 In
  82 .I mkfs.xfs
  83 this is specified with
  84 .B -i
  85 .BI maxpct= nn.
  86 .TP
  87 .B \-n
  88 Specifies that no change to the filesystem is to be made.
  89 The filesystem geometry is printed, and argument checking is performed,
  90 but no growth occurs.
  91 .TP
  92 \f3\-r\f1, \f3\-R\f1 \f2size\f1
  93 Specifies that the real-time section of the filesystem should be grown.
  94 If the
  95 .B \-R
  96 .I size
  97 option is given, the real-time section is grown to that size, otherwise
  98 the real-time section is grown to the largest size possible.
  99 The size
 100 is expressed in
 101 filesystem blocks.
 102 The filesystem does not need to have contained a real-time section before
 103 the \f2xfs_growfs\f1 operation.
 104 .TP
 105 .B \-t
 106 Specifies an alternate mount table file (default is
 107 .IR /etc/mtab ).
 108 This is used when working with filesystems mounted without writing to
 109 .I /etc/mtab
 110 file - refer to
 111 .BR mount (8)
 112 for further details.
 113 .TP
 114 .PP
 115 .I xfs_growfs
 116 is most often used in conjunction with
 117 logical volumes
 118 (see
 119 .IR lvm (8)
 120 ).
 121 However, it can also be used on a regular disk partition, for example if a
 122 partition has been enlarged while retaining the same starting block.
 123 .SH PRACTICAL USE
 124 Filesystems normally occupy all of the space on the device where they
 125 reside.
 126 In order to grow a filesystem, it is necessary to provide added
 127 space for it to occupy.
 128 Therefore there must be at least one spare new
 129 disk partition available.
 130 Adding the space is done through the mechanism of
 131 logical volumes.
 132 .SH SEE ALSO
 133 mkfs.xfs(8),
 134 lvm(8),
 135 mount(8).