mirror of
https://github.com/xen-project/xen.git
synced 2026-10-29 10:40:03 +01:00
mwilli2@equilibrium.research.intel-research.net
9b9ca98b6a
Update xentrace to produce binary output format and xentrace_format to correctly parse it.
44 lines
1.1 KiB
Plaintext
44 lines
1.1 KiB
Plaintext
.TH XENTRACE 8 "11 March 2004" "Xen domain 0 utils"
|
|
.SH NAME
|
|
xentrace \- capture Xen trace buffer data
|
|
.SH SYNOPSIS
|
|
.B xentrace
|
|
[
|
|
.I OPTIONS
|
|
] [
|
|
.I FILE
|
|
]
|
|
.SH DESCRIPTION
|
|
.B xentrace
|
|
is used to capture trace buffer data from Xen. The data is
|
|
output in the following binary format (host endian):
|
|
.PP
|
|
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
|
|
set the threshold number, l, of new records required to trigger a write of
|
|
all new records to the output
|
|
.TP
|
|
.B -s, --poll-sleep=p
|
|
set the time, p, (in milliseconds) to sleep between polling the buffers
|
|
for new data.
|
|
|
|
.SH AUTHOR
|
|
Mark A. Williamson <mark.a.williamson@intel.com>
|
|
|
|
.SH "SEE ALSO"
|
|
xentrace_cpuinfo(1), xentrace_format(1)
|