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.


parrot