Adding upstream version 4.22.0.upstream/4.22.0

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

1 files changed, 199 insertions, 0 deletions

diff --git a/upstream/opensuse-tumbleweed/man8/xfs_admin.8 b/upstream/opensuse-tumbleweed/man8/xfs_admin.8
new file mode 100644
index 00000000..4794d677
--- /dev/null
+++ b/upstream/opensuse-tumbleweed/man8/xfs_admin.8
@@ -0,0 +1,199 @@
+.TH xfs_admin 8
+.SH NAME
+xfs_admin \- change parameters of an XFS filesystem
+.SH SYNOPSIS
+.B xfs_admin
+[
+.B \-eflpu
+] [
+.BI \-O " featurelist"
+] [
+.BR "\-c 0" | 1
+] [
+.B \-L
+.I label
+] [
+.B \-U
+.I uuid
+] [
+.B \-r
+.I rtdev
+]
+.I device
+[
+.I logdev
+]
+.br
+.B xfs_admin \-V
+.SH DESCRIPTION
+.B xfs_admin
+uses the
+.BR xfs_db (8)
+command to modify various parameters of a filesystem.
+.PP
+Devices that are mounted cannot be modified.
+Administrators must unmount filesystems before
+.BR xfs_admin " or " xfs_db (8)
+can convert parameters.
+A number of parameters of a mounted filesystem can be examined
+and modified using the
+.BR xfs_growfs (8)
+command.
+.PP
+The optional
+.B logdev
+parameter specifies the device special file where the filesystem's external
+log resides.
+This is required only for filesystems that use an external log.
+See the
+.B mkfs.xfs \-l
+option, and refer to
+.BR xfs (5)
+for a detailed description of the XFS log.
+.SH OPTIONS
+.TP
+.B \-e
+Enables unwritten extent support on a filesystem that does not
+already have this enabled (for legacy filesystems, it can't be
+disabled anymore at mkfs time).
+.IP
+This option only applies to the deprecated V4 format.
+.TP
+.B \-f
+Specifies that the filesystem image to be processed is stored in a
+regular file at
+.I device
+(see the
+.B mkfs.xfs \-d
+.I file
+option).
+.TP
+.B \-j
+Enables version 2 log format (journal format supporting larger
+log buffers).
+.IP
+This option only applies to the deprecated V4 format.
+.TP
+.B \-l
+Print the current filesystem label.
+.TP
+.B \-p
+Enable 32bit project identifier support (PROJID32BIT feature).
+.IP
+This option only applies to the deprecated V4 format.
+.TP
+.B \-u
+Print the current filesystem UUID (Universally Unique IDentifier).
+.TP
+.BR "\-c 0" | 1
+Enable (1) or disable (0) lazy-counters in the filesystem.
+.IP
+Lazy-counters may not be disabled on Version 5 superblock filesystems
+(i.e. those with metadata CRCs enabled).
+.IP
+In other words, this option only applies to the deprecated V4 format.
+.IP
+This operation may take quite a bit of time on large filesystems as the
+entire filesystem needs to be scanned when this option is changed.
+.IP
+With lazy-counters enabled, the superblock is not modified or logged on
+every change of the free-space and inode counters. Instead, enough
+information is kept in other parts of the filesystem to be able to
+maintain the counter values without needing to keep them in the
+superblock. This gives significant improvements in performance on some
+configurations and metadata intensive workloads.
+.TP
+.BI \-L " label"
+Set the filesystem label to
+.IR label .
+XFS filesystem labels can be at most 12 characters long; if
+.I label
+is longer than 12 characters,
+.B xfs_admin
+will truncate it and print a warning message.
+The filesystem label can be cleared using the special "\c
+.B \-\-\c
+" value for
+.IR label .
+.TP
+.BI \-O " feature1" = "status" , "feature2" = "status..."
+Add or remove features on an existing V5 filesystem.
+The features should be specified as a comma-separated list.
+.I status
+should be either 0 to disable the feature or 1 to enable the feature.
+Note, however, that most features cannot be disabled.
+.IP
+.B NOTE:
+Administrators must ensure the filesystem is clean by running
+.B xfs_repair -n
+to inspect the filesystem before performing the upgrade.
+If corruption is found, recovery procedures (e.g. reformat followed by
+restoration from backup; or running
+.B xfs_repair
+without the
+.BR -n )
+must be followed to clean the filesystem.
+.IP
+Supported features are as follows:
+.RS 0.7i
+.TP 0.4i
+.B inobtcount
+Keep a count the number of blocks in each inode btree in the AGI.
+This reduces mount time by speeding up metadata space reservation calculations.
+The filesystem cannot be downgraded after this feature is enabled.
+Once enabled, the filesystem will not be writable by older kernels.
+This feature was added to Linux 5.10.
+.TP 0.4i
+.B bigtime
+Upgrade a filesystem to support larger timestamps up to the year 2486.
+The filesystem cannot be downgraded after this feature is enabled.
+Once enabled, the filesystem will not be mountable by older kernels.
+This feature was added to Linux 5.10.
+.TP 0.4i
+.B nrext64
+Upgrade a filesystem to support large per-inode extent counters. The maximum
+data fork extent count will be 2^48 - 1, while the maximum attribute fork
+extent count will be 2^32 - 1. The filesystem cannot be downgraded after this
+feature is enabled. Once enabled, the filesystem will not be mountable by
+older kernels.  This feature was added to Linux 5.19.
+.RE
+.TP
+.BI \-U " uuid"
+Set the UUID of the filesystem to
+.IR uuid .
+A sample UUID looks like this: "c1b9d5a2-f162-11cf-9ece-0020afc76f16".
+The
+.I uuid
+may also be
+.BR nil ,
+which will set the filesystem UUID to the null UUID.
+The
+.I uuid
+may also be
+.BR generate ,
+which will generate a new UUID for the filesystem.  Note that on CRC-enabled
+filesystems, this will set an incompatible flag such that older kernels will
+not be able to mount the filesystem.  To remove this incompatible flag, use
+.BR restore ,
+which will restore the original UUID and remove the incompatible
+feature flag as needed.
+.TP
+.BI \-r " rtdev"
+Specifies the device special file where the filesystem's realtime section
+resides.
+Only for those filesystems which use a realtime section.
+.TP
+.B \-V
+Prints the version number and exits.
+.PP
+The
+.BR mount (8)
+manual entry describes how to mount a filesystem using its label or UUID,
+rather than its block special device name.
+.SH SEE ALSO
+.BR mkfs.xfs (8),
+.BR mount (8),
+.BR xfs_db (8),
+.BR xfs_growfs (8),
+.BR xfs_repair (8),
+.BR xfs (5).