All of lore.kernel.org
 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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.