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 fileiname [-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)