dtd_profile.html
by
admin
—
last modified
2007-12-11 00:33
Click here to get the file
Size
5.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: PROFILE 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: PROFILE</h2>
<!-- ********************************************************************** -->
<h3>SYNOPSIS</h3>
<div class="indent">
<p>XML DTD (Document Type Definition):
<a href="../lib/dtd/PROFILE.dtd"><code>${HPCTOOLKIT}/lib/dtd/PROFILE.dtd</code></a>.
<p>Suggested file extension: `.pxml'
<p><span class="hpctool">PROFILE</span> files are platform-independent XML documents that describe a profile histogram by associating profiling metrics with program source code. A number of tools produce output of this format, including <a href="hpc_ptran.html" class="hpctool">ptran</a> and <a href="hpc_xprof.html" class="hpctool">xprof</a>.
</div> <!-- class=indent -->
<!-- ********************************************************************** -->
<h3>DESCRIPTION</h3>
<div class="indent">
<p>The format of a <span class="hpctool">PROFILE</span> file should be
fairly self-explanatory.
Metric counts (M) are embedded within a program scope tree
(essentially identical to the file format
<a href="dtd_pgm.html" class="hpctool">PGM</a>).
The program scope tree consists of a program (PGM), load modules (LM),
files (F), procedures (P), loops (L) and statement ranges (S).
Multiple metrics are supported in each
<span class="hpctool">PROFILE</span>, and thus each
metric in the scope tree is identified by a short name (`shortName')
previously assigned in the header information. (The METRIC elements
of <a href="dtd_hpcview.html" class="hpctool">HPCVIEW</a> files may
also use this short name in the `select' attribute of FILE to identify
one of the many metrics.) Metric values are reported as number
of events (not samples):
<blockquote>
(samples) * (events/sample)
</blockquote>
</div> <!-- class=indent -->
<!-- ********************************************************************** -->
<h3>EXAMPLES</h3>
<div class="indent">
<p>The examples below are snippets of
<a href="hpc_xprof.html" class="hpctool">xprof</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>
...
<PROFILE version="3.0">
<PROFILEHDR>
name hydro.alpha-OSF1.f77
image 2002080915562145afda
path hydro.alpha-OSF1.f77
epoch 200209231725
platform limerick
text_start 0x000120000000
text_size 0x000000010000
</PROFILEHDR>
<PROFILEPARAMS>
<TARGET name="hydro.alpha-OSF1.f77"/>
<METRICS>
<METRIC shortName="0" nativeName="cycles" period="126976"/>
<METRIC shortName="1" nativeName="bmiss" period="8192"/>
</METRICS>
</PROFILEPARAMS>
<PROFILESCOPETREE>
<PGM n="hydro.alpha-OSF1.f77">
...
<F n="pencilvelp1.f">
<P n="pencilbig1_">
<S b="122" id="0">
<M n="0" v="380928"/>
</S>
<S b="124" id="0">
<M n="0" v="3.80928e+06"/>
<M n="1" v="16384"/>
</S>
<S b="126" id="0">
<M n="0" v="9.39622e+06"/>
<M n="1" v="90112"/>
</S>
<S b="127" id="0">
<M n="0" v="6.98368e+06"/>
<M n="1" v="24576"/>
</S>
<S b="128" id="0">
<M n="0" v="8.12646e+06"/>
<M n="1" v="49152"/>
</S>
<S b="132" id="0">
<M n="0" v="9.39622e+06"/>
<M n="1" v="90112"/>
</S>
<S b="133" id="0">
<M n="0" v="5.07904e+06"/>
<M n="1" v="81920"/>
</S>
<S b="134" id="0">
<M n="0" v="1.00311e+07"/>
<M n="1" v="90112"/>
</S>
...
<S b="165" id="0">
<M n="0" v="1.01581e+06"/>
</S>
<S b="177" id="0">
<M n="1" v="8192"/>
</S>
...
</P>
</F>
...
</PGM>
</PROFILESCOPETREE>
</PROFILE>
</pre>
</div> <!-- class=indent -->
</div> <!-- class=indent -->
<!-- ********************************************************************** -->
<script language="JavaScript" src="footer_hpctools.js"></script>
<!-- ********************************************************************** -->
</body>
</html>
