1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
.TH MC68DIS 1 "630 MTG"
.SH NAME
mc68dis \- MC68000 disassembler
.SH SYNOPSIS
.B mc68dis
.RB [ \-o ]
.RB [ \-V ]
.RB [ \-L ]
.RB [ \-d " sec]"
.RB [ \-da " sec ]"
.RB [ \-F " function]"
.RB [ \-t " sec]"
.br
.RB [ \-l " string]"
files
.SH DESCRIPTION
The
.I mc68dis
command
produces an assembly language listing
of each of its
object
.IR file
arguments.
The listing includes
assembly
statements
and a hexadecimal or octal representation of the binary that
produced those statements.
.PP
The following \fIoptions\fP are
interpreted by the disassembler and may be specified in any order.
.PP
.TP 12
.B \-o
Prints numbers in octal.
Default is hexadecimal.
.PP
.TP 12
.B \-V
Version number of the disassembler is written to standard error.
.PP
.TP 12
.B \-L
Invokes a look-up of C source labels in the symbol table for
subsequent printing.
.PP
.TP 12
.BR \-d " sec"
Disassembles the
named section as data,
printing the offset of
the data from the
beginning of the section.
.PP
.TP 12
.BR \-da " sec"
Disassembles the
named section as data,
printing the actual
address of the data.
.PP
.TP 12
.BR \-F " function"
Disassembles the
named function
in each object file
that is specified
on the command line.
.PP
.TP 12
.BR \-t " sec"
Disassembles the
named section as text.
.PP
.TP 12
.BR \-l " string"
Disassembles the
library file specified
as
.IR string .
For example,
one would issue the
command
.B "mc68dis \-l x \-l z"
to disassemble
.B libx.a
and
.B libz.a\c
\&.
All libraries are
assumed to be in
.BR $DMD/lib .
.DT
.br
.PP
If the
.BR \-d ,
.B \-da
or
.BR \-t
options are specified,
only those named
sections from each
user supplied file name
are disassembled.
Otherwise, all sections
containing text will
be disassembled.
.PP
If the
.BR \-F
option is specified,
only those named
functions from each
user supplied file name
are disassembled.
.B \-F
only works with object files that have been compiled with the
.B "dmdcc -g"
option.
.bp
.PP
On output, a number enclosed in brackets
at the beginning of a line,
such as
.BR [5] ,
represents a C break-pointable line number that
starts with the following instruction.
These line numbers are present only when the
object file has been compiled with the
.B "dmdcc -g"
option.
An expression such as
.B <40>
in the operand field,
following a relative displacement
for control transfer instructions,
is the computed address
within the section to which
control is transferred.
Similarly, an expression such as
\f3<40>+%d0\f1,
following a program counter index plus displacement
operand, indicates that the effective address
of the operand in the current section is 40 plus the content of %d0.
A C function name
will appear in the first column,
followed by
.BR (\|) ,
if the function was compiled with
.BR -g .
.SH "SEE ALSO"
dmdcc(1),
mc68as(1),
mc68ld(1).
.SH "DIAGNOSTICS"
The self-explanatory diagnostics
indicate errors in
the command line or problems
encountered with the
specified files.
|
