Windows2003-3790/sdktools/trace/traceview/traceviewhelp/loggercontrolinterface.htm

482 lines
16 KiB
HTML
Raw Normal View History

2001-01-01 00:00:00 +01:00
<html>
<head>
<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
<meta name=Generator content="Microsoft Word 10 (filtered)">
<title>Creating Trace Log Sessions</title>
<style>
<!--
/* Font Definitions */
@font-face
{font-family:"MS Sans Serif";
panose-1:0 0 0 0 0 0 0 0 0 0;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman";}
h1
{margin-top:12.0pt;
margin-right:0in;
margin-bottom:3.0pt;
margin-left:0in;
page-break-after:avoid;
font-size:16.0pt;
font-family:Arial;
font-weight:bold;}
h3
{margin-right:0in;
margin-left:0in;
font-size:13.5pt;
font-family:"Times New Roman";
font-weight:bold;}
h4
{margin-top:12.0pt;
margin-right:0in;
margin-bottom:3.0pt;
margin-left:0in;
page-break-after:avoid;
font-size:14.0pt;
font-family:"Times New Roman";
font-weight:bold;}
a:link, span.MsoHyperlink
{color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{color:blue;
text-decoration:underline;}
p
{margin-right:0in;
margin-left:0in;
font-size:12.0pt;
font-family:"Times New Roman";}
@page Section1
{size:8.5in 11.0in;
margin:1.0in 1.25in 1.0in 1.25in;}
div.Section1
{page:Section1;}
/* List Definitions */
ol
{margin-bottom:0in;}
ul
{margin-bottom:0in;}
-->
</style>
</head>
<body lang=EN-US link=blue vlink=blue>
<div class=Section1>
<h1><span style='font-size:24.0pt;font-family:"Times New Roman"'>Logger Control
Interface</span></h1>
<p>The TraceView command-line interface uses the following command-line syntax:</p>
<p><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> traceview [action] [options] | [-h | -help | -?]</p>
<p>The possible actions for the TraceView command-line interface are broken
down into three categories:</p>
<ul style='margin-top:0in' type=disc>
<li class=MsoNormal>Control</li>
<li class=MsoNormal>Consumption</li>
<li class=MsoNormal>Parsing<br>
<br>
</li>
</ul>
<p class=MsoNormal>The Control actions are used to control active trace
loggers.<2E> The following table describes the control interface options:</p>
<p class=MsoNormal>&nbsp;</p>
<p class=MsoNormal><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> </p>
<table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0 width=648
style='width:6.75in;margin-left:-.05in;border-collapse:collapse;border:none;
width:6.75in !msorm;border-collapse:collapse !msorm;border:none !msorm'>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt;border:solid windowtext 1.0pt !msorm;padding:
0in 5.4pt 0in 5.4pt !msorm'>
<p>Control Actions:</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border:solid windowtext 1.0pt;
border-left:none;padding:0in 5.4pt 0in 5.4pt;border:solid windowtext 1.0pt !msorm;
border-left:none !msorm;padding:0in 5.4pt 0in 5.4pt !msorm'>
<p>&nbsp;</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-start [LoggerName]</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Starts up the [LoggerName] trace session</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-stop [LoggerName]</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Stops the [LoggerName] trace session</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-update [LoggerName]</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Updates the [LoggerName] trace session</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-enable [LoggerName]</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Enables providers for the [LoggerName] session</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-disable [LoggerName]</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Disables providers for the [LoggerName] session</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-flush [LoggerName]</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Flushes the [LoggerName] active buffers</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-enumguid</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Enumerate Registered Trace Guids</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-q [LoggerName]</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Query status of [LoggerName] trace session</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-l</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>List all trace sessions</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-x</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Stops all active trace sessions</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>&nbsp;</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>&nbsp;</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>Control Options:</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>&nbsp;</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-b<><62> &lt;n&gt;</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Sets buffer size to &lt;n&gt; Kbytes</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-min &lt;n&gt;</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Sets minimum buffers</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-max &lt;n&gt;</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Sets maximum buffers</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-f &lt;name&gt;</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Log to file &lt;name&gt;</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-append</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Append to file</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-prealloc</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Pre-allocate</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-seq &lt;n&gt;</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Sequential logfile of up to n Mbytes</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-cir &lt;n&gt;</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Circular logfile of n Mbytes</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-newfile &lt;n&gt;</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Log to a new file after every n Mbytes</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-ft &lt;n&gt;</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Set flush timer to n seconds</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-paged</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Use pageable memory for buffers</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-guid &lt;file&gt;</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Start tracing for providers in file</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-rt</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Enable tracing in real time mode</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-kd</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Enable tracing in kernel debugger</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-age &lt;n&gt;</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Modify aging decay time to n minutes</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-level &lt;n&gt;</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Enable Level passed to the providers</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-flag &lt;n&gt;</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Enable Flags passed to the providers</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-eflag &lt;n&gt; &lt;flag...&gt;</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Enable flags (several) to providers</p>
</td>
</tr>
<tr>
<td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
border-top:none;padding:0in 5.4pt 0in 5.4pt'>
<p>-pdb</p>
</td>
<td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
padding:0in 5.4pt 0in 5.4pt'>
<p>Start tracing for related provider</p>
</td>
</tr>
</table>
<p class=MsoNormal>&nbsp;</p>
<p class=MsoNormal style='margin-left:.25in'>&nbsp;</p>
<p class=MsoNormal style='margin-left:.25in'>&nbsp;</p>
<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=873
style='width:654.65pt'>
<tr style='height:.05in'>
<td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:.05in'>
<p class=MsoNormal style='line-height:3.6pt'><span style='font-size:2.0pt'>&nbsp;</span></p>
</td>
</tr>
</table>
<p><b><span style='font-size:10.0pt;font-family:"MS Sans Serif"'><EFBFBD> Microsoft
Corporation 2002</span></b></p>
<h3><span style='font-weight:normal'>&nbsp;</span></h3>
</div>
</body>
</html>