diff options
| author | mwilli2@equilibrium.research.intel-research.net <mwilli2@equilibrium.research.intel-research.net> | 2004-05-11 17:04:48 +0000 |
|---|---|---|
| committer | mwilli2@equilibrium.research.intel-research.net <mwilli2@equilibrium.research.intel-research.net> | 2004-05-11 17:04:48 +0000 |
| commit | c5c7615f281ee0a9ec2a5c9cadd2f49a73c565f4 (patch) | |
| tree | 19b23e259e7202f46012cf95a032d51fb0ef96e6 /docs/interface.tex | |
| parent | 1de448f4c54eac94a966d65e72b15bcbef3a7e5d (diff) | |
| download | xen-c5c7615f281ee0a9ec2a5c9cadd2f49a73c565f4.tar.gz xen-c5c7615f281ee0a9ec2a5c9cadd2f49a73c565f4.tar.bz2 xen-c5c7615f281ee0a9ec2a5c9cadd2f49a73c565f4.zip | |
bitkeeper revision 1.891.3.1 (40a107b0xATyR-Pt7aENgr5O6ydSyA)
Improvements to trace buffer features.
Diffstat (limited to 'docs/interface.tex')
| -rw-r--r-- | docs/interface.tex | 13 |
1 files changed, 9 insertions, 4 deletions
diff --git a/docs/interface.tex b/docs/interface.tex index 46da27626a..4e3d4b93b9 100644 --- a/docs/interface.tex +++ b/docs/interface.tex @@ -705,12 +705,16 @@ value of the CPU cycle-counter. For builds without the trace buffer enabled, the macros expand to no-ops and thus can be left in place without incurring overheads. -\subsection{Enabling tracing} +\subsection{Trace-enabled builds} By default, the trace buffer is enabled only in debug builds (i.e. {\tt NDEBUG} is not defined). It can be enabled separately by defining {\tt TRACE\_BUFFER}, either in {\tt <xen/config.h>} or on the gcc command line. +The size (in pages) of the per-CPU trace buffers can be specified using the +{\tt tbuf_size=n } boot parameter to Xen. If the size is set to 0, the trace +buffers will be disabled. + \subsection{Dumping trace data} When running a trace buffer build of Xen, trace data are written continuously @@ -725,10 +729,11 @@ in overall chronological order. The output from {\tt xentrace} can be post-processed using {\tt xentrace\_cpusplit} (used to split trace data out into per-cpu log files) and -{\tt xentrace\_format} (used to pretty-print trace data). +{\tt xentrace\_format} (used to pretty-print trace data). For the predefined +trace points, there is an example format file in {\tt tools/xentrace/formats }. -For more information, see the manual pages for {\tt xentrace}, -{\tt xentrace\_format} and {\tt xentrace\_cpusplit}. +For more information, see the manual pages for {\tt xentrace}, {\tt +xentrace\_format} and {\tt xentrace\_cpusplit}. \chapter{Hypervisor calls} |