1XENTRACE_FORMAT(1)          General Commands Manual         XENTRACE_FORMAT(1)
2
3
4

NAME

6       xentrace_format - pretty-print Xen trace data
7

SYNOPSIS

9       xentrace_format [ DEFS-FILE ]
10

DESCRIPTION

12       xentrace_format  parses trace data in xentrace binary format from stan‐
13       dard input and reformats it according to the rules in a file of defini‐
14       tions (DEFS-FILE), printing to standard output.
15
16       The rules in DEFS-FILE should have the format shown below:
17
18       event_id whitespace format
19
20       Each rule should start on a new line.
21
22       The  format  string  may  include  format specifiers, such as: %(cpu)d,
23       %(tsc)d, %(event)d, %(1)d, %(2)d, %(3)d, %(4)d, %(5)d
24
25       [ the `d' format specifier output in decimal, alternatively `x'
26         will output in hexadecimal and `o' will output in octal ]
27
28       These correspond to the CPU number, event ID, timestamp counter and the
29       5 data fields from the trace record.  There should be one such rule for
30       each type of event to be pretty-printed (events which do not have  for‐
31       matting rules are ignored).
32
33       A  sample format file for Xen's predefined trace events is available in
34       the file tools/xentrace/formats in the Xen source tree.
35
36       Depending on your system and the rate at which trace data is  produced,
37       this  script  may not be able to keep up with the output of xentrace if
38       it is piped directly.  In these circumstances you should have  xentrace
39       output to a file for processing off-line.
40
41

AUTHOR

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

SEE ALSO

47       xentrace(8), xentrace_cpusplit(1)
48
49
50
51Xen domain 0 utils                11 May 2004               XENTRACE_FORMAT(1)
Impressum