14.2.3 Options

Table 14-3. XC32-nm Options
Option	Function
`-A` `-o` `--print-file-name`	Precede each symbol by the name of the input file (or archive member) in which it was found, rather than identifying the input file once only, before all of its symbols.
`-a` `--debug-syms`	Display all symbols, even debugger-only symbols; normally these are not listed.
`-B`	The same as `--format=bsd`.
`--defined-only`	Display only defined symbols for each object file.
`-u` `--undefined-only`	Display only undefined symbols (those external to each object file).
`-fformat` `--format=format`	Use the output format `format`, which can be `bsd, sysv` or `posix`. The default is `bsd`. Only the first character of `format` is significant; it can be either upper or lower case.
`-g` `--extern-only`	Display only external symbols.
`--help`	Show a summary of the options to `xc32-nm` and exit.
`-l` `--line-numbers`	For each symbol, use debugging information to try to find a filename and line number. For a defined symbol, look for the line number of the address of the symbol. For an undefined symbol, look for the line number of a relocation entry that refers to the symbol. If line number information can be found, print it after the other symbol information.
`-n` `-v` `--numeric-sort`	Sort symbols numerically by their addresses, rather than alphabetically by their names.
`-p` `--no-sort`	Do not bother to sort the symbols in any order; print them in the order encountered.
`-P` `--portability`	Use the POSIX.2 standard output format instead of the default format. Equivalent to `-f posix`.
`-r` `--reverse-sort`	Reverse the order of the sort (whether numeric or alphabetic); let the last come first.
`-s` `--print-armap`	When listing symbols from archive members, include the index: a mapping (stored in the archive by `xc32-ar` or `xc32-ranlib`) of which modules contain definitions for which names.
`--size-sort`	Sort symbols by size. The size is computed as the difference between the value of the symbol and the value of the symbol with the next higher value. The size of the symbol is printed, rather than the value.
`-t radix` `--radix=radix`	Use `radix` as the radix for printing the symbol values. It must be `d` for decimal, `o` for octal or `x` for hexadecimal.
`-V` `--version`	Show the version number of `xc32-nm` and exit.

-A

-o

--print-file-name

Precede each symbol by the name of the input file (or archive member) in which it was found, rather than identifying the input file once only, before all of its symbols.

-a

--debug-syms

Display all symbols, even debugger-only symbols; normally these are not listed.

-B

The same as --format=bsd.

--defined-only

Display only defined symbols for each object file.

-u

--undefined-only

Display only undefined symbols (those external to each object file).

-fformat

--format=format

Use the output format format, which can be bsd, sysv or posix. The default is bsd. Only the first character of format is significant; it can be either upper or lower case.

-g

--extern-only

Display only external symbols.

--help

Show a summary of the options to xc32-nm and exit.

-l

--line-numbers

For each symbol, use debugging information to try to find a filename and line number. For a defined symbol, look for the line number of the address of the symbol. For an undefined symbol, look for the line number of a relocation entry that refers to the symbol. If line number information can be found, print it after the other symbol information.

-n

-v

--numeric-sort

Sort symbols numerically by their addresses, rather than alphabetically by their names.

-p

--no-sort

Do not bother to sort the symbols in any order; print them in the order encountered.

-P

--portability

Use the POSIX.2 standard output format instead of the default format. Equivalent to -f posix.

-r

--reverse-sort

Reverse the order of the sort (whether numeric or alphabetic); let the last come first.

-s

--print-armap

When listing symbols from archive members, include the index: a mapping (stored in the archive by xc32-ar or xc32-ranlib) of which modules contain definitions for which names.

--size-sort

Sort symbols by size. The size is computed as the difference between the value of the symbol and the value of the symbol with the next higher value. The size of the symbol is printed, rather than the value.

-t
                           radix

--radix=radix

Use radix as the radix for printing the symbol values. It must be d for decimal, o for octal or x for hexadecimal.

-V

--version

Show the version number of xc32-nm and exit.