<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Parrot - Display symbol table information</title>
<link rel="stylesheet" type="text/css"
href="../../../resources/parrot.css"
media="all">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
</head>
<body>
<div id="wrapper">
<div id="header">
<a href="http://www.parrot.org">
<img border=0 src="../../../resources/parrot_logo.png" id="logo" alt="parrot">
</a>
</div> <!-- "header" -->
<div id="divider"></div>
<div id="mainbody">
<div id="breadcrumb">
<a href="../../../html/index.html">Home</a> » <a href="../../../html/tools.html">Tools</a> » Display symbol table information
</div>
<h1><a name="NAME"
>NAME</a></h1>
<p>tools/dev/nm.pl - Display symbol table information</p>
<h1><a name="SYNOPSIS"
>SYNOPSIS</a></h1>
<pre> % perl tools/dev/nm.pl [options] file</pre>
<p>To list all the symbols in Parrot:</p>
<pre> % perl tools/dev/nm.pl parrot</pre>
<h1><a name="DESCRIPTION"
>DESCRIPTION</a></h1>
<p>Portable frontend for <code>nm(1)</code>; by default lists all the code and data symbols in the object or archive files.</p>
<h2><a name="Command-Line_Options"
>Command-Line Options</a></h2>
<p>The following options can be used to limit the symbols:</p>
<dl>
<dt><a name="--code"
><b><code>--code</b></code></a></dt>
<dt><a name="-c"
><b><code>-c</b></code></a></dt>
List the code/text symbols.
<dt><a name="--data"
><b><code>--data</b></code></a></dt>
<dt><a name="-d"
><b><code>-d</b></code></a></dt>
List the data symbols.
<dt><a name="--init"
><b><code>--init</b></code></a></dt>
<dt><a name="-i"
><b><code>-i</b></code></a></dt>
List the initialised data symbols.
<dt><a name="--uninit"
><b><code>--uninit</b></code></a></dt>
<dt><a name="-u"
><b><code>-u</b></code></a></dt>
List the uninitialised data symbols.
<dt><a name="--const"
><b><code>--const</b></code></a></dt>
<dt><a name="-C"
><b><code>-C</b></code></a></dt>
List the constant (read-only) data symbols.Not all platforms support this, a warning will be given if not. You can try GNU <code>nm</code> if you want this feature.
<dt><a name="--undef"
><b><code>--undef</b></code></a></dt>
<dt><a name="-U"
><b><code>-U</b></code></a></dt>
List the undefined symbols.
<dt><a name="--def"
><b><code>--def</b></code></a></dt>
<dt><a name="-D"
><b><code>-D</b></code></a></dt>
List the defined symbols.
<dt><a name="--file"
><b><code>--file</b></code></a></dt>
<dt><a name="-f"
><b><code>-f</b></code></a></dt>
List the file(name) symbols.</dl>
<p>If more than one of all the above options are given, they are <code>AND</code>ed. They can also be negated with a "no", for example <code>--noconst</code>.</p>
<dl>
<dt><a name="--objectname"
><b><code>--objectname</b></code></a></dt>
<dt><a name="-o"
><b><code>-o</b></code></a></dt>
Prepend the object name before the symbol name.
<dt><a name="--t"
><b><code>--t</b></code></a></dt>
Append the short BSD-style type to the symbol name.
<pre> B - uninitialised data symbol
D - initialised data symbol
F - file name symbol
R - read-only data symbol
T - code/text symbol
U - undefined symbol</pre>
Uppercase indicates that the symbol is global; lowercase indicates that it is local.
<dt><a name="--type=bsd"
><b><code>--type=bsd</b></code></a></dt>
<dt><a name="-B"
><b><code>-B</b></code></a></dt>
The same as <code>--t</code>.
<dt><a name="--type=long"
><b><code>--type=long</b></code></a></dt>
<dt><a name="-L"
><b><code>-L</b></code></a></dt>
Append a long type (e.g. "global_const_init_data" versus "R") to the symbol name.
<dt><a name="--help"
><b><code>--help</b></code></a></dt>
Show the help.
<dt><a name="--version"
><b><code>--version</b></code></a></dt>
Show the version number.</dl>
<p>All the options can be shortened to their unique prefixes, and one leading dash ("-") can be used instead of two ("--").</p>
<h1><a name="HISTORY"
>HISTORY</a></h1>
<p>Author: Jarkko Hietaniemi.</p>
</div> <!-- "mainbody" -->
<div id="divider"></div>
<div id="footer">
Copyright © 2002-2009, Parrot Foundation.
</div>
</div> <!-- "wrapper" -->
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
cd14cddf3b3ceaf1193157472227757a
>
files
>
387
