summaryrefslogtreecommitdiffstats
path: root/system/d52/d52.pod
blob: 8f2502ebc66665e9a0f2332e6e6834d2db5248fc (plain)
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
# pod source for d52 man page
# pod2man -s1 -r3.4.1 --stderr -nD52 -cSlackBuilds.org < d52.pod > d52.1

=pod

=head1 NAME

d52 - disassembler for Intel 8052/8051/8031/etc

d48 - disassembler for Intel 8048 and 8041

dz80 - disassembler for Zilog Z80, Intel 8080 and 8085

=head1 SYNOPSIS

d52 I<options> B<filename>

=head1 DESCRIPTION

Full documentation may be found in I</usr/doc/d52-3.4.1/d52manual.html>
and I</usr/doc/d52-3.4.1/dz80-d48addendum.html>.

=head1 OPTIONS

Options may be entered Unix style (-d) or DOS style (/b).

Options may be entered in a freeform fashion as long as a dash (-) or
a slash (/) precedes any option that precedes the filename.
Examples:

	d52 filename bd
	d52 -d filename x100
	d52 /h filename d -x100

=head2 Common Options

These options are supported by d52, d48, and dz80.

=over

=item B<-b>

disassemble file with .bin extension.

=item B<-h>

disassemble file with .hex extension. If neither 'b' nor 'h' is specified, first search for a .hex file, and if not found, then a .bin file

=item B<-a>

use ascii macro instead of db/defb for text.

=item B<-d>

include address and data in the comment field.

=item B<-n>

use C style for hexadecimal operands

=item B<-p>

put dot '.' at beginning of pseudo ops

=item B<-s>

use 'defb' and 'defw' instead of 'db' and 'dw' for binary data.

=item B<-u>

output labels, symbols, and mnemonics in upper case.

=back

=head2 D52 Options

=over

=item B<-i>

put statement in output file to include 'sfr52.inc'.

=item B<-k>

disassemble for Keil A51 (obsolete).

=item B<-x>

add a hexadecimal offset to file addresses.

=item B<-z[filename]>

read cycle count file. Cycle count files are installed to /usr/share/d52/ in this build.
See /usr/doc/d52-3.4.1/cycle_counting.htm for more information.

=item B<-t>

trace and analyze code before disassembly. will overwrite any existing ctl file for the file being disassembled.

=back

=head2 D48 Options

=over

=item B<-1>

disassemble 8041 code (note, this is the numeral one, not the lowercase letter L).

=back

=head2 DZ80 Options

=over

=item B<-c>

disassemble CP/M .com file (implies -x100).

=item B<-t>

trace and analyze code before disassembly. will overwrite any existing ctl file for the file being disassembled.

=item B<-x>

add a hexadecimal offset to file addresses.

=item B<-80>

generate 8080 mnemonics.

=item B<-85>

generate 8085 mnemonics.

=back

=head1 AUTHOR

d52, d48, and dz80 are copyright (C) 1995-2007 by J. L. Post.

This man page was written by B. Watson for the SlackBuilds.org project. It
may be used by anyone.