1XENTRACE(8)                 System Manager's Manual                XENTRACE(8)
2
3
4

NAME

6       xentrace - capture Xen trace buffer data
7

SYNOPSIS

9       xentrace [ OPTIONS ] [ FILE ]
10

DESCRIPTION

12       xentrace  is  used  to capture trace buffer data from Xen.  The data is
13       output in the following binary format (host endian):
14
15           CPU(uint) TSC(u64) EVENT(u32) D1 D2 D3 D4 D5 (all u32)
16
17       Where CPU is the processor number, TSC is the record's  timestamp  (the
18       value  of the CPU cycle counter), EVENT is the event ID and D1...D5 are
19       the trace data.
20
21       Data is dumped onto the standard output (which must not be a TTY) or  a
22       FILE specified on the command line.
23
24       The  output  should be parsed using the tool xentrace_format, which can
25       produce human-readable output in ASCII format.
26
27
28
29   Options
30       -t, --log-thresh=l
31              set the threshold number, l, of new records required to  trigger
32              a write of all new records to the output
33
34       -s, --poll-sleep=p
35              set  the time, p, (in milliseconds) to sleep between polling the
36              buffers for new data.
37
38       -c, --cpu-mask=c
39              set cpu-mask
40
41       -e, --evt-mask=e
42              set evt-mask
43
44       -?, --help
45              Give this help list
46
47       --usage
48              Give a short usage message
49
50       -V, --version
51              Print program version
52
53
54   Event Classes (Masks)
55       The following event classes (masks) can be used to  filter  the  events
56       being gathered by xentrace:
57
58               ID                  Description
59
60               0x0001f000          TRC_GEN
61               0x0002f000          TRC_SCHED
62               0x0004f000          TRC_DOM0OP
63               0x0008f000          TRC_HVM
64               0x0010f000          TRC_MEM
65               0xfffff000          TRC_ALL
66
67
68
69   Event Subclasses (More Masks)
70       The  following  event subclasses (masks) can also be used to filter the
71       events being gathered by xentrace:
72
73               ID                  Description
74
75               0x00081000          TRC_HVM_ENTRYEXIT
76               0x00082000          TRC_HVM_HANDLER
77
78
79
80   Events
81       xentrace collects the following events from the trace buffer:
82
83               ID                Description
84
85               0x0001f001         TRC_LOST_RECORDS
86               0x0002f001         TRC_SCHED_DOM_ADD
87               0x0002f002         TRC_SCHED_DOM_REM
88               0x0002f003         TRC_SCHED_SLEEP
89               0x0002f004         TRC_SCHED_WAKE
90               0x0002f005         TRC_SCHED_YIELD
91               0x0002f006         TRC_SCHED_BLOCK
92               0x0002f007         TRC_SCHED_SHUTDOWN
93               0x0002f008         TRC_SCHED_CTL
94               0x0002f009         TRC_SCHED_ADJDOM
95               0x0002f010         TRC_SCHED_SWITCH
96               0x0002f011         TRC_SCHED_S_TIMER_FN
97               0x0002f012         TRC_SCHED_T_TIMER_FN
98               0x0002f013         TRC_SCHED_DOM_TIMER_FN
99               0x0002f014         TRC_SCHED_SWITCH_INFPREV
100               0x0002f015         TRC_SCHED_SWITCH_INFNEXT
101
102               0x00081001         TRC_HVM_VMENTRY
103               0x00081002         TRC_HVM_VMEXIT
104               0x00082001         TRC_HVM_PF_XEN
105               0x00082002         TRC_HVM_PF_INJECT
106               0x00082003         TRC_HVM_INJ_EXC
107               0x00082004         TRC_HVM_INJ_VIRQ
108               0x00082005         TRC_HVM_REINJ_VIRQ
109               0x00082006         TRC_HVM_IO_READ
110               0x00082007         TRC_HVM_IO_WRITE
111               0x00082008         TRC_HVM_CR_READ
112               0x00082009         TRC_HVM_CR_WRITE
113               0x0008200A         TRC_HVM_DR_READ
114               0x0008200B         TRC_HVM_DR_WRITE
115               0x0008200C         TRC_HVM_MSR_READ
116               0x0008200D         TRC_HVM_MSR_WRITE
117               0x0008200E         TRC_HVM_CPUID
118               0x0008200F         TRC_HVM_INTR
119               0x00082010         TRC_HVM_NMI
120               0x00082011         TRC_HVM_SMI
121               0x00082012         TRC_HVM_VMMCALL
122               0x00082013         TRC_HVM_HLT
123               0x00082014         TRC_HVM_INVLPG
124
125               0x0010f001         TRC_MEM_PAGE_GRANT_MAP
126               0x0010f002         TRC_MEM_PAGE_GRANT_UNMAP
127               0x0010f003         TRC_MEM_PAGE_GRANT_TRANSFER
128
129

AUTHOR

131       Mark A. Williamson <mark.a.williamson@intel.com>
132
133

SEE ALSO

135       xentrace_cpuinfo(1), xentrace_format(1)
136
137
138
139Xen domain 0 utils             22 February 2007                    XENTRACE(8)