ia64/xen-unstable

changeset 10065:c5551469f00e

Extend xentrace man page.
From: Kaleb Pederson
Signed-off-by: Keir Fraser <keir@xensource.com>
author kaf24@firebug.cl.cam.ac.uk
date Tue May 16 09:21:33 2006 +0100 (2006-05-16)
parents 18fceb2f6b2d
children df1521633fb5
files tools/xentrace/xentrace.8
line diff
     1.1 --- a/tools/xentrace/xentrace.8	Tue May 16 09:18:25 2006 +0100
     1.2 +++ b/tools/xentrace/xentrace.8	Tue May 16 09:21:33 2006 +0100
     1.3 @@ -35,6 +35,81 @@ all new records to the output
     1.4  .B -s, --poll-sleep=p
     1.5  set the time, p, (in milliseconds) to sleep between polling the buffers
     1.6  for new data.
     1.7 +.TP
     1.8 +.B -c, --cpu-mask=c
     1.9 +set cpu-mask
    1.10 +.TP
    1.11 +.B -e, --evt-mask=e
    1.12 +set evt-mask
    1.13 +.TP
    1.14 +.B -?, --help
    1.15 +Give this help list
    1.16 +.TP
    1.17 +.B --usage
    1.18 +Give a short usage message
    1.19 +.TP
    1.20 +.B -V, --version
    1.21 +Print program version
    1.22 +
    1.23 +.SS Event Classes (Masks)
    1.24 +The following event classes (masks) can be used to filter the events being
    1.25 +gathered by xentrace:
    1.26 +.PP
    1.27 +        \fIID\fP                  \fIDescription\fP
    1.28 +.PP
    1.29 +        0x0001f000          TRC_GEN
    1.30 +        0x0002f000          TRC_SCHED
    1.31 +        0x0004f000          TRC_DOM0OP          
    1.32 +        0x0008f000          TRC_VMX
    1.33 +        0x000af000          TRC_MEM
    1.34 +        0xfffff000          TRC_ALL 
    1.35 +
    1.36 +
    1.37 +.SS Event Subclasses (More Masks)
    1.38 +The following event subclasses (masks) can also be used to filter the events being
    1.39 +gathered by xentrace:
    1.40 +.PP
    1.41 +        \fIID\fP                  \fIDescription\fP
    1.42 +.PP
    1.43 +        0x00081000          TRC_VMXEXIT
    1.44 +        0x00082000          TRC_VMXTIMER
    1.45 +        0x00084000          TRC_VMXINT
    1.46 +        0x00088000          TRC_VMXIO
    1.47 +
    1.48 +
    1.49 +.SS Events
    1.50 +.B xentrace
    1.51 +collects the following events from the trace buffer:
    1.52 +.PP
    1.53 +        \fIID\fP                \fIDescription\fP
    1.54 +.PP	
    1.55 +        0x0002f001         TRC_SCHED_DOM_ADD
    1.56 +        0x0002f002         TRC_SCHED_DOM_REM
    1.57 +        0x0002f003         TRC_SCHED_SLEEP
    1.58 +        0x0002f004         TRC_SCHED_WAKE
    1.59 +        0x0002f005         TRC_SCHED_YIELD
    1.60 +        0x0002f006         TRC_SCHED_BLOCK
    1.61 +        0x0002f007         TRC_SCHED_SHUTDOWN
    1.62 +        0x0002f008         TRC_SCHED_CTL
    1.63 +        0x0002f009         TRC_SCHED_ADJDOM
    1.64 +        0x0002f010         TRC_SCHED_SWITCH
    1.65 +        0x0002f011         TRC_SCHED_S_TIMER_FN
    1.66 +        0x0002f012         TRC_SCHED_T_TIMER_FN
    1.67 +        0x0002f013         TRC_SCHED_DOM_TIMER_FN
    1.68 +        0x0002f014         TRC_SCHED_SWITCH_INFPREV
    1.69 +        0x0002f015         TRC_SCHED_SWITCH_INFNEXT
    1.70 +
    1.71 +        0x000af001         TRC_MEM_PAGE_GRANT_MAP
    1.72 +        0x000af002         TRC_MEM_PAGE_GRANT_UNMAP
    1.73 +        0x000af003         TRC_MEM_PAGE_GRANT_TRANSFER
    1.74 +
    1.75 +        0x00081001         TRC_VMX_VMEXIT
    1.76 +        0x00081002         TRC_VMX_VMENTRY
    1.77 +        
    1.78 +        0x00082001         TRC_VMX_TIMER_INTR
    1.79 +        
    1.80 +        0x00084001         TRC_VMX_INT
    1.81 +.PP
    1.82  
    1.83  .SH AUTHOR
    1.84  Mark A. Williamson <mark.a.williamson@intel.com>