diff options
author | mwilli2@equilibrium.research.intel-research.net <mwilli2@equilibrium.research.intel-research.net> | 2004-05-12 13:41:47 +0000 |
---|---|---|
committer | mwilli2@equilibrium.research.intel-research.net <mwilli2@equilibrium.research.intel-research.net> | 2004-05-12 13:41:47 +0000 |
commit | 9b9ca98b6ab16d657deaf37bd51f3290ad1d2df8 (patch) | |
tree | 78e3eb5693c326123e99a3011edb38e8d7a7ed2d /tools/xentrace/xentrace.8 | |
parent | e3d8d5ffdd61b1de7510db9c883f96f2a95238ae (diff) | |
download | xen-9b9ca98b6ab16d657deaf37bd51f3290ad1d2df8.tar.gz xen-9b9ca98b6ab16d657deaf37bd51f3290ad1d2df8.tar.bz2 xen-9b9ca98b6ab16d657deaf37bd51f3290ad1d2df8.zip |
bitkeeper revision 1.891.1.8 (40a2299bVaCq0t5_5UXpB7OSB1yLKA)
Update xentrace to produce binary output format and xentrace_format to
correctly parse it.
Diffstat (limited to 'tools/xentrace/xentrace.8')
-rw-r--r-- | tools/xentrace/xentrace.8 | 15 |
1 files changed, 10 insertions, 5 deletions
diff --git a/tools/xentrace/xentrace.8 b/tools/xentrace/xentrace.8 index b9720b9fbe..93c86ac8ad 100644 --- a/tools/xentrace/xentrace.8 +++ b/tools/xentrace/xentrace.8 @@ -10,17 +10,22 @@ xentrace \- capture Xen trace buffer data ] .SH DESCRIPTION .B xentrace -is used to dump data from Xen's per-cpu trace buffers. Records -are dumped in ASCII format, onto the standard output or a \fIFILE\fP -specified on the command line. -Trace records are formatted as follows: +is used to capture trace buffer data from Xen. The data is +output in the following binary format (host endian): .PP - CPU TSC EVENT D1 D2 D3 D4 D5 + CPU(uint) TSC(u64) EVENT(u32) D1 D2 D3 D4 D5 (all u32) .PP Where CPU is the processor number, TSC is the record's timestamp (the value of the CPU cycle counter), EVENT is the event ID and D1...D5 are the trace data. +Data is dumped onto the standard output (which must not be a TTY) or a +\fIFILE\fP specified on the command line. + +The output should be parsed using the tool xentrace_format, which can +produce human-readable output in ASCII format. + + .SS Options .TP .B -t, --log-thresh=l |