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)