Changes between Initial Version and Version 1 of Doc/compiler/scripts/Threads


Ignore:
Timestamp:
Oct 3, 2008, 4:17:15 PM (16 years ago)
Author:
/C=IE/O=Grid-Ireland/OU=cs.tcd.ie/L=RA-TCD/CN=Stephen O. Childs
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Doc/compiler/scripts/Threads

    v1 v1  
     1{{{
     2#!html
     3<h1>PANC&minus;THREADS.PL</h1>
     4<a href="#NAME">NAME</a><br>
     5<a href="#SYNOPSIS">SYNOPSIS</a><br>
     6<a href="#DESCRIPTION">DESCRIPTION</a><br>
     7<a href="#EXAMPLE">EXAMPLE</a><br>
     8<a href="#AUTHOR">AUTHOR</a><br>
     9
     10<hr>
     11<a name="NAME"></a>
     12<h2>NAME</h2>
     13<!-- INDENTATION -->
     14<table width="100%" border=0 rules="none" frame="void"
     15       cols="2" cellspacing="0" cellpadding="0">
     16<tr valign="top" align="left">
     17<td width="10%"></td>
     18<td width="89%">
     19<p>panc-threads.pl &minus; create a report of thread
     20activity</p>
     21</td>
     22</table>
     23<a name="SYNOPSIS"></a>
     24<h2>SYNOPSIS</h2>
     25<!-- INDENTATION -->
     26<table width="100%" border=0 rules="none" frame="void"
     27       cols="2" cellspacing="0" cellpadding="0">
     28<tr valign="top" align="left">
     29<td width="10%"></td>
     30<td width="89%">
     31<p><b>panc&minus;threads.pl</b> [<b>&minus;&minus;help</b>]
     32{logfile}</p>
     33</td>
     34</table>
     35<a name="DESCRIPTION"></a>
     36<h2>DESCRIPTION</h2>
     37<!-- INDENTATION -->
     38<table width="100%" border=0 rules="none" frame="void"
     39       cols="2" cellspacing="0" cellpadding="0">
     40<tr valign="top" align="left">
     41<td width="10%"></td>
     42<td width="89%">
     43<p>The <b>panc&minus;threads.pl</b> script will analyze a
     44panc log file and report on build activity per thread. The
     45script takes the name of the log file as its only argument.
     46If no argument is given or the <b>&minus;&minus;help</b>
     47option is used, a short usage message is printed. <i>The log
     48file must have been created with &quot;task&quot; logging
     49enabled.</i></p>
     50<!-- INDENTATION -->
     51<p>The script will give the start time of build activity on
     52any particular thread and the ending time. This can be used
     53to understand the build and thread activity in a particular
     54compilation. The times are given in milliseconds relative to
     55the first entry in the log file.</p>
     56</td>
     57</table>
     58<a name="EXAMPLE"></a>
     59<h2>EXAMPLE</h2>
     60<!-- INDENTATION -->
     61<table width="100%" border=0 rules="none" frame="void"
     62       cols="2" cellspacing="0" cellpadding="0">
     63<tr valign="top" align="left">
     64<td width="10%"></td>
     65<td width="89%">
     66<p>If the output from the command is written to the file
     67thread.txt, then the following R script will create a plot
     68showing the duration of the activity on each thread.</p>
     69</td>
     70</table>
     71<!-- INDENTATION -->
     72<table width="100%" border=0 rules="none" frame="void"
     73       cols="2" cellspacing="0" cellpadding="0">
     74<tr valign="top" align="left">
     75<td width="16%"></td>
     76<td width="83%">
     77<pre><small># R&minus;script for simple analysis of thread report
     78tstats &lt;&minus;  read.table(&quot;threads.txt&quot;)
     79attach(tstats)
     80plot(stop/1000,thread, type=&quot;n&quot;, xlab=&quot;time (s)&quot;, ylab=&quot;thread ID&quot;)
     81segments(start/1000, thread, stop/1000, thread)
     82detach(tstats)
     83</small></pre>
     84</td>
     85</table>
     86<a name="AUTHOR"></a>
     87<h2>AUTHOR</h2>
     88<!-- INDENTATION -->
     89
     90<table width="100%" border=0 rules="none" frame="void"
     91       cols="2" cellspacing="0" cellpadding="0">
     92<tr valign="top" align="left">
     93<td width="10%"></td>
     94<td width="89%">
     95<p><b>Charles Loomis</b></p></td>
     96</table>
     97}}}