dtd_pgm.html
by
admin
—
last modified
2007-12-11 00:33
Click here to get the file
Size
4.1 kB
-
File type
text/html
File contents
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!--
HPCToolkit Documentation: Editing within Netscape/Mozilla Composer
is possible, but it generates strange stuff in-line.
Please use an ordinary text editor.
-->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>HPCToolkit: PGM file man page</title>
<link rel='stylesheet' type='text/css' href='styleForAll.css'>
</head>
<body>
<!-- ********************************************************************** -->
<script language="JavaScript" src="header_hpctools.js"></script>
<!-- ********************************************************************** -->
<div class="lastupdated">Last Updated 07 Mar 2003</div>
<h2>File Format: PGM</h2>
<!-- ********************************************************************** -->
<h3>SYNOPSIS</h3>
<div class="indent">
<p>XML DTD (Document Type Definition):
<a href="../lib/dtd/PGM.dtd"><code>${HPCTOOLKIT}/lib/dtd/PGM.dtd</code></a>.
<p>Suggested file extension: `.psxml'
<p><span class="hpctool">PGM</span> files specify program structure,
i.e. they describe the source code structure of a program. By
default, <a href="hpc_bloop.html" class="hpctool">bloop</a> outputs data
in this format.
</div> <!-- class=indent -->
<!-- ********************************************************************** -->
<h3>DESCRIPTION</h3>
<div class="indent">
<p>The format of a <span class="hpctool">PGM</span> file should be
fairly self-explanatory. It is essentially a program scope tree (PGM)
with scopes for load modules (LM), files (F), procedures (P), loops
(L) and statement ranges (S). Loops may be arbitrarily nested. The
group (G) element allows one to specify and label aribrary sets of the
above scopes (except PGM) for later reference.
</div> <!-- class=indent -->
<!-- ********************************************************************** -->
<h3>EXAMPLES</h3>
<div class="indent">
<p>The examples below are snippets of
<a href="hpc_bloop.html" class="hpctool">bloop</a> output.
Note that `n' attributes give names (such as file names, procedure
names, label names), and `b' and `e' give an item's begin and end source
code line numbers, respectively.
<div class="indent">
<pre>
...
<PGM n="../../binaries/smg98/smg98.mips-IRIX64.cc-64-O3" version="3.0">
...
<F n="/home/eraxxon/DDevelop/HPCToolkit/tests/binaries/smg98/src/struct_linear_solvers/cyclic_reduction.c">
<P n="hypre_CycRedSetupCoarseOp" b="225" e="371">
<L b="261" e="352">
<S b="261" e="261"/>
...
<L b="327" e="327">
<S b="327" e="327"/>
</L>
<S b="351" e="351"/>
<L b="352" e="352">
<S b="352" e="352"/>
</L>
</L>
</P>
<P n="hypre_CyclicReductionSetup" b="387" e="722">
...
<L b="468" e="613">
<L b="468" e="613">
<S b="468" e="468"/>
...
<L b="488" e="490">
<S b="488" e="488"/>
<S b="490" e="490"/>
</L>
<S b="493" e="493"/>
<S b="500" e="500"/>
<L b="503" e="506">
<S b="503" e="503"/>
<S b="504" e="504"/>
<S b="506" e="506"/>
</L>
<S b="511" e="511"/>
<L b="514" e="514">
<S b="514" e="514"/>
</L>
<S b="518" e="518"/>
...
</L>
...
</P>
</F>
</PGM>
</pre>
</div> <!-- class=indent -->
</div> <!-- class=indent -->
<!-- ********************************************************************** -->
<script language="JavaScript" src="footer_hpctools.js"></script>
<!-- ********************************************************************** -->
</body>
</html>
