ckmame — verify
MAME ROM sets
ckmame |
[-bCcdFfhjKkLlSsuVvwX]
[-D dbfile]
[-e dir]
[-O dbfile]
[-R dir]
[-T file]
[--autofixdat]
[--cleanup-extra]
[--correct] [--db
dbfile] [--delete-duplicate]
[--delete-found]
[--delete-long]
[--delete-unknown] [--fix]
[--fixdat file]
[--games-from file]
[--help] [--ignore-extra]
[--ignore-unknown]
[--keep-duplicate]
[--keep-found]
[--move-long]
[--move-unknown]
[--nobroken] [--nofixable]
[--nonogooddumps]
[--nosuperfluous]
[--nowarnings] [--old-db
dbfile] [--rom-dir
dir] [--roms-unzipped]
[--search dir]
[--stats] [--superfluous]
[--verbose] [--version]
[game ...] |
ckmame is a program to check ROM sets for
MAME, the Multiple Arcade Machine Emulator (see
http://www.mame.net/), or other emulators that
provide ROM set information in a compatible way (e.g., Raine, Impact, or
other emulators). This is the same format as clrmamepro dat files.
ckmame tells you which ROM files are missing or have
a wrong checksum, can delete unknown and unused files from the ROM sets, and
rename or move files.
MAME is an emulator for numerous arcade machines (video games,
ranging from the 1970s to today). Since MAME is emulating the games, it uses
the original images from the arcade machines' original ROM chips. MAME's
internal database contains extensive information on the ROMs, including the
sizes and checksums of the used ROMs. Since some arcade games are variants
of others and share some of the same ROMs, there are also internal
dependencies between these so called clones. To save space, ROMs can be
archived in zip files and dynamically unzipped by MAME when you play a game.
ckmame does only support ROM sets stored as zip
files.
ckmame tries to create a “split ROM
set” from your current collection. This means that all files needed
by the parent are kept in the parent's zip file, and only the files needed
by the clone (or child) that are different from the parent's are kept in the
child's zip file. For identifying the ROMs ckmame uses the sizes and
checksums; names are only used for verification, since the MAME team often
renames ROMs.
While ckmame uses MAME's ROM database, it
must be converted into a more efficient format before use. See
mkmamedb(1) for details.
By default, ckmame will check the games
named on the command line, or all games if none are given. Shell wildcards
are allowed. You can use command line options to select which type of errors
to report.
Supported options:
--autofixdat--fixdat, but automatically generates the
output file name from the datfile's name and version number:
“fix_$SYSTEM ($VERSION).dat”.-b,
--nobroken-f and
-w.--cleanup-extra-C,
--complete-only-c,
--correct-D
dbfile, --db
dbfile-d,
--nonogooddumps--delete-duplicate--keep-duplicate.-e
dir, --search
dir-j.-F,
--fix-f,
--nofixable-b and
-w.--fixdat
name-h,
--help--ignore-unknown-j,
--delete-found-e, delete files that are copied to the
ROM set. See also --keep-found.--keep-duplicate--delete-duplicate.--keep-found-e, do not remove files that are copied
to the ROM set (default). See also -j.-K,
--move-unknown-k.-k,
--delete-unknown-K.-L,
--move-long-K and -l.-l,
--delete-long-L.-O
dbfile, --old-db
dbfile-R
dir, --rom-dir
dir--stats--superfluous-s,
--nosuperfluous-T
file, --games-from
file-u,
--roms-unzipped-V,
--version-v,
--verbose-F.-w,
--nowarnings-b and -f.-X,
--ignore-extrackmame creates a
roms/garbage directory (see also
-K), which you will also be warned about.MAMEDB-D option. Defaults to
“mame.db”.MAMEDB_OLD-O option. Defaults to
“old.db”.Unknown files are moved to the sub-directory unknown. Files that will be needed by other games in the ROM set are moved to the needed directory.
In unzipped mode (-u),
ckmame creates .ckmame.db
files in the rom directory as well as the directories given with
-e. These files are databases containing file names,
sizes, and their hashes. The database information used when the file hasn't
changed since the last run (i.e. same size and modification time).
Print a report about the current state of your ROM sets in the roms subdir of the current dir:
ckmameFix all sets and only report unfixable errors, omitting those ROMs where no good dump exists:
ckmame
-FwdFix all sets using the files found in updatedir, removing files from there that are copied to the ROM set:
ckmame -Fj -e
updatedirMost messages should be straightforward. Two need special explanations:
If a file is marked as “broken”, it means that the computed checksum is not the same as the checksum stored in the zip archive, usually because there has been a decompression error.
If a ROM or disk is marked with “checksum mismatch”, the primary checksum matches, but one of the other checksums does not. The primary checksum for ROMs is CRC32, for disks MD5.
ckmame was written by
Dieter Baron ⟨dillo@nih.at⟩ and
Thomas Klausner ⟨tk@giga.or.at⟩.