aboutsummaryrefslogtreecommitdiff
path: root/jindroush/man/chkexe.rst
diff options
context:
space:
mode:
Diffstat (limited to 'jindroush/man/chkexe.rst')
-rw-r--r--jindroush/man/chkexe.rst55
1 files changed, 55 insertions, 0 deletions
diff --git a/jindroush/man/chkexe.rst b/jindroush/man/chkexe.rst
new file mode 100644
index 0000000..91c65ab
--- /dev/null
+++ b/jindroush/man/chkexe.rst
@@ -0,0 +1,55 @@
+.. |version| replace:: 2.62
+
+======
+chkexe
+======
+
+------------------------------------------------
+check and/or disassemble Atari 8-bit executables
+------------------------------------------------
+
+.. include:: manhdr.rst
+
+SYNOPSIS
+========
+
+chkexe [**-gaps** *gap-size*] [**-silent**] [**-split**] [**-d**] **xex-file** [**output-file**]
+
+DESCRIPTION
+===========
+
+**chkexe** 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.
+
+If no **output-file** is given, **chkexe** simply prints the results of
+its analysis. With an **output-file**, 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 **-gaps**
+option can be used to control the threshold for combining blocks.
+
+OPTIONS
+=======
+
+**-gaps** *gap-size*
+ Blocks less than *gap-size* bytes apart will be combined. Default: *0*.
+
+**-silent**
+ Don't print informational messages.
+
+**-split**
+ Split multi-segment executables into one file per segment. The output
+ files will be called *blkNNNN.blk*, where *NNNN* is the block number in
+ hexadecimal. These files are standard Atari executables, with *$FFFF*
+ headers.
+
+**-d**
+ Disassemble each block. The disassembler is very simple: single pass,
+ no attempt to recognize data blocks.
+
+EXIT STATUS
+===========
+
+Zero for success, non-zero for failure.
+
+.. include:: manftr.rst