1PYCDLIB-GENISOIMAGE(1)      General Commands Manual     PYCDLIB-GENISOIMAGE(1)
2
3
4

NAME

6       pycdlib-genisoimage - tool to master ISOs using pycdlib
7
8

SYNOPSIS

10       pycdlib-genisoimage [options] [-o filename] pathspec [pathspec ...]
11
12

DESCRIPTION

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
38

OPTIONS

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
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
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
133              options 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-
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
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
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
176              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
182              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
189       -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
198       -b eltorito_boot_image
199
200       -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
212              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
216              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
221       -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
225       -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
230       -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
235              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
241              PPC    Boot entries for the Power PC platform.
242
243              Mac    Boot entries for the Apple Mac platform.
244
245              efi    Boot entries for EFI based PCs.
246
247              #      A numeric value specifying any platform id.
248
249              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
253              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
257              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
261       -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
267       -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
272       -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
277       -boot-load-seg segment_address
278              Specifies the load segment address of the boot image for no-emu‐
279              lation El Torito CDs.
280
281       -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
286       -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
290       -C last_sess_start,next_sess_start
291
292       -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
308       -c boot_catalog
309
310       -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
319              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
324       -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
331       -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
338       -checksum_algorithm_iso alg1,alg2,...
339              (not supported  by  pycdlib-genisoimage)  Specify  the  checksum
340              types desired for the output image.
341
342       -checksum_algorithm_template alg1,alg2,...
343              (not  supported  by  pycdlib-genisoimage)  Specify  the checksum
344              types desired for the output jigdo template.
345
346       -copyright file
347              Specifies copyright information, typically  a  filename  on  the
348              disc.  There is space for 37 characters.
349
350       -d
351
352       -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
358       -D
359
360       -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
367       -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
373       -debug (not supported by pycdlib-genisoimage) Set debug flag.
374
375       -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
381       -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
388              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
395       -e efi_boot_file
396
397       -efi-boot efi_boot_file
398              Set EFI boot image name.
399
400       -f
401
402       -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
408       -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
414       -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
420              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
425              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
430              -help  Lists the available find(1) syntax.
431
432              -chgrp gname
433                     The  primary  always evaluates as true; it sets the group
434                     of the file to gname.
435
436              -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
441              -chown uname
442                     The primary always evaluates as true; it sets  the  owner
443                     of the file to uname.
444
445              -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
449              -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
453              The command line:
454
455              pycdlib-genisoimage -o o.iso -find . ( -type d -ls -o false ) -o
456              ! -type d
457
458              lists all directories and puts all non-directories to the  image
459              o.iso.
460
461              The command line:
462
463              pycdlib-genisoimage  -o  o.iso  -find . ( -type d -chown root -o
464              true )
465
466              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
470              Note that the -ls, -exec and the -ok primary cannot be  used  if
471              stdin or stdout has not been redirected.
472
473       -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
478       -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
482       -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
489       -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
500       -hide-list file
501              A  file  containing a list of shell wildcards to be hidden.  See
502              -hide.
503
504       -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
513       -hidden-list file
514              A file containing a list of shell wildcards to  get  the  hidden
515              attribute.  See -hidden.
516
517       -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
528       -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
532       -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
538       -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
548       -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
558       -hide-udf-list file
559              A file containing a list of globs to be hidden as above.
560
561       -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
569       -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
575       -iso-level level
576              Set the ISO9660 conformance level. Valid numbers are 1 to 4.
577
578              With  level  1,  files may only consist of one section and file‐
579              names are restricted to 8.3 characters.
580
581              With level 2, files may only consist of one section.
582
583              With level 3, no  restrictions  (other  than  ISO-9660:1988)  do
584              apply.
585
586              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
592              Level  4  officially does not exist but pycdlib-genisoimage maps
593              it to ISO-9660:1999, which is ISO9660 version 2.
594
595              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
602              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
608       -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
617       -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
622       -jcharset charset
623              (not supported  by  pycdlib-genisoimage)  A  combination  of  -J
624              -input-charset charset.
625
626       -l
627
628       -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
636       -L     Outdated option; use -allow-leading-dots instead.
637
638       -jigdo-jigdo jigdo_file
639              (not supported by pycdlib-genisoimage) Produce  a  jigdo  .jigdo
640              metadata file as well as the filesystem image.
641
642       -jigdo-template template_file
643              (not supported by pycdlib-genisoimage) Produce a jigdo .template
644              file as well as the filesystem image.
645
646       -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
651       -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
656       -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
660       -jigdo-map path
661              (not supported by pycdlib-genisoimage) Specify a pattern mapping
662              for the jigdo file (e.g.  Debian=/mirror/debian).
663
664       -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
669       -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
674       -log-file log_file
675              Redirect  all  error,  warning  and  informational  messages  to
676              log_file instead of the standard error.
677
678       -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
684              The short ISO-9660 time format only  allows  to  represent  year
685              1900 .. year 2155 with a granularity of 1s.
686
687       -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
693                   pycdlib-genisoimage -o rom -m '*.o' -m core -m foobar
694
695              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
699       -exclude-list file
700              A file containing a list of shell wildcards to be excluded.  See
701              -m.
702
703       -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
714       -M path
715
716       -M device
717
718       -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
728       -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
734              The format of date-spec is:
735
736                   yyyy[mm[dd[hh[mm[ss]]]]][.hh][+-ghgm]
737
738              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
742              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
751              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
761                   date "+%Y-%m-%d %H:%M:%S %z"
762
763              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
766       -N
767
768       -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
774       -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
779       -nobak
780
781       -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
786       -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
794       -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
800       -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
806       -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
811       -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
817              It is questionable whether this option is useful nowadays.
818
819       -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
826              It is questionable whether this option is useful nowadays.
827
828       -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
837       -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
844              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
850       -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
855       -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
861       -P     Outdated option; use -publisher instead.
862
863       -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
869       -p preparer_id
870
871       -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
878       -posix-H
879              (not supported by pycdlib-genisoimage) Follow all symbolic links
880              encountered on command line when generating the filesystem.
881
882       -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
888       -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
894       -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
906                   cdblocks=` pycdlib-genisoimage -print-size -quiet ... `
907                   pycdlib-genisoimage ... | wodim ... tsize=${cdblocks}s -
908
909       -quiet This makes pycdlib-genisoimage even less verbose.   No  progress
910              output will be provided.
911
912       -R
913
914       -rock  Generate  SUSP  and  RR records using the Rock Ridge protocol to
915              further describe the files on the ISO9660 filesystem.
916
917       -r
918
919       -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
938       -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
944       -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
952       -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
959              If  a file system has been created with -rrip110, the Rock Ridge
960              attributes do not include inode number information.
961
962       -rrip112
963              Create ISO-9660 file system images that follow the new Rrip Ver‐
964              sion-1.12 standard from 1994.
965
966       -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
989       -s sector type
990
991       -sectype sector type
992              (not supported by pycdlib-genisoimage) Set output sector type to
993              e.g. data/xa1/raw.
994
995       -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
1012       -sparc-boot img_sun4,img_sun4c,img_sun4m,img_sun4d,img_sun4e
1013              (not supported by pycdlib-genisoimage) See -B above.
1014
1015       -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
1019       -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
1028       -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
1041              The option -stream-media-size creates simple ISO9660 filesystems
1042              only and may not  used  together  with  multisession  or  hybrid
1043              filesystem options.
1044
1045       -stream-file-name name
1046              Reserved for future use.
1047
1048       -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
1053              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
1064              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
1075              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
1080       -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
1084       -sysid ID
1085              Specifies the system ID.  There is space for 32 characters.
1086
1087       -T
1088
1089       -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
1097       -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
1103       -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
1107       -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
1114       -udf   Rationalized  UDF  with user and group set to 0 and with simpli‐
1115              fied permissions.  See -r option for more information.
1116
1117       -udf-symlinks
1118              Support symlinks in UDF filesystems. This is the default.
1119
1120       -no-udf-symlinks
1121              Do not support symlinks in UDF filesystems.
1122
1123       -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
1128       -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
1136       -U
1137
1138       -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
1148       -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
1156       -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
1163       -volset ID
1164              Specifies the volume set ID.  There is space for 128 characters.
1165
1166       -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
1172              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
1181              pycdlib-genisoimage currently does not  support  a  -volset-size
1182              that is larger than 1.
1183
1184              The  option  -volset-size must be specified before -volset-seqno
1185              on each command line.
1186
1187       -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
1193       -v
1194
1195       -verbose
1196              Verbose  execution.  If  given  twice on the command line, extra
1197              debug information will be printed.
1198
1199       -x glob
1200              Identical to -m glob.
1201
1202       -XA    Generate XA directory attruibutes.
1203
1204       -xa    Generate rationalized XA directory attruibutes.
1205
1206       -z
1207
1208       -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
1220       -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

HFS OPTIONS

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
1231       -no-hfs
1232              Do not create  an  ISO-9660/HFS  hybrid  CD  even  though  other
1233              options may imply to do so.
1234
1235       -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
1244       -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
1250       -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
1257       -hfs-creator creator
1258              (not  supported  by pycdlib-genisoimage) Set the default CREATOR
1259              for all files. Must be exactly 4 characters.
1260
1261       -hfs-type type
1262              (not supported by pycdlib-genisoimage) Set the default TYPE  for
1263              all files. Must be exactly 4 characters.
1264
1265       -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
1272       -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
1278       -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
1283       -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
1287       -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
1292       -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
1299       -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
1304       -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
1311                   pycdlib-genisoimage  -o  rom -hfs -hide-hfs '*.o' -hide-hfs
1312              foobar
1313
1314              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
1320                   pycdlib-genisoimage -o rom -hfs -hide-hfs src/html src
1321
1322              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
1329       -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
1333       -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
1338       -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
1346       -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
1352       -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
1357       -chrp-boot
1358              (not supported by pycdlib-genisoimage) Add CHRP boot header.
1359
1360       -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
1365       -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
1370       -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
1376       -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
1385       -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
1390       --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
1395       --netatalk
1396              (not supported by pycdlib-genisoimage) Look for NETATALK  Macin‐
1397              tosh files
1398
1399       --double
1400              (not supported by pycdlib-genisoimage) Look for AppleDouble Mac‐
1401              intosh files
1402
1403       --ethershare
1404              (not supported by pycdlib-genisoimage) Look  for  Helios  Ether‐
1405              Share Macintosh files
1406
1407       --ushare
1408              (not  supported by pycdlib-genisoimage) Look for IPT UShare Mac‐
1409              intosh files
1410
1411       --exchange
1412              (not supported by pycdlib-genisoimage) Look for PC Exchange Mac‐
1413              intosh files
1414
1415       --sgi  (not  supported  by  pycdlib-genisoimage) Look for SGI Macintosh
1416              files
1417
1418       --xinet
1419              (not supported by pycdlib-genisoimage) Look for XINET  Macintosh
1420              files
1421
1422       --macbin
1423              (not supported by pycdlib-genisoimage) Look for MacBinary Macin‐
1424              tosh files
1425
1426       --single
1427              (not supported by pycdlib-genisoimage) Look for AppleSingle Mac‐
1428              intosh files
1429
1430       --dave (not supported by pycdlib-genisoimage) Look for Thursby Software
1431              Systems DAVE Macintosh files
1432
1433       --sfm  (not supported by pycdlib-genisoimage) Look for Microsoft's Ser‐
1434              vices for Macintosh files (NT only) (Alpha)
1435
1436       --osx-double
1437              (not  supported by pycdlib-genisoimage) Look for Mac OS X Apple‐
1438              Double Macintosh files
1439
1440       --osx-hfs
1441              (not supported by pycdlib-genisoimage) Look for  Mac  OS  X  HFS
1442              Macintosh files
1443
1444

SEE ALSO

1446       genisoimage(1),   pycdlib-compare(1),   pycdlib-explorer(1),   pycdlib-
1447       extract-files(1)
1448
1449

AUTHOR

1451       Chris Lalancette <clalancette@gmail.com>
1452
1453
1454
1455pycdlib-genisoimage                Sep 2017             PYCDLIB-GENISOIMAGE(1)
Impressum