aboutsummaryrefslogtreecommitdiff
path: root/jindroush/man/chkexe.1
blob: c266a034f6aad0862c4374c9c187f71b607405f5 (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
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "CHKEXE" 1 "2024-05-16" "2.62" "Jindroush's Atari 8-bit tools"
.SH NAME
chkexe \- check and/or disassemble Atari 8-bit executables
.SH SYNOPSIS
.sp
chkexe [\fB\-gaps\fP \fIgap\-size\fP] [\fB\-silent\fP] [\fB\-split\fP] [\fB\-d\fP] \fBxex\-file\fP [\fBoutput\-file\fP]
.SH DESCRIPTION
.sp
\fBchkexe\fP reads an Atari 8\-bit executable (aka XEX file) and prints a
list of segments, each with their start and end address. Run and init
addresses are decoded.
.sp
If no \fBoutput\-file\fP is given, \fBchkexe\fP simply prints the results of
its analysis. With an \fBoutput\-file\fP, a possibly modified copy of the
XEX file is created: Adjacent blocks (e.g. a block ending at $1FFF,
followed by a block beginning at $2000) will be combined. The \fB\-gaps\fP
option can be used to control the threshold for combining blocks.
.SH OPTIONS
.INDENT 0.0
.TP
.B \fB\-gaps\fP \fIgap\-size\fP
Blocks less than \fIgap\-size\fP bytes apart will be combined. Default: \fI0\fP\&.
.TP
.B \fB\-silent\fP
Don\(aqt print informational messages.
.TP
.B \fB\-split\fP
Split multi\-segment executables into one file per segment. The output
files will be called \fIblkNNNN.blk\fP, where \fINNNN\fP is the block number in
hexadecimal. These files are standard Atari executables, with \fI$FFFF\fP
headers.
.TP
.B \fB\-d\fP
Disassemble each block. The disassembler is very simple: single pass,
no attempt to recognize data blocks.
.UNINDENT
.SH EXIT STATUS
.sp
Zero for success, non\-zero for failure.
.SH COPYRIGHT
.sp
This utility is released under the GNU General Public License.
.SH AUTHORS
.sp
This utility was written by Jindrich Kubec, AKA Jindroush.
.sp
This page was written by B. Watson <\fI\%urchlay@slackware.uk\fP>.
.SH SEE ALSO
.sp
\fBacvt\fP(1),
\fBaext\fP(1),
\fBbas2boot\fP(1),
\fBchkbas\fP(1),
\fBchkexe\fP(1),
\fBchkrom\fP(1).
.\" Generated by docutils manpage writer.
.