CHDMAN(1)

NAME
chdman - MAME Compressed Hunks of Data (CHD) manager

SYNOPSIS
chdman option

DESCRIPTION
chdman is the (C)ompressed (H)unks of (D)ata (CHD) manager for MAME. It is a tool to manage CHD images.

OPTIONS
Please note that each option allows a set of switches, the meaning of each is explained in the SWITCHES section below. Whenever the short form for the switch is listed, the long one may be used instead.

help [option]
    Print a summary of the available options or, if option is given, a detailed list of the valid switches for the option.

info -i filename [-v]
    Dump the header information from a drive image.

verify -i filename [-ip filename]
    Validate the MD5/SHA1 on a drive image.

createraw -o filename [-op filename] [-f] -i filename [-isb offset] [-ish offset] [-ib length] [-ih length] -hs bytes -us bytes [-c none|type1[,[...]]] [-np processors]
    Create a new compressed raw image from a raw file.

createhd -o filename [-op filename] [-f] [-i filename] [-isb offset] [-ish offset] [-ib length] [-ih length] [-hs bytes] [-c none|type1[,[...]]] [-chs cylinders,heads,sectors] [-ss bytes] [-np processors]
    Create a new compressed hard disk image from a raw file.

createcd -o filename [-op filename] [-f] -i filename [-hs bytes] [-c none|type1[,[...]]] [-np processors]
    Create a new compressed CD image from a raw file.

createld -o filename [-op filename] [-f] -i filename [-isf offset] [-if length] [-hs bytes] [-c none|type1[,[...]]] [-np processors]
    Create a new compressed laserdisc image from a raw file.

extractraw -o filename [-f] -i filename [-ip filename] [-isb offset] [-ish offset] [-ib length] [-ih length]
    Extract a raw file from a CHD image.

extracthd -o filename [-f] -i filename [-ip filename] [-isb offset] [-ish offset] [-ib length] [-ih length]
    Extract a hard disk block image from a CHD image.

extractcd -o filename [-ob filename] [-f] -i filename [-ip filename]
    Extract a CDRDAO .toc/.bin, CDRWIN .bin/.cue, or Sega Dreamcast .GDI file from a CHD-CD image.

extractld -o filename [-f] -i filename [-ip filename] [-isf offset] [-if length]
    Extract a laserdisc image from a CHD-LD image.

copy -o filename [-op filename] [-f] -i filename [-ip filename] [-isb offset] [-ish offset] [-ib length] [-ih length] -hs bytes [-c none|type1[,[...]]] [-np processors]
    Copy all hunks of data from one CHD file to another. The hunk sizes do not need to match. If the source is shorter than the destination, the source data will be padded with 0s.

addmeta -i filename -t tag [-ix index] [-vt text] [-vf filename] [-nocs]
    Add metadata to the chd.

delmeta -i filename -t tag [-ix index]
    Remove metadata from the chd.

dumpmeta -i filename [-o filename] [-f] -t tag [-ix index]
    Dump metadata from the chd to standard output or to a file.

SWITCHES

--chs, -chs cylinders,heads,sectors
    Specifies CHS geometry values for CHD harddisks.

--compression, -c none|type1[,[...]]
    Which compression codecs to use (up to 4).

--force, -f
    Force overwriting an existing file.

--hunksize, -hs bytes
    Size of each unit, in hunks.

--ident, -id filename
    Name of ident file to provide CHS information.

--index, -ix index
    Indexed instance of the metadata tag.

--input, -i filename
    Input file name.

--inputbytes, -ib length
    Effective length of the input in bytes.

--inputframes, -if length
    Effective length of the input in frames.

--inputhunks, -ih length
    Effective length of the input in hunks.

--inputparent, -ip filename
    Parent CHD's input file name.

--inputstartbyte, -isb offset
    Starting byte offset within the input.

--inputstartframe, -isf offset
    Starting frame offset within the input.

--inputstarthunk, -ish offset
    Starting hunk offset within the input.

--nochecksum, -nocs
    Do not include this metadata information in the overall SHA-1.

--numprocessors, -np count
    Limits the number of processors to use during compression.

--output, -o filename
    Output file name.

--outputbin, -ob filename
    Output binary file name for extractcd.

--outputparent, -op filename
    Parent CHD's output file name.

--sectorsize, -ss bytes
    Size of each hard disk sector.

--tag, -t tag
    4-character tag for metadata.

--valuefile, -vf filename
    Text file containing data to add.

--valuetext, -vt text
    Text for the metadata.

--unitsize, -us bytes
    Size of each unit, in bytes.

--verbose, -v
    Output additional information about the operation.

SEE ALSO
mame(6), mess(6)