16.2.3 Options

Long and short forms of options, shown in the table below as alternatives, are equivalent.

Table 16-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).
`-f format` `--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.
`-mdfp=path`	Use the device family pack (DFP) specified at the `path` location.
`-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.