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