xfsprogs: Fix manpages for missing or incorrect options

Add valid options which aren't in manpages, and
remove invalid options which are in manpages:

* Document -V (show version and exit) for many manpages.
* Remove -? option from xfs_estimate.8
* Document -p passes, -d (debug) and -g (syslog) in xfs_fsr.8
* Document -n (O_NONBLOCK) in xfs_io.8
* Document -v (print overwrite) in xfs_logprint.8
* Document -m max_extents in xfs_metadump.8
* Document -p (preallocate) in xfs_mkfile.8

Signed-off-by: Eric Sandeeen <sandeen@redhat.com>
Reviewed-by: Rich Johnston <rjohnston@sgi.com>
Signed-off-by: Rich Johnston <rjohnston@sgi.com>

diff --git a/man/man8/mkfs.xfs.8 b/man/man8/mkfs.xfs.8
index f707881e4873badbd0404a68634f364ebea6e103..04c19b4ce2de9b751f8b9c6b32d00a9b05b719c3 100644 (file)
--- a/man/man8/mkfs.xfs.8
+++ b/man/man8/mkfs.xfs.8
@@ -40,6 +40,8 @@ mkfs.xfs \- construct an XFS filesystem
 .B \-K
 ]
 .I device
+.br
+.B mkfs.xfs \-V
 .SH DESCRIPTION
 .B mkfs.xfs
 constructs an XFS filesystem by writing on a special
@@ -728,6 +730,9 @@ creating the file system.
 .TP
 .B \-K
 Do not attempt to discard blocks at mkfs time.
+.TP
+.B \-V
+Prints the version number and exits.
 .SH SEE ALSO
 .BR xfs (5),
 .BR mkfs (8),

diff --git a/man/man8/xfs_admin.8 b/man/man8/xfs_admin.8
index 2de907bb69182ea9f073ef805123a7d6a8457580..b393d7446ead1b1d80bd4af121bd99e860b4d5d8 100644 (file)
--- a/man/man8/xfs_admin.8
+++ b/man/man8/xfs_admin.8
@@ -15,6 +15,8 @@ xfs_admin \- change parameters of an XFS filesystem
 .I uuid
 ]
 .I device
+.br
+.B xfs_admin \-V
 .SH DESCRIPTION
 .B xfs_admin
 uses the
@@ -97,6 +99,9 @@ The
 may also be
 .BR generate ,
 which will generate a new UUID for the filesystem.
+.TP
+.B \-V
+Prints the version number and exits.
 .PP
 The
 .BR mount (8)

diff --git a/man/man8/xfs_bmap.8 b/man/man8/xfs_bmap.8
index ccaa79bed689c47812374b820ce435577ec955ea..e196559a1ae1410489a6ce1eaad3e6dae2c4d354 100644 (file)
--- a/man/man8/xfs_bmap.8
+++ b/man/man8/xfs_bmap.8
@@ -10,6 +10,8 @@ xfs_bmap \- print block mapping for an XFS file
 .I num_extents
 ]
 .I file
+.br
+.B xfs_bmap \-V
 .SH DESCRIPTION
 .B xfs_bmap
 prints the map of disk blocks used by files in an XFS filesystem.
@@ -91,6 +93,9 @@ A second
 option will print out the
 .I flags
 legend.
+.TP
+.B \-V
+Prints the version number and exits.
 .SH SEE ALSO
 .BR xfs_fsr (8),
 .BR xfs (5).

diff --git a/man/man8/xfs_check.8 b/man/man8/xfs_check.8
index 1654532b2d304d69b35c8ed8da37d069e33eecdb..23027ca799bf0f1db6d221d804ca1583e1ac929a 100644 (file)
--- a/man/man8/xfs_check.8
+++ b/man/man8/xfs_check.8
@@ -20,6 +20,8 @@ xfs_check \- check XFS filesystem consistency
 .I logdev
 ]
 .I device
+.br
+.B xfs_check \-V
 .SH DESCRIPTION
 .B xfs_check
 checks whether an XFS filesystem is consistent.
@@ -89,6 +91,9 @@ Conversion between disk addresses (i.e. addresses reported by
 and file system blocks may be accomplished using
 .BR xfs_db "(8)'s " convert
 command.
+.TP
+.B \-V
+Prints the version number and exits.
 .PP
 Any output that is produced when
 .B xfs_check

diff --git a/man/man8/xfs_copy.8 b/man/man8/xfs_copy.8
index 3028db89340cdbadd28f740cc997036395b39f7d..1eaf85d54ca2a58ca5b269c5cf7c3f4e6852bc8c 100644 (file)
--- a/man/man8/xfs_copy.8
+++ b/man/man8/xfs_copy.8
@@ -13,6 +13,8 @@ xfs_copy \- copy the contents of an XFS filesystem
 [
 .I target2
 \&... ]
+.br
+.B xfs_copy \-V
 .SH DESCRIPTION
 .B xfs_copy
 copies an XFS filesystem to one or more targets in parallel (see
@@ -87,6 +89,9 @@ Specifies the location of the
 if the default location of
 .I /var/tmp/xfs_copy.log.XXXXXX
 is not desired.
+.TP
+.B \-V
+Prints the version number and exits.
 .SH DIAGNOSTICS
 .B xfs_copy
 reports errors to both

diff --git a/man/man8/xfs_db.8 b/man/man8/xfs_db.8
index 05586714e08524ff74ef420befb90e49a2dfed28..7a43a2c1aa80f5f43e8f2ec75541e022b09488cd 100644 (file)
--- a/man/man8/xfs_db.8
+++ b/man/man8/xfs_db.8
@@ -103,7 +103,7 @@ and
 commands.
 .TP
 .B \-V
-Prints out the current version number and exits.
+Prints the version number and exits.
 .SH CONCEPTS
 .B xfs_db
 commands can be broken up into two classes. Most commands are for

diff --git a/man/man8/xfs_estimate.8 b/man/man8/xfs_estimate.8
index bb458ec99458ace004a54d14e89e2b637a207f7a..2594eb878cdae5f961b918946026f2498935b670 100644 (file)
--- a/man/man8/xfs_estimate.8
+++ b/man/man8/xfs_estimate.8
@@ -3,8 +3,10 @@
 xfs_estimate \- estimate the space that an XFS filesystem will take
 .SH SYNOPSIS
 .nf
-\f3xfs_estimate\f1 [ \f3\-h?\f1 ] [ \f3\-b\f1 blocksize ] [ \f3\-i\f1 logsize ]
+\f3xfs_estimate\f1 [ \f3\-h\f1 ] [ \f3\-b\f1 blocksize ] [ \f3\-i\f1 logsize ]
                   [ \f3\-e\f1 logsize ] [ \f3\-v\f1 ] directory ...
+.br
+.B xfs_estimate \-V
 .fi
 .SH DESCRIPTION
 For each \f2directory\f1 argument,
@@ -51,9 +53,6 @@ Display more information, formatted.
 .B \-h
 Display usage message.
 .TP
-.B \-?
-Display usage message.
-.TP
 \f3\-i, \-e\f1 \f2logsize\f1
 Use
 .I logsize
@@ -77,6 +76,9 @@ For example,
 .IP
 requests an estimate of the space required by the directory / on an
 XFS filesystem using an internal log of 1 megabyte.
+.TP
+.B \-V
+Print the version number and exits.
 .SH EXAMPLES
 .nf
 .sp 8v

diff --git a/man/man8/xfs_freeze.8 b/man/man8/xfs_freeze.8
index 97c7911996a4864cd67934d663848587aa148621..c581ad772dad52396b91fae8f6203fc1c1b0fa35 100644 (file)
--- a/man/man8/xfs_freeze.8
+++ b/man/man8/xfs_freeze.8
@@ -2,10 +2,15 @@
 .SH NAME
 xfs_freeze \- suspend access to an XFS filesystem
 .SH SYNOPSIS
-.B xfs_freeze \-f
+.B xfs_freeze
+[
+.B \-f
 |
 .B \-u
+]
 .I mount-point
+.br
+.B xfs_freeze \-V
 .fi
 .SH DESCRIPTION
 .B xfs_freeze
@@ -25,6 +30,7 @@ is mounted.
 The filesystem must be mounted to be frozen (see
 .BR mount (8)).
 .PP
+.PP
 The
 .B \-f
 flag requests the specified XFS filesystem to be
@@ -48,7 +54,13 @@ operations to continue.
 Any filesystem modifications that were blocked by the freeze are
 unblocked and allowed to complete.
 .PP
-One of
+The
+.B \-V
+flag prints the version number and exits.
+.PP
+Unless
+.B \-V
+is specified, one of
 .B \-f
 or
 .B \-u

diff --git a/man/man8/xfs_fsr.8 b/man/man8/xfs_fsr.8
index bf5e94251873a945904dc48c0fe979e7ba8f417e..0a162b6074c05be15ea2f741c3f848c91e61f0be 100644 (file)
--- a/man/man8/xfs_fsr.8
+++ b/man/man8/xfs_fsr.8
@@ -3,10 +3,12 @@
 xfs_fsr \- filesystem reorganizer for XFS
 .SH SYNOPSIS
 .nf
-\f3xfs_fsr\f1 [\f3\-v\f1] \c
-[\f3\-t\f1 seconds] [\f3\-f\f1 leftoff] [\f3\-m\f1 mtab]
-\f3xfs_fsr\f1 [\f3\-v\f1] \c
+\f3xfs_fsr\f1 [\f3\-vdg\f1] \c
+[\f3\-t\f1 seconds] [\f3\-p\f1 passes] [\f3\-f\f1 leftoff] [\f3\-m\f1 mtab]
+\f3xfs_fsr\f1 [\f3\-vdg\f1] \c
 [xfsdev | file] ...
+.br
+.B xfs_fsr \-V
 .fi
 .SH DESCRIPTION
 .I xfs_fsr
@@ -35,7 +37,11 @@ The default is to use
 .TP
 .BI \-t " seconds"
 How long to reorganize.
-The default is 7200 (2 hours).
+The default is 7200 seconds (2 hours).
+.TP
+.BI \-p " passes"
+Number of passes before terminating global re-org.
+The default is 10 passes.
 .TP
 .BI \-f " leftoff"
 Use this file instead of
@@ -47,6 +53,16 @@ to store the state of where reorganization left off.
 Verbose.
 Print cryptic information about
 each file being reorganized.
+.TP
+.B \-d
+Debug.  Print even more cryptic information.
+.TP
+.B \-g
+Print to syslog (default if stdout not a tty).
+.TP
+.B \-V
+Prints the version number and exits.
+
 .PP
 When invoked with no arguments
 .I xfs_fsr

diff --git a/man/man8/xfs_growfs.8 b/man/man8/xfs_growfs.8
index b55438bf8b504f9b50c45679a19e12b7d8d5055d..e23d30e28a8d53ac89f4a6db42e429cbbcd5b221 100644 (file)
--- a/man/man8/xfs_growfs.8
+++ b/man/man8/xfs_growfs.8
@@ -15,7 +15,7 @@ xfs_growfs, xfs_info \- expand an XFS filesystem
 .SH SYNOPSIS
 .B xfs_growfs
 [
-.B \-dilnrxV
+.B \-dilnrx
 ] [
 .B \-D
 .I size
@@ -37,12 +37,17 @@ xfs_growfs, xfs_info \- expand an XFS filesystem
 ]
 .I mount-point
 .br
+.B xfs_growfs \-V
+.PP
+.br
 .B xfs_info
 [
 .B \-t
 .I mtab
 ]
 .I mount-point
+.br
+.B xfs_info \-V
 .SH DESCRIPTION
 .B xfs_growfs
 expands an existing XFS filesystem (see

diff --git a/man/man8/xfs_io.8 b/man/man8/xfs_io.8
index 33a594462a99f25a20853412640d3ba2a05ad63c..5e3535b0fce17d36204a24517f25294fb0572377 100644 (file)
--- a/man/man8/xfs_io.8
+++ b/man/man8/xfs_io.8
@@ -13,6 +13,8 @@ xfs_io \- debug the I/O path of an XFS filesystem
 .I prog
 ]
 .I file
+.br
+.B xfs_io \-V
 .SH DESCRIPTION
 .B xfs_io
 is a debugging tool like
@@ -52,6 +54,9 @@ is immutable or append-only.
 .B \-x
 Expert mode. Dangerous commands are only available in this mode.
 These commands also tend to require additional privileges.
+.TP
+.B \-V
+Prints the version number and exits.
 .PP
 The other
 .BR open (2)
@@ -111,6 +116,9 @@ opens for synchronous I/O (O_SYNC).
 .B \-t
 truncates on open (O_TRUNC).
 .TP
+.B \-n
+opens in non-blocking mode if possible (O_NONBLOCK).
+.TP
 .B \-R
 marks the file as a realtime XFS file after
 opening it, if it is not already marked as such.

diff --git a/man/man8/xfs_logprint.8 b/man/man8/xfs_logprint.8
index c1a8077c3b13b520e590419d94bf0ee1a0796236..16e881ee8f230d253617f573426d336aa6af1ae3 100644 (file)
--- a/man/man8/xfs_logprint.8
+++ b/man/man8/xfs_logprint.8
@@ -97,6 +97,12 @@ Override any notion of where to start printing.
 .TP
 .B \-t
 Print out the transactional view.
+.TP
+.B \-v
+Print "overwrite" data.
+.TP
+.B \-V
+Prints the version number and exits.
 .SH SEE ALSO
 .BR mkfs.xfs (8),
 .BR mount (8).

diff --git a/man/man8/xfs_mdrestore.8 b/man/man8/xfs_mdrestore.8
index 7b9ba8924e8b83502d1cce81cec85b56edc5e947..51297c48e39326f327d6fe271fa99a59dea1b48a 100644 (file)
--- a/man/man8/xfs_mdrestore.8
+++ b/man/man8/xfs_mdrestore.8
@@ -8,6 +8,8 @@ xfs_mdrestore \- restores an XFS metadump image to a filesystem image
 ]
 .I source
 .I target
+.br
+.B xfs_mdrestore \-V
 .SH DESCRIPTION
 .B xfs_mdrestore
 is a debugging tool that restores a metadata image generated by
@@ -36,6 +38,9 @@ can be destroyed.
 .TP
 .B \-g
 Shows restore progress on stdout.
+.TP
+.B \-V
+Prints the version number and exits.
 .SH DIAGNOSTICS
 .B xfs_mdrestore
 returns an exit code of 0 if all the metadata is successfully restored or

diff --git a/man/man8/xfs_metadump.8 b/man/man8/xfs_metadump.8
index 9672713e45b30b28ded860c2d143d5189b94ce3b..26cea97f205e51c685a1084f8363804bfe4896f1 100644 (file)
--- a/man/man8/xfs_metadump.8
+++ b/man/man8/xfs_metadump.8
@@ -6,11 +6,17 @@ xfs_metadump \- copy XFS filesystem metadata to a file
 [
 .B \-efgow
 ] [
+.B \-m
+.I max_extents
+]
+] [
 .B \-l
 .I logdev
 ]
 .I source
 .I target
+.br
+.B xfs_metadump \-V
 .SH DESCRIPTION
 .B xfs_metadump
 is a debugging tool that copies the metadata from an XFS filesystem to a file.
@@ -94,12 +100,20 @@ For filesystems which use an external log, this specifies the device where the
 external log resides. The external log is not copied, only internal logs are
 copied.
 .TP
+.B \-m
+Set the maximum size of an allowed metadata extent.  Extremely large metadata
+extents are likely to be corrupt, and will be skipped if they exceed
+this value.  The default size is 1000 blocks.
+.TP
 .B \-o
 Disables obfuscation of file names and extended attributes.
 .TP
 .B \-w
 Prints warnings of inconsistent metadata encountered to stderr. Bad metadata
 is still copied.
+.TP
+.B \-V
+Prints the version number and exits.
 .SH DIAGNOSTICS
 .B xfs_metadump
 returns an exit code of 0 if all readable metadata is successfully copied or

diff --git a/man/man8/xfs_mkfile.8 b/man/man8/xfs_mkfile.8
index 96f443fd2710521cb0bdb00e8b33e2183426c44e..abaa4e60e0f04b1df6be299cb4e7be87bae18dc9 100644 (file)
--- a/man/man8/xfs_mkfile.8
+++ b/man/man8/xfs_mkfile.8
@@ -7,10 +7,14 @@ xfs_mkfile \- create an XFS file
 .B \-v
 ] [
 .B \-n
+] [
+.B \-p
 ]
 .I size\c
 .RB [ k | b | m | g ]
 .IR filename " ..."
+.br
+.B xfs_mkfile \-V
 .SH DESCRIPTION
 .B xfs_mkfile
 creates one or more files. The file is padded with zeroes by default.
@@ -30,3 +34,10 @@ Verbose. Report the names and sizes of created files.
 .B \-n
 No bytes. Create a holey file - that is, do not write out any data, just
 seek to end of file and write a block.
+.TP
+.B \-p
+Preallocate.  The file is preallocated, then overwritten with zeroes,
+then truncated to the desired size.
+.TP
+.B \-V
+Prints the version number and exits.

diff --git a/man/man8/xfs_ncheck.8 b/man/man8/xfs_ncheck.8
index 408919d05b53132ac6bf4f1a96121a8f56205888..40997722d56cb1bda438f9f1b62f5dcd6e342a4c 100644 (file)
--- a/man/man8/xfs_ncheck.8
+++ b/man/man8/xfs_ncheck.8
@@ -15,6 +15,8 @@ xfs_ncheck \- generate pathnames from i-numbers for XFS
 .I logdev
 ]
 .I device
+.br
+.B xfs_ncheck \-V
 .SH DESCRIPTION
 .B xfs_ncheck
 with no
@@ -56,6 +58,9 @@ This option may be used to detect violations of security policy.
 .BI \-i " ino"
 Limits the report to only those files whose inode numbers follow.
 May be given multiple times to select multiple inode numbers.
+.TP
+.B \-V
+Prints the version number and exits.
 .PP
 If the filesystem is seriously corrupted, or very busy and looks
 like it is corrupt, a message of the form that would be generated by

diff --git a/man/man8/xfs_quota.8 b/man/man8/xfs_quota.8
index 9327feb06f6697db3b54a7ac7241a8d02aad5667..8cc8ab7a38f06419cd543ed6c4dfe9c8464d9bad 100644 (file)
--- a/man/man8/xfs_quota.8
+++ b/man/man8/xfs_quota.8
@@ -16,6 +16,8 @@ xfs_quota \- manage use of quota on XFS filesystems
 .I project
 ] ... [
 .IR path " ... ]"
+.br
+.B xfs_quota \-V
 .SH DESCRIPTION
 .B xfs_quota
 is a utility for reporting and editing various aspects of filesystem quota.
@@ -50,6 +52,9 @@ which restricts the output of the individual
 commands to the set of projects specified. Multiple
 .B \-d
 arguments may be given.
+.TP
+.B \-V
+Prints the version number and exits.
 .PP
 The optional
 .I path

diff --git a/man/man8/xfs_repair.8 b/man/man8/xfs_repair.8
index 7b296ba09314f83b51912388d0cdd1c0c737296d..96adb2916febd7a9c168845e39b2bc54627dbc77 100644 (file)
--- a/man/man8/xfs_repair.8
+++ b/man/man8/xfs_repair.8
@@ -173,7 +173,7 @@ to repair an XFS filesystem mounted read only. This is typically done
 on a root filesystem from single user mode, immediately followed by a reboot.
 .TP
 .B \-V
-Prints out the current version number and exits.
+Prints the version number and exits.
 .SS Checks Performed
 Inconsistencies corrected include the following:
 .IP 1.

diff --git a/man/man8/xfs_rtcp.8 b/man/man8/xfs_rtcp.8
index be81cb3493f1784e1d6b55921793e2df6e7a25db..40e9097e5131dd8559f74a4972096146c37bd38f 100644 (file)
--- a/man/man8/xfs_rtcp.8
+++ b/man/man8/xfs_rtcp.8
@@ -10,6 +10,8 @@ xfs_rtcp \- XFS realtime copy command
 .B -p
 ]
 .IR source " ... " target
+.br
+.B xfs_rtcp \-V
 .SH DESCRIPTION
 .B xfs_rtcp
 copies a file to the realtime partition on an XFS filesystem.
@@ -35,6 +37,9 @@ will pad the destination file to a size which is an even multiple
 of the filesystem block size.
 This is necessary since the realtime file is created using
 direct I/O and the minimum I/O is the filesystem block size.
+.TP
+.B \-V
+Prints the version number and exits.
 .SH SEE ALSO
 .BR xfs (5),
 .BR mkfs.xfs (8),