|
|
1.1 root 1: .TH MC68DUMP 1 "630 MTG"
2: .tr ~
3: .SH NAME
4: mc68dump \- dump parts of an MC68000 object file
5: .SH SYNOPSIS
6: .B mc68dump
7: .RB [ \-acfghlorst ]
8: .RB [ \-z " name]"
9: files
10: .SH DESCRIPTION
11: The
12: .I mc68dump
13: command
14: dumps selected parts of each
15: of its object \fIfile\fP arguments.
16: .PP
17: This command
18: accepts both object files and archives of object files.
19: It
20: processes each file argument according to one or more of the following
21: options:
22: .TP \w'\fB\-d~number~~'u
23: .B \-a
24: Dumps the archive header of each member of each archive file
25: argument.
26: .TP
27: .B \-g
28: Dumps the global symbols in the symbol table of a 6.0 archive.
29: .TP
30: .B \-f
31: Dumps each file header.
32: .TP
33: .B \-o
34: Dumps each optional header.
35: .TP
36: .B \-h
37: Dumps section headers.
38: .TP
39: .B \-s
40: Dumps section contents.
41: .TP
42: .B \-r
43: Dumps relocation information.
44: .TP
45: .B \-l
46: Dumps line number information.
47: .TP
48: .B \-t
49: Dumps symbol table entries.
50: .TP
51: .BR \-z ~name
52: Dumps line number entries for the named function.
53: .TP
54: .BR \-c
55: Dumps the string table.
56: .PP
57: The following \fImodifiers\fP are used in conjunction with the options
58: listed above to modify their capabilities.
59: .TP \w'\fB\-d~number~~'u
60: .BR \-d ~number
61: Dumps the section number or range of sections starting at \fInumber\fP
62: and ending either at the last section number or \fInumber\fP specified by
63: .BR +d .
64: .TP
65: .BR +d ~number
66: Dumps sections in the range either beginning with
67: first section or beginning
68: with section specified by \fB\-d\fP.
69: .TP
70: .BR \-n ~name
71: Dumps information pertaining only to the named entity.
72: This
73: .I modifier
74: applies to
75: .BR \-h ,
76: .BR \-s ,
77: .BR \-r ,
78: .BR \-l ,
79: and
80: .BR \-t .
81: .TP
82: .B \-p
83: Suppresses printing of the headers.
84: .TP
85: .BR \-t ~index
86: Dumps only the indexed symbol table entry.
87: The
88: \f3-t\f1,
89: used in conjunction with
90: .BR +t ,
91: specifies a range of symbol
92: table entries.
93: .TP
94: .BR +t ~index
95: Dumps the symbol table entries in the range ending with the indexed entry.
96: The range begins at the first symbol table entry or at the entry
97: specified by the
98: .B \-t
99: option.
100: .TP
101: .B \-u
102: Underlines the name of the file for emphasis.
103: .TP
104: .B \-v
105: Dumps information in symbolic representation rather than numeric
106: (e.g.,
107: .SM C_STATIC
108: instead of
109: .BR \s-10X02\s+1 ).
110: This \fImodifier\fP can be used with all the above options
111: except
112: .B \-s
113: and
114: .B \-o
115: options
116: of
117: .IR mc68dump.
118: .TP
119: .BR \-z ~name,number
120: Dumps line number entry or range of line numbers starting at
121: .I number
122: for the named function.
123: .TP
124: .BR \+z ~number
125: Dumps line numbers starting at either function
126: .IR name " or " number
127: specified
128: by
129: .BR \-z,
130: up to
131: .I number
132: specified by
133: .BR +z .
134: .PP
135: .PP
136: Blanks separating an \fIoption\fP and its \fImodifier\fP are optional.
137: The comma separating the name from the number modifying the
138: .B \-z
139: option may
140: be replaced by a blank.
141: .PP
142: The
143: .B -z
144: and
145: .B -n
146: options that take a
147: .I name
148: modifier will only work with object files that have been compiled
149: with the
150: .B "dmdcc \-g"
151: option.
152: .PP
153: The
154: .I mc68dump
155: command
156: attempts to format the information it dumps in a meaningful way,
157: printing certain information in character,
158: hex, octal or decimal representation as appropriate.
159: .SH "SEE ALSO"
160: dmdcc(1).
161: .br
162: a.out(4), ar(4) in the \f2UNIX System V Programer's
163: Reference Manual\f1.
164: .tr ~~
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.