Leaked source code of windows server 2003
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

481 lines
16 KiB

  1. <html>
  2. <head>
  3. <meta http-equiv=Content-Type content="text/html; charset=windows-1252">
  4. <meta name=Generator content="Microsoft Word 10 (filtered)">
  5. <title>Creating Trace Log Sessions</title>
  6. <style>
  7. <!--
  8. /* Font Definitions */
  9. @font-face
  10. {font-family:"MS Sans Serif";
  11. panose-1:0 0 0 0 0 0 0 0 0 0;}
  12. /* Style Definitions */
  13. p.MsoNormal, li.MsoNormal, div.MsoNormal
  14. {margin:0in;
  15. margin-bottom:.0001pt;
  16. font-size:12.0pt;
  17. font-family:"Times New Roman";}
  18. h1
  19. {margin-top:12.0pt;
  20. margin-right:0in;
  21. margin-bottom:3.0pt;
  22. margin-left:0in;
  23. page-break-after:avoid;
  24. font-size:16.0pt;
  25. font-family:Arial;
  26. font-weight:bold;}
  27. h3
  28. {margin-right:0in;
  29. margin-left:0in;
  30. font-size:13.5pt;
  31. font-family:"Times New Roman";
  32. font-weight:bold;}
  33. h4
  34. {margin-top:12.0pt;
  35. margin-right:0in;
  36. margin-bottom:3.0pt;
  37. margin-left:0in;
  38. page-break-after:avoid;
  39. font-size:14.0pt;
  40. font-family:"Times New Roman";
  41. font-weight:bold;}
  42. a:link, span.MsoHyperlink
  43. {color:blue;
  44. text-decoration:underline;}
  45. a:visited, span.MsoHyperlinkFollowed
  46. {color:blue;
  47. text-decoration:underline;}
  48. p
  49. {margin-right:0in;
  50. margin-left:0in;
  51. font-size:12.0pt;
  52. font-family:"Times New Roman";}
  53. @page Section1
  54. {size:8.5in 11.0in;
  55. margin:1.0in 1.25in 1.0in 1.25in;}
  56. div.Section1
  57. {page:Section1;}
  58. /* List Definitions */
  59. ol
  60. {margin-bottom:0in;}
  61. ul
  62. {margin-bottom:0in;}
  63. -->
  64. </style>
  65. </head>
  66. <body lang=EN-US link=blue vlink=blue>
  67. <div class=Section1>
  68. <h1><span style='font-size:24.0pt;font-family:"Times New Roman"'>Logger Control
  69. Interface</span></h1>
  70. <p>The TraceView command-line interface uses the following command-line syntax:</p>
  71. <p>����������� traceview [action] [options] | [-h | -help | -?]</p>
  72. <p>The possible actions for the TraceView command-line interface are broken
  73. down into three categories:</p>
  74. <ul style='margin-top:0in' type=disc>
  75. <li class=MsoNormal>Control</li>
  76. <li class=MsoNormal>Consumption</li>
  77. <li class=MsoNormal>Parsing<br>
  78. <br>
  79. </li>
  80. </ul>
  81. <p class=MsoNormal>The Control actions are used to control active trace
  82. loggers.� The following table describes the control interface options:</p>
  83. <p class=MsoNormal>&nbsp;</p>
  84. <p class=MsoNormal>����������� </p>
  85. <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0 width=648
  86. style='width:6.75in;margin-left:-.05in;border-collapse:collapse;border:none;
  87. width:6.75in !msorm;border-collapse:collapse !msorm;border:none !msorm'>
  88. <tr>
  89. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  90. padding:0in 5.4pt 0in 5.4pt;border:solid windowtext 1.0pt !msorm;padding:
  91. 0in 5.4pt 0in 5.4pt !msorm'>
  92. <p>Control Actions:</p>
  93. </td>
  94. <td width=456 valign=bottom style='width:4.75in;border:solid windowtext 1.0pt;
  95. border-left:none;padding:0in 5.4pt 0in 5.4pt;border:solid windowtext 1.0pt !msorm;
  96. border-left:none !msorm;padding:0in 5.4pt 0in 5.4pt !msorm'>
  97. <p>&nbsp;</p>
  98. </td>
  99. </tr>
  100. <tr>
  101. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  102. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  103. <p>-start [LoggerName]</p>
  104. </td>
  105. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  106. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  107. padding:0in 5.4pt 0in 5.4pt'>
  108. <p>Starts up the [LoggerName] trace session</p>
  109. </td>
  110. </tr>
  111. <tr>
  112. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  113. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  114. <p>-stop [LoggerName]</p>
  115. </td>
  116. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  117. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  118. padding:0in 5.4pt 0in 5.4pt'>
  119. <p>Stops the [LoggerName] trace session</p>
  120. </td>
  121. </tr>
  122. <tr>
  123. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  124. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  125. <p>-update [LoggerName]</p>
  126. </td>
  127. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  128. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  129. padding:0in 5.4pt 0in 5.4pt'>
  130. <p>Updates the [LoggerName] trace session</p>
  131. </td>
  132. </tr>
  133. <tr>
  134. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  135. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  136. <p>-enable [LoggerName]</p>
  137. </td>
  138. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  139. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  140. padding:0in 5.4pt 0in 5.4pt'>
  141. <p>Enables providers for the [LoggerName] session</p>
  142. </td>
  143. </tr>
  144. <tr>
  145. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  146. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  147. <p>-disable [LoggerName]</p>
  148. </td>
  149. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  150. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  151. padding:0in 5.4pt 0in 5.4pt'>
  152. <p>Disables providers for the [LoggerName] session</p>
  153. </td>
  154. </tr>
  155. <tr>
  156. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  157. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  158. <p>-flush [LoggerName]</p>
  159. </td>
  160. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  161. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  162. padding:0in 5.4pt 0in 5.4pt'>
  163. <p>Flushes the [LoggerName] active buffers</p>
  164. </td>
  165. </tr>
  166. <tr>
  167. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  168. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  169. <p>-enumguid</p>
  170. </td>
  171. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  172. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  173. padding:0in 5.4pt 0in 5.4pt'>
  174. <p>Enumerate Registered Trace Guids</p>
  175. </td>
  176. </tr>
  177. <tr>
  178. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  179. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  180. <p>-q [LoggerName]</p>
  181. </td>
  182. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  183. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  184. padding:0in 5.4pt 0in 5.4pt'>
  185. <p>Query status of [LoggerName] trace session</p>
  186. </td>
  187. </tr>
  188. <tr>
  189. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  190. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  191. <p>-l</p>
  192. </td>
  193. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  194. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  195. padding:0in 5.4pt 0in 5.4pt'>
  196. <p>List all trace sessions</p>
  197. </td>
  198. </tr>
  199. <tr>
  200. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  201. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  202. <p>-x</p>
  203. </td>
  204. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  205. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  206. padding:0in 5.4pt 0in 5.4pt'>
  207. <p>Stops all active trace sessions</p>
  208. </td>
  209. </tr>
  210. <tr>
  211. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  212. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  213. <p>&nbsp;</p>
  214. </td>
  215. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  216. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  217. padding:0in 5.4pt 0in 5.4pt'>
  218. <p>&nbsp;</p>
  219. </td>
  220. </tr>
  221. <tr>
  222. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  223. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  224. <p>Control Options:</p>
  225. </td>
  226. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  227. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  228. padding:0in 5.4pt 0in 5.4pt'>
  229. <p>&nbsp;</p>
  230. </td>
  231. </tr>
  232. <tr>
  233. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  234. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  235. <p>-b�� &lt;n&gt;</p>
  236. </td>
  237. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  238. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  239. padding:0in 5.4pt 0in 5.4pt'>
  240. <p>Sets buffer size to &lt;n&gt; Kbytes</p>
  241. </td>
  242. </tr>
  243. <tr>
  244. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  245. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  246. <p>-min &lt;n&gt;</p>
  247. </td>
  248. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  249. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  250. padding:0in 5.4pt 0in 5.4pt'>
  251. <p>Sets minimum buffers</p>
  252. </td>
  253. </tr>
  254. <tr>
  255. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  256. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  257. <p>-max &lt;n&gt;</p>
  258. </td>
  259. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  260. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  261. padding:0in 5.4pt 0in 5.4pt'>
  262. <p>Sets maximum buffers</p>
  263. </td>
  264. </tr>
  265. <tr>
  266. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  267. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  268. <p>-f &lt;name&gt;</p>
  269. </td>
  270. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  271. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  272. padding:0in 5.4pt 0in 5.4pt'>
  273. <p>Log to file &lt;name&gt;</p>
  274. </td>
  275. </tr>
  276. <tr>
  277. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  278. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  279. <p>-append</p>
  280. </td>
  281. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  282. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  283. padding:0in 5.4pt 0in 5.4pt'>
  284. <p>Append to file</p>
  285. </td>
  286. </tr>
  287. <tr>
  288. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  289. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  290. <p>-prealloc</p>
  291. </td>
  292. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  293. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  294. padding:0in 5.4pt 0in 5.4pt'>
  295. <p>Pre-allocate</p>
  296. </td>
  297. </tr>
  298. <tr>
  299. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  300. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  301. <p>-seq &lt;n&gt;</p>
  302. </td>
  303. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  304. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  305. padding:0in 5.4pt 0in 5.4pt'>
  306. <p>Sequential logfile of up to n Mbytes</p>
  307. </td>
  308. </tr>
  309. <tr>
  310. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  311. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  312. <p>-cir &lt;n&gt;</p>
  313. </td>
  314. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  315. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  316. padding:0in 5.4pt 0in 5.4pt'>
  317. <p>Circular logfile of n Mbytes</p>
  318. </td>
  319. </tr>
  320. <tr>
  321. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  322. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  323. <p>-newfile &lt;n&gt;</p>
  324. </td>
  325. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  326. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  327. padding:0in 5.4pt 0in 5.4pt'>
  328. <p>Log to a new file after every n Mbytes</p>
  329. </td>
  330. </tr>
  331. <tr>
  332. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  333. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  334. <p>-ft &lt;n&gt;</p>
  335. </td>
  336. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  337. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  338. padding:0in 5.4pt 0in 5.4pt'>
  339. <p>Set flush timer to n seconds</p>
  340. </td>
  341. </tr>
  342. <tr>
  343. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  344. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  345. <p>-paged</p>
  346. </td>
  347. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  348. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  349. padding:0in 5.4pt 0in 5.4pt'>
  350. <p>Use pageable memory for buffers</p>
  351. </td>
  352. </tr>
  353. <tr>
  354. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  355. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  356. <p>-guid &lt;file&gt;</p>
  357. </td>
  358. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  359. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  360. padding:0in 5.4pt 0in 5.4pt'>
  361. <p>Start tracing for providers in file</p>
  362. </td>
  363. </tr>
  364. <tr>
  365. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  366. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  367. <p>-rt</p>
  368. </td>
  369. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  370. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  371. padding:0in 5.4pt 0in 5.4pt'>
  372. <p>Enable tracing in real time mode</p>
  373. </td>
  374. </tr>
  375. <tr>
  376. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  377. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  378. <p>-kd</p>
  379. </td>
  380. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  381. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  382. padding:0in 5.4pt 0in 5.4pt'>
  383. <p>Enable tracing in kernel debugger</p>
  384. </td>
  385. </tr>
  386. <tr>
  387. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  388. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  389. <p>-age &lt;n&gt;</p>
  390. </td>
  391. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  392. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  393. padding:0in 5.4pt 0in 5.4pt'>
  394. <p>Modify aging decay time to n minutes</p>
  395. </td>
  396. </tr>
  397. <tr>
  398. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  399. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  400. <p>-level &lt;n&gt;</p>
  401. </td>
  402. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  403. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  404. padding:0in 5.4pt 0in 5.4pt'>
  405. <p>Enable Level passed to the providers</p>
  406. </td>
  407. </tr>
  408. <tr>
  409. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  410. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  411. <p>-flag &lt;n&gt;</p>
  412. </td>
  413. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  414. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  415. padding:0in 5.4pt 0in 5.4pt'>
  416. <p>Enable Flags passed to the providers</p>
  417. </td>
  418. </tr>
  419. <tr>
  420. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  421. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  422. <p>-eflag &lt;n&gt; &lt;flag...&gt;</p>
  423. </td>
  424. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  425. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  426. padding:0in 5.4pt 0in 5.4pt'>
  427. <p>Enable flags (several) to providers</p>
  428. </td>
  429. </tr>
  430. <tr>
  431. <td width=192 valign=bottom style='width:2.0in;border:solid windowtext 1.0pt;
  432. border-top:none;padding:0in 5.4pt 0in 5.4pt'>
  433. <p>-pdb</p>
  434. </td>
  435. <td width=456 valign=bottom style='width:4.75in;border-top:none;border-left:
  436. none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
  437. padding:0in 5.4pt 0in 5.4pt'>
  438. <p>Start tracing for related provider</p>
  439. </td>
  440. </tr>
  441. </table>
  442. <p class=MsoNormal>&nbsp;</p>
  443. <p class=MsoNormal style='margin-left:.25in'>&nbsp;</p>
  444. <p class=MsoNormal style='margin-left:.25in'>&nbsp;</p>
  445. <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=873
  446. style='width:654.65pt'>
  447. <tr style='height:.05in'>
  448. <td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:.05in'>
  449. <p class=MsoNormal style='line-height:3.6pt'><span style='font-size:2.0pt'>&nbsp;</span></p>
  450. </td>
  451. </tr>
  452. </table>
  453. <p><b><span style='font-size:10.0pt;font-family:"MS Sans Serif"'>� Microsoft
  454. Corporation 2002</span></b></p>
  455. <h3><span style='font-weight:normal'>&nbsp;</span></h3>
  456. </div>
  457. </body>
  458. </html>