summaryrefslogtreecommitdiff
path: root/man/mcpu-nm.1
diff options
context:
space:
mode:
authorkx <kx@radix-linux.su>2026-10-09 18:00:15 +0300
committerkx <kx@radix-linux.su>2026-10-09 18:00:15 +0300
commit065da3509019b15dd0e678072e6be629e5330bef (patch)
tree69c934c9e786ac048b4fbe8f4c4c5571661521f4 /man/mcpu-nm.1
parentd130fe27fa753be02ed76fd9b277aa3c3d928eb9 (diff)
downloadlibmcpu-0.4.0.tar.xz
Version 0.4.00.4.0
Diffstat (limited to 'man/mcpu-nm.1')
-rw-r--r--man/mcpu-nm.166
1 files changed, 66 insertions, 0 deletions
diff --git a/man/mcpu-nm.1 b/man/mcpu-nm.1
new file mode 100644
index 0000000..abf4f92
--- /dev/null
+++ b/man/mcpu-nm.1
@@ -0,0 +1,66 @@
+.TH MCPU-NM 1 "October 2026" "LibMCPU" "User Commands"
+
+.SH NAME
+mcpu-nm \- list symbols from MCPU MELF files and archives
+.SH SYNOPSIS
+.B mcpu-nm
+.RI [ options ] " MELF-file(s)"
+.SH DESCRIPTION
+.B mcpu-nm
+lists symbols from MELF ET_REL objects, ET_EXEC executables, ET_DYN shared
+objects and deterministic MCPU static archives. By default it reads .symtab
+and sorts symbols by name. For ABI-v2/v3 runtime symbols use
+.BR -D .
+.SH OPTIONS
+.TP
+.BR -a ", " --debug-syms
+Display all named symbols, including FILE and SECTION symbols.
+.TP
+.BR -g ", " --extern-only
+Display only external GLOBAL and WEAK symbols.
+.TP
+.BR -u ", " --undefined-only
+Display only undefined symbols.
+.TP
+.BR -n ", " --numeric-sort
+Sort symbols numerically by value.
+.TP
+.BR -r ", " --reverse-sort
+Reverse the selected sort order.
+.TP
+.BR -p ", " --no-sort
+Preserve symbol-table order.
+.TP
+.BR -D ", " --dynamic
+Read .dynsym instead of .symtab.
+.TP
+.BR -A ", " --print-file-name
+Prefix each output line with the input file name. Archive output identifies
+the archive and member.
+.TP
+.B --help
+Display help and exit.
+.TP
+.B --version
+Display the program name, MCPU toolchain identity and version, then exit.
+.TP
+.B --dump-version
+Display only the MCPU package version number and exit.
+.SH SYMBOL TYPE LETTERS
+As with traditional nm output, upper-case type letters identify external
+symbols and lower-case letters local symbols. The letter also reflects the
+MCPU section class, for example T/t for PROGRAM text and D/d for DATA.
+.SH EXIT STATUS
+Zero on successful inspection; nonzero for inaccessible or malformed input.
+.SH EXAMPLES
+.nf
+mcpu-nm file.o
+mcpu-nm -n file.o
+mcpu-nm -D libfoo.so.1
+mcpu-nm -A -D -g libfoo.so.1
+mcpu-nm -A libsimple.a
+.fi
+.SH SEE ALSO
+.BR mcpu-readelf (1),
+.BR mcpu-objdump (1),
+.BR libmcpu (7)