1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
|
.. _chdman:
chdman – CHD (Compressed Hunks of Data) File Manager
====================================================
chdman can be used to create, convert, check the integrity of and extract data
from media images in CHD (Compressed Hunks of Data) format.
The basic usage is ``chdman <command> <option>...``
.. contents:: :local:
.. _chdman-commonopts:
Common options
--------------
The options available depend on the command, but the following options are
used by multiple commands:
--input <file> / -i <file>
Specify the input file. This option is required for most commands. The
input file formats supported depend on the command
--inputparent <chdfile> / -ip <chdfile>
Specify the parent CHD file for the input file. This option is supported for
most commands that operate on CHD format input files. This option must be
used if the input file is a *delta CHD*, storing only the hunks that differ
from its parent CHD,
--output <file> / -o <file>
Specify the output file name. This option is required for commands that
produce output files. The output file formats supported depend on the
command.
--outputparent <chdfile> / -op <chdfile>
Specify the parent CHD file for the output file. This option is supported
for commands that produce CHD format output files. Using this option
produces a *delta CHD*, storing only the hunks that differ from its parent
CHD. The parent CHD should be the same media type and size, with the same
hunk size.
--compression none|<type>[,<type>]... / -c none|<type>[,<type>]...
Specify compression algorithms to use. This option is supported for commands
that produce CHD format output files. Specify ``none`` to disable
compression, or specify up to four comma-separated compression algorithms.
See :ref:`compression algorithms <chdman-compression>` for supported
compression algorithms. Compression must be disable to create writable media
image files.
--hunksize <bytes> / -hs <bytes>
Specifies the hunk size in bytes. This option is supported for commands that
produce CHD format output files. The hunk size must be no smaller than
16 bytes and no larger than 1048576 bytes (1 MiB). The hunk size must be a
multiple of the sector size or unit size of the media. Larger hunk sizes may
give better compression ratios, but reduce performance for small random
reads as an entire hunk needs to be read and decompressed at a time.
--force / -f
Overwrite output files if they already exist. This option is supported for
commands that produce output files.
--verbose / -v
Enable verbose output. This prints more detailed information for some
commands.
--numprocessors <count> / -np <count>
Limit the maximum number of concurrent threads used for data compression.
This option is supported for commands that produce CHD format output files.
.. _chdman-commands:
Commands
--------
info
~~~~
Display information about a CHD format file. Information includes:
* CHD format version and compression algorithms used.
* Compressed and uncompressed sizes and overall compression ratio.
* Hunk size, unit size and number of hunks in the file.
* SHA1 digests of the data and metadata.
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
* ``--verbose`` / ``-v``
verify
~~~~~~
Verify the integrity of a CHD format file. The input file must be a read-only
CHD format file (the integrity of writable CHD files cannot be verified).
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
* ``--inputparent <chdfile>`` / ``-ip <chdfile>``
createraw
~~~~~~~~~
Create a CHD format file from a raw media image.
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
* ``--output <file>`` / ``-o <file>`` (required)
* ``--outputparent <chdfile>`` / ``-op <chdfile>``
* ``--compression none|<type>[,<type>]...`` / ``-c none|<type>[,<type>]...``
* ``--hunksize <bytes>`` / ``-hs <bytes>`` (required)
* ``--force`` / ``-f``
* ``--numprocessors <count>`` / ``-np <count>``
Additional options:
* ``--unitsize <bytes>`` / ``-us <bytes>`` (required)
* ``--inputstartbyte <offset>`` / ``-isb <offset>``
* ``--inputstarthunk <offset>`` / ``-ish <offset>``
* ``--inputbytes <length>`` / ``-ib <length>``
* ``--inputhunks <length>`` / ``-ih <length>``
If the ``--compression`` or ``-c`` option is not supplied, it defaults to
``lzma,zlib,huff,flac``.
createhd
~~~~~~~~
Create a CHD format hard disk image file.
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
* ``--output <file>`` / ``-o <file>`` (required)
* ``--outputparent <chdfile>`` / ``-op <chdfile>``
* ``--compression none|<type>[,<type>]...`` / ``-c none|<type>[,<type>]...``
* ``--hunksize <bytes>`` / ``-hs <bytes>`` (required)
* ``--force`` / ``-f``
* ``--numprocessors <count>`` / ``-np <count>``
Additional options:
* ``--sectorsize <bytes>`` / ``-ss <bytes>``
* ``--size <bytes>`` / ``-s <bytes>``
* ``--chs <cylinders>,<heads>,<sectors>`` / ``-chs <cylinders>,<heads>,<sectors>``
* ``--template <template>`` / ``-tp <template>``
* ``--inputstartbyte <offset>`` / ``-isb <offset>``
* ``--inputstarthunk <offset>`` / ``-ish <offset>``
* ``--inputbytes <length>`` / ``-ib <length>``
* ``--inputhunks <length>`` / ``-ih <length>``
If the ``--compression`` or ``-c`` option is not supplied, it defaults to
``lzma,zlib,huff,flac``.
createcd
~~~~~~~~
Create a CHD format CD-ROM image file.
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
* ``--output <file>`` / ``-o <file>`` (required)
* ``--outputparent <chdfile>`` / ``-op <chdfile>``
* ``--compression none|<type>[,<type>]...`` / ``-c none|<type>[,<type>]...``
* ``--hunksize <bytes>`` / ``-hs <bytes>`` (required)
* ``--force`` / ``-f``
* ``--numprocessors <count>`` / ``-np <count>``
If the ``--compression`` or ``-c`` option is not supplied, it defaults to
``cdlz,cdzl,cdfl``.
createdvd
~~~~~~~~~
Create a CHD format DVD-ROM image file.
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
* ``--output <file>`` / ``-o <file>`` (required)
* ``--outputparent <chdfile>`` / ``-op <chdfile>``
* ``--compression none|<type>[,<type>]...`` / ``-c none|<type>[,<type>]...``
* ``--hunksize <bytes>`` / ``-hs <bytes>`` (required)
* ``--force`` / ``-f``
* ``--numprocessors <count>`` / ``-np <count>``
If the ``--compression`` or ``-c`` option is not supplied, it defaults to
``lzma,zlib,huff,flac``.
createld
~~~~~~~~
Create a CHD format LaserDisc image file.
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
* ``--output <file>`` / ``-o <file>`` (required)
* ``--outputparent <chdfile>`` / ``-op <chdfile>``
* ``--compression none|<type>[,<type>]...`` / ``-c none|<type>[,<type>]...``
* ``--hunksize <bytes>`` / ``-hs <bytes>`` (required)
* ``--force`` / ``-f``
* ``--numprocessors <count>`` / ``-np <count>``
Additional options:
* ``--inputstartframe <offset>`` / ``-isf <offset>``
* ``--inputframes <length>`` / ``-if <length>``
If the ``--compression`` or ``-c`` option is not supplied, it defaults to
``avhu``.
extractraw
~~~~~~~~~~
Extract data from a CHD format raw media image.
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
* ``--inputparent <chdfile>`` / ``-ip <chdfile>``
* ``--output <file>`` / ``-o <file>`` (required)
* ``--force`` / ``-f``
Additional options:
* ``--inputstartbyte <offset>`` / ``-isb <offset>``
* ``--inputstarthunk <offset>`` / ``-ish <offset>``
* ``--inputbytes <length>`` / ``-ib <length>``
* ``--inputhunks <length>`` / ``-ih <length>``
extracthd
~~~~~~~~~
Extract data from a CHD format hard disk image.
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
* ``--inputparent <chdfile>`` / ``-ip <chdfile>``
* ``--output <file>`` / ``-o <file>`` (required)
* ``--force`` / ``-f``
Additional options:
* ``--inputstartbyte <offset>`` / ``-isb <offset>``
* ``--inputstarthunk <offset>`` / ``-ish <offset>``
* ``--inputbytes <length>`` / ``-ib <length>``
* ``--inputhunks <length>`` / ``-ih <length>``
extractcd
~~~~~~~~~
Extract data from a CHD format CD-ROM image.
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
* ``--inputparent <chdfile>`` / ``-ip <chdfile>``
* ``--output <file>`` / ``-o <file>`` (required)
* ``--force`` / ``-f``
Additional options:
* ``--outputbin <file>`` / ``-ob <file>``
extractdvd
~~~~~~~~~~
Extract data from a CHD format DVD-ROM image.
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
* ``--inputparent <chdfile>`` / ``-ip <chdfile>``
* ``--output <file>`` / ``-o <file>`` (required)
* ``--force`` / ``-f``
extractld
~~~~~~~~~
Extract data from a CHD format DVD-ROM image.
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
* ``--inputparent <chdfile>`` / ``-ip <chdfile>``
* ``--output <file>`` / ``-o <file>`` (required)
* ``--force`` / ``-f``
Additional options:
* ``--inputstartframe <offset>`` / ``-isf <offset>``
* ``--inputframes <length>`` / ``-if <length>``
addmeta
~~~~~~~
Add a metadata item to a CHD format file. Note that this command modifies its
input file.
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
Additional options:
* ``--tag <tag>`` / ``-t <tag>`` (required)
* ``--index <index>`` / ``-ix <index>``
* ``--valuetext <text>`` / ``-vt <text>``
* ``--valuefile <file>`` / ``-vf <file>``
* ``--nochecksum`` / ``-nocs``
delmeta
~~~~~~~
Delete a metadata item from a CHD format file. Note that this command modifies
its input file.
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
Additional options:
* ``--tag <tag>`` / ``-t <tag>`` (required)
* ``--index <index>`` / ``-ix <index>``
dumpmeta
~~~~~~~~
Extract metadata items from a CHD format file to the standard output or to a
file.
Common options supported:
* ``--input <file>`` / ``-i <file>`` (required)
* ``--output <file>`` / ``-o <file>``
* ``--force`` / ``-f``
Additional options:
* ``--tag <tag>`` / ``-t <tag>`` (required)
* ``--index <index>`` / ``-ix <index>``
listtemplates
~~~~~~~~~~~~~
List available hard disk templates. This command does not accept any options.
.. _chdman-compression:
Compression algorithms
----------------------
The following compression algorithms are supported:
zlib – zlib deflate
Compresses data using the zlib deflate algorithm.
zstd – Zstandard
Compresses data using the Zstandard algorithm. This gives very good
compression and decompression performance with better compression ratios than
zlib deflate, but older software may not support CHD files that use Zstandard
compression.
lzma – Lempel-Ziv-Markov chain algorithm
Compresses data using the Lempel-Ziv-Markov-chain algorithm (LZMA). This
gives high compression ratios at the cost of poor compression and
decompression performance.
huff – Huffman coding
Compresses data using 8-bit Huffman entropy coding.
flac – Free Lossless Audio Codec
Compresses data as two-channel (stereo) 16-bit 44.1 kHz PCM audio using the
Free Lossless Audio Codec (FLAC). This gives good compression ratios if the
media contains 16-bit PCM audio data.
cdzl – zlib deflate for CD-ROM data
Compresses audio data and subchannel data from CD-ROM sectors separately
using the zlib deflate algorithm.
cdzs – Zstandard for CD-ROM data
Compresses audio data and subchannel data from CD-ROM sectors separately
using the Zstandard algorithm. This gives very good compression and
decompression performance with better compression ratios than zlib deflate,
but older software may not support CHD files that use Zstandard compression.
cdlz - Lempel-Ziv-Markov chain algorithm/zlib deflate for CD-ROM data
Compresses audio data and subchannel data from CD-ROM sectors separately
using the Lempel-Ziv-Markov chain algorithm (LZMA) for audio data and the
zlib deflate algorithm for subchannel data. This gives high compression
ratios at the cost of poor compression and decompression performance.
cdfl – Free Lossless Audio Codec/zlib deflate for CD-ROM data
Compresses audio data and subchannel data from CD-ROM sectors separately
using the Free Lossless Audio Codec (FLAC) for audio data and the zlib
deflate algorithm for subchannel data. This gives good compression ratios
for audio CD tracks.
avhu – Huffman coding for audio-visual data
This is a specialised compression algorithm for audio-visual (A/V) data. It
should only be used for LaserDisc CHD files.
|