Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 170 insertions, 0 deletions

diff --git a/upstream/opensuse-tumbleweed/man8/xfs_growfs.8 b/upstream/opensuse-tumbleweed/man8/xfs_growfs.8
new file mode 100644
index 00000000..a0126927
--- /dev/null
+++ b/upstream/opensuse-tumbleweed/man8/xfs_growfs.8
@@ -0,0 +1,170 @@
+.\" Verbatim blocks taken from openssl req manpage content
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+
+.TH xfs_growfs 8
+.SH NAME
+xfs_growfs \- expand an XFS filesystem
+.SH SYNOPSIS
+.B xfs_growfs
+[
+.B \-dilnrx
+] [
+.B \-D
+.I size
+] [
+.B \-e
+.I rtextsize
+] [
+.B \-L
+.I size
+] [
+.B \-m
+.I maxpct
+] [
+.B \-t
+.I mtab
+] [
+.B \-R
+.I size
+]
+[
+.I mount-point
+|
+.I block-device
+]
+
+.br
+.B xfs_growfs \-V
+.SH DESCRIPTION
+.B xfs_growfs
+expands an existing XFS filesystem (see
+.BR xfs (5)).
+The
+.I mount-point
+argument is the pathname of the directory where the filesystem
+is mounted. The
+.I block-device
+argument is the device name of a mounted XFS filesystem.
+The filesystem must be mounted to be grown (see
+.BR mount (8)).
+The existing contents of the filesystem are undisturbed, and the added space
+becomes available for additional file storage.
+.SH OPTIONS
+.TP
+.BI "\-d | \-D " size
+Specifies that the data section of the filesystem should be resized. If the
+.B \-D
+.I size
+option is given, the data section is changed to that
+.IR size ,
+otherwise the data section is grown to the largest size possible with the
+.B \-d
+option. The size is expressed in filesystem blocks. A filesystem with only
+1 AG cannot be shrunk further, and a filesystem cannot be shrunk to the point
+where it would only have 1 AG.
+.TP
+.B \-e
+Allows the real-time extent size to be specified. In
+.BR mkfs.xfs (8)
+this is specified with
+.B \-r extsize=\c
+.IR nnnn .
+.TP
+.B \-i
+The new log is an internal log (inside the data section).
+.B [NOTE: This option is not implemented]
+.TP
+.BI "\-l | \-L " size
+Specifies that the log section of the filesystem should be grown,
+shrunk, or moved. If the
+.B \-L
+.I size
+option is given, the log section is changed to be that
+.IR size ,
+if possible. The size is expressed in filesystem blocks.
+The size of an internal log must be smaller than the size
+of an allocation group (this value is printed at
+.BR mkfs (8)
+time). If neither
+.B \-i
+nor
+.B \-x
+is given with
+.BR \-l ,
+the log continues to be internal or external as it was before.
+.B [NOTE: These options are not implemented]
+.TP
+.B \-m
+Specify a new value for the maximum percentage
+of space in the filesystem that can be allocated as inodes. In
+.BR mkfs.xfs (8)
+this is specified with
+.B -i maxpct=\c
+.IR nn .
+.TP
+.B \-n
+Specifies that no change to the filesystem is to be made.
+The filesystem geometry is printed, and argument checking is performed,
+but no growth occurs.
+.B See output examples below.
+.TP
+.BI "\-r | \-R " size
+Specifies that the real-time section of the filesystem should be grown. If the
+.B \-R
+.I size
+option is given, the real-time section is grown to that size, otherwise
+the real-time section is grown to the largest size possible with the
+.B \-r
+option. The size is expressed in filesystem blocks.
+The filesystem does not need to have contained a real-time section before
+the
+.B xfs_growfs
+operation.
+.TP
+.B \-t
+Specifies an alternate mount table file (default is
+.I /proc/mounts
+if it exists, else
+.IR /etc/mtab ).
+This is used when working with filesystems mounted without writing to
+.I /etc/mtab
+file - refer to
+.BR mount (8)
+for further details.
+.TP
+.B \-V
+Prints the version number and exits. The
+.I mount-point
+argument is not required with
+.BR \-V .
+.PP
+.B xfs_growfs
+is most often used in conjunction with
+logical volumes
+(see
+.BR md (4)
+and
+.BR lvm (8)
+on Linux).
+However, it can also be used on a regular disk partition, for example if a
+partition has been enlarged while retaining the same starting block.
+.SH PRACTICAL USE
+Filesystems normally occupy all of the space on the device where they
+reside. In order to grow a filesystem, it is necessary to provide added
+space for it to occupy. Therefore there must be at least one spare new
+disk partition available. Adding the space is often done through the use
+of a logical volume manager.
+.SH SEE ALSO
+.BR mkfs.xfs (8),
+.BR xfs_info (8),
+.BR md (4),
+.BR lvm (8),
+.BR mount (8).