Return to nm.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / pgrm / nm

Annotation of 43BSDReno/pgrm/nm/nm.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980, 1990 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted provided
                      5: .\" that: (1) source distributions retain this entire copyright notice and
                      6: .\" comment, and (2) distributions including binaries display the following
                      7: .\" acknowledgement:  ``This product includes software developed by the
                      8: .\" University of California, Berkeley and its contributors'' in the
                      9: .\" documentation or other materials provided with the distribution and in
                     10: .\" all advertising materials mentioning features or use of this software.
                     11: .\" Neither the name of the University nor the names of its contributors may
                     12: .\" be used to endorse or promote products derived from this software without
                     13: .\" specific prior written permission.
                     14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     17: .\"
                     18: .\"     @(#)nm.1       6.4 (Berkeley) 7/24/90
                     19: .\"
                     20: .Dd July 24, 1990
                     21: .Dt NM 1
                     22: .Os BSD 4
                     23: .Sh NAME
                     24: .Nm nm
                     25: .Nd display name list (symbol table)
                     26: .Sh SYNOPSIS
                     27: .Nm nm
                     28: .Op Fl agnopruw
                     29: .Ar
                     30: .Sh DESCRIPTION
                     31: The symbol table (name list) of each object in
                     32: .Ar file(s)
                     33: is displayed.
                     34: If a library (archive) is given,
                     35: .Nm 
                     36: displays a list for each
                     37: object archive member.
                     38: If
                     39: .Ar file
                     40: is not present,
                     41: .Nm
                     42: searches for the file
                     43: .Pa a.out
                     44: and if present, displays the symbol
                     45: table for
                     46: .Pa a.out .
                     47: .Pp
                     48: .Tp Fl a
                     49: Display symbol table entries inserted for use by debuggers.
                     50: .Tp Fl g
                     51: Restrict display to external (global) symbols.
                     52: .Tp Fl n
                     53: Present results in numerical order.
                     54: .Tp Fl o
                     55: Display full path or library name of object on every line.
                     56: .Tp Fl p
                     57: Do not sort at all.
                     58: .Tp Fl r
                     59: Reverse order sort.
                     60: .Tp Fl u
                     61: Display undefined symbols only.
                     62: .Tp Fl w
                     63: Warn about non-object archive members.
                     64: Normally, nm will silently ignore all archive members which are not
                     65: object files.
                     66: .Tp
                     67: .Pp
                     68: Each symbol name is preceded by its value (a blank field if the symbol
                     69: is undefined) and one of the following letters:
                     70: .Tw Ds
                     71: .Tp Fl
                     72: debugger symbol table entries (see the
                     73: .Fl a
                     74: option).
                     75: .Tp Li A
                     76: absolute
                     77: .Tp Li B
                     78: bss segment symbol
                     79: .Tp Li C
                     80: common symbol
                     81: .Tp Li D
                     82: data segment symbol
                     83: .Tp Li f
                     84: file name
                     85: .Tp Li T
                     86: text segment symbol
                     87: .Tp Li U
                     88: undefined
                     89: .Tp
                     90: .Pp
                     91: If the symbol is local (non-external) the type letter is in lower case.
                     92: The output is sorted alphabetically.
                     93: .Sh SEE ALSO
                     94: .Xr ar 1 ,
                     95: .Xr ar 5 ,
                     96: .Xr a.out 5 ,
                     97: .Xr stab 5
                     98: .Sh HISTORY
                     99: .Nm Nm
                    100: appeared in Version 6 AT&T UNIX.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.