diff options
author | mwilli2@equilibrium.research.intel-research.net <mwilli2@equilibrium.research.intel-research.net> | 2004-03-11 19:55:00 +0000 |
---|---|---|
committer | mwilli2@equilibrium.research.intel-research.net <mwilli2@equilibrium.research.intel-research.net> | 2004-03-11 19:55:00 +0000 |
commit | 578734ab97aeef213ceabd85ac7984ce029706b3 (patch) | |
tree | 46d4d3e261321fbcc8d0128e5c3cece65d1e2aec /tools/xentrace/xentrace.8 | |
parent | 76fff2563fe96d97805f9873334a69122a1406f2 (diff) | |
download | xen-578734ab97aeef213ceabd85ac7984ce029706b3.tar.gz xen-578734ab97aeef213ceabd85ac7984ce029706b3.tar.bz2 xen-578734ab97aeef213ceabd85ac7984ce029706b3.zip |
bitkeeper revision 1.784 (4050c414tIvxGfQ8IUNIXoAjpoXBVA)
Updated script names and added man pages for all the xentrace tools.
Diffstat (limited to 'tools/xentrace/xentrace.8')
-rw-r--r-- | tools/xentrace/xentrace.8 | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/tools/xentrace/xentrace.8 b/tools/xentrace/xentrace.8 new file mode 100644 index 0000000000..b9720b9fbe --- /dev/null +++ b/tools/xentrace/xentrace.8 @@ -0,0 +1,38 @@ +.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 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: +.PP + CPU TSC EVENT D1 D2 D3 D4 D5 +.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. + +.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) |