diff options
Diffstat (limited to 'xex1to2.rst')
-rw-r--r-- | xex1to2.rst | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/xex1to2.rst b/xex1to2.rst new file mode 100644 index 0000000..44464f8 --- /dev/null +++ b/xex1to2.rst @@ -0,0 +1,48 @@ +.. RST source for xex1to2(1) man page. Convert with: +.. rst2man.py xex1to2.rst > xex1to2.1 + +======= +xex1to2 +======= + +------------------------------------------------------------------ +Convert an Atari DOS 1.0 executable to a standard Atari executable +------------------------------------------------------------------ + +.. include:: manhdr.rst + +SYNOPSIS +======== + +xex1to2 [*infile*] [*outfile*] + +DESCRIPTION +=========== + +**xex1to2** reads a binary load file created by Atari DOS 1.0 and +converts it to a standard Atari executable, as used by Atari DOS 2.0S +and all other Atari DOSes. + +DOS 1.0's executable format is segmented, like the XEX format, +but the signature bytes are **$84**, **$09** rather than **$FF**, +**$FF**. Also, the signature bytes can *only* occur for the first +segment (the start of the file). Further segments just have a 4-byte +header with the start and end addresses. + +All this utility really does is copy *infile* to *outfile*, replacing +the first two bytes (which must be **$84**, **$09**) with **$FF**, +**$FF**. + +If *outfile* is omitted, output is written to **stdout**. If *infile* +is also omitted, input is read from **stdin**. **xex1to2** will not +write to **stdout** if it's a terminal. + +To convert the other way, from a DOS 2.0 compatible XEX file to a DOS +1.0 executable, use **xexcat -1**. + +EXIT STATUS +=========== + +Exit status is zero for success, non-zero for failure. + +.. include:: manftr.rst |