![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to mc68nm.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / 630 / man / src / u_man / man1|
Return to mc68nm.1 CVS log | Up to [Research Unix] / researchv10dc / 630 / man / src / u_man / man1 |
1.1 root 1: .TH MC68NM 1 "630 MTG"
2: .SH NAME
3: mc68nm \- print name list of a MC68000 object file
4: .SH SYNOPSIS
5: \f3mc68nm [\f1 options \f3]\f1 file-names
6: .SH DESCRIPTION
7: The
8: .I mc68nm\^
9: command
10: displays the symbol table of each
11: Motorola 68000 object file
12: .IR file-name .
13: .I File-name\^
14: may be a relocatable or absolute Motorola 68000 object file;
15: or it may be an archive of relocatable or absolute Motorola 68000 object files.
16: For each symbol, the following information is printed.
17: For the \f3TYPE\f1, \f3SIZE\f1, or \f3LINE\f1 information,
18: the object file must be compiled with the
19: \f3-g\f1 option of the \f2dmdcc\f1(1) command.
20: .PP
21: .TP 9
22: .B Name
23: The name of the symbol.
24: .TP 9
25: .B Value
26: Its value expressed as an offset or an address
27: depending on its storage class.
28: .TP 9
29: .B Class
30: Its storage class.
31: .TP 9
32: .B Type
33: Its type and derived type.
34: If the symbol is an instance of a structure or of a union, then the structure
35: or union tag is given following the type (e.g. struct-tag).
36: If the symbol is an array, then the array dimensions are given
37: following the type (eg.,
38: .BR char[ n ][ m ] ).
39: .TP 9
40: .B Size
41: Its size in bytes, if available.
42: .TP 9
43: .B Line
44: The source line number at which it is defined, if available.
45: .TP 9
46: .B Section
47: For storage classes static and external,
48: the object file section containing the symbol (e.g., text, data or bss).
49: .DT
50: .br
51: .PP
52: The output of
53: .I mc68nm
54: may be controlled using the following options:
55: .\" .if !'mc68'' \{\
56: .\" .PP
57: .\" .TP 9
58: .\" .B \-a
59: .\" Produce full output. Redundant symbols (.text, .data, and .bss),
60: .\" normally suppressed, are printed.
61: .\" \}
62: .PP
63: .TP 9
64: .B \-d
65: Prints the value and size of a symbol in decimal (the default).
66: .PP
67: .TP 9
68: .B \-o
69: Prints the value and size of a symbol in octal instead of decimal.
70: .PP
71: .TP 9
72: .B \-x
73: Prints the value and size of a symbol in hexadecimal instead of decimal.
74: .PP
75: .TP 9
76: .B \-h
77: Does not display the output header data.
78: .PP
79: .TP 9
80: .B \-v
81: Sorts external symbols by value before they are printed.
82: .PP
83: .TP 9
84: .B \-n
85: Sorts external symbols by name before they are printed.
86: .PP
87: .TP 9
88: .B \-e
89: Prints only external and static symbols.
90: .PP
91: .TP 9
92: .B \-f
93: .\" .ie 'mc68'' \{\
94: Produces full output. Prints redundant symbols (.text, .data and .bss),
95: that are normally suppressed.
96: .\" \}
97: .\" .el \{\
98: .\" ``Fancy'' output is produced; that is, the symbol table information
99: .\" is post-processed to reflect the block structure of the source code.
100: .\" \}
101: .bp
102: .TP 9
103: .B \-u
104: Prints undefined symbols only.
105: .PP
106: .TP 9
107: .B \-V
108: Prints the version of the mc68nm command executing on the standard error output.
109: .PP
110: .TP 9
111: .B \-T
112: By default,
113: .I mc68nm\^
114: prints the entire name of the symbols listed.
115: Since object files can have symbol names with an arbitrary number of
116: characters, a name that is longer than the width of the column set aside
117: for names will overflow its column, forcing every column after the name
118: to be misaligned. The
119: .B \-T
120: option causes
121: .I mc68nm\^
122: to truncate every name which would otherwise overflow its column and
123: place an asterisk as the last character in the displayed name to mark
124: it as truncated.
125: .DT
126: .br
127: .PP
128: Options may be used in any order, either singly or in combination,
129: and may appear anywhere in the command line.
130: Therefore, both
131: .B "mc68nm name \-e \-v"
132: and
133: .B "mc68nm \-ve name"
134: print the static and external symbols in
135: .IR name ,
136: with external symbols sorted by value.
137: .SH "FILES"
138: /usr/tmp/nm??????
139: .SH "SEE ALSO"
140: dmdcc(1),
141: mc68as(1),
142: mc68ld(1).
143: .br
144: a.out(4), ar(4) in the \f2UNIX System V Programmer's Reference
145: Manual\f1.
146: .SH "DIAGNOSTICS"
147: .TP 9
148: ``mc68nm: name: cannot open''
149: if
150: .I name
151: cannot be read.
152: .PP
153: .TP 9
154: ``mc68nm: name: bad magic''
155: if
156: .I name
157: is not an appropriate Motorola 68000 object file.
158: .PP
159: .TP 9
160: ``mc68nm: name: no symbols''
161: if the symbols have been stripped from
162: .IR name .
163: .SH "WARNINGS"
164: When all the symbols are printed, they must be printed in the order they
165: appear in the symbol table in order to preserve scoping information.
166: Therefore, the
167: .B \-v
168: and
169: .B \-n
170: options should be used only in conjunction with the
171: .B \-e
172: option.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.