-
Notifications
You must be signed in to change notification settings - Fork 0
/
dis8080.1
110 lines (110 loc) · 2.52 KB
/
dis8080.1
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
.\"
.\" dis8080 - Intel 8080 disassembler
.\"
.\" Copyright (c) 2020 Brian Callahan <[email protected]>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd November 16, 2020
.Dt DIS8080 1
.Os
.Sh NAME
.Nm dis8080
.Nd Intel 8080 disassembler
.Sh SYNOPSIS
.Nm
.Ar file
.Op Ar count
.Op Ar offset
.Op Ar loadaddr
.Sh DESCRIPTION
.Nm
is a disassembler for the Intel 8080 CPU.
It reads in an Intel 8080 executable
.Ar file
and outputs the assembly instructions of that executable to
.Ar stdout .
.Pp
If
.Ar count
is issued on the command line, print that many lines of instructions.
The
.Ar count
argument is understood as hexadecimal.
Defaults to 7.
.Pp
If
.Ar offset
is issued on the command line, disassembly begins at
.Ar offset
bytes from the
.Ar loadaddr .
The
.Ar offset
argument is understood as hexadecimal.
Defaults to 0.
.Pp
If
.Ar loadaddr
is issued on the command line, set the binary's load address to
.Ar loadaddr .
The
.Ar loadaddr
argument is understood as hexadecimal.
Defaults to 100h.
.Sh EXIT STATUS
The
.Nm
utility exits 0 on success, and >0 if an error occurs.
.Sh EXAMPLES
Read an Intel 8080 executable named
.Ar hello.com ,
print
.Ar 11
instructions, offset the first instruction printed by
.Ar 300h ,
and set the binary's load address to
.Ar 200h :
.Pp
.Dl dis8080 hello.com b 300 200
.Pp
Print the entire disassembly of
.Ar hello.com :
.Pp
.Dl dis8080 hello.com ffff
.Sh AUTHORS
.Nm
was written by
.An Brian Callahan Aq Mt [email protected] .
.Sh CAVEATS
The
.Ar offset
argument cannot be issued unless the
.Ar count
argument is also issued.
.Pp
The
.Ar loadaddr
argument cannot be issued unless the
.Ar offset
argument is also issued.
.Sh BUGS
If the user specifies an incorrect
.Ar offset
and/or
.Ar loadaddr ,
.Nm
will display addresses and/or instructions that will be incorrect.
The default value for
.Ar loadaddr
will work for most standard CP/M binaries.