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

Timestamp:

Oct 3, 2008, 4:16:06 PM (16 years ago)

Author:

/C=IE/O=Grid-Ireland/OU=cs.tcd.ie/L=RA-TCD/CN=Stephen O. Childs

Comment:

--

Doc/compiler/scripts/Memory

@@ +1 @@
+{{{
+#!href
+<h1 align=center>PANC&minus;MEMORY.PL</h1>
+<a href="#NAME">NAME</a><br>
+<a href="#SYNOPSIS">SYNOPSIS</a><br>
+<a href="#DESCRIPTION">DESCRIPTION</a><br>
+<a href="#EXAMPLE">EXAMPLE</a><br>
+<a href="#AUTHOR">AUTHOR</a><br>
+
+<hr>
+<a name="NAME"></a>
+<h2>NAME</h2>
+<!-- INDENTATION -->
+<table width="100%" border=0 rules="none" frame="void"
+       cols="2" cellspacing="0" cellpadding="0">
+<tr valign="top" align="left">
+<td width="10%"></td>
+<td width="89%">
+<p>panc-memory.pl &minus; create a report of panc memory
+utilization</p>
+</td>
+</table>
+<a name="SYNOPSIS"></a>
+<h2>SYNOPSIS</h2>
+<!-- INDENTATION -->
+<table width="100%" border=0 rules="none" frame="void"
+       cols="2" cellspacing="0" cellpadding="0">
+<tr valign="top" align="left">
+<td width="10%"></td>
+<td width="89%">
+<p><b>panc&minus;memory.pl</b> [<b>&minus;&minus;help</b>]
+{logfile}</p>
+</td>
+</table>
+<a name="DESCRIPTION"></a>
+<h2>DESCRIPTION</h2>
+<!-- INDENTATION -->
+<table width="100%" border=0 rules="none" frame="void"
+       cols="2" cellspacing="0" cellpadding="0">
+<tr valign="top" align="left">
+<td width="10%"></td>
+<td width="89%">
+<p>The <b>panc&minus;memory.pl</b> script will analyze a
+panc log file and report on the memory usage. The script
+takes the name of the log file as its only argument. If no
+argument is given or the <b>&minus;&minus;help</b> option is
+used, a short usage message is printed. <i>The log file must
+have been created with &quot;memory&quot; logging
+enabled.</i></p>
+<!-- INDENTATION -->
+<p>The script will extract the heap memory usage of the
+compiler as a function of time. The memory use is reported
+in megabytes and the times are in milliseconds. Usually one
+will want to use this information in conjunction with the
+thread information to understand the memory use as it
+relates to general compiler activity. Note that java uses
+sophisticated memory management and garbage collection
+techniques; fluctuations in memory usage may not be directly
+related to the compiler activity at any instant in time.</p>
+</td>
+</table>
+<a name="EXAMPLE"></a>
+<h2>EXAMPLE</h2>
+<!-- INDENTATION -->
+<table width="100%" border=0 rules="none" frame="void"
+       cols="2" cellspacing="0" cellpadding="0">
+<tr valign="top" align="left">
+<td width="10%"></td>
+<td width="89%">
+<p>If the output from the command is written to the file
+memory.txt, then the following R script will create a plot
+of the memory utilization as a function of time.</p>
+</td>
+</table>
+<!-- INDENTATION -->
+<table width="100%" border=0 rules="none" frame="void"
+       cols="2" cellspacing="0" cellpadding="0">
+<tr valign="top" align="left">
+<td width="16%"></td>
+<td width="83%">
+<pre><small># R&minus;script for simple analysis of memory report
+mstats &lt;&minus;  read.table(&quot;memory.txt&quot;)
+attach(mstats)
+plot(time/1000, memory, xlab=&quot;time (s)&quot;, ylab=&quot;memory (MB)&quot;, type=&quot;l&quot;)
+detach(mstats)
+</small></pre>
+</td>
+</table>
+<a name="AUTHOR"></a>
+<h2>AUTHOR</h2>
+<!-- INDENTATION -->
+
+<table width="100%" border=0 rules="none" frame="void"
+       cols="2" cellspacing="0" cellpadding="0">
+<tr valign="top" align="left">
+<td width="10%"></td>
+<td width="89%">
+<p><b>Charles Loomis</b></p></td>
+</table>
+}}}