linux-xfs.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH] xfs_io: clarify the fsmap documentation
@ 2017-08-24 20:55 Darrick J. Wong
  0 siblings, 0 replies; only message in thread
From: Darrick J. Wong @ 2017-08-24 20:55 UTC (permalink / raw)
  To: Eric Sandeen; +Cc: xfs

Explicitly declare that the 'start' and 'end' arguments to fsmap require
one of -d, -l, or -r to select the data, log, or realtime device, and fix
misspelled command name while we're at it.

Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
---
 io/fsmap.c        |    2 ++
 man/man8/xfs_io.8 |    7 +++++--
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/io/fsmap.c b/io/fsmap.c
index 9e70c7b..448fb53 100644
--- a/io/fsmap.c
+++ b/io/fsmap.c
@@ -48,6 +48,8 @@ fsmap_help(void)
 " -n -- query n extents at a time.\n"
 " -m -- output machine-readable format.\n"
 " -v -- Verbose information, show AG and offsets.  Show flags legend on 2nd -v\n"
+"\n"
+"The optional start and end arguments require one of -d, -l, or -r to be set.\n"
 "\n"));
 }
 
diff --git a/man/man8/xfs_io.8 b/man/man8/xfs_io.8
index c87db0b..0082ca9 100644
--- a/man/man8/xfs_io.8
+++ b/man/man8/xfs_io.8
@@ -323,6 +323,9 @@ and
 .I end
 arguments can be used to constrain the output to a particular range of
 disk blocks.
+If these two options are specified, exactly one of
+.BR "-d" ", " "-l" ", or " "-r"
+must also be set.
 .RE
 .RS 1.0i
 .PD 0
@@ -372,12 +375,12 @@ for other filesystem metadata.
 .TP
 .BI \-n " num_extents"
 If this option is given,
-.B xfs_fsmap
+.B fsmap
 obtains the extent list of the file in groups of
 .I num_extents
 extents.
 In the absence of
-.BR \-n ", " xfs_fsmap
+.BR "-n" ", " "fsmap"
 queries the system for extents in groups of 131,072 records.
 .TP
 .B \-v

^ permalink raw reply related	[flat|nested] only message in thread

only message in thread, other threads:[~2017-08-24 20:56 UTC | newest]

Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-08-24 20:55 [PATCH] xfs_io: clarify the fsmap documentation Darrick J. Wong

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).