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.