xref: /original-bsd/usr.bin/nm/nm.1 (revision acda45c0)
1.\" Copyright (c) 1980, 1990 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)nm.1	6.4 (Berkeley) 07/24/90
7.\"
8.Dd
9.Dt NM 1
10.Os BSD 4
11.Sh NAME
12.Nm nm
13.Nd display name list (symbol table)
14.Sh SYNOPSIS
15.Nm nm
16.Op Fl agnopruw
17.Ar
18.Sh DESCRIPTION
19The symbol table (name list) of each object in
20.Ar file(s)
21is displayed.
22If a library (archive) is given,
23.Nm
24displays a list for each
25object archive member.
26If
27.Ar file
28is not present,
29.Nm
30searches for the file
31.Pa a.out
32and if present, displays the symbol
33table for
34.Pa a.out .
35.Pp
36.Tp Fl a
37Display symbol table entries inserted for use by debuggers.
38.Tp Fl g
39Restrict display to external (global) symbols.
40.Tp Fl n
41Present results in numerical order.
42.Tp Fl o
43Display full path or library name of object on every line.
44.Tp Fl p
45Do not sort at all.
46.Tp Fl r
47Reverse order sort.
48.Tp Fl u
49Display undefined symbols only.
50.Tp Fl w
51Warn about non-object archive members.
52Normally, nm will silently ignore all archive members which are not
53object files.
54.Tp
55.Pp
56Each symbol name is preceded by its value (a blank field if the symbol
57is undefined) and one of the following letters:
58.Tw Ds
59.Tp Fl
60debugger symbol table entries (see the
61.Fl a
62option).
63.Tp Li A
64absolute
65.Tp Li B
66bss segment symbol
67.Tp Li C
68common symbol
69.Tp Li D
70data segment symbol
71.Tp Li f
72file name
73.Tp Li T
74text segment symbol
75.Tp Li U
76undefined
77.Tp
78.Pp
79If the symbol is local (non-external) the type letter is in lower case.
80The output is sorted alphabetically.
81.Sh SEE ALSO
82.Xr ar 1 ,
83.Xr ar 5 ,
84.Xr a.out 5 ,
85.Xr stab 5
86.Sh HISTORY
87.Nm Nm
88appeared in Version 6 AT&T UNIX.
89