ckmame: mkmamedb(1)

NAME

mkmamedb - create database for use by ckmame

SYNOPSIS

mkmamedb [-hV] [-C hashtypes] [-o dbfile] [-x pat] [--detector file] [--exclude pat] [--hash-types types] [--help] [--output dbfile] [--prog-name name] [--prog-version version] [--version] [rominfo-file ...]

DESCRIPTION

mkmamedb converts ROM set descriptions from one format to another.

The ROM set description is read from the specified files (or directories) or the standard input if no files are specified. The default output file is mame.db. You can override it with the -o option or the MAMEDB environment variable.

Supported input formats are:

  • CMPro dat file
  • MAME xml file
  • Romcenter dat file
  • ckmame(1) database format
  • directory of zip archives
Supported output formats are:

The CMPro file format is described at http://www.logiqx.com/FAQs/CMPro.shtml, the DTD for MAME xml can be found in PREFIX/share/doc/ckmame/.

OPTIONS

mkmamedb supports the following options:

-C types -,-hash-types types
A comma separated list of hash types to compute when creating a ROM set description from a directory of zip archives. Supported hash types are: crc, md5, sha1.

--detector file
Use CMPro XML header skip detector description from file.

-h, -help
Display a short help message.

-o dbfile -,-output dbfile
Write to database dbfile instead of the default ``mame.db''.

--prog-name name
Set name of the program the ROM info is from.

--prog-version version
Set version of the program the ROM info is from.

-V, -version
Display program name and version number.

-x pat -,-exclude pat
Exclude games with names matching pat from the created database.

ENVIRONMENT

MAMEDB
Location for the database file. Can be overridden with the -o option. Defaults to ``mame.db''.

EXAMPLES

Get an input file for mkmamedb(1) from xmame(6) and convert it to the internal database format:
# xmame -listxml > db.txt
# mkmamedb db.txt

Alternatively, if you have xmame(6) installed and in your PATH, you can just run mkmamedb-xmame.sh.

SEE ALSO

ckmame(1), dumpgame(1)

AUTHORS

mkmamedb was written by Dieter Baron <dillo@giga.or.at> and Thomas Klausner <tk@giga.or.at>.