Hi Jens, I needed to follow practical block I/O request behavior and was new to blktrace. So I read the docs, noted down where I had questions, did code history research, and collected my experience during practical use. This is the result, hoping somebody else might find it useful. Patches 1-20 are documentation updates (incl. tool usage output). While I synchronized the man page updates mostly into blktrace.tex, some things such as option details did not fit nicely into the latex tables. Removing the 2 reference sections for blktrace(8) and blkparse(1) from the tex file and instead referring to the man pages would be an option to avoid sync issues. But then again, I guess the tex file was the origin for the man pages in the first place. Patches 21-23 are small bugfixes. Patches 24-31 are small enhancements. Steffen Maier (31): btt: doc: PDF output with bookmark structure and clickable cross references btt: doc: small fixes btrace: fix usage by adding -h (blkparse --hash-by-name) btrace: fix usage by adding -v (blkparse --verbose) btrace: man: improve by pointing to blkparse for option -r (debugfs) blkrawverify: man: fix input format, reports written unconditionally verify_blkparse: man: document prereq and behavior blkparse: man: fix typos and formatting, complete and update information blktrace: man: fix typos and formatting, complete and update information blktrace: doc: PDF output with bookmark structure and clickable cross references blktrace: doc: add table of contents to show document structure blktrace: doc: blktrace: sync fixes from man page updates blktrace: doc: blkparse: sync fixes from man page updates blktrace: doc: (un)plug event updates for on-stack plugging blktrace: doc: update RWBS including flush, FUA replacing barrier blktrace: doc: no more SCSI CDB in payload blktrace: doc: assorted fixes and updates blktrace: doc: alternatives to blktrace traditional tooling README: complete tool overview README: remove incomplete tool option descriptions btt: fix --do-active to not perform --q2d-latencies|-z blkrawverify: fix dumping of erroneous trace blkparse: fix allowed event type specifiers for custom output format verify_blkparse: inform on bad line, report line no btrace: bring back possibility to toggle statistics at end of trace blkparse: treat sector as %llu for custom format like elsewhere in code blkparse: elapsed time: change unit of custom format, no exit on none blkparse: add custom format for calendar date of time stamp blkparse: enable custom output format also for message event type blkparse: add custom format field specifiers for remapping event blkparse: new option to customize format of default output header only README | 152 ++++---- blkparse.c | 22 +- blkparse_fmt.c | 81 ++++- blkrawverify.c | 6 +- blktrace.h | 1 + btrace | 5 +- btt/args.c | 2 +- btt/doc/Makefile | 2 +- btt/doc/btt.tex | 183 ++++++---- doc/Makefile | 2 +- doc/blkparse.1 | 354 +++++++++++++------ doc/blkrawverify.1 | 3 +- doc/blktrace.8 | 92 +++-- doc/blktrace.tex | 958 ++++++++++++++++++++++++++++++++++++++++++-------- doc/btrace.8 | 16 +- doc/btt.1 | 2 +- doc/verify_blkparse.1 | 12 + verify_blkparse.c | 12 +- 18 files changed, 1430 insertions(+), 475 deletions(-) -- 2.14.2 -- To unsubscribe from this list: send the line "unsubscribe linux-btrace" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html