| 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). |