Blame gfs2/man/gfs2_grow.8

Packit 6ef888
.TH gfs2_grow 8
Packit 6ef888
Packit 6ef888
.SH NAME
Packit 6ef888
gfs2_grow - Expand a GFS2 filesystem
Packit 6ef888
Packit 6ef888
.SH SYNOPSIS
Packit 6ef888
.B gfs2_grow
Packit 6ef888
[\fIOPTION\fR]... <\fIDEVICE\fR|\fIMOUNTPOINT\fR>...
Packit 6ef888
Packit 6ef888
.SH DESCRIPTION
Packit 6ef888
gfs2_grow is used to expand a GFS2 filesystem after the device
Packit 6ef888
upon which the filesystem resides has also been expanded.  By
Packit 6ef888
running gfs2_grow on a GFS2 filesystem, you are requesting that
Packit 6ef888
any spare space between the current end of the filesystem and
Packit 6ef888
the end of the device is filled with a newly initialized GFS2
Packit 6ef888
filesystem extension.  When this operation is complete, the resource
Packit 6ef888
group index for the filesystem is updated so that all nodes in the
Packit 6ef888
cluster can use the extra storage space that has been added.
Packit 6ef888
Packit 6ef888
You may only run gfs2_grow on a mounted filesystem; expansion of 
Packit 6ef888
unmounted filesystems is not supported.  You only need to
Packit 6ef888
run gfs2_grow on one node in the cluster.  All the other nodes will
Packit 6ef888
see the expansion has occurred and automatically start to use the
Packit 6ef888
newly available space.
Packit 6ef888
Packit 6ef888
You must be superuser to execute \fBgfs2_grow\fP.  The gfs2_grow
Packit 6ef888
tool tries to prevent you from corrupting your filesystem by checking as
Packit 6ef888
many of the likely problems as it can.  When expanding a filesystem,
Packit 6ef888
only the last step of updating the resource index affects the currently
Packit 6ef888
mounted filesystem and so failure part way through the expansion process
Packit 6ef888
should leave your filesystem in its original unexpanded state.
Packit 6ef888
Packit 6ef888
You can run gfs2_grow with the \fB-T\fP flag to get a display
Packit 6ef888
of the current state of a mounted GFS2 filesystem.
Packit 6ef888
Packit 6ef888
The gfs2_grow tool uses the resource group (RG) size that was originally
Packit 6ef888
calculated when mkfs.gfs2 was done.  This allows tools like fsck.gfs2
Packit 6ef888
to better ensure the integrity of the file system.  Since the new free
Packit 6ef888
space often does not lie on even boundaries based on that RG size,
Packit 6ef888
there may be some unused space on the device after gfs2_grow is run.
Packit 6ef888
.SH OPTIONS
Packit 6ef888
.TP
Packit 6ef888
\fB-D\fP
Packit 6ef888
Print out debugging information about the filesystem layout.
Packit 6ef888
.TP
Packit 6ef888
\fB-h\fP
Packit 6ef888
Prints out a short usage message and exits.
Packit 6ef888
.TP
Packit 6ef888
\fB-q\fP
Packit 6ef888
Be quiet.  Don't print anything.
Packit 6ef888
.TP
Packit 6ef888
\fB-T\fP
Packit 6ef888
Test. Do all calculations, but do not write any data to the disk and do
Packit 6ef888
not expand the filesystem. This is used to discover what the tool would
Packit 6ef888
have done were it run without this flag.
Packit 6ef888
.TP
Packit 6ef888
\fB-V\fP
Packit 6ef888
Version. Print out version information, then exit.
Packit 6ef888
Packit 6ef888
.SH BUGS
Packit 6ef888
Packit 6ef888
There is no way to shrink a GFS2 filesystem.
Packit 6ef888
Packit 6ef888
.SH SEE ALSO
Packit 6ef888
mkfs.gfs2(8) gfs2_jadd(8)
Packit 6ef888