aboutsummaryrefslogtreecommitdiff
path: root/ksiders/makeatr.1
blob: 79248e2f4c2bd78f18ccf8e42cfc62d997b015c9 (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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
.\" 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 "MAKEATR" 1 "2024-05-10" "0.9.0" "Ken Siders' Atari 8-bit Tools"
.SH NAME
makeatr \- convert an Atari executable to a "K-file" bootable disk
.SH SYNOPSIS
.sp
makeatr \fIimagefile.atr\fP \fIatari\-executable\fP
.SH DESCRIPTION
.sp
For various reasons, it\(aqs sometimes useful to make a bootable disk
image of an Atari executable. \fBmakeatr\fP does exactly that.
.sp
If you have a bootable image made with \fBmakeatr\fP, but you\(aqve lost
the original executable, you can extract it from the image with
\fBunmakatr\fP(1).
.SH NOTES
.sp
\fBmakeatr\fP is only useful for single\-file games or other programs
that don\(aqt need DOS disk access to run: the bootable image
won\(aqt contain any DOS at all, or even a DOS file  structure
(you can\(aqt read the directory).
.sp
Disks made with \fBmakeatr\fP are recognizable when booted on the Atari,
because they display a GRAPHICS 0 screen with a lowercase k (screen
is otherwise blank).
.sp
Disk images made with \fBmakeatr\fP are only created with enough sectors
to hold the executable. AtariSIO can handle these images fine, as can
most other ATR utilities, but the smaller\-than\-regulation size may
cause problems with some utilities.
.sp
There is only one Atari executable format, regardless of filename
extension. All .XEX, .COM, .BIN, .EXE, etc. files for the Atari are
the same file type, regardless of the name, and regardless of what
you may have read on some forum site. Atari DOS doesn\(aqt care about
the filename; it only exists for human consumption (and for filetype
association with emulators, these days).
.SH DIAGNOSTICS
.sp
\fBmakeatr\fP\(aqs error messages are not well documented. They consist only
of an internal error number code, listed here:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B 1
Unable to open ATR image for writing
.TP
.B 2
Unable to write image ATR header
.TP
.B 6
Unable to write boot sectors to ATR image
.TP
.B 7
Error while padding ATR image to an even sector size
.TP
.B 11
Unable to stat the input file (not found, permission denied, etc)
.TP
.B 12
Input file is 0 bytes in length
.TP
.B 13
Can\(aqt open input file
.TP
.B 19
Error writing to ATR image, or trailing junk in the input image
.TP
.B 20
Input file is not an Atari executable (missing 0xFF 0xFF signature)
.UNINDENT
.UNINDENT
.UNINDENT
.sp
Error messages are printed to standard output, not standard error output.
.SH EXIT STATUS
.sp
Exit status is 0 for success, or non\-zero status for failure.
.SH COPYRIGHT
.sp
Copyright 1997, Ken Siders.
.SH AUTHOR
.sp
Ken Siders was the original author of this utility.
.sp
Man page and Linux port done by B. Watson <\fI\%urchlay@slackware.uk\fP>;
Urchlay on irc.libera.chat \fI##atari\fP\&.
.SH SEE ALSO
.sp
\fBatrdir\fP(1),
\fBatrextr\fP(1),
\fBmakeatr\fP(1),
\fBsortatr\fP(1).
.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.
.