<!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-2011, Parrot Foundation. </div> </div> <!-- "wrapper" --> </body> </html>