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