aboutsummaryrefslogtreecommitdiff
path: root/xex1to2.1
blob: 89d1698f0feb9c071f0877e2203c8a31156ec48f (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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
.\" 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-07-02" "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
\fBa8cat\fP(1),
\fBa8eol\fP(1),
\fBa8xd\fP(1),
\fBatr2xfd\fP(1),
\fBatrsize\fP(1),
\fBaxe\fP(1),
\fBblob2c\fP(1),
\fBblob2xex\fP(1),
\fBcart2xex\fP(1),
\fBcxrefbas\fP(1),
\fBdasm2atasm\fP(1),
\fBdumpbas\fP(1),
\fBf2toxex\fP(1),
\fBfenders\fP(1),
\fBlistbas\fP(1),
\fBprotbas\fP(1),
\fBrenumbas\fP(1),
\fBrom2cart\fP(1),
\fBunmac65\fP(1),
\fBunprotbas\fP(1),
\fBvxrefbas\fP(1),
\fBxex1to2\fP(1),
\fBxexamine\fP(1),
\fBxexcat\fP(1),
\fBxexsplit\fP(1),
\fBxfd2atr\fP(1),
\fBxex\fP(5),
\fBatascii\fP(7).
.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.
.