-
Notifications
You must be signed in to change notification settings - Fork 3
/
README
195 lines (165 loc) · 7.32 KB
/
README
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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
Emutils V3.0 (C)2006-2024 Bo Zimmerman
Please read the LICENSE file for license information
Please read the NOTICE file for credits information
Emutil is a collection of utilities for dealing with files which are in
formats most commonly used by Commodore 64 emulators.
These formats include:
- *.D64 - 170k image of a normal formatted 5.25" Commodore 1541 disk
- 170k image of a C64 or C128 CP/M formatted 5.25" Commodore 1541 disk
- *.D71 - 340k image of a normal formatted 5.25" Commodore 1571 disk
- 340k image of a C128 CP/M formatted 5.25" Commodore 1571 disk
- *.D81 - 800k image of a normal formatted 3.5" Commodore 1581 disk
- 800k image of a C128 CP/M formatted 3.5" Commodore 1581 disk
- *.D80 - 520k image of a normal formatted 5.25" Commodore 8050 disk
- 520k image of a CPM-86 CP/M formatted 5.25" Commodore 1571 disk
- *.D82 - 1040k image of a normal formatted 5.25" Commodore 8250 or SFD-1001 disk
- 1040k image of a CPM-86 CP/M formatted 5.25" Commodore 1571 disk
- *.DNP - image of a normal formatted CMD (HD or RL) Native Partition, up to 16mb
- *.DHD - image of raw CMD FD/HD disk image with partition table
- *.LNX - file archiver image from the LYNX utility
- *.T64 - Digital tape image / file archive
The following utilities exist in this project:
D64Search (java)
----------------
A tool for searching the internal filenames and/or file data inside of common
Emulator image files (.D64, .D71, D80, .D81, .D82). This tool will report the
names ofimage files containing matches, and the names of the internal Commodore
files which were matched. Supports recursing directories of image files. It also
supports
Java version requires Java 1.6 or better.
To execute from the command line (and get further help):
java -jar bin/D64Search.jar
or
java com.planet_ink.emutil.D64Search
USAGE:
D64Search [options] [path] [expression]
OPTIONS:
-R recursive search
-V verbose
-M show MD5 sum for each matching file
-C case sensitive
-F full absolute paths
-Q suppress parse errors
-X expr fmt (-Xp=petscii, Xa=ascii, Xh=hex)
-I search inside files (substring search)
-D db export of disk info data (-Du[user],
-Dp[password], -Dc[java class],
-Ds[service] -Dt[tablename])
(Columns: string imagepath,
string filename, int filenum,
long size, string md5,
string filetype)
* Expressions include % and ? characters.
* Hex expressions include hex digits, *, and ?.
-----------------------------------------------------------------------------
D64Compare
-----------
A tool for comparing the file contents of two disk images with
each other, noting files that are in one image but not another,
and any files with different content. This tool supports CMD
HD subdirectories as well, and will recurse into them.
Java version requires Java 1.6 or better.
To execute from the command line (and get further help):
java -jar bin/D64Compare.jar
or
java com.planet_ink.emutil.D64Compare
USAGE:
D64Compare [file1] [file2]
-----------------------------------------------------------------------------
D64FileMatcher
--------------
USAGE:
D64FileMatcher [file/path1] [file/path2]
OPTIONS:
-R recursive search inside DNP
-A X approx matching min X% (slower)
-V verbose
-P X verbose on disks with X percent matches
-C use memory cache of all comparison files
-D X Recursive depth X
-Q Suppress parsing errors
-En X exclude files matching mask 'X' in path 'n'
-N No sorting of source filenames
-----------------------------------------------------------------------------
D64Mod
-----------
A tool for viewing, extracting from, or modifying the contents of an
image file.
Java version requires Java 1.6 or better.
To execute from the command line (and get further help):
java -jar bin/D64Mod.jar
or
java com.planet_ink.emutil.D64Mod
USAGE:
D64Mod [options] [image file] [action] [action arguments]
ACTIONS:
SCRATCH [file]/ALL
EXTRACT (-p) [file]/ALL [target path]
INSERT [source path] [file]
BAM CHECK
BAM ALLOC (Checks for sectors that need bam alloc)
BAM FREE (Checks for sectors that need bam free)
LIST/DIR [PATH]
LIST/DIR ALL
OPTIONS:
-r Recurse into subdirectories
-q suppress parsing errors
-p extract files with .prg/.seq extensions
-----------------------------------------------------------------------------
CMDHDParser
-----------
A tool for viewing the partition list and extracting or replacing
existing partitions/disk images in a raw CMD Hard Drive (HD) iso image,
such as might be created with the *NIX "dd" utility. This is not the
same as a DNP (native partition) image. A CMD HD image may contain
D64, D81, DNP, and other kinds of images inside it.
Java version requires Java 1.6 or better.
To execute from the command line (and get further help):
java -jar bin/CMDHDParser.jar
or
java com.planet_ink.emutil.CMDHDParser
USAGE:
CMDHDParser LIST [CMDHD_RAWIMAGE]
CMDHDParser EXTRACT [CMDHD_RAWIMAGE] [EXTRACT_PATH_OR_FILENAME] [CMDHD_PARTITION_NUMBER]
CMDHDParser EXTRACT [CMDHD_RAWIMAGE] [EXTRACT_PATH] ALL
CMDHDParser REPLACE [CMDHD_RAWIMAGE] [NEW_PART_IMAGE_FILE] [CMDHD_PARTITION_NUMBER]
CMDHDParser REPLACE [CMDHD_RAWIMAGE] [NEW_PART_IMAGES_PATH] ALL
-----------------------------------------------------------------------------
D64Duplifind
------------
A tool for comparing two sets of directories full of files, and reporting on non-duplicates.
Although not strictly for Commodore disk images, it does cater to them by restricting itself
to common disk image extensions. It will also automatically parse gzipped (.gz) and zipped (.zip)
files to find images.
Java version requires Java 1.6 or better.
To execute from the command line (and get further help):
java -jar bin/D64Duplifind.jar
or
java -cp ".;commons-compress-1.12.jar" com.planet_ink.emutil.D64Duplifind
or
java -cp ".;commons-compress-1.12.jar" com.planet_ink.emutil.D64Duplifind
USAGE:
D64Duplifind [options]
OPTIONS:
-R recursive search
-V verbose
-S matches1 matches2 mismatches1 mismatches2
-1 add to path1
-2 add to path2
-----------------------------------------------------------------------------
Emutil.prg (Commodore BASIC/ML)
-------------------------------
A disk image archiver for Commodore 64, 128, VIC-20, Plus/4, CBM-II, and CBM/PET
computers with 16k or more. It supports all known Commodore disk drives, of all
capacities. It also supports all CMD HD and RL Native partitions.
EMUTIL creates and dissolves single and multiple archive images. The images
may be RLE compressed or uncompressed. A single uncompressed archive image
of a 1541 disk is equivalent to a .D64 file, so it will handle those just
fine, though it is intended to cover disk drives unsupported by other
programs, such as the CBM 8050/8250 and CMD Native drives.
The program is a collaborative effort by Bo Zimmerman and Andre Fachat. After
building the source in CBM Prg Studio, you'll need to "fix" the binary by
changing the start address to $0401 for PETs, and then loading it and
re-saving it, to get all the line link addresses fixed. Next, you'll need
to fix the CBM-II BANK command in line 3450 with a hex editor. Change the
bytes in that line from $FE $02 to $20 $DC.