/ 
parrot-0.2.3
/ tools/dev/nm.pl

NAME

tools/dev/nm.pl - Display symbol table information

SYNOPSIS

% perl tools/dev/nm.pl [options] file

To list all the symbols in Parrot:

% perl tools/dev/nm.pl parrot

DESCRIPTION

Portable frontend for nm(1); by default lists all the code and data symbols in the object or archive files.

Command-Line Options

The following options can be used to limit the symbols:

--code
-c

List the code/text symbols.

--data
-d

List the data symbols.

--init
-i

List the initialised data symbols.

--uninit
-u

List the uninitialised data symbols.

--const
-C

List the constant (read-only) data symbols.

Not all platforms support this, a warning will be given if not. You can try GNU nm if you want this feature.

--undef
-U

List the undefined symbols.

--def
-D

List the defined symbols.

--file
-f

List the file(name) symbols.

If more than one of all the above options are given, they are ANDed. They can also be negated with a "no", for example --noconst.

--objectname
-o

Prepend the object name before the symbol name.

--t

Append the short BSD-style type to the symbol name.

B - uninitialised data symbol
D - initialised data symbol
F - file name symbol
R - read-only data symbol
T - code/text symbol
U - undefined symbol

Uppercase indicates that the symbol is global; lowercase indicates that it is local.

--type=bsd
-B

The same as --t.

--type=long
-L

Append a long type (e.g. "global_const_init_data" versus "R") to the symbol name.

--help

Show the help.

--version

Show the version number.

All the options can be shortened to their unique prefixes, and one leading dash ("-") can be used instead of two ("--").

HISTORY

Author: Jarkko Hietaniemi.