xref: /original-bsd/usr.bin/nm/nm.1 (revision c3e32dec)
1.\" Copyright (c) 1980, 1990, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)nm.1	8.1 (Berkeley) 06/06/93
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.Bl -tag -width flag
36.It Fl a
37Display symbol table entries inserted for use by debuggers.
38.It Fl g
39Restrict display to external (global) symbols.
40.It Fl n
41Present results in numerical order.
42.It Fl o
43Display full path or library name of object on every line.
44.It Fl p
45Do not sort at all.
46.It Fl r
47Reverse order sort.
48.It Fl u
49Display undefined symbols only.
50.It Fl w
51Warn about non-object archive members.
52Normally, nm will silently ignore all archive members which are not
53object files.
54.El
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.Pp
59.Bl -tag -width Ds -compact -offset indent
60.It Fl
61debugger symbol table entries (see the
62.Fl a
63option).
64.It Li A
65absolute
66.It Li B
67bss segment symbol
68.It Li C
69common symbol
70.It Li D
71data segment symbol
72.It Li f
73file name
74.It Li T
75text segment symbol
76.It Li U
77undefined
78.El
79.Pp
80If the symbol is local (non-external) the type letter is in lower case.
81The output is sorted alphabetically.
82.Sh SEE ALSO
83.Xr ar 1 ,
84.Xr ar 5 ,
85.Xr a.out 5 ,
86.Xr stab 5
87.Sh HISTORY
88An
89.Nm nm
90command appeared in
91.At v6 .
92