hpc_ptran.html
by
admin
—
last modified
2007-12-11 00:34
Click here to get the file
Size
4.5 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 ptran man page</title>
<link rel='stylesheet' type='text/css' href='styleForAll.css'>
</head>
<body>
<!-- ********************************************************************** -->
<script language="JavaScript" src="header_hpctools.js"></script>
<!-- ********************************************************************** -->
<div id="main">
<p class="lastupdated">Last Updated 31 Jan 2003</p>
<h2>User Commands: ptran(1)</h2>
<!-- ********************************************************************** -->
<h3>SYNOPSIS</h3>
<div class="indent">
<p><span class="hpctool">ptran</span>
[-V] [-m <i>platform</i>] [-e <i>nn</i>] [-h]
< <i>input_file</i>
> <i>output_file.pxml</i>
<p>Location: <code>${HPCTOOLKIT}/bin</code>
</div> <!-- class=indent -->
<!-- ********************************************************************** -->
<h3>DESCRIPTION</h3>
<div class="indent">
<p><span class="hpctool">ptran</span> is a Perl script that reads a
vendor-specific profile file and outputs a
<a href="dtd_profile.html" class="hpctool">PROFILE</a> document. Each
profile data file provided to
<a href="hpcview.html" class="hpctool">hpcview</a>
must be in this format.</p>
</div> <!-- class=indent -->
<!-- ********************************************************************** -->
<h3>ARGUMENTS</h3>
<div class="indent">
<dl>
<dt>-V
<dd>Print version information.
<dt>-m <i>platform</i>
<dd>platforms currently supported are <code>sgi</code> and
<code>compaq</code> unless specified explicitly, the platform name is
inferred using the output from <code class="xtool">uname(1)</code>.
<dt>-e <i>nn</i>
<dd><i>nn</i> is an integer that selects specific metrics from
experiments (e.g. ideal on SGIs) that generate more than one interesting
column in the vendor-format prof file.
<dt><i>input_file</i>
<dd>The current release includes <span class="hpctool">ptran</span>
scripts for interpeting vendor-specific profile information on SGI and
Compaq platforms.
<br><br>
On an SGI system, apply <span class="xtool">prof -lines</span> to an
output file generated by <span class="xtool">ssrun</span>.
<br><br>
On a Compaq Tru64/Alpha system, apply
<span class="xtool">prof -lines</span> to a <code>umon.out</code>
file generated by <span class="xtool">uprofile</span>.
<dt>-h
<dd>Print help.
</dl>
</div> <!-- class=indent -->
<!-- ********************************************************************** -->
<h3>EXAMPLES</h3>
<div class="indent">
<ol class="noindent">
<li><p>To send <a href="dtd_profile.html" class="hpctool">PROFILE</a>
information to the file <code>fcy_hwc.pxml</code> for the program
<code>foo</code> using the <span class="xtool">ssrun</span> experiment
named `fcy_hwc', use the following commands:
<div class="indent">
<code>ssrun -fcy_hwc foo</code><br>
<code>prof -lines foo.fcy_hwc.m* | ptran > fcy_hwc.pxml</code>
</div>
<li><p>To send <a href="dtd_profile.html" class="hpctool">PROFILE</a>
information to the file <code>cycles.pxml</code> for the program
<code>foo</code> using the <span class="xtool">uprofile</span> experiment
named `cycles0', use the following commands:
<div class="indent">
<code>uprofile cycles0 foo</code><br>
<code>prof -lines foo umon.out > foo.cycles</code><br>
<code>ptran < foo.cycles > cycles.pxml</code>
</div>
</ol>
</div> <!-- class=indent -->
<!-- ********************************************************************** -->
<h3>NOTES</h3>
<div class="indent">
<span class="hpctool">ptran</span> runs on any system with a
relatively recent version of Perl. Depending on the version of Perl
on your system, either the PERLLIB or PERL5LIB environment variable
must be set to point to the Perl library located in
<code>${HPCTOOLKIT}/lib/perl</code>. The
<a href="../Sourceme-csh"><code>Sourceme-csh</code></a> and
<a href="../Sourceme-sh"><code>Sourceme-sh</code></a> files set both of these
variables for <code>csh</code>-based and <code>sh</code>-based shells,
respectively. </p>
</div> <!-- class=indent -->
<!-- ********************************************************************** -->
<script language="JavaScript" src="footer_hpctools.js"></script>
<!-- ********************************************************************** -->
</div> <!-- id=main -->
</body>
</html>
