ia64/xen-unstable

view tools/xentrace/xentrace.8 @ 7238:971e7c7411b3

Raise an exception if an error appears on the pipes to our children, and make
sure that the child's pipes are closed even under that exception. Move the
handling of POLLHUP to the end of the loop, so that we guarantee to read any
remaining data from the child if POLLHUP and POLLIN appear at the same time.

Signed-off-by: Ewan Mellor <ewan@xensource.com>
author emellor@ewan
date Thu Oct 06 10:13:11 2005 +0100 (2005-10-06)
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)