Skip to contentSkip to conversation

verify_blkparse: man: document prereq and behavior

PATCH In review Steffen Maier 1 participant 1 message Apr 27, 2018

lore
Share & tools
lore
#0 lore raw

PATCH 7/31 verify_blkparse: man: document prereq and behavior

---
 doc/verify_blkparse.1 | 12 ++++++++++++
 1 file changed, 12 insertions(+)
doc/verify_blkparse.1 +12 -0
index c209ef8b4f33..8ea886ef83a3 100644
@@ -16,6 +16,18 @@ Verifies an output file from blkparse. All it does is check if the events in
 the file are correctly time ordered. If an entry is found that isn't ordered,
 it's dumped to stdout.
 
+This only works with blkparse's default output header up to and
+including timestamp. The sscanf format string for parsing input lines
+is "%3d,%3d %5d %8d %lf". This corresponds to blkparse's default
+output header prefix "%D %2c %8s %5T.%9t", see section DEFAULT OUTPUT
+HEADER in blkparse(1). Take care when using custom output format with
+blkparse options \fB-F\fR or \fB-f\fR.
+
+On reading an unrecognized input line, the tool exits early.
+
+Currently, false positives for sequence number aliases can be reported,
+because they are only tracked per CPU but not per device (major, minor).
+
 
 .SH AUTHORS
 \fIblkparse\fR was written by Jens Axboe, Alan D. Brunelle and Nathan Scott.  This
Signature · 1 line
2.14.2