usr/src/usr.bin/nm/nm.1

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)nm.1	6.1 (Berkeley) %G%
.\"
.TH NM 1 ""
.UC 4
.SH NAME
nm \- print name list
.SH SYNOPSIS
.B nm
[
.B \-agnopru
]
[ file ... ]
.SH DESCRIPTION
.I Nm
prints the name list (symbol table) of each object
.I file
in the argument list.  If an argument is an archive, a listing for each object
file in the archive will be produced.  If no
.I file
is given, the symbols in "a.out" are listed.
.PP
Each symbol name is preceded by its value (blanks if undefined)
and one of the letters
.SM
.B U
(undefined),
.SM
.B A
(absolute),
.SM
.B  T
(text segment symbol),
.SM
.B D
(data segment symbol),
.SM
.B B
(bss segment symbol),
.SM
.B C
(common symbol),
.SM
.B f
file name,
or
.B \-
for debugger symbol table entries (see
.B \-a
below).
If the symbol is local (non-external) the type letter is in lower case.
The output is sorted alphabetically.
.PP
Options are:
.TP
.B  \-a
Print symbol table entries inserted for use by debuggers.
.TP
.B  \-g
Print only global (external) symbols.
.TP
.B \-n
Sort numerically rather than alphabetically.
.TP
.B  \-o
Prepend file or archive element name to each output line rather than only once.
.TP
.B  \-p
Don't sort; print in symbol-table order.
.TP
.B  \-r
Sort in reverse order.
.TP
.B  \-u
Print only undefined symbols.
.SH SEE ALSO
ar(1), ar(5), a.out(5), stab(5)
Commit	Line	Data
	1	.\" Copyright (c) 1980 Regents of the University of California.
	2	.\" All rights reserved. The Berkeley software License Agreement
	3	.\" specifies the terms and conditions for redistribution.
	4	.\"
	5	.\" @(#)nm.1 6.1 (Berkeley) %G%
	6	.\"
	7	.TH NM 1 ""
	8	.UC 4
	9	.SH NAME
	10	nm \- print name list
	11	.SH SYNOPSIS
	12	.B nm
	13	[
	14	.B \-agnopru
	15	]
	16	[ file ... ]
	17	.SH DESCRIPTION
	18	.I Nm
	19	prints the name list (symbol table) of each object
	20	.I file
	21	in the argument list. If an argument is an archive, a listing for each object
	22	file in the archive will be produced. If no
	23	.I file
	24	is given, the symbols in "a.out" are listed.
	25	.PP
	26	Each symbol name is preceded by its value (blanks if undefined)
	27	and one of the letters
	28	.SM
	29	.B U
	30	(undefined),
	31	.SM
	32	.B A
	33	(absolute),
	34	.SM
	35	.B T
	36	(text segment symbol),
	37	.SM
	38	.B D
	39	(data segment symbol),
	40	.SM
	41	.B B
	42	(bss segment symbol),
	43	.SM
	44	.B C
	45	(common symbol),
	46	.SM
	47	.B f
	48	file name,
	49	or
	50	.B \-
	51	for debugger symbol table entries (see
	52	.B \-a
	53	below).
	54	If the symbol is local (non-external) the type letter is in lower case.
	55	The output is sorted alphabetically.
	56	.PP
	57	Options are:
	58	.TP
	59	.B \-a
	60	Print symbol table entries inserted for use by debuggers.
	61	.TP
	62	.B \-g
	63	Print only global (external) symbols.
	64	.TP
	65	.B \-n
	66	Sort numerically rather than alphabetically.
	67	.TP
	68	.B \-o
	69	Prepend file or archive element name to each output line rather than only once.
	70	.TP
	71	.B \-p
	72	Don't sort; print in symbol-table order.
	73	.TP
	74	.B \-r
	75	Sort in reverse order.
	76	.TP
	77	.B \-u
	78	Print only undefined symbols.
	79	.SH SEE ALSO
	80	ar(1), ar(5), a.out(5), stab(5)