Windows2003-3790/sdktools/trace/traceview/traceviewhelp/loggercontrolinterface.htm
2020-09-30 16:53:55 +02:00

482 lines
16 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<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>            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.  The following table describes the control interface options:</p>
<p class=MsoNormal>&nbsp;</p>
<p class=MsoNormal>            </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   &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"'>© Microsoft
Corporation 2002</span></b></p>
<h3><span style='font-weight:normal'>&nbsp;</span></h3>
</div>
</body>
</html>