1PYCDLIB-GENISOIMAGE(1) General Commands Manual PYCDLIB-GENISOIMAGE(1)
2
3
4
6 pycdlib-genisoimage - tool to master ISOs using pycdlib
7
8
10 pycdlib-genisoimage [options] [-o filename] pathspec [pathspec ...]
11
12
14 pycdlib-genisoimage is a pre-mastering program to generate
15 ISO9660/Joliet/HFS hybrid filesystems. It is meant to be 100% flag-
16 compatible with the original genisoimage program so that it can be
17 dropped into existing scripts with no changes. Please see the man page
18 for genisoimage for more detailed explanation of the options to this
19 program. There are a few differences to note between this program and
20 the original genisoimage. First, not all of the options are imple‐
21 mented in this program. This means that pycdlib-genisoimage will
22 silently ignore some flags; for the most common usage of this program,
23 this will not matter. However, if you are trying to do something odd
24 and specific, it may not work. The flags that this applies to are
25 noted in the OPTIONS below. In some cases these flags can be imple‐
26 mented with a bit of work, and in some cases the flags can never be im‐
27 plemented due to the design of pycdlib. If in doubt, please ask on
28 https://github.com/clalancette/pycdlib/issues. Second, pycdlib-
29 genisoimage does not output all of the same messages to standard
30 out/standard error that genisoimage does. Any program that relies on
31 parsing the output of genisoimage will probably not work. Third, py‐
32 cdlib-genisoimage will not always generate ISOs that are 100% the same
33 as the genisoimage counterparts. This is for a variety of reasons,
34 ranging from bug fixing to simple differences in implementations. In
35 almost all cases this does not matter, but please keep it in mind when
36 using this program instead of genisoimage.
37
38
40 -abstract file
41 Specifies the abstract filename. There is space for 37 charac‐
42 ters.
43
44 -A application_id
45
46 -appid application_id
47 Specifies a text string that will be written into the volume
48 header. This should describe the application that will be on
49 the disc. There is space for 128 characters.
50
51 -allow-limited-size
52 (not supported by pycdlib-genisoimage) When processing files
53 larger than 2GiB which cannot be easily represented in ISO9660,
54 add them with a shrunk visible file size to ISO9660 and with the
55 correct visible file size to the UDF system. The result is an
56 inconsistent filesystem and users need to make sure that they
57 really use UDF rather than ISO9660 driver to read a such disk.
58 Implies enabling -udf.
59
60 -allow-leading-dots
61
62 -ldots (not supported by pycdlib-genisoimage) Allow ISO9660 filenames
63 to begin with a period. Usually, a leading dot is replaced with
64 an underscore in order to maintain MS-DOS compatibility.
65 This violates the ISO9660 standard, but it happens to work on
66 many systems. Use with caution.
67
68 -allow-lowercase
69 (not supported by pycdlib-genisoimage) This options allows low‐
70 ercase characters to appear in ISO9660 filenames.
71 This violates the ISO9660 standard, but it happens to work on
72 some systems. Use with caution.
73
74 -allow-multidot
75 (not supported by pycdlib-genisoimage) This options allows more
76 than one dot to appear in ISO9660 filenames. A leading dot is
77 not affected by this option, it may be allowed separately using
78 -allow-leading-dots.
79 This violates the ISO9660 standard, but it happens to work on
80 many systems. Use with caution.
81
82 -biblio file
83 Specifies the bibliographic filename. There is space for 37
84 characters.
85
86 -cache-inodes
87
88 -no-cache-inodes
89 (not supported by pycdlib-genisoimage) Enable or disable caching
90 inode and device numbers to find hard links to files. If py‐
91 cdlib-genisoimage finds a hard link (a file with multiple
92 names), the file will also be hard-linked on the CD, so the file
93 contents only appear once. This helps to save space.
94 -cache-inodes is default on Unix-like operating systems, but
95 -no-cache-inodes is default on some other systems such as Cyg‐
96 win, because it is not safe to assume that inode numbers are
97 unique on those systems. (Some versions of Cygwin create fake
98 inode numbers using a weak hashing algorithm, which may produce
99 duplicates.) If two files have the same inode number but are
100 not hard links to the same file, pycdlib-genisoimage -cache-in‐
101 odes will not behave correctly. -no-cache-inodes is safe in all
102 situations, but in that case pycdlib-genisoimage cannot detect
103 hard links, so the resulting CD image may be larger than neces‐
104 sary.
105
106 -alpha-boot alpha_boot_image
107 (not supported by pycdlib-genisoimage) Specifies the path and
108 filename of the boot image to be used when making an Alpha/SRM
109 bootable CD. The pathname must be relative to the source path
110 specified to pycdlib-genisoimage.
111
112 -hppa-bootloader hppa_bootloader_image
113 (not supported by pycdlib-genisoimage) Specifies the path and
114 filename of the boot image to be used when making an HPPA
115 bootable CD. The pathname must be relative to the source path
116 specified to pycdlib-genisoimage. Other options are required,
117 at the very least a kernel filename and a boot command line.
118
119 -hppa-cmdline hppa_boot_command_line
120 (not supported by pycdlib-genisoimage) Specifies the command
121 line to be passed to the HPPA boot loader when making a bootable
122 CD. Separate the parameters with spaces or commas. More options
123 must be passed to pycdlib-genisoimage, at the very least a ker‐
124 nel filename and the boot loader filename.
125
126 -hppa-kernel-32 hppa_kernel_32
127
128 -hppa-kernel-64 hppa_kernel_64
129 (not supported by pycdlib-genisoimage) Specifies the path and
130 filename of the 32-bit and/or 64-bit kernel images to be used
131 when making an HPPA bootable CD. The pathnames must be relative
132 to the source path specified to pycdlib-genisoimage. Other op‐
133 tions are required, at the very least the boot loader filename
134 and the boot command line.
135
136 -hppa-ramdisk hppa_ramdisk_image
137 (not supported by pycdlib-genisoimage) Specifies the path and
138 filename of the ramdisk image to be used when making an HPPA
139 bootable CD. The pathname must be relative to the source path
140 specified to pycdlib-genisoimage. This parameter is optional.
141 Other options are required, at the very least a kernel filename
142 and the boot command line.
143
144 -mips-boot mips_boot_image
145 (not supported by pycdlib-genisoimage) Specifies the path and
146 filename of the boot image to be used when making an SGI/big-en‐
147 dian MIPS bootable CD. The pathname must be relative to the
148 source path specified to pycdlib-genisoimage. This option may
149 be specified several times, to store up to 15 boot images.
150
151 -mipsel-boot mipsel_boot_image
152 (not supported by pycdlib-genisoimage) Specifies the path and
153 filename of the boot image to be used when making an DEC/little-
154 endian MIPS bootable CD. The pathname must be relative to the
155 source path specified to pycdlib-genisoimage.
156
157 -B img_sun4,img_sun4c,img_sun4m,img_sun4d,img_sun4e
158
159 -sparc-boot img_sun4,img_sun4c,img_sun4m,img_sun4d,img_sun4e
160 (not supported by pycdlib-genisoimage) Specifies a comma-sepa‐
161 rated list of boot images that are needed to make a bootable CD
162 for SPARC systems. Partition 0 is used for the ISO9660 image,
163 the first image file is mapped to partition 1. The comma-sepa‐
164 rated list may have up to 7 fields, including empty fields.
165 This option is required to make a bootable CD for Sun SPARC sys‐
166 tems. If -B or -sparc-boot has been specified, the first sector
167 of the resulting image will contain a Sun disk label. This disk
168 label specifies slice 0 for the ISO9660 image and slices 1 to 7
169 for the boot images that have been specified with this option.
170 Byte offsets 512 to 8191 within each of the additional boot im‐
171 ages must contain a primary boot that works for the appropriate
172 SPARC architecture. The rest of each of the images usually con‐
173 tains a UFS filesystem used for the primary kernel boot stage.
174
175 The implemented boot method is the one found with SunOS 4.x and
176 SunOS 5.x. However, it does not depend on SunOS internals but
177 only on properties of the Open Boot prom, so it should be usable
178 for any OS for SPARC systems. For more information also see the
179 NOTES section below.
180
181 If the special filename ... is used, the actual and all follow‐
182 ing boot partitions are mapped to the previous partition. If py‐
183 cdlib-genisoimage is called with -G image -B ... all boot par‐
184 titions are mapped to the partition that contains the ISO9660
185 filesystem image and the generic boot image that is located in
186 the first 16 sectors of the disc is used for all architectures.
187
188 -G generic_boot_image
189 (not supported by pycdlib-genisoimage) Specifies the path and
190 filename of the generic boot image to be used when making a
191 generic bootable CD. The boot image will be placed on the first
192 16 sectors of the CD, before the ISO9660 primary volume descrip‐
193 tor. If this option is used together with -sparc-boot, the Sun
194 disk label will overlay the first 512 bytes of the generic boot
195 image.
196
197 -b eltorito_boot_image
198
199 -eltorito-boot eltorito_boot_image
200 Specifies the path and filename of the boot image to be used
201 when making an El Torito bootable CD for x86 PCs. The pathname
202 must be relative to the source path specified to pycdlib-
203 genisoimage. This option is required to make an El Torito
204 bootable CD. The boot image must be exactly 1200 kB, 1440 kB or
205 2880 kB, and pycdlib-genisoimage will use this size when creat‐
206 ing the output ISO9660 filesystem. The PC BIOS will use the im‐
207 age to emulate a floppy disk, so the first 512-byte sector
208 should contain PC boot code. This will work, for example, if
209 the boot image is a LILO-based boot floppy.
210
211 If the boot image is not an image of a floppy, you need to add
212 either -hard-disk-boot or -no-emul-boot. If the system should
213 not boot off the emulated disk, use -no-boot.
214
215 If -sort has not been specified, the boot images are sorted with
216 low priority (+2) to the beginning of the medium. If you don't
217 like this, you need to specify a sort weight of 0 for the boot
218 images.
219
220 -eltorito-alt-boot
221 Start with a new set of El Torito boot parameters. Up to 63 El
222 Torito boot entries may be stored on a single CD.
223
224 -hard-disk-boot
225 Specifies that the boot image used to create El Torito bootable
226 CDs is a hard disk image. The image must begin with a master
227 boot record that contains a single partition.
228
229 -eltorito-platform id
230 (not supported by pycdlib-genisoimage) Set the "El Torito" plat‐
231 form id for a boot record or a section of boot records. The id
232 parameter may be either:
233
234 x86 This is the default platform id value and specifies en‐
235 tries for the PC platform. If no -eltorito-platform op‐
236 tion appears before the first -eltorito-boot option, the
237 default boot entry becomes an entry for the x86 PC plat‐
238 form.
239
240 PPC Boot entries for the Power PC platform.
241
242 Mac Boot entries for the Apple Mac platform.
243
244 efi Boot entries for EFI based PCs.
245
246 # A numeric value specifying any platform id.
247
248 If the option -eltorito-platform appears before the first -el‐
249 torito-boot option, it sets the platform id for the default boot
250 entry.
251
252 If the option -eltorito-platform appears after an -eltorito-boot
253 option and sets the platform id to a value different from the
254 previous value, it starts a new set of boot entries.
255
256 The second boot entry and any new platform id creates a new sec‐
257 tion header and reduces the number of boot entries per CD by
258 one.
259
260 -ignore-error
261 (not supported by pycdlib-genisoimage) Ignore errors. pycdlib-
262 genisoimage by default aborts on several errors, such as read
263 errors. With this option in effect, pycdlib-genisoimage tries to
264 continue. Use with care.
265
266 -no-emul-boot
267 Specifies that the boot image used to create El Torito bootable
268 CDs is a "no emulation" image. The system will load and execute
269 this image without performing any disk emulation.
270
271 -no-boot
272 Specifies that the created El Torito CD should be marked as not
273 bootable. The system will provide an emulated drive for the im‐
274 age, but will boot off a standard boot device.
275
276 -boot-load-seg segment_address
277 Specifies the load segment address of the boot image for no-emu‐
278 lation El Torito CDs.
279
280 -boot-load-size load_sectors
281 Specifies the number of "virtual" (512-byte) sectors to load in
282 no-emulation mode. The default is to load the entire boot file.
283 Some BIOSes may have problems if this is not a multiple of 4.
284
285 -boot-info-table
286 Specifies that a 56-byte table with information of the CD-ROM
287 layout will be patched in at offset 8 in the boot file.
288
289 -C last_sess_start,next_sess_start
290
291 -cdrecord-params last_sess_start,next_sess_start
292 (not supported by pycdlib-genisoimage) This option is needed to
293 create a CD Extra or the image of a second session or a higher-
294 level session for a multisession disc. -C takes two numbers
295 separated by a comma. The first is the first sector in the last
296 session of the disc that should be appended to. The second num‐
297 ber is the starting sector number of the new session. The cor‐
298 rect numbers may be retrieved by calling wodim -msinfo ... If
299 -C is used in conjunction with -M, pycdlib-genisoimage will cre‐
300 ate a filesystem image that is intended to be a continuation of
301 the previous session. If -C is used without -M, pycdlib-
302 genisoimage will create a filesystem image that is intended to
303 be used for a second session on a CD Extra. This is a multises‐
304 sion CD that holds audio data in the first session and an
305 ISO9660 filesystem in the second session.
306
307 -c boot_catalog
308
309 -eltorito-catalog boot_catalog
310 Specifies the path and filename of the boot catalog, which is
311 required for an El Torito bootable CD. The pathname must be rel‐
312 ative to the source path specified to pycdlib-genisoimage. This
313 file will be inserted into the output tree and not created in
314 the source filesystem, so be sure the specified filename does
315 not conflict with an existing file, or it will be excluded. Usu‐
316 ally a name like boot.catalog is chosen.
317
318 If -sort has not been specified, the boot catalog sorted with
319 low priority (+1) to the beginning of the medium. If you don't
320 like this, you need to specify a sort weight of 0 for the boot
321 catalog.
322
323 -check-oldnames
324 (not supported by pycdlib-genisoimage) Check all filenames im‐
325 ported from the old session for compliance with the ISO9660 file
326 naming rules. Without this option, only names longer than 31
327 characters are checked, as these files are a serious violation
328 of the ISO9660 standard.
329
330 -check-session file
331 (not supported by pycdlib-genisoimage) Check all old sessions
332 for compliance with actual pycdlib-genisoimage ISO9660 file nam‐
333 ing rules. This is a high-level option that combines -M file -C
334 0,0 -check-oldnames. For the parameter file, see the descrip‐
335 tion of -M.
336
337 -checksum_algorithm_iso alg1,alg2,...
338 (not supported by pycdlib-genisoimage) Specify the checksum
339 types desired for the output image.
340
341 -checksum_algorithm_template alg1,alg2,...
342 (not supported by pycdlib-genisoimage) Specify the checksum
343 types desired for the output jigdo template.
344
345 -copyright file
346 Specifies copyright information, typically a filename on the
347 disc. There is space for 37 characters.
348
349 -d
350
351 -omit-period
352 (not supported by pycdlib-genisoimage) Do not append a period to
353 files that do not have one.
354 This violates the ISO9660 standard, but it happens to work on
355 many systems. Use with caution.
356
357 -D
358
359 -disable-deep-relocation
360 (not supported by pycdlib-genisoimage) Do not use deep directory
361 relocation, and instead just pack them in the way we see them.
362 If ISO9660:1999 has not been selected, this violates the ISO9660
363 standard, but it happens to work on many systems. Use with cau‐
364 tion.
365
366 -data-change-warn
367 (not supported by pycdlib-genisoimage) If the size of a file
368 changes while the file is being archived, treat this condition
369 as a warning only that does not cause pycdlib-genisoimage to
370 abort.
371
372 -debug (not supported by pycdlib-genisoimage) Set debug flag.
373
374 -dir-mode mode
375 (not supported by pycdlib-genisoimage) Overrides the mode of di‐
376 rectories used to create the image to mode, specified as 4 dig‐
377 its of permission bits as in chmod(1). This option automati‐
378 cally enables Rock Ridge extensions.
379
380 -dvd-video
381 (not supported by pycdlib-genisoimage) Generate a DVD-Video com‐
382 pliant UDF filesystem. This is done by sorting the order of the
383 content of the appropriate files and by adding padding between
384 the files if needed. Note that the sorting only works if the
385 DVD-Video filenames include uppercase characters only.
386
387 Note that in order to get a DVD-Video compliant filesystem im‐
388 age, you need to prepare a DVD-Video compliant directory tree.
389 This requires a directory VIDEO_TS (all caps) in the root direc‐
390 tory of the resulting DVD, and usually another directory AU‐
391 DIO_TS. VIDEO_TS needs to include all needed files (filenames
392 must be all caps) for a compliant DVD-Video filesystem.
393
394 -e efi_boot_file
395
396 -efi-boot efi_boot_file
397 Set EFI boot image name.
398
399 -f
400
401 -follow-links
402 (not supported by pycdlib-genisoimage) Follow symbolic links
403 when generating the filesystem. When this option is not in use,
404 symbolic links will be entered using Rock Ridge if enabled, oth‐
405 erwise they will be ignored.
406
407 -file-mode mode
408 (not supported by pycdlib-genisoimage) Overrides the mode of
409 regular files used to create the image to mode, specified as 4
410 digits of permission bits as in chmod(1). This option automati‐
411 cally enables Rock Ridge extensions.
412
413 -find (not supported by pycdlib-genisoimage) This option acts a sepa‐
414 rator. If it is used, all pycdlib-genisoimage options must be
415 to the left of the -find option. To the right of the -find op‐
416 tion, pycdlib-genisoimage accepts the find command line syntax
417 only.
418
419 The find expression acts as a filter between the source of file
420 names and the consumer, which is archiving engine. If the find
421 expression evaluated as TRUE, then the related file is selected
422 for processing, otherwise it is omited.
423
424 In order to make the evaluation of the find expression more con‐
425 venient, pycdlib-genisoimage implements additional find pri‐
426 maries that have side effects on the file meta data. pycdlib-
427 genisoimage implements the following additional find primaries:
428
429 -help Lists the available find(1) syntax.
430
431 -chgrp gname
432 The primary always evaluates as true; it sets the group
433 of the file to gname.
434
435 -chmod mode
436 The primary always evaluates as true; it sets the permis‐
437 sions of the file to mode. Octal and symbolic permis‐
438 sions are accepted for mode as with chmod(1).
439
440 -chown uname
441 The primary always evaluates as true; it sets the owner
442 of the file to uname.
443
444 -false The primary always evaluates as false; it allows to make
445 the result of the full expression different from the re‐
446 sult of a part of the expression.
447
448 -true The primary always evaluates as true; it allows to make
449 the result of the full expression different from the re‐
450 sult of a part of the expression.
451
452 The command line:
453
454 pycdlib-genisoimage -o o.iso -find . ( -type d -ls -o false ) -o
455 ! -type d
456
457 lists all directories and puts all non-directories to the image
458 o.iso.
459
460 The command line:
461
462 pycdlib-genisoimage -o o.iso -find . ( -type d -chown root -o
463 true )
464
465 archives all directories so they appear to be owned by root in
466 the archive, all non-directories are archived as they are in the
467 file system.
468
469 Note that the -ls, -exec and the -ok primary cannot be used if
470 stdin or stdout has not been redirected.
471
472 -gid gid
473 (not supported by pycdlib-genisoimage) Overrides the group ID
474 read from the source files to the value of gid. Specifying this
475 option automatically enables Rock Ridge extensions.
476
477 -gui (not supported by pycdlib-genisoimage) Switch the behaviour for
478 a GUI. This currently makes the output more verbose but may have
479 other effects in the future.
480
481 -graft-points
482 (not supported by pycdlib-genisoimage) Allow use of graft points
483 for filenames. If this option is used, all filenames are checked
484 for graft points. The filename is divided at the first unescaped
485 equal sign. All occurrences of `\' and `=' characters must be
486 escaped with `\' if -graft-points has been specified.
487
488 -hide glob
489 Hide any files matching glob, a shell wildcard pattern, from be‐
490 ing seen in the ISO9660 or Rock Ridge directory. glob may match
491 any part of the filename or path. If glob matches a directory,
492 the contents of that directory will be hidden. In order to
493 match a directory name, make sure the pathname does not include
494 a trailing `/' character. All the hidden files will still be
495 written to the output CD image file. See also -hide-joliet, and
496 README.hide. This option may be used multiple times.
497
498 -hide-list file
499 A file containing a list of shell wildcards to be hidden. See
500 -hide.
501
502 -hidden glob
503 Add the hidden (existence) ISO9660 directory attribute for files
504 and directories matching glob, a shell wildcard pattern. This
505 attribute will prevent the files from being shown by some MS-DOS
506 and Windows commands. glob may match any part of the filename
507 or path. In order to match a directory name, make sure the
508 pathname does not include a trailing `/' character. This option
509 may be used multiple times.
510
511 -hidden-list file
512 A file containing a list of shell wildcards to get the hidden
513 attribute. See -hidden.
514
515 -hide-joliet glob
516 Hide files and directories matching glob, a shell wildcard pat‐
517 tern, from being seen in the Joliet directory. glob may match
518 any part of the filename or path. If glob matches a directory,
519 the contents of that directory will be hidden. In order to
520 match a directory name, make sure the pathname does not include
521 a trailing `/' character. All the hidden files will still be
522 written to the output CD image file. This option is usually
523 used with -hide. See also README.hide. This option may be used
524 multiple times.
525
526 -hide-joliet-list file
527 A file containing a list of shell wildcards to be hidden from
528 the Joliet tree. See -hide-joliet.
529
530 -hide-joliet-trans-tbl
531 (not supported by pycdlib-genisoimage) Hide the TRANS.TBL files
532 from the Joliet tree. These files usually don't make sense in
533 the Joliet world as they list the real name and the ISO9660 name
534 which may both be different from the Joliet name.
535
536 -hide-rr-moved
537 Rename the directory RR_MOVED to .rr_moved in the Rock Ridge
538 tree. It seems to be impossible to completely hide the RR_MOVED
539 directory from the Rock Ridge tree. This option only makes the
540 visible tree less confusing for people who don't know what this
541 directory is for. If you need to have no RR_MOVED directory at
542 all, you should use -D. Note that if -D has been specified, the
543 resulting filesystem is not ISO9660 level-1 compliant and will
544 not be readable on MS-DOS. See also the NOTES section.
545
546 -hide-udf glob
547 Hide glob from being seen on the UDF directory. glob is a shell
548 wild-card-style pattern that must match any part of the filename
549 or path. Multiple globs may be hidden. If glob matches a di‐
550 rectory, then the contents of that directory will be hidden. In
551 order to match a directory name, make sure the pathname does not
552 include a trailing '/' character. All the hidden files will
553 still be written to the output CD image file. Should be used
554 with the -hide option.
555
556 -hide-udf-list file
557 A file containing a list of globs to be hidden as above.
558
559 -input-charset charset
560 (not supported by pycdlib-genisoimage) Input charset that de‐
561 fines the characters used in local filenames. To get a list of
562 valid charset names, call pycdlib-genisoimage -input-charset
563 help. To get a 1:1 mapping, you may use default as charset
564 name. The default initial values are cp437 on DOS-based systems
565 and iso8859-1 on all other systems.
566
567 -output-charset charset
568 (not supported by pycdlib-genisoimage) Output charset that de‐
569 fines the characters that will be used in Rock Ridge filenames.
570 Defaults to the input charset. See CHARACTER SETS section below
571 for more details.
572
573 -iso-level level
574 Set the ISO9660 conformance level. Valid numbers are 1 to 4.
575
576 With level 1, files may only consist of one section and file‐
577 names are restricted to 8.3 characters.
578
579 With level 2, files may only consist of one section.
580
581 With level 3, no restrictions (other than ISO-9660:1988) do ap‐
582 ply.
583
584 With all ISO9660 levels from 1 to 3, all filenames are re‐
585 stricted to uppercase letters, numbers and underscores (_).
586 Filenames are limited to 31 characters, directory nesting is
587 limited to 8 levels, and pathnames are limited to 255 charac‐
588 ters.
589
590 Level 4 officially does not exist but pycdlib-genisoimage maps
591 it to ISO-9660:1999, which is ISO9660 version 2.
592
593 With level 4, an enhanced volume descriptor with version number
594 and file structure version number set to 2 is emitted. Direc‐
595 tory nesting is not limited to 8 levels, there is no need for a
596 file to contain a dot and the dot has no special meaning, file‐
597 names do not have version numbers, and filenames can be up to
598 207 characters long, or 197 characters if Rock Ridge is used.
599
600 When creating Version 2 images, pycdlib-genisoimage emits an en‐
601 hanced volume descriptor, similar but not identical to a primary
602 volume descriptor. Be careful not to use broken software to make
603 ISO9660 images bootable by assuming a second PVD copy and patch‐
604 ing this putative PVD copy into an El Torito VD.
605
606 -J Generate Joliet directory records in addition to regular ISO9660
607 filenames. This is primarily useful when the discs are to be
608 used on Windows machines. Joliet filenames are specified in
609 Unicode and each path component can be up to 64 Unicode charac‐
610 ters long. Note that Joliet is not a standard — only Microsoft
611 Windows and Linux systems can read Joliet extensions. For
612 greater portability, consider using both Joliet and Rock Ridge
613 extensions.
614
615 -joliet-long
616 (not supported by pycdlib-genisoimage) Allow Joliet filenames to
617 be up to 103 Unicode characters, instead of 64. This breaks the
618 Joliet specification, but appears to work. Use with caution.
619
620 -jcharset charset
621 (not supported by pycdlib-genisoimage) A combination of -J -in‐
622 put-charset charset.
623
624 -l
625
626 -full-iso9660-filenames
627 (not supported by pycdlib-genisoimage) Allow full 31-character
628 filenames. Normally the ISO9660 filename will be in an 8.3 for‐
629 mat which is compatible with MS-DOS, even though the ISO9660
630 standard allows filenames of up to 31 characters. If you use
631 this option, the disc may be difficult to use on a MS-DOS sys‐
632 tem, but will work on most other systems. Use with caution.
633
634 -L Outdated option; use -allow-leading-dots instead.
635
636 -jigdo-jigdo jigdo_file
637 (not supported by pycdlib-genisoimage) Produce a jigdo .jigdo
638 metadata file as well as the filesystem image.
639
640 -jigdo-template template_file
641 (not supported by pycdlib-genisoimage) Produce a jigdo .template
642 file as well as the filesystem image.
643
644 -jigdo-min-file-size size
645 (not supported by pycdlib-genisoimage) Specify the minimum size
646 for a file to be listed in the .jigdo file. Default (and minimum
647 allowed) is 1KB.
648
649 -jigdo-force-md5 path
650 (not supported by pycdlib-genisoimage) Specify a file pattern
651 where files must be contained in the externally-supplied MD5
652 list as supplied by -md5-list.
653
654 -jigdo-exclude path
655 (not supported by pycdlib-genisoimage) Specify a file pattern
656 where files will not be listed in the .jigdo file.
657
658 -jigdo-map path
659 (not supported by pycdlib-genisoimage) Specify a pattern mapping
660 for the jigdo file (e.g. Debian=/mirror/debian).
661
662 -md5-list md5_file
663 (not supported by pycdlib-genisoimage) Specify a file containing
664 the MD5sums, sizes and pathnames of the files to be included in
665 the .jigdo file.
666
667 -jigdo-template-compress algorithm
668 (not supported by pycdlib-genisoimage) Specify a compression al‐
669 gorithm to use for template date. gzip and bzip2 are currently
670 supported, and gzip is the default.
671
672 -log-file log_file
673 Redirect all error, warning and informational messages to
674 log_file instead of the standard error.
675
676 -long-rr-time
677 (not supported by pycdlib-genisoimage) Use the long ISO-9660
678 time format for the file time stamps used in Rock Ridge. This
679 time format allows to represent year 0 .. year 9999 with a gran‐
680 ularity of 10ms.
681
682 The short ISO-9660 time format only allows to represent year
683 1900 .. year 2155 with a granularity of 1s.
684
685 -m glob
686 Exclude files matching glob, a shell wildcard pattern, from be‐
687 ing written to CD-ROM. glob may match either the filename com‐
688 ponent or the full pathname. This option may be used multiple
689 times. For example:
690
691 pycdlib-genisoimage -o rom -m '*.o' -m core -m foobar
692
693 would exclude all files ending in `.o', or called core or foobar
694 from the image. Note that if you had a directory called foobar,
695 it too (and of course all its descendants) would be excluded.
696
697 -exclude-list file
698 A file containing a list of shell wildcards to be excluded. See
699 -m.
700
701 -max-iso9660-filenames
702 (not supported by pycdlib-genisoimage) Allow ISO9660 filenames
703 to be up to 37 characters long. This option enables -N as the
704 extra name space is taken from the space reserved for file ver‐
705 sion numbers.
706 This violates the ISO9660 standard, but it happens to work on
707 many systems. Although a conforming application needs to pro‐
708 vide a buffer space of at least 37 characters, discs created
709 with this option may cause a buffer overflow in the reading op‐
710 erating system. Use with extreme care.
711
712 -M path
713
714 -M device
715
716 -dev device
717 (not supported by pycdlib-genisoimage) Specifies path to exist‐
718 ing ISO9660 image to be merged. The alternate form takes a SCSI
719 device specifier that uses the same syntax as the dev= parameter
720 of wodim. The output of pycdlib-genisoimage will be a new ses‐
721 sion which should get written to the end of the image specified
722 in -M. Typically this requires multisession capability for the
723 CD recorder used to write the image. This option may only be
724 used in conjunction with -C.
725
726 -modification-date date-spec
727 (not supported by pycdlib-genisoimage) Set the modification date
728 in the primary volume descriptor (PVD) to a value different from
729 the current time. This allows e.g. to set up an intentional
730 UUID for grub.
731
732 The format of date-spec is:
733
734 yyyy[mm[dd[hh[mm[ss]]]]][.hh][+-ghgm]
735
736 The fields are year, month, day of month, hour, minute, second,
737 hundreds of a second, GMT offset in hours and minutes. The time
738 is interpreted as local time.
739
740 Year and the GMT offset are four digit fields, all other fields
741 take two digits. The GMT offset may be between -12 and +13
742 hours in 15 minute steps. Locations east to Greenwich have posi‐
743 tive values. The value is the sum of the time zone offset and
744 the effects from daylight saving time. Omited values are re‐
745 placed by the minimal possible values. If the GMT offset is
746 omited, it is computed from the local time value that has been
747 supplied.
748
749 Between year and month as well as between month and day of
750 month, a separator chosen from '/' and '-' may appear. In this
751 case, the year may be a two digit number with values 69..99 rep‐
752 resenting 1969..1999 and values 00..68 representing 2000..2068.
753 Between date and time spec, an optional space is permitted. Be‐
754 tween hours and minutes as well as between minutes and seconds,
755 an optional ':' separator is permitted. This allows pycdlib-
756 genisoimage to parse the popular POSIX date format created by:
757
758 date "+%Y-%m-%d %H:%M:%S %z"
759
760 Note that the possible range for date-spec for 32 bit programs
761 is limited to values up to 2038 Jan 19 04:14:07 GMT.
762
763 -N
764
765 -omit-version-number
766 (not supported by pycdlib-genisoimage) Omit version numbers from
767 ISO9660 filenames.
768 This violates the ISO9660 standard, but no one really uses the
769 version numbers anyway. Use with caution.
770
771 -new-dir-mode mode
772 (not supported by pycdlib-genisoimage) Specify the mode, a
773 4-digit number as used in chmod(1), to use when creating new di‐
774 rectories in the filesystem image. The default is 0555.
775
776 -nobak
777
778 -no-bak
779 Exclude backup files files on the ISO9660 filesystem; that is,
780 filenames that contain the characters `~' or `#' or end in .bak.
781 These are typically backup files for Unix text editors.
782
783 -no-limit-pathtables
784 (not supported by pycdlib-genisoimage) A ISO-9660 filesystem
785 contains path tables that contain a list of directories. This
786 list may contain many directories but only 65535 of them may be
787 parent directories. When -no-limit-pathtables is in use, fur‐
788 ther parent directories will be folded to the root directory and
789 the resulting filesystem will no longer be usable on DOS.
790
791 -no-long-rr-time
792 (not supported by pycdlib-genisoimage) Use the short ISO-9660
793 time format for the file time stamps used in Rock Ridge. This
794 time format allows to represent year 1990 .. year 2155 with a
795 granularity of one second.
796
797 -force-rr
798 (not supported by pycdlib-genisoimage) Do not use the automatic
799 Rock Ridge attributes recognition for previous sessions. This
800 can work around problems with images created by, e.g., NERO
801 Burning ROM.
802
803 -no-rr (not supported by pycdlib-genisoimage) Do not use the Rock Ridge
804 attributes from previous sessions. This may help to avoid prob‐
805 lems when pycdlib-genisoimage finds illegal Rock Ridge signa‐
806 tures on an old session.
807
808 -no-split-symlink-components
809 (not supported by pycdlib-genisoimage) Don't split the symlink
810 components, but begin a new Continuation Area (CE) instead. This
811 may waste some space, but the SunOS 4.1.4 cdrom driver has a bug
812 in reading split symlink components.
813
814 It is questionable whether this option is useful nowadays.
815
816 -no-split-symlink-fields
817 (not supported by pycdlib-genisoimage) Don't split the symlink
818 fields, but begin a new Continuation Area (CE) instead. This may
819 waste some space, but the SunOS 4.1.4 and Solaris 2.5.1 cdrom
820 driver have a bug in reading split symlink fields (a `/' can be
821 dropped).
822
823 It is questionable whether this option is useful nowadays.
824
825 -o filename
826 Specify the output file for the the ISO9660 filesystem image.
827 This can be a disk file, a tape drive, or it can correspond di‐
828 rectly to the device name of the optical disc writer. If not
829 specified, stdout is used. Note that the output can also be a
830 block device for a regular disk partition, in which case the
831 ISO9660 filesystem can be mounted normally to verify that it was
832 generated correctly.
833
834 -pad (not supported by pycdlib-genisoimage) Pad the end of the whole
835 image by 150 sectors (300 kB). This option is enabled by de‐
836 fault. If used in combination with -B, padding is inserted be‐
837 tween the ISO9660 partition and the boot partitions, such that
838 the first boot partition starts on a sector number that is a
839 multiple of 16.
840
841 The padding is needed as many operating systems (e.g. Linux) im‐
842 plement read-ahead bugs in their filesystem I/O. These bugs re‐
843 sult in read errors on files that are located near the end of a
844 track, particularly if the disc is written in Track At Once
845 mode, or where a CD audio track follows the data track.
846
847 -no-pad
848 (not supported by pycdlib-genisoimage) Do not pad the end by 150
849 sectors (300 kB) and do not make the the boot partitions start
850 on a multiple of 16 sectors.
851
852 -path-list file
853 A file containing a list of pathspec directories and filenames
854 to be added to the ISO9660 filesystem. This list of pathspecs
855 are processed after any that appear on the command line. If the
856 argument is -, the list is read from the standard input.
857
858 -P Outdated option; use -publisher instead.
859
860 -publisher publisher_id
861 Specifies a text string that will be written into the volume
862 header. This should describe the publisher of the CD-ROM, usu‐
863 ally with a mailing address and phone number. There is space
864 for 128 characters.
865
866 -p preparer_id
867
868 -preparer preparer_id
869 Specifies a text string that will be written into the volume
870 header. This should describe the preparer of the CD-ROM, usu‐
871 ally with a mailing address and phone number. There is space on
872 the disc for 128 characters of information. The related Joliet
873 entry is limited to 64 characters.
874
875 -posix-H
876 (not supported by pycdlib-genisoimage) Follow all symbolic links
877 encountered on command line when generating the filesystem.
878
879 -posix-L
880 (not supported by pycdlib-genisoimage) Follow all symbolic links
881 when generating the filesystem. When this option is not in use,
882 symbolic links will be entered using Rock Ridge if enabled, oth‐
883 erwise the file will be ignored.
884
885 -posix-P
886 (not supported by pycdlib-genisoimage) Do not follow symbolic
887 links when generating the filesystem (this is the default). If
888 -posix-P is specified after -posix-H or -posix-L, the effect of
889 these options will be reset.
890
891 -print-size
892 Print estimated filesystem size in multiples of the sector size
893 (2048 bytes) and exit. This option is needed for Disk At Once
894 mode and with some CD-R drives when piping directly into wodim,
895 cases where wodim needs to know the size of the filesystem image
896 in advance. Old versions of mkisofs wrote this information
897 (among other information) to stderr. As this turns out to be
898 hard to parse, the number without any other information is now
899 printed on stdout too. If you like to write a simple shell
900 script, redirect stderr and catch the number from stdout. This
901 may be done with:
902
903 cdblocks=` pycdlib-genisoimage -print-size -quiet ... `
904 pycdlib-genisoimage ... | wodim ... tsize=${cdblocks}s -
905
906 -quiet This makes pycdlib-genisoimage even less verbose. No progress
907 output will be provided.
908
909 -R
910
911 -rock Generate SUSP and RR records using the Rock Ridge protocol to
912 further describe the files on the ISO9660 filesystem.
913
914 -r
915
916 -rational-rock
917 This is like the -R option, but file ownership and modes are set
918 to more useful values. The uid and gid are set to zero, because
919 they are usually only useful on the author's system, and not
920 useful to the client. All the file read bits are set true, so
921 that files and directories are globally readable on the client.
922 If any execute bit is set for a file, set all of the execute
923 bits, so that executables are globally executable on the client.
924 If any search bit is set for a directory, set all of the search
925 bits, so that directories are globally searchable on the client.
926 All write bits are cleared, because the filesystem will be
927 mounted read-only in any case. If any of the special mode bits
928 are set, clear them, because file locks are not useful on a
929 read-only filesystem, and set-id bits are not desirable for uid
930 0 or gid 0. When used on Win32, the execute bit is set on all
931 files. This is a result of the lack of file permissions on Win32
932 and the Cygwin POSIX emulation layer. See also -uid, -gid,
933 -dir-mode, -file-mode and -new-dir-mode.
934
935 -relaxed-filenames
936 (not supported by pycdlib-genisoimage) Allows ISO9660 filenames
937 to include all 7-bit ASCII characters except lowercase letters.
938 This violates the ISO9660 standard, but it happens to work on
939 many systems. Use with caution.
940
941 -root dir
942 (not supported by pycdlib-genisoimage) Moves all files and di‐
943 rectories into dir in the image. This is essentially the same as
944 using -graft-points and adding dir in front of every pathspec,
945 but is easier to use. dir may actually be several levels deep.
946 It is created with the same permissions as other graft points.
947
948 -rrip110
949 Create ISO-9660 file system images that follow the old Rrip Ver‐
950 sion-1.10 standard from 1993. This option may be needed if you
951 know of systems that do not implement the Rrip protocol cor‐
952 rectly and like the file system to be read by such a system.
953 Currently no such system is known.
954
955 If a file system has been created with -rrip110, the Rock Ridge
956 attributes do not include inode number information.
957
958 -rrip112
959 Create ISO-9660 file system images that follow the new Rrip Ver‐
960 sion-1.12 standard from 1994.
961
962 -old-root dir
963 (not supported by pycdlib-genisoimage) This option is necessary
964 when writing a multisession image and the previous (or even
965 older) session was written with -root dir. Using a directory
966 name not found in the previous session causes pycdlib-genisoim‐
967 age to abort with an error. Without this option, pycdlib-
968 genisoimage would not be able to find unmodified files and would
969 be forced to write their data into the image once more. -root
970 and -old-root are meant to be used together to do incremental
971 backups. The initial session would e.g. use: pycdlib-genisoim‐
972 age -root backup_1 dirs. The next incremental backup with py‐
973 cdlib-genisoimage -root backup_2 -old-root backup_1 dirs would
974 take another snapshot of these directories. The first snapshot
975 would be found in backup_1, the second one in backup_2, but only
976 modified or new files need to be written into the second ses‐
977 sion. Without these options, new files would be added and old
978 ones would be preserved. But old ones would be overwritten if
979 the file was modified. Recovering the files by copying the whole
980 directory back from CD would also restore files that were
981 deleted intentionally. Accessing several older versions of a
982 file requires support by the operating system to choose which
983 sessions are to be mounted.
984
985 -s sector type
986
987 -sectype sector type
988 (not supported by pycdlib-genisoimage) Set output sector type to
989 e.g. data/xa1/raw.
990
991 -sort sort_file
992 (not supported by pycdlib-genisoimage) Sort file locations on
993 the media. Sorting is controlled by a file that contains pairs
994 of filenames and sorting offset weighting. If the weighting is
995 higher, the file will be located closer to the beginning of the
996 media, if the weighting is lower, the file will be located
997 closer to the end of the media. There must be only one space or
998 tabs character between the filename and the weight and the
999 weight must be the last characters on a line. The filename is
1000 taken to include all the characters up to, but not including the
1001 last space or tab character on a line. This is to allow for
1002 space characters to be in, or at the end of a filename. This
1003 option does not sort the order of the filenames that appear in
1004 the ISO9660 directory. It sorts the order in which the file data
1005 is written to the CD image, which is useful in order to optimize
1006 the data layout on a CD. See README.sort for more details.
1007
1008 -sparc-boot img_sun4,img_sun4c,img_sun4m,img_sun4d,img_sun4e
1009 (not supported by pycdlib-genisoimage) See -B above.
1010
1011 -sparc-label label
1012 (not supported by pycdlib-genisoimage) Set the Sun disk label
1013 name for the Sun disk label that is created with -sparc-boot.
1014
1015 -split-output
1016 (not supported by pycdlib-genisoimage) Split the output image
1017 into several files of approximately 1 GB each. This helps to
1018 create DVD-sized ISO9660 images on operating systems without
1019 large file support. wodim will concatenate more than one file
1020 into a single track if writing to a DVD. To make -split-output
1021 work, -o filename must be specified. The resulting output images
1022 will be named: filename_00, filename_01, filename_02....
1023
1024 -stream-media-size #
1025 (not supported by pycdlib-genisoimage) Select streaming opera‐
1026 tion and set the media size to # sectors. This allows you to
1027 pipe the output of the tar(1) program into pycdlib-genisoimage
1028 and to create an ISO9660 filesystem without the need of an in‐
1029 termediate tar archive file. If this option has been specified,
1030 pycdlib-genisoimage reads from stdin and creates a file with the
1031 name STREAM.IMG. The maximum size of the file (with padding) is
1032 200 sectors less than the specified media size. If -no-pad has
1033 been specified, the file size is 50 sectors less than the speci‐
1034 fied media size. If the file is smaller, pycdlib-genisoimage
1035 will write padding. This may take awhile.
1036
1037 The option -stream-media-size creates simple ISO9660 filesystems
1038 only and may not used together with multisession or hybrid
1039 filesystem options.
1040
1041 -stream-file-name name
1042 Reserved for future use.
1043
1044 -sunx86-boot UFS_img,,,AUX1_img
1045 (not supported by pycdlib-genisoimage) Specifies a comma-sepa‐
1046 rated list of filesystem images that are needed to make a
1047 bootable CD for Solaris x86 systems.
1048
1049 Note that partition 1 is used for the ISO9660 image and that
1050 partition 2 is the whole disk, so partition 1 and 2 may not be
1051 used by external partition data. The first image file is mapped
1052 to partition 0. There may be empty fields in the comma-sepa‐
1053 rated list, and list entries for partition 1 and 2 must be
1054 empty. The maximum number of supported partitions is 8 (al‐
1055 though the Solaris x86 partition table could support up to 16
1056 partitions), so it is impossible to specify more than 6 parti‐
1057 tion images. This option is required to make a bootable CD for
1058 Solaris x86 systems.
1059
1060 If -sunx86-boot has been specified, the first sector of the re‐
1061 sulting image will contain a PC fdisk label with a Solaris type
1062 0x82 fdisk partition that starts at offset 512 and spans the
1063 whole CD. In addition, for the Solaris type 0x82 fdisk parti‐
1064 tion, there is a SVr4 disk label at offset 1024 in the first
1065 sector of the CD. This disk label specifies slice 0 for the
1066 first (usually UFS type) filesystem image that is used to boot
1067 the PC and slice 1 for the ISO9660 image. Slice 2 spans the
1068 whole CD slice 3 ... slice 7 may be used for additional filesys‐
1069 tem images that have been specified with this option.
1070
1071 A Solaris x86 boot CD uses a 1024 byte sized primary boot that
1072 uses the El-Torito no-emulation boot mode and a secondary
1073 generic boot that is in CD sectors 1..15. For this reason, both
1074 -b bootimage -no-emul-boot and -G genboot must be specified.
1075
1076 -sunx86-label label
1077 (not supported by pycdlib-genisoimage) Set the SVr4 disk label
1078 name for the SVr4 disk label that is created with -sunx86-boot.
1079
1080 -sysid ID
1081 Specifies the system ID. There is space for 32 characters.
1082
1083 -T
1084
1085 -translation-table
1086 (not supported by pycdlib-genisoimage) Generate a file TRANS.TBL
1087 in each directory on the CD-ROM, which can be used on non-
1088 Rock Ridge-capable systems to help establish the correct file‐
1089 names. There is also information present in the file that indi‐
1090 cates the major and minor numbers for block and character de‐
1091 vices, and each symlink has the name of the link file given.
1092
1093 -table-name table_name
1094 (not supported by pycdlib-genisoimage) Alternative translation
1095 table filename (see above). Implies -T. If you are creating a
1096 multisession image you must use the same name as in the previous
1097 session.
1098
1099 -ucs-level level
1100 Set Unicode conformance level in the Joliet SVD. The default
1101 level is 3. It may be set to 1..3 using this option.
1102
1103 -UDF Include a UDF hybrid in the generated filesystem image. As py‐
1104 cdlib-genisoimage always creates a ISO-9660 filesystem, it is
1105 not possible to create UDF only images. Note that UDF wastes
1106 the space from sector ~20 to sector 256 at the beginning of the
1107 disk in addition to the space needed for real UDF data struc‐
1108 tures.
1109
1110 -udf Rationalized UDF with user and group set to 0 and with simpli‐
1111 fied permissions. See -r option for more information.
1112
1113 -udf-symlinks
1114 Support symlinks in UDF filesystems. This is the default.
1115
1116 -no-udf-symlinks
1117 Do not support symlinks in UDF filesystems.
1118
1119 -uid uid
1120 (not supported by pycdlib-genisoimage) Overrides the uid read
1121 from the source files to the value of uid. Specifying this op‐
1122 tion automatically enables Rock Ridge extensions.
1123
1124 -use-fileversion
1125 (not supported by pycdlib-genisoimage) The option -use-filever‐
1126 sion allows pycdlib-genisoimage to use file version numbers from
1127 the filesystem. If the option is not specified, pycdlib-
1128 genisoimage creates a version number of 1 for all files. File
1129 versions are strings in the range ;1 to ;32767 This option is
1130 the default on VMS.
1131
1132 -U
1133
1134 -untranslated-filenames
1135 (not supported by pycdlib-genisoimage) Allows "untranslated"
1136 filenames, completely violating the ISO9660 standards described
1137 above. Enables the following flags: -d -l -N -allow-lead‐
1138 ing-dots -relaxed-filenames -allow-lowercase -allow-multidot
1139 -no-iso-translate. Allows more than one `.' character in the
1140 filename, as well as mixed-case filenames. This is useful on
1141 HP-UX, where the built-in cdfs filesystem does not recognize any
1142 extensions. Use with extreme caution.
1143
1144 -no-iso-translate
1145 (not supported by pycdlib-genisoimage) Do not translate the
1146 characters `#' and `~' which are invalid for ISO9660 filenames.
1147 Although invalid, these characters are often used by Microsoft
1148 systems.
1149 This violates the ISO9660 standard, but it happens to work on
1150 many systems. Use with caution.
1151
1152 -V volid
1153 Specifies the volume ID (volume name or label) to be written
1154 into the master block. There is space for 32 characters. The
1155 volume ID is used as the mount point by the Solaris volume man‐
1156 ager and as a label assigned to a disc on various other plat‐
1157 forms such as Windows and Apple Mac OS.
1158
1159 -volset ID
1160 Specifies the volume set ID. There is space for 128 characters.
1161
1162 -volset-size #
1163 Sets the volume set size to #. The volume set size is the num‐
1164 ber of CDs that are in a CD volume set. A volume set is a col‐
1165 lection of one or more volumes, on which a set of files is
1166 recorded.
1167
1168 Volume Sets are not intended to be used to create a set numbered
1169 CDs that are part of e.g. a Operation System installation set of
1170 CDs. Volume Sets are rather used to record a big directory tree
1171 that would not fit on a single volume. Each volume of a Volume
1172 Set contains a description of all the directories and files that
1173 are recorded on the volumes where the sequence numbers are less
1174 than, or equal to, the assigned Volume Set Size of the current
1175 volume.
1176
1177 pycdlib-genisoimage currently does not support a -volset-size
1178 that is larger than 1.
1179
1180 The option -volset-size must be specified before -volset-seqno
1181 on each command line.
1182
1183 -volset-seqno #
1184 Sets the volume set sequence number to #. The volume set se‐
1185 quence number is the index number of the current CD in a CD set.
1186 The option -volset-size must be specified before -volset-seqno
1187 on each command line.
1188
1189 -v
1190
1191 -verbose
1192 Verbose execution. If given twice on the command line, extra de‐
1193 bug information will be printed.
1194
1195 -x glob
1196 Identical to -m glob.
1197
1198 -XA Generate XA directory attruibutes.
1199
1200 -xa Generate rationalized XA directory attruibutes.
1201
1202 -z
1203
1204 -transparent-compression
1205 (not supported by pycdlib-genisoimage) Generate special RRIP
1206 records for transparently compressed files. This is only of use
1207 and interest for hosts that support transparent decompression,
1208 such as Linux 2.4.14 or later. You must specify -R or -r to en‐
1209 able Rock Ridge, and generate compressed files using the
1210 mkzftree utility before running pycdlib-genisoimage. Note that
1211 transparent compression is a nonstandard Rock Ridge extension.
1212 The resulting disks are only transparently readable if used on
1213 Linux. On other operating systems you will need to call
1214 mkzftree by hand to decompress the files.
1215
1216 -scan-for-duplicates
1217 Keep a running list of file hashes, attempting to link as many
1218 files together as possible. This results in the smallest possi‐
1219 ble ISO image, but may be very slow, particular with large
1220 files.
1221
1223 -hfs (not supported by pycdlib-genisoimage) Create an ISO9660/HFS hy‐
1224 brid CD. This option should be used in conjunction with the
1225 -map, -magic and/or the various double dash options given below.
1226
1227 -no-hfs
1228 Do not create an ISO-9660/HFS hybrid CD even though other op‐
1229 tions may imply to do so.
1230
1231 -apple (not supported by pycdlib-genisoimage) Create an ISO9660 CD with
1232 Apple's extensions. Similar to -hfs, except that the Apple Ex‐
1233 tensions to ISO9660 are added instead of creating an HFS hybrid
1234 volume. Former pycdlib-genisoimage versions did include Rock
1235 Ridge attributes by default if -apple was specified. This ver‐
1236 sions of pycdlib-genisoimage does not do this anymore. If you
1237 like to have Rock Ridge attributes, you need to specify this
1238 separately.
1239
1240 -map mapping_file
1241 (not supported by pycdlib-genisoimage) Use the mapping_file to
1242 set the CREATOR and TYPE information for a file based on the
1243 filename's extension. A filename is mapped only if it is not one
1244 of the know Apple/Unix file formats.
1245
1246 -magic magic_file
1247 (not supported by pycdlib-genisoimage) The CREATOR and TYPE in‐
1248 formation is set by using a file's magic number (usually the
1249 first few bytes of a file). The magic_file is only used if a
1250 file is not one of the known Apple/Unix file formats, or the
1251 filename extension has not been mapped using -map.
1252
1253 -hfs-creator creator
1254 (not supported by pycdlib-genisoimage) Set the default CREATOR
1255 for all files. Must be exactly 4 characters.
1256
1257 -hfs-type type
1258 (not supported by pycdlib-genisoimage) Set the default TYPE for
1259 all files. Must be exactly 4 characters.
1260
1261 -probe (not supported by pycdlib-genisoimage) Search the contents of
1262 files for all the known Apple/Unix file formats. However, the
1263 only way to check for MacBinary and AppleSingle files is to open
1264 and read them, so this option may increase processing time. It
1265 is better to use one or more double dash options given below if
1266 the Apple/Unix formats in use are known.
1267
1268 -no-desktop
1269 (not supported by pycdlib-genisoimage) Do not create (empty)
1270 Desktop files. New HFS Desktop files will be created when the CD
1271 is used on a Macintosh (and stored in the System Folder). By
1272 default, empty Desktop files are added to the HFS volume.
1273
1274 -mac-name
1275 (not supported by pycdlib-genisoimage) Use the HFS filename as
1276 the starting point for the ISO9660, Joliet and Rock Ridge file‐
1277 names.
1278
1279 -boot-hfs-file driver_file
1280 (not supported by pycdlib-genisoimage) Installs the driver_file
1281 that may make the CD bootable on a Macintosh.
1282
1283 -part (not supported by pycdlib-genisoimage) Generate an HFS partition
1284 table. By default, no partition table is generated, but some
1285 older Macintosh CD-ROM drivers need an HFS partition table on
1286 the CD-ROM to be able to recognize a hybrid CD-ROM.
1287
1288 -auto AutoStart_file
1289 (not supported by pycdlib-genisoimage) Make the HFS CD use the
1290 QuickTime 2.0 Autostart feature to launch an application or doc‐
1291 ument. The given filename must be the name of a document or ap‐
1292 plication located at the top level of the CD. The filename must
1293 be less than 12 characters. (Alpha).
1294
1295 -cluster-size size
1296 (not supported by pycdlib-genisoimage) Set the size in bytes of
1297 the cluster or allocation units of PC Exchange files. Implies
1298 --exchange.
1299
1300 -hide-hfs glob
1301 (not supported by pycdlib-genisoimage) Hide glob, a shell wild‐
1302 card pattern, from the HFS volume. The file or directory will
1303 still exist in the ISO9660 and/or Joliet directory. glob may
1304 match any part of the filename. Multiple globs may be excluded.
1305 Example:
1306
1307 pycdlib-genisoimage -o rom -hfs -hide-hfs '*.o' -hide-hfs
1308 foobar
1309
1310 would exclude all files ending in `.o' or called foobar from the
1311 HFS volume. Note that if you had a directory called foobar, it
1312 too (and of course all its descendants) would be excluded. The
1313 glob can also be a path name relative to the source directories
1314 given on the command line. Example:
1315
1316 pycdlib-genisoimage -o rom -hfs -hide-hfs src/html src
1317
1318 would exclude just the file or directory called html from the
1319 src directory. Any other file or directory called html in the
1320 tree will not be excluded. Should be used with -hide and/or
1321 -hide-joliet. In order to match a directory name, make sure the
1322 pattern does not include a trailing `/' character. See
1323 README.hide for more details.
1324
1325 -hide-hfs-list file
1326 (not supported by pycdlib-genisoimage) Specify a file containing
1327 a list of wildcard patterns to be hidden as in -hide-hfs.
1328
1329 -hfs-volid hfs_volid
1330 (not supported by pycdlib-genisoimage) Volume name for the HFS
1331 partition. This is the name that is assigned to the disc on a
1332 Macintosh and replaces the volid used with -V.
1333
1334 -icon-position
1335 (not supported by pycdlib-genisoimage) Use the icon position in‐
1336 formation, if it exists, from the Apple/Unix file. The icons
1337 will appear in the same position as they would on a Macintosh
1338 desktop. Folder location and size on screen, its scroll posi‐
1339 tions, folder View (view as Icons, Small Icons, etc.) are also
1340 preserved. (Alpha).
1341
1342 -root-info file
1343 (not supported by pycdlib-genisoimage) Set the location, size on
1344 screen, scroll positions, folder View etc. for the root folder
1345 of an HFS volume. See README.rootinfo for more information.
1346 (Alpha)
1347
1348 -prep-boot file
1349 (not supported by pycdlib-genisoimage) PReP boot image file. Up
1350 to 4 are allowed. See README.prep_boot for more information.
1351 (Alpha)
1352
1353 -chrp-boot
1354 (not supported by pycdlib-genisoimage) Add CHRP boot header.
1355
1356 -input-hfs-charset charset
1357 (not supported by pycdlib-genisoimage) Input charset that de‐
1358 fines the characters used in HFS filenames when used with
1359 -mac-name. The default charset is cp10000 (Mac Roman).
1360
1361 -output-hfs-charset charset
1362 (not supported by pycdlib-genisoimage) Output charset that de‐
1363 fines the characters that will be used in the HFS filenames. De‐
1364 faults to the input charset.
1365
1366 -hfs-unlock
1367 (not supported by pycdlib-genisoimage) By default, pycdlib-
1368 genisoimage will create an HFS volume that is locked. This op‐
1369 tion leaves the volume unlocked so that other applications (e.g.
1370 hfsutils) can modify the volume.
1371
1372 -hfs-bless folder_name
1373 (not supported by pycdlib-genisoimage) "Bless" the given direc‐
1374 tory (folder). This is usually the System Folder and is used in
1375 creating HFS bootable CDs. The name of the directory must be the
1376 whole path name as pycdlib-genisoimage sees it. E.g., if the
1377 given pathspec is ./cddata and the required folder is called
1378 System Folder, the whole path name is "/cddata/System Folder"
1379 (remember to use quotes if the name contains spaces).
1380
1381 -hfs-parms parameters
1382 (not supported by pycdlib-genisoimage) Override certain parame‐
1383 ters used to create the HFS filesystem. Unlikely to be used in
1384 normal circumstances.
1385
1386 --cap (not supported by pycdlib-genisoimage) Look for AUFS CAP Macin‐
1387 tosh files. Search for CAP Apple/Unix file formats only. Search‐
1388 ing for the other possible Apple/Unix file formats is disabled,
1389 unless other double dash options are given.
1390
1391 --netatalk
1392 (not supported by pycdlib-genisoimage) Look for NETATALK Macin‐
1393 tosh files
1394
1395 --double
1396 (not supported by pycdlib-genisoimage) Look for AppleDouble Mac‐
1397 intosh files
1398
1399 --ethershare
1400 (not supported by pycdlib-genisoimage) Look for Helios Ether‐
1401 Share Macintosh files
1402
1403 --ushare
1404 (not supported by pycdlib-genisoimage) Look for IPT UShare Mac‐
1405 intosh files
1406
1407 --exchange
1408 (not supported by pycdlib-genisoimage) Look for PC Exchange Mac‐
1409 intosh files
1410
1411 --sgi (not supported by pycdlib-genisoimage) Look for SGI Macintosh
1412 files
1413
1414 --xinet
1415 (not supported by pycdlib-genisoimage) Look for XINET Macintosh
1416 files
1417
1418 --macbin
1419 (not supported by pycdlib-genisoimage) Look for MacBinary Macin‐
1420 tosh files
1421
1422 --single
1423 (not supported by pycdlib-genisoimage) Look for AppleSingle Mac‐
1424 intosh files
1425
1426 --dave (not supported by pycdlib-genisoimage) Look for Thursby Software
1427 Systems DAVE Macintosh files
1428
1429 --sfm (not supported by pycdlib-genisoimage) Look for Microsoft's Ser‐
1430 vices for Macintosh files (NT only) (Alpha)
1431
1432 --osx-double
1433 (not supported by pycdlib-genisoimage) Look for Mac OS X Apple‐
1434 Double Macintosh files
1435
1436 --osx-hfs
1437 (not supported by pycdlib-genisoimage) Look for Mac OS X HFS
1438 Macintosh files
1439
1440
1442 genisoimage(1), pycdlib-explorer(1), pycdlib-extract-files(1)
1443
1444
1446 Chris Lalancette <clalancette@gmail.com>
1447
1448
1449
1450pycdlib-genisoimage Sep 2017 PYCDLIB-GENISOIMAGE(1)