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 im‐
27       plemented due to the design of pycdlib.  If in  doubt,  please  ask  on
28       https://github.com/clalancette/pycdlib/issues.      Second,    pycdlib-
29       genisoimage does not output  all  of  the  same  messages  to  standard
30       out/standard  error  that genisoimage does.  Any program that relies on
31       parsing the output of genisoimage will probably not work.   Third,  py‐
32       cdlib-genisoimage  will not always generate ISOs that are 100% the same
33       as the genisoimage counterparts.  This is for  a  variety  of  reasons,
34       ranging  from  bug fixing to simple differences in implementations.  In
35       almost all cases this does not matter, but please keep it in mind  when
36       using this program instead of genisoimage.
37
38

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

HFS OPTIONS

1223       -hfs   (not supported by pycdlib-genisoimage) Create an ISO9660/HFS hy‐
1224              brid  CD.  This  option  should  be used in conjunction with the
1225              -map, -magic and/or the various double dash options given below.
1226
1227       -no-hfs
1228              Do not create an ISO-9660/HFS hybrid CD even  though  other  op‐
1229              tions may imply to do so.
1230
1231       -apple (not supported by pycdlib-genisoimage) Create an ISO9660 CD with
1232              Apple's extensions. Similar to -hfs, except that the  Apple  Ex‐
1233              tensions  to ISO9660 are added instead of creating an HFS hybrid
1234              volume.  Former pycdlib-genisoimage versions  did  include  Rock
1235              Ridge  attributes  by default if -apple was specified. This ver‐
1236              sions of pycdlib-genisoimage does not do this  anymore.  If  you
1237              like  to  have  Rock  Ridge attributes, you need to specify this
1238              separately.
1239
1240       -map mapping_file
1241              (not supported by pycdlib-genisoimage) Use the  mapping_file  to
1242              set  the  CREATOR  and  TYPE information for a file based on the
1243              filename's extension. A filename is mapped only if it is not one
1244              of the know Apple/Unix file formats.
1245
1246       -magic magic_file
1247              (not  supported by pycdlib-genisoimage) The CREATOR and TYPE in‐
1248              formation is set by using a file's  magic  number  (usually  the
1249              first  few  bytes  of  a file). The magic_file is only used if a
1250              file is not one of the known Apple/Unix  file  formats,  or  the
1251              filename extension has not been mapped using -map.
1252
1253       -hfs-creator creator
1254              (not  supported  by pycdlib-genisoimage) Set the default CREATOR
1255              for all files. Must be exactly 4 characters.
1256
1257       -hfs-type type
1258              (not supported by pycdlib-genisoimage) Set the default TYPE  for
1259              all files. Must be exactly 4 characters.
1260
1261       -probe (not  supported  by  pycdlib-genisoimage) Search the contents of
1262              files for all the known Apple/Unix file formats.   However,  the
1263              only way to check for MacBinary and AppleSingle files is to open
1264              and read them, so this option may increase processing  time.  It
1265              is  better to use one or more double dash options given below if
1266              the Apple/Unix formats in use are known.
1267
1268       -no-desktop
1269              (not supported by pycdlib-genisoimage)  Do  not  create  (empty)
1270              Desktop files. New HFS Desktop files will be created when the CD
1271              is used on a Macintosh (and stored in the  System  Folder).   By
1272              default, empty Desktop files are added to the HFS volume.
1273
1274       -mac-name
1275              (not  supported  by pycdlib-genisoimage) Use the HFS filename as
1276              the starting point for the ISO9660, Joliet and Rock Ridge  file‐
1277              names.
1278
1279       -boot-hfs-file driver_file
1280              (not  supported by pycdlib-genisoimage) Installs the driver_file
1281              that may make the CD bootable on a Macintosh.
1282
1283       -part  (not supported by pycdlib-genisoimage) Generate an HFS partition
1284              table.  By  default,  no  partition table is generated, but some
1285              older Macintosh CD-ROM drivers need an HFS  partition  table  on
1286              the CD-ROM to be able to recognize a hybrid CD-ROM.
1287
1288       -auto AutoStart_file
1289              (not  supported  by pycdlib-genisoimage) Make the HFS CD use the
1290              QuickTime 2.0 Autostart feature to launch an application or doc‐
1291              ument.  The given filename must be the name of a document or ap‐
1292              plication located at the top level of the CD. The filename  must
1293              be less than 12 characters. (Alpha).
1294
1295       -cluster-size size
1296              (not  supported by pycdlib-genisoimage) Set the size in bytes of
1297              the cluster or allocation units of PC  Exchange  files.  Implies
1298              --exchange.
1299
1300       -hide-hfs glob
1301              (not  supported by pycdlib-genisoimage) Hide glob, a shell wild‐
1302              card pattern, from the HFS volume.  The file or  directory  will
1303              still  exist  in  the ISO9660 and/or Joliet directory.  glob may
1304              match any part of the filename.  Multiple globs may be excluded.
1305              Example:
1306
1307                   pycdlib-genisoimage  -o  rom -hfs -hide-hfs '*.o' -hide-hfs
1308              foobar
1309
1310              would exclude all files ending in `.o' or called foobar from the
1311              HFS  volume.  Note that if you had a directory called foobar, it
1312              too (and of course all its descendants) would be excluded.   The
1313              glob  can also be a path name relative to the source directories
1314              given on the command line. Example:
1315
1316                   pycdlib-genisoimage -o rom -hfs -hide-hfs src/html src
1317
1318              would exclude just the file or directory called  html  from  the
1319              src  directory.   Any other file or directory called html in the
1320              tree will not be excluded.  Should be  used  with  -hide  and/or
1321              -hide-joliet.  In order to match a directory name, make sure the
1322              pattern  does  not  include  a  trailing  `/'   character.   See
1323              README.hide for more details.
1324
1325       -hide-hfs-list file
1326              (not supported by pycdlib-genisoimage) Specify a file containing
1327              a list of wildcard patterns to be hidden as in -hide-hfs.
1328
1329       -hfs-volid hfs_volid
1330              (not supported by pycdlib-genisoimage) Volume name for  the  HFS
1331              partition.  This  is  the name that is assigned to the disc on a
1332              Macintosh and replaces the volid used with -V.
1333
1334       -icon-position
1335              (not supported by pycdlib-genisoimage) Use the icon position in‐
1336              formation,  if  it  exists, from the Apple/Unix file.  The icons
1337              will appear in the same position as they would  on  a  Macintosh
1338              desktop.  Folder  location  and size on screen, its scroll posi‐
1339              tions, folder View (view as Icons, Small Icons, etc.)  are  also
1340              preserved.  (Alpha).
1341
1342       -root-info file
1343              (not supported by pycdlib-genisoimage) Set the location, size on
1344              screen, scroll positions, folder View etc. for the  root  folder
1345              of  an  HFS  volume.  See  README.rootinfo for more information.
1346              (Alpha)
1347
1348       -prep-boot file
1349              (not supported by pycdlib-genisoimage) PReP boot image file.  Up
1350              to  4  are  allowed.  See README.prep_boot for more information.
1351              (Alpha)
1352
1353       -chrp-boot
1354              (not supported by pycdlib-genisoimage) Add CHRP boot header.
1355
1356       -input-hfs-charset charset
1357              (not supported by pycdlib-genisoimage) Input  charset  that  de‐
1358              fines  the  characters  used  in  HFS  filenames  when used with
1359              -mac-name.  The default charset is cp10000 (Mac Roman).
1360
1361       -output-hfs-charset charset
1362              (not supported by pycdlib-genisoimage) Output charset  that  de‐
1363              fines the characters that will be used in the HFS filenames. De‐
1364              faults to the input charset.
1365
1366       -hfs-unlock
1367              (not supported  by  pycdlib-genisoimage)  By  default,  pycdlib-
1368              genisoimage  will create an HFS volume that is locked.  This op‐
1369              tion leaves the volume unlocked so that other applications (e.g.
1370              hfsutils) can modify the volume.
1371
1372       -hfs-bless folder_name
1373              (not  supported by pycdlib-genisoimage) "Bless" the given direc‐
1374              tory (folder). This is usually the System Folder and is used  in
1375              creating HFS bootable CDs. The name of the directory must be the
1376              whole path name as pycdlib-genisoimage sees it.   E.g.,  if  the
1377              given  pathspec  is  ./cddata  and the required folder is called
1378              System Folder, the whole path name  is  "/cddata/System  Folder"
1379              (remember to use quotes if the name contains spaces).
1380
1381       -hfs-parms parameters
1382              (not  supported by pycdlib-genisoimage) Override certain parame‐
1383              ters used to create the HFS filesystem. Unlikely to be  used  in
1384              normal circumstances.
1385
1386       --cap  (not  supported by pycdlib-genisoimage) Look for AUFS CAP Macin‐
1387              tosh files. Search for CAP Apple/Unix file formats only. Search‐
1388              ing  for the other possible Apple/Unix file formats is disabled,
1389              unless other double dash options are given.
1390
1391       --netatalk
1392              (not supported by pycdlib-genisoimage) Look for NETATALK  Macin‐
1393              tosh files
1394
1395       --double
1396              (not supported by pycdlib-genisoimage) Look for AppleDouble Mac‐
1397              intosh files
1398
1399       --ethershare
1400              (not supported by pycdlib-genisoimage) Look  for  Helios  Ether‐
1401              Share Macintosh files
1402
1403       --ushare
1404              (not  supported by pycdlib-genisoimage) Look for IPT UShare Mac‐
1405              intosh files
1406
1407       --exchange
1408              (not supported by pycdlib-genisoimage) Look for PC Exchange Mac‐
1409              intosh files
1410
1411       --sgi  (not  supported  by  pycdlib-genisoimage) Look for SGI Macintosh
1412              files
1413
1414       --xinet
1415              (not supported by pycdlib-genisoimage) Look for XINET  Macintosh
1416              files
1417
1418       --macbin
1419              (not supported by pycdlib-genisoimage) Look for MacBinary Macin‐
1420              tosh files
1421
1422       --single
1423              (not supported by pycdlib-genisoimage) Look for AppleSingle Mac‐
1424              intosh files
1425
1426       --dave (not supported by pycdlib-genisoimage) Look for Thursby Software
1427              Systems DAVE Macintosh files
1428
1429       --sfm  (not supported by pycdlib-genisoimage) Look for Microsoft's Ser‐
1430              vices for Macintosh files (NT only) (Alpha)
1431
1432       --osx-double
1433              (not  supported by pycdlib-genisoimage) Look for Mac OS X Apple‐
1434              Double Macintosh files
1435
1436       --osx-hfs
1437              (not supported by pycdlib-genisoimage) Look for  Mac  OS  X  HFS
1438              Macintosh files
1439
1440

SEE ALSO

1442       genisoimage(1), pycdlib-explorer(1), pycdlib-extract-files(1)
1443
1444

AUTHOR

1446       Chris Lalancette <clalancette@gmail.com>
1447
1448
1449
1450pycdlib-genisoimage                Sep 2017             PYCDLIB-GENISOIMAGE(1)
Impressum