Skip to content

non interactive reader

yotamr edited this page May 5, 2012 · 9 revisions

simple_trace_reader(1) -- Parse and dump trace file to stdout

SYNOPSIS

simple_trace_reader -h simple_trace_reader -d [-g] [-n] [-e] [-f] [-t] [-r] <file1> <file2> ...
simple_trace_reader -s [-e] [-f] <file1> <file2> ...
simple_trace_reader -m <file1> <file2> ...

OPTIONS

simple_trace_reader has two operating modes: -d or -s
-d, dumping mode, parses and dumps the record contents of a trace file
-s, statistics mode, prints an account of trace log occurrences -m, metadata dump mode, prints all metadata in a given file

  • -h, --help: Print help
  • -d, --dump: Dump contents of trace files. The reader will open and dump the contents of the specified files according to the modifiers specified in the command line. By default, if no modifiers are specified, the dumper prints only INFO/WARN/ERROR/FATAL records.
  • -n --no-color: Don't dump colored output, only plain text. For terminals that do not support ANSI escape codes
  • -e --enable-debug: Enable debug buffers. Dump DEBUG records as well as INFO/WARN/ERROR/FATAL records. Does not cause the dumping of function entry/leave
  • -f --enable-functions: Enable function entry/leave dumping. This will cause the dumping of a lot of data to stdout. For large files, this isn't particularly useful and the use of the interactive reader is recommended
  • -t --time [timestamp]: Dump all records beginning at timestamp. The reader will seek to the specified timestamp and will begin dumping records from that time. Time is specified in nanoseconds
  • -r --relative-timestamp: Printed timestamp is relative to the boot time of the machine
  • -g --grep [str]: Display entries whose constant strings contain the specified substring
  • -s --print-stats: Show the number of log occurrences in all files specified
  • -m --dump-metadata: Dump metadata of traced processes in all files specified

Examples

Print only the INFO/WARN/ERROR/FATAL records of a given file:

$ simple_trace_reader -d trace_file

Print all records in the same file:

$ simple_trace_reader -d -f trace_file

Print the records of all trace files:

$ simple_trace_reader -d -f trace*

Print non-function records with the constant substring 'message'

$ simple_trace_reader -g message -d -e trace*

NOTES

When filtering records that match a certain substring, the -g option is much faster than piping the output through the grep command.

COPYRIGHT

Traces is Copyright (C) 2012 Yotam Rubin yotamrubin@gmail.com
Traces is sponsored by Infinidat http://infinidat.com

SEE ALSO

trace_dumper(1), interactive_trace_reader(1)

Clone this wiki locally