ia64/xen-unstable

view tools/xentrace/xentrace.8 @ 6392:bca2fd76995e

Add EXT3 as built-in filesystem for x86/64 domU.
author kaf24@firebug.cl.cam.ac.uk
date Wed Aug 24 15:21:48 2005 +0000 (2005-08-24)
parents 6cf25fb7eebd
children c5551469f00e
line source
1 .TH XENTRACE 8 "11 March 2004" "Xen domain 0 utils"
2 .SH NAME
3 xentrace \- capture Xen trace buffer data
4 .SH SYNOPSIS
5 .B xentrace
6 [
7 .I OPTIONS
8 ] [
9 .I FILE
10 ]
11 .SH DESCRIPTION
12 .B xentrace
13 is used to capture trace buffer data from Xen. The data is
14 output in the following binary format (host endian):
15 .PP
16 CPU(uint) TSC(u64) EVENT(u32) D1 D2 D3 D4 D5 (all u32)
17 .PP
18 Where CPU is the processor number, TSC is the record's timestamp
19 (the value of the CPU cycle counter), EVENT is the event ID and
20 D1...D5 are the trace data.
22 Data is dumped onto the standard output (which must not be a TTY) or a
23 \fIFILE\fP specified on the command line.
25 The output should be parsed using the tool xentrace_format, which can
26 produce human-readable output in ASCII format.
29 .SS Options
30 .TP
31 .B -t, --log-thresh=l
32 set the threshold number, l, of new records required to trigger a write of
33 all new records to the output
34 .TP
35 .B -s, --poll-sleep=p
36 set the time, p, (in milliseconds) to sleep between polling the buffers
37 for new data.
39 .SH AUTHOR
40 Mark A. Williamson <mark.a.williamson@intel.com>
42 .SH "SEE ALSO"
43 xentrace_cpuinfo(1), xentrace_format(1)