Man Linux: Main Page and Category List

NAME

       xentrace_format - pretty-print Xen trace data

SYNOPSIS

       xentrace_format [ DEFS-FILE ]

DESCRIPTION

       xentrace_format  parses  trace  data  in  xentrace  binary  format from
       standard input and reformats it according to the rules  in  a  file  of
       definitions (DEFS-FILE), printing to standard output.

       The rules in DEFS-FILE should have the format shown below:

       event_id whitespace format

       Each rule should start on a new line.

       The  format  string  may  include  format specifiers, such as: %(cpu)d,
       %(tsc)d, %(event)d, %(1)d, %(2)d, %(3)d, %(4)d, %(5)d

       [ the ‘d’ format specifier output in decimal, alternatively ‘x’
         will output in hexadecimal and ‘o’ will output in octal ]

       These correspond to the CPU number, event ID, timestamp counter and the
       5 data fields from the trace record.  There should be one such rule for
       each type of event to be  pretty-printed  (events  which  do  not  have
       formatting rules are ignored).

       A  sample format file for Xen’s predefined trace events is available in
       the file tools/xentrace/formats in the Xen source tree.

       Depending on your system and the rate at which trace data is  produced,
       this  script  may not be able to keep up with the output of xentrace if
       it is piped directly.  In these circumstances you should have  xentrace
       output to a file for processing off-line.

AUTHOR

       Mark A. Williamson <mark.a.williamson@intel.com>

SEE ALSO

       xentrace(8), xentrace_cpusplit(1)