xex1to2: added.

4 files changed, 207 insertions, 2 deletions

diff --git a/Makefile b/Makefile
index 19bb1a0..76d7361 100644
--- a/Makefile
+++ b/Makefile
@@ -15,9 +15,9 @@ CC=gcc
 CFLAGS=-Wall $(COPT) -ansi -D_GNU_SOURCE -DVERSION=\"$(VERSION)\"
 
 # BINS and SCRIPTS go in $BINDIR, DOCS go in $DOCDIR
-BINS=a8eol xfd2atr atr2xfd blob2c cart2xex fenders xexsplit xexcat atrsize rom2cart unmac65 axe blob2xex xexamine
+BINS=a8eol xfd2atr atr2xfd blob2c cart2xex fenders xexsplit xexcat atrsize rom2cart unmac65 axe blob2xex xexamine xex1to2
 SCRIPTS=dasm2atasm a8utf8
-MANS=a8eol.1 xfd2atr.1 atr2xfd.1 blob2c.1 cart2xex.1 fenders.1 xexsplit.1 xexcat.1 atrsize.1 rom2cart.1 unmac65.1 axe.1 dasm2atasm.1 a8utf8.1 blob2xex.1 xexamine.1
+MANS=a8eol.1 xfd2atr.1 atr2xfd.1 blob2c.1 cart2xex.1 fenders.1 xexsplit.1 xexcat.1 atrsize.1 rom2cart.1 unmac65.1 axe.1 dasm2atasm.1 a8utf8.1 blob2xex.1 xexamine.1 xex1to2.1
 MAN5S=xex.5
 DOCS=README equates.inc *.dasm
 
diff --git a/xex1to2.1 b/xex1to2.1
new file mode 100644
index 0000000..96b2c37
--- /dev/null
+++ b/xex1to2.1
@@ -0,0 +1,97 @@
+.\" 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 "XEX1TO2" 1 "2024-04-29" "0.2.1" "Urchlay's Atari 8-bit Tools"
+.SH NAME
+xex1to2 \- Convert an Atari DOS 1.0 executable to a standard Atari executable
+.\" RST source for xex1to2(1) man page. Convert with:
+.
+.\" rst2man.py xex1to2.rst > xex1to2.1
+.
+.SH SYNOPSIS
+.sp
+xex1to2 [\fIinfile\fP] [\fIoutfile\fP]
+.SH DESCRIPTION
+.sp
+\fBxex1to2\fP 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.
+.sp
+DOS 1.0\(aqs executable format is segmented, like the XEX format,
+but the signature bytes are \fB$84\fP, \fB$09\fP rather than \fB$FF\fP,
+\fB$FF\fP\&. Also, the signature bytes can \fIonly\fP occur for the first
+segment (the start of the file). Further segments just have a 4\-byte
+header with the start and end addresses.
+.sp
+All this utility really does is copy \fIinfile\fP to \fIoutfile\fP, replacing
+the first two bytes (which must be \fB$84\fP, \fB$09\fP) with \fB$FF\fP,
+\fB$FF\fP\&.
+.sp
+If \fIoutfile\fP is omitted, output is written to \fBstdout\fP\&. If \fIinfile\fP
+is also omitted, input is read from \fBstdin\fP\&. \fBxex1to2\fP will not
+write to \fBstdout\fP if it\(aqs a terminal.
+.sp
+To convert the other way, from a DOS 2.0 compatible XEX file to a DOS
+1.0 executable, use \fBxexcat \-1\fP\&.
+.SH EXIT STATUS
+.sp
+Exit status is zero for success, non\-zero for failure.
+.SH COPYRIGHT
+.sp
+WTFPL. See \fI\%http://www.wtfpl.net/txt/copying/\fP for details.
+.SH AUTHOR
+.INDENT 0.0
+.IP B. 3
+Watson <\fI\%urchlay@slackware.uk\fP>; Urchlay on irc.libera.chat \fI##atari\fP\&.
+.UNINDENT
+.SH SEE ALSO
+.sp
+\fBa8eol\fP(1),
+\fBa8utf8\fP(1),
+\fBatr2xfd\fP(1),
+\fBatrsize\fP(1),
+\fBaxe\fP(1),
+\fBblob2c\fP(1),
+\fBblob2xex\fP(1),
+\fBcart2xex\fP(1),
+\fBdasm2atasm\fP(1),
+\fBf2toxex\fP(1),
+\fBfenders\fP(1),
+\fBrom2cart\fP(1),
+\fBunmac65\fP(1),
+\fBxexamine\fP(1),
+\fBxexcat\fP(1),
+\fBxexsplit\fP(1),
+\fBxfd2atr\fP(1),
+\fBxex\fP(5).
+.sp
+Any good Atari 8\-bit book: \fIDe Re Atari\fP, \fIThe Atari BASIC  Reference
+Manual\fP,  the  \fIOS Users\(aq Guide\fP, \fIMapping the Atari\fP, etc.
+.\" Generated by docutils manpage writer.
+.
diff --git a/xex1to2.c b/xex1to2.c
new file mode 100644
index 0000000..36a33a2
--- /dev/null
+++ b/xex1to2.c
@@ -0,0 +1,60 @@
+#include <stdio.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <errno.h>
+#include <string.h>
+
+#define SELF "xex1to2"
+
+FILE *open_file(const char *name, const char *mode) {
+	FILE *f = fopen(name, mode);
+	if(f) return f;
+
+	fprintf(stderr, SELF ": %s: %s\n", name, strerror(errno));
+	exit(1);
+}
+
+void invalid(void) {
+	fprintf(stderr, SELF ": input is not a valid Atari DOS 1.0 executable.\n");
+	exit(1);
+}
+
+void read_header(FILE *in) {
+	int c;
+
+	c = getc(in);
+	if(c < 0 || c != 0x84) invalid();
+	c = getc(in);
+	if(c < 0 || c != 0x09) invalid();
+}
+
+int main(int argc, char **argv) {
+	int c;
+	FILE *in = stdin, *out = stdout;
+
+	if(argc > 3) {
+		fprintf(stderr, "Usage: " SELF " [dos1_input.xex] [dos2_output.xex]\n");
+		exit(1);
+	}
+
+	if(argc > 1) in  = open_file(argv[1], "rb");
+	if(argc > 2) out = open_file(argv[2], "wb");
+
+	if(isatty(fileno(out))) {
+		fprintf(stderr,
+				SELF ": Standard output is a terminal; not writing binary data\n");
+		exit(1);
+	}
+
+	read_header(in);
+	fputc(0xff, out);
+	fputc(0xff, out);
+
+	while( (c = fgetc(in)) >= 0 )
+		fputc(c, out);
+
+	fclose(in);
+	fclose(out);
+
+	return 0;
+}
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