aboutsummaryrefslogtreecommitdiff
path: root/games/atari800/cart.6
blob: 9153c92eac30893707484abfb0da6fadad511e7c (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
.\" 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 "CART" 6 "2022-06-15" "5.0.0" "SlackBuilds.org"
.SH NAME
cart \- convert raw Atari 8-bit ROM images to Atari800 CART files.
.\" RST source for cart(1) man page. Convert with:
.
.\" rst2man.py cart.rst > cart.6
.
.\" rst2man.py comes from the SBo development/docutils package.
.
.SH SYNOPSIS
.sp
cart \fIromfile\fP \fIcartfile\fP \fIcarttype\fP
.sp
cart \fB\-l\fP
.sp
cart \fB\-p\fP \fIromfile\fP
.SH DESCRIPTION
.sp
\fBcart\fP creates an Atari800 CART image file from a raw Atari 8\-bit ROM
image file by adding a 16\-byte \fBCART\fP header.
.sp
The \fIromfile\fP is a file containing a raw Atari 8\-bit ROM image
dump. It must be of the correct size for the \fIcarttype\fP argument
(e.g. for type 1, "Standard 8KB cartridge", the file must be exactly
8192 bytes).
.sp
Output is written to \fIcartfile\fP\&. This must be a different filename
from \fIromfile\fP (in\-place conversion is not supported). \fIcartfile\fP will
be exactly 16 bytes longer than \fIromfile\fP (e.g. for type 1, it will be
8208 bytes).
.sp
The \fIcarttype\fP argument is numeric, one of the supported types. The
list can be viewed with \fBcart \-l\fP\&. If you\(aqre not sure of the correct
type for a given ROM, you can narrow it down by running \fBcart \-p\fP
\fIromfile\fP, which will show all the possible types that match the size
of the ROM.
.sp
There is no corresponding tool to convert a CART image back to a raw
ROM file, but this can be done with e.g. \fBdd\fP(1):
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
dd if=image.cart of=image.raw bs=1 skip=16
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
\&...or \fBhead\fP(1) and \fBcat\fP(1):
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
cat image.cart | ( head \-c16 >/dev/null ; cat ) > image.raw
.ft P
.fi
.UNINDENT
.UNINDENT
.SH OPTIONS
.INDENT 0.0
.TP
.B  \-l
Show the complete list of supported cartridge types.
.UNINDENT
.INDENT 0.0
.TP
.B \-p \fIromfile\fP
Show the list of cartridge types that match the size of \fIromfile\fP\&.
.UNINDENT
.SH COPYRIGHT
.sp
See the file /usr/doc/atari800\-5.0.0/COPYING for license information.
.SH AUTHORS
.sp
\fBcart\fP is part of the \fBatari800\fP(6) distribution. See
/usr/doc/atari800\-5.0.0/CREDITS for the list of authors.
.sp
This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.
.SH SEE ALSO
.sp
\fBatari800\fP(6)
.INDENT 0.0
.TP
.B Full documentation for the CART file format:
/usr/doc/atari800\-5.0.0/cart.txt
.TP
.B The \fBatari800\fP website:
\fI\%https://atari800.github.io/\fP
.UNINDENT
.\" Generated by docutils manpage writer.
.