Provided by: python3-pycdlib_1.11.0-0ubuntu1_all bug

NAME

       pycdlib-genisoimage - tool to master ISOs using pycdlib

SYNOPSIS

       pycdlib-genisoimage [options] [-o filename] pathspec [pathspec ...]

DESCRIPTION

       pycdlib-genisoimage  is a pre-mastering program to generate ISO9660/Joliet/HFS hybrid filesystems.  It is
       meant to be 100% flag-compatible with the original genisoimage program so that it  can  be  dropped  into
       existing  scripts with no changes.  Please see the man page for genisoimage for more detailed explanation
       of the options to this program.  There are a few  differences  to  note  between  this  program  and  the
       original  genisoimage.   First,  not all of the options are implemented in this program.  This means that
       pycdlib-genisoimage will silently ignore some flags; for the most common usage of this program, this will
       not matter.  However, if you are trying to do something odd and specific, it may  not  work.   The  flags
       that this applies to are noted in the OPTIONS below.  In some cases these flags can be implemented with a
       bit  of  work,  and in some cases the flags can never be implemented due to the design of pycdlib.  If in
       doubt, please ask on https://github.com/clalancette/pycdlib/issues.  Second, pycdlib-genisoimage does not
       output all of the same messages to standard out/standard error that genisoimage does.  Any  program  that
       relies  on parsing the output of genisoimage will probably not work.  Third, pycdlib-genisoimage will not
       always generate ISOs that are 100% the same as the genisoimage counterparts.  This is for  a  variety  of
       reasons, ranging from bug fixing to simple differences in implementations.  In almost all cases this does
       not matter, but please keep it in mind when using this program instead of genisoimage.

OPTIONS

       -abstract file
              Specifies the abstract filename.  There is space for 37 characters.

       -A application_id

       -appid application_id
              Specifies  a  text  string  that will be written into the volume header.  This should describe the
              application that will be on the disc.  There is space for 128 characters.

       -allow-limited-size
              (not supported by pycdlib-genisoimage) When processing files larger  than  2GiB  which  cannot  be
              easily  represented  in  ISO9660, add them with a shrunk visible file size to ISO9660 and with the
              correct visible file size to the UDF system. The result is an inconsistent  filesystem  and  users
              need to make sure that they really use UDF rather than ISO9660 driver to read a such disk. Implies
              enabling -udf.

       -allow-leading-dots

       -ldots (not supported by pycdlib-genisoimage) Allow ISO9660 filenames to begin with a period.  Usually, a
              leading dot is replaced with an underscore in order to maintain MS-DOS compatibility.
              This violates the ISO9660 standard, but it happens to work on many systems.  Use with caution.

       -allow-lowercase
              (not  supported  by  pycdlib-genisoimage)  This  options  allows lowercase characters to appear in
              ISO9660 filenames.
              This violates the ISO9660 standard, but it happens to work on some systems.  Use with caution.

       -allow-multidot
              (not supported by pycdlib-genisoimage) This options allows more than one dot to appear in  ISO9660
              filenames.   A  leading  dot  is  not  affected by this option, it may be allowed separately using
              -allow-leading-dots.
              This violates the ISO9660 standard, but it happens to work on many systems.  Use with caution.

       -biblio file
              Specifies the bibliographic filename.  There is space for 37 characters.

       -cache-inodes

       -no-cache-inodes
              (not supported by pycdlib-genisoimage) Enable or disable caching inode and device numbers to  find
              hard  links  to files.  If pycdlib-genisoimage finds a hard link (a file with multiple names), the
              file will also be hard-linked on the CD, so the file contents only appear  once.   This  helps  to
              save  space.   -cache-inodes  is  default  on Unix-like operating systems, but -no-cache-inodes is
              default on some other systems such as Cygwin, because it is not safe to assume that inode  numbers
              are  unique  on  those  systems.   (Some versions of Cygwin create fake inode numbers using a weak
              hashing algorithm, which may produce duplicates.)  If two files have the same inode number but are
              not hard links to the same file, pycdlib-genisoimage  -cache-inodes  will  not  behave  correctly.
              -no-cache-inodes  is  safe  in  all situations, but in that case pycdlib-genisoimage cannot detect
              hard links, so the resulting CD image may be larger than necessary.

       -alpha-boot alpha_boot_image
              (not supported by pycdlib-genisoimage) Specifies the path and filename of the  boot  image  to  be
              used  when  making  an  Alpha/SRM  bootable  CD.  The pathname must be relative to the source path
              specified to pycdlib-genisoimage.

       -hppa-bootloader hppa_bootloader_image
              (not supported by pycdlib-genisoimage) Specifies the path and filename of the  boot  image  to  be
              used  when  making an HPPA bootable CD. The pathname must be relative to the source path specified
              to pycdlib-genisoimage.  Other options are required, at the very least a  kernel  filename  and  a
              boot command line.

       -hppa-cmdline hppa_boot_command_line
              (not  supported  by  pycdlib-genisoimage) Specifies the command line to be passed to the HPPA boot
              loader when making a bootable CD. Separate the parameters with spaces or commas. More options must
              be passed to pycdlib-genisoimage, at the  very  least  a  kernel  filename  and  the  boot  loader
              filename.

       -hppa-kernel-32 hppa_kernel_32

       -hppa-kernel-64 hppa_kernel_64
              (not supported by pycdlib-genisoimage) Specifies the path and filename of the 32-bit and/or 64-bit
              kernel  images  to  be used when making an HPPA bootable CD. The pathnames must be relative to the
              source path specified to pycdlib-genisoimage.  Other options are required, at the very  least  the
              boot loader filename and the boot command line.

       -hppa-ramdisk hppa_ramdisk_image
              (not  supported by pycdlib-genisoimage) Specifies the path and filename of the ramdisk image to be
              used when making an HPPA bootable CD. The pathname must be relative to the source  path  specified
              to  pycdlib-genisoimage.   This  parameter  is  optional.  Other options are required, at the very
              least a kernel filename and the boot command line.

       -mips-boot mips_boot_image
              (not supported by pycdlib-genisoimage) Specifies the path and filename of the  boot  image  to  be
              used  when  making an SGI/big-endian MIPS bootable CD. The pathname must be relative to the source
              path specified to pycdlib-genisoimage.  This option may be specified several times, to store up to
              15 boot images.

       -mipsel-boot mipsel_boot_image
              (not supported by pycdlib-genisoimage) Specifies the path and filename of the  boot  image  to  be
              used  when  making  an  DEC/little-endian  MIPS  bootable CD. The pathname must be relative to the
              source path specified to pycdlib-genisoimage.

       -B img_sun4,img_sun4c,img_sun4m,img_sun4d,img_sun4e

       -sparc-boot img_sun4,img_sun4c,img_sun4m,img_sun4d,img_sun4e
              (not supported by pycdlib-genisoimage) Specifies a comma-separated list of boot  images  that  are
              needed  to  make  a bootable CD for SPARC systems.  Partition 0 is used for the ISO9660 image, the
              first image file is mapped to partition 1.  The comma-separated list may  have  up  to  7  fields,
              including  empty fields.  This option is required to make a bootable CD for Sun SPARC systems.  If
              -B or -sparc-boot has been specified, the first sector of the resulting image will contain  a  Sun
              disk label. This disk label specifies slice 0 for the ISO9660 image and slices 1 to 7 for the boot
              images  that  have  been  specified  with this option. Byte offsets 512 to 8191 within each of the
              additional boot images  must  contain  a  primary  boot  that  works  for  the  appropriate  SPARC
              architecture.  The  rest  of  each  of  the  images usually contains a UFS filesystem used for the
              primary kernel boot stage.

              The implemented boot method is the one found with SunOS 4.x and SunOS 5.x.  However, it  does  not
              depend on SunOS internals but only on properties of the Open Boot prom, so it should be usable for
              any OS for SPARC systems.  For more information also see the NOTES section below.

              If  the  special filename ...  is used, the actual and all following boot partitions are mapped to
              the previous partition. If pycdlib-genisoimage is called with -G image -B ...  all boot partitions
              are mapped to the partition that contains the ISO9660 filesystem image and the generic boot  image
              that is located in the first 16 sectors of the disc is used for all architectures.

       -G generic_boot_image
              (not  supported  by pycdlib-genisoimage) Specifies the path and filename of the generic boot image
              to be used when making a generic bootable CD.  The boot image will  be  placed  on  the  first  16
              sectors  of the CD, before the ISO9660 primary volume descriptor.  If this option is used together
              with -sparc-boot, the Sun disk label will overlay the first 512 bytes of the generic boot image.

       -b eltorito_boot_image

       -eltorito-boot eltorito_boot_image
              Specifies the path and filename of the boot image to be used when making an El Torito bootable  CD
              for  x86  PCs.  The pathname must be relative to the source path specified to pycdlib-genisoimage.
              This option is required to make an El Torito bootable CD.  The boot image must be exactly 1200 kB,
              1440 kB or 2880 kB, and pycdlib-genisoimage will use this size when creating  the  output  ISO9660
              filesystem.  The PC BIOS will use the image to emulate a floppy disk, so the first 512-byte sector
              should  contain PC boot code.  This will work, for example, if the boot image is a LILO-based boot
              floppy.

              If the boot image is not an image  of  a  floppy,  you  need  to  add  either  -hard-disk-boot  or
              -no-emul-boot.  If the system should not boot off the emulated disk, use -no-boot.

              If  -sort  has  not  been  specified,  the  boot  images  are sorted with low priority (+2) to the
              beginning of the medium.  If you don't like this, you need to specify a sort weight of 0  for  the
              boot images.

       -eltorito-alt-boot
              Start  with a new set of El Torito boot parameters.  Up to 63 El Torito boot entries may be stored
              on a single CD.

       -hard-disk-boot
              Specifies that the boot image used to create El Torito bootable CDs is  a  hard  disk  image.  The
              image must begin with a master boot record that contains a single partition.

       -eltorito-platform id
              (not  supported  by  pycdlib-genisoimage)  Set  the "El Torito" platform id for a boot record or a
              section of boot records.  The id parameter may be either:

              x86    This is the default platform id value and specifies entries for the  PC  platform.   If  no
                     -eltorito-platform  option appears before the first -eltorito-boot option, the default boot
                     entry becomes an entry for the x86 PC platform.

              PPC    Boot entries for the Power PC platform.

              Mac    Boot entries for the Apple Mac platform.

              efi    Boot entries for EFI based PCs.

              #      A numeric value specifying any platform id.

              If the option -eltorito-platform appears before the  first  -eltorito-boot  option,  it  sets  the
              platform id for the default boot entry.

              If  the  option -eltorito-platform appears after an -eltorito-boot option and sets the platform id
              to a value different from the previous value, it starts a new set of boot entries.

              The second boot entry and any new platform id creates a new section header and reduces the  number
              of boot entries per CD by one.

       -ignore-error
              (not  supported  by  pycdlib-genisoimage) Ignore errors.  pycdlib-genisoimage by default aborts on
              several errors, such as read errors. With this option  in  effect,  pycdlib-genisoimage  tries  to
              continue.  Use with care.

       -no-emul-boot
              Specifies that the boot image used to create El Torito bootable CDs is a "no emulation" image. The
              system will load and execute this image without performing any disk emulation.

       -no-boot
              Specifies  that the created El Torito CD should be marked as not bootable. The system will provide
              an emulated drive for the image, but will boot off a standard boot device.

       -boot-load-seg segment_address
              Specifies the load segment address of the boot image for no-emulation El Torito CDs.

       -boot-load-size load_sectors
              Specifies the number of "virtual" (512-byte) sectors to load in no-emulation mode.  The default is
              to load the entire boot file.  Some BIOSes may have problems if this is not a multiple of 4.

       -boot-info-table
              Specifies that a 56-byte table with information of the CD-ROM layout will be patched in at  offset
              8 in the boot file.

       -C last_sess_start,next_sess_start

       -cdrecord-params last_sess_start,next_sess_start
              (not  supported by pycdlib-genisoimage) This option is needed to create a CD Extra or the image of
              a second session or a higher-level  session  for  a  multisession  disc.   -C  takes  two  numbers
              separated by a comma. The first is the first sector in the last session of the disc that should be
              appended  to.   The  second  number is the starting sector number of the new session.  The correct
              numbers may be retrieved by calling wodim -msinfo ...  If -C  is  used  in  conjunction  with  -M,
              pycdlib-genisoimage  will  create  a filesystem image that is intended to be a continuation of the
              previous session.  If -C is used without -M, pycdlib-genisoimage will create  a  filesystem  image
              that  is  intended  to  be used for a second session on a CD Extra. This is a multisession CD that
              holds audio data in the first session and an ISO9660 filesystem in the second session.

       -c boot_catalog

       -eltorito-catalog boot_catalog
              Specifies the path and filename of the boot catalog, which is required for an El  Torito  bootable
              CD.  The pathname must be relative to the source path specified to pycdlib-genisoimage.  This file
              will be inserted into the output tree and not created in the source filesystem,  so  be  sure  the
              specified filename does not conflict with an existing file, or it will be excluded. Usually a name
              like boot.catalog is chosen.

              If  -sort  has not been specified, the boot catalog sorted with low priority (+1) to the beginning
              of the medium.  If you don't like this, you need to specify a  sort  weight  of  0  for  the  boot
              catalog.

       -check-oldnames
              (not  supported  by  pycdlib-genisoimage)  Check  all  filenames imported from the old session for
              compliance with the ISO9660 file naming rules.  Without this option, only  names  longer  than  31
              characters are checked, as these files are a serious violation of the ISO9660 standard.

       -check-session file
              (not  supported by pycdlib-genisoimage) Check all old sessions for compliance with actual pycdlib-
              genisoimage ISO9660 file naming rules.  This is a high-level option that combines -M file  -C  0,0
              -check-oldnames.  For the parameter file, see the description of -M.

       -checksum_algorithm_iso alg1,alg2,...
              (not supported by pycdlib-genisoimage) Specify the checksum types desired for the output image.

       -checksum_algorithm_template alg1,alg2,...
              (not  supported  by  pycdlib-genisoimage)  Specify the checksum types desired for the output jigdo
              template.

       -copyright file
              Specifies copyright information, typically a  filename  on  the  disc.   There  is  space  for  37
              characters.

       -d

       -omit-period
              (not supported by pycdlib-genisoimage) Do not append a period to files that do not have one.
              This violates the ISO9660 standard, but it happens to work on many systems.  Use with caution.

       -D

       -disable-deep-relocation
              (not supported by pycdlib-genisoimage) Do not use deep directory relocation, and instead just pack
              them in the way we see them.
              If  ISO9660:1999 has not been selected, this violates the ISO9660 standard, but it happens to work
              on many systems.  Use with caution.

       -data-change-warn
              (not supported by pycdlib-genisoimage) If the size of a file  changes  while  the  file  is  being
              archived, treat this condition as a warning only that does not cause pycdlib-genisoimage to abort.

       -debug (not supported by pycdlib-genisoimage) Set debug flag.

       -dir-mode mode
              (not  supported by pycdlib-genisoimage) Overrides the mode of directories used to create the image
              to mode, specified as 4 digits of permission bits  as  in  chmod(1).   This  option  automatically
              enables Rock Ridge extensions.

       -dvd-video
              (not supported by pycdlib-genisoimage) Generate a DVD-Video compliant UDF filesystem. This is done
              by  sorting  the  order  of the content of the appropriate files and by adding padding between the
              files if needed.  Note that the sorting only works if the DVD-Video  filenames  include  uppercase
              characters only.

              Note  that in order to get a DVD-Video compliant filesystem image, you need to prepare a DVD-Video
              compliant directory tree.  This requires a directory VIDEO_TS (all caps) in the root directory  of
              the  resulting  DVD, and usually another directory AUDIO_TS.  VIDEO_TS needs to include all needed
              files (filenames must be all caps) for a compliant DVD-Video filesystem.

       -e efi_boot_file

       -efi-boot efi_boot_file
              Set EFI boot image name.

       -f

       -follow-links
              (not supported by pycdlib-genisoimage) Follow symbolic links when generating the filesystem.  When
              this option is not in use, symbolic links will be entered using Rock Ridge if  enabled,  otherwise
              they will be ignored.

       -file-mode mode
              (not  supported  by  pycdlib-genisoimage)  Overrides  the mode of regular files used to create the
              image to mode, specified as 4 digits of permission bits as in chmod(1).  This option automatically
              enables Rock Ridge extensions.

       -find  (not supported by pycdlib-genisoimage) This option acts a separator.  If it is used, all  pycdlib-
              genisoimage  options  must  be  to the left of the -find option. To the right of the -find option,
              pycdlib-genisoimage accepts the find command line syntax only.

              The find expression acts as a filter between the source of file names and the consumer,  which  is
              archiving engine.  If the find expression evaluated as TRUE, then the related file is selected for
              processing, otherwise it is omited.

              In  order  to  make  the  evaluation  of  the find expression more convenient, pycdlib-genisoimage
              implements additional find primaries that have side effects  on  the  file  meta  data.   pycdlib-
              genisoimage implements the following additional find primaries:

              -help  Lists the available find(1) syntax.

              -chgrp gname
                     The primary always evaluates as true; it sets the group of the file to gname.

              -chmod mode
                     The  primary  always evaluates as true; it sets the permissions of the file to mode.  Octal
                     and symbolic permissions are accepted for mode as with chmod(1).

              -chown uname
                     The primary always evaluates as true; it sets the owner of the file to uname.

              -false The primary always evaluates as false; it allows to make the result of the full  expression
                     different from the result of a part of the expression.

              -true  The  primary  always evaluates as true; it allows to make the result of the full expression
                     different from the result of a part of the expression.

              The command line:

              pycdlib-genisoimage -o o.iso -find . ( -type d -ls -o false ) -o ! -type d

              lists all directories and puts all non-directories to the image o.iso.

              The command line:

              pycdlib-genisoimage -o o.iso -find . ( -type d -chown root -o true )

              archives all directories so they appear to be owned by root in the  archive,  all  non-directories
              are archived as they are in the file system.

              Note  that  the  -ls,  -exec  and  the  -ok primary cannot be used if stdin or stdout has not been
              redirected.

       -gid gid
              (not supported by pycdlib-genisoimage) Overrides the group ID read from the source  files  to  the
              value of gid.  Specifying this option automatically enables Rock Ridge extensions.

       -gui   (not  supported  by  pycdlib-genisoimage) Switch the behaviour for a GUI. This currently makes the
              output more verbose but may have other effects in the future.

       -graft-points
              (not supported by pycdlib-genisoimage) Allow use of graft points for filenames. If this option  is
              used,  all  filenames are checked for graft points. The filename is divided at the first unescaped
              equal sign. All occurrences of `\' and `=' characters must be escaped with  `\'  if  -graft-points
              has been specified.

       -hide glob
              Hide  any  files  matching  glob, a shell wildcard pattern, from being seen in the ISO9660 or Rock
              Ridge directory.  glob may match any part of the filename or path.  If glob matches  a  directory,
              the  contents of that directory will be hidden.  In order to match a directory name, make sure the
              pathname does not include a trailing `/' character.  All the hidden files will still be written to
              the output CD image file.  See also -hide-joliet,  and  README.hide.   This  option  may  be  used
              multiple times.

       -hide-list file
              A file containing a list of shell wildcards to be hidden.  See -hide.

       -hidden glob
              Add  the hidden (existence) ISO9660 directory attribute for files and directories matching glob, a
              shell wildcard pattern.  This attribute will prevent the files from being shown by some MS-DOS and
              Windows commands.  glob may match any part of the filename or path.  In order to match a directory
              name, make sure the pathname does not include a trailing `/' character.  This option may  be  used
              multiple times.

       -hidden-list file
              A file containing a list of shell wildcards to get the hidden attribute.  See -hidden.

       -hide-joliet glob
              Hide  files and directories matching glob, a shell wildcard pattern, from being seen in the Joliet
              directory.  glob may match any part of the filename or path.  If glob  matches  a  directory,  the
              contents  of  that  directory  will  be hidden.  In order to match a directory name, make sure the
              pathname does not include a trailing `/' character.  All the hidden files will still be written to
              the output CD image file.  This option is usually used with -hide.  See  also  README.hide.   This
              option may be used multiple times.

       -hide-joliet-list file
              A file containing a list of shell wildcards to be hidden from the Joliet tree.  See -hide-joliet.

       -hide-joliet-trans-tbl
              (not supported by pycdlib-genisoimage) Hide the TRANS.TBL files from the Joliet tree.  These files
              usually don't make sense in the Joliet world as they list the real name and the ISO9660 name which
              may both be different from the Joliet name.

       -hide-rr-moved
              Rename  the  directory RR_MOVED to .rr_moved in the Rock Ridge tree.  It seems to be impossible to
              completely hide the RR_MOVED directory from the Rock Ridge  tree.   This  option  only  makes  the
              visible  tree less confusing for people who don't know what this directory is for.  If you need to
              have no RR_MOVED directory at all, you should use -D.  Note that if -D  has  been  specified,  the
              resulting  filesystem  is  not  ISO9660 level-1 compliant and will not be readable on MS-DOS.  See
              also the NOTES section.

       -hide-udf glob
              Hide glob from being seen on the UDF directory.  glob is a shell wild-card-style pattern that must
              match any part of the filename or path.   Multiple  globs  may  be  hidden.   If  glob  matches  a
              directory,  then  the  contents  of  that directory will be hidden.  In order to match a directory
              name, make sure the pathname does not include a trailing '/' character.  All the hidden files will
              still be written to the output CD image file.  Should be used with the -hide option.

       -hide-udf-list file
              A file containing a list of globs to be hidden as above.

       -input-charset charset
              (not supported by pycdlib-genisoimage) Input charset that defines the  characters  used  in  local
              filenames.   To  get  a list of valid charset names, call pycdlib-genisoimage -input-charset help.
              To get a 1:1 mapping, you may use default as charset name. The default initial values are cp437 on
              DOS-based systems and iso8859-1 on all other systems.

       -output-charset charset
              (not supported by pycdlib-genisoimage) Output charset that defines the  characters  that  will  be
              used  in  Rock  Ridge filenames.  Defaults to the input charset.  See CHARACTER SETS section below
              for more details.

       -iso-level level
              Set the ISO9660 conformance level. Valid numbers are 1 to 4.

              With level 1, files may  only  consist  of  one  section  and  filenames  are  restricted  to  8.3
              characters.

              With level 2, files may only consist of one section.

              With level 3, no restrictions (other than ISO-9660:1988) do apply.

              With  all  ISO9660  levels from 1 to 3, all filenames are restricted to uppercase letters, numbers
              and underscores (_). Filenames are limited to 31 characters, directory nesting  is  limited  to  8
              levels, and pathnames are limited to 255 characters.

              Level  4  officially  does  not  exist  but pycdlib-genisoimage maps it to ISO-9660:1999, which is
              ISO9660 version 2.

              With level 4, an enhanced volume descriptor with version number and file structure version  number
              set to 2 is emitted.  Directory nesting is not limited to 8 levels, there is no need for a file to
              contain  a  dot  and  the  dot  has no special meaning, filenames do not have version numbers, and
              filenames can be up to 207 characters long, or 197 characters if Rock Ridge is used.

              When creating Version 2 images, pycdlib-genisoimage emits an enhanced volume  descriptor,  similar
              but  not  identical  to a primary volume descriptor. Be careful not to use broken software to make
              ISO9660 images bootable by assuming a second PVD copy and patching this putative PVD copy into  an
              El Torito VD.

       -J     Generate  Joliet  directory  records  in addition to regular ISO9660 filenames.  This is primarily
              useful when the discs are to be used on Windows  machines.   Joliet  filenames  are  specified  in
              Unicode  and each path component can be up to 64 Unicode characters long.  Note that Joliet is not
              a standard — only Microsoft Windows and Linux systems can read  Joliet  extensions.   For  greater
              portability, consider using both Joliet and Rock Ridge extensions.

       -joliet-long
              (not  supported by pycdlib-genisoimage) Allow Joliet filenames to be up to 103 Unicode characters,
              instead of 64.  This breaks the Joliet specification, but appears to work. Use with caution.

       -jcharset charset
              (not supported by pycdlib-genisoimage) A combination of -J -input-charset charset.

       -l

       -full-iso9660-filenames
              (not supported by pycdlib-genisoimage) Allow full 31-character filenames.   Normally  the  ISO9660
              filename  will  be  in  an  8.3  format  which  is compatible with MS-DOS, even though the ISO9660
              standard allows filenames of up to 31 characters.  If  you  use  this  option,  the  disc  may  be
              difficult to use on a MS-DOS system, but will work on most other systems.  Use with caution.

       -L     Outdated option; use -allow-leading-dots instead.

       -jigdo-jigdo jigdo_file
              (not  supported  by  pycdlib-genisoimage)  Produce  a  jigdo  .jigdo  metadata file as well as the
              filesystem image.

       -jigdo-template template_file
              (not supported by pycdlib-genisoimage) Produce a jigdo .template file as well  as  the  filesystem
              image.

       -jigdo-min-file-size size
              (not  supported  by  pycdlib-genisoimage)  Specify the minimum size for a file to be listed in the
              .jigdo file. Default (and minimum allowed) is 1KB.

       -jigdo-force-md5 path
              (not supported by pycdlib-genisoimage) Specify a file pattern where files must be contained in the
              externally-supplied MD5 list as supplied by -md5-list.

       -jigdo-exclude path
              (not supported by pycdlib-genisoimage) Specify a file pattern where files will not  be  listed  in
              the .jigdo file.

       -jigdo-map path
              (not  supported  by  pycdlib-genisoimage)  Specify  a  pattern  mapping  for  the jigdo file (e.g.
              Debian=/mirror/debian).

       -md5-list md5_file
              (not supported by pycdlib-genisoimage) Specify a file containing the MD5sums, sizes and  pathnames
              of the files to be included in the .jigdo file.

       -jigdo-template-compress algorithm
              (not  supported  by pycdlib-genisoimage) Specify a compression algorithm to use for template date.
              gzip and bzip2 are currently supported, and gzip is the default.

       -log-file log_file
              Redirect all error, warning and informational messages to log_file instead of the standard error.

       -long-rr-time
              (not supported by pycdlib-genisoimage) Use the long ISO-9660 time format for the file time  stamps
              used  in  Rock Ridge.  This time format allows to represent year 0 .. year 9999 with a granularity
              of 10ms.

              The short ISO-9660 time format only allows to represent year 1900 .. year 2155 with a  granularity
              of 1s.

       -m glob
              Exclude  files  matching  glob,  a shell wildcard pattern, from being written to CD-ROM.  glob may
              match either the filename component or the full pathname.  This option may be used multiple times.
              For example:

                   pycdlib-genisoimage -o rom -m '*.o' -m core -m foobar

              would exclude all files ending in `.o', or called core or foobar from the image.  Note that if you
              had a directory called foobar, it too (and of course all its descendants) would be excluded.

       -exclude-list file
              A file containing a list of shell wildcards to be excluded.  See -m.

       -max-iso9660-filenames
              (not supported by pycdlib-genisoimage) Allow ISO9660 filenames to be up  to  37  characters  long.
              This  option  enables -N as the extra name space is taken from the space reserved for file version
              numbers.
              This violates the ISO9660 standard, but it happens to work on many systems.  Although a conforming
              application needs to provide a buffer space of at least 37 characters,  discs  created  with  this
              option may cause a buffer overflow in the reading operating system. Use with extreme care.

       -M path

       -M device

       -dev device
              (not  supported by pycdlib-genisoimage) Specifies path to existing ISO9660 image to be merged. The
              alternate form takes a SCSI device specifier that uses the same syntax as the  dev=  parameter  of
              wodim.   The  output  of pycdlib-genisoimage will be a new session which should get written to the
              end of the image specified in -M.  Typically this requires  multisession  capability  for  the  CD
              recorder used to write the image.  This option may only be used in conjunction with -C.

       -modification-date date-spec
              (not  supported by pycdlib-genisoimage) Set the modification date in the primary volume descriptor
              (PVD) to a value different from the current time.  This allows e.g. to set up an intentional  UUID
              for grub.

              The format of date-spec is:

                   yyyy[mm[dd[hh[mm[ss]]]]][.hh][+-ghgm]

              The  fields  are year, month, day of month, hour, minute, second, hundreds of a second, GMT offset
              in hours and minutes.  The time is interpreted as local time.

              Year and the GMT offset are four digit fields, all other fields take two digits.  The  GMT  offset
              may  be  between  -12  and +13 hours in 15 minute steps. Locations east to Greenwich have positive
              values. The value is the sum of the time zone offset and the effects from  daylight  saving  time.
              Omited  values  are  replaced  by the minimal possible values.  If the GMT offset is omited, it is
              computed from the local time value that has been supplied.

              Between year and month as well as between month and day of month, a separator chosen from '/'  and
              '-'  may  appear. In this case, the year may be a two digit number with values 69..99 representing
              1969..1999 and values 00..68 representing 2000..2068.  Between date and  time  spec,  an  optional
              space  is permitted. Between hours and minutes as well as between minutes and seconds, an optional
              ':' separator is permitted.  This allows pycdlib-genisoimage  to  parse  the  popular  POSIX  date
              format created by:

                   date "+%Y-%m-%d %H:%M:%S %z"

              Note that the possible range for date-spec for 32 bit programs is limited to values up to 2038 Jan
              19 04:14:07 GMT.

       -N

       -omit-version-number
              (not supported by pycdlib-genisoimage) Omit version numbers from ISO9660 filenames.
              This  violates  the ISO9660 standard, but no one really uses the version numbers anyway.  Use with
              caution.

       -new-dir-mode mode
              (not supported by pycdlib-genisoimage) Specify the mode, a 4-digit number as used in chmod(1),  to
              use when creating new directories in the filesystem image.  The default is 0555.

       -nobak

       -no-bak
              Exclude  backup  files  files  on  the  ISO9660  filesystem;  that  is, filenames that contain the
              characters `~' or `#' or end in .bak.  These are typically backup files for Unix text editors.

       -no-limit-pathtables
              (not supported by pycdlib-genisoimage) A ISO-9660 filesystem contains path tables that  contain  a
              list  of directories.  This list may contain many directories but only 65535 of them may be parent
              directories.  When -no-limit-pathtables is in use, further parent directories will  be  folded  to
              the root directory and the resulting filesystem will no longer be usable on DOS.

       -no-long-rr-time
              (not supported by pycdlib-genisoimage) Use the short ISO-9660 time format for the file time stamps
              used  in  Rock  Ridge.   This  time  format  allows  to  represent  year  1990 .. year 2155 with a
              granularity of one second.

       -force-rr
              (not supported by pycdlib-genisoimage) Do not use the automatic Rock Ridge attributes  recognition
              for  previous  sessions.  This can work around problems with images created by, e.g., NERO Burning
              ROM.

       -no-rr (not supported by pycdlib-genisoimage)  Do  not  use  the  Rock  Ridge  attributes  from  previous
              sessions.   This  may  help  to  avoid  problems when pycdlib-genisoimage finds illegal Rock Ridge
              signatures on an old session.

       -no-split-symlink-components
              (not supported by pycdlib-genisoimage) Don't  split  the  symlink  components,  but  begin  a  new
              Continuation  Area (CE) instead. This may waste some space, but the SunOS 4.1.4 cdrom driver has a
              bug in reading split symlink components.

              It is questionable whether this option is useful nowadays.

       -no-split-symlink-fields
              (not  supported  by  pycdlib-genisoimage)  Don't  split  the  symlink  fields,  but  begin  a  new
              Continuation  Area  (CE) instead. This may waste some space, but the SunOS 4.1.4 and Solaris 2.5.1
              cdrom driver have a bug in reading split symlink fields (a `/' can be dropped).

              It is questionable whether this option is useful nowadays.

       -o filename
              Specify the output file for the the ISO9660 filesystem image.  This can be a  disk  file,  a  tape
              drive,  or  it  can  correspond  directly  to  the device name of the optical disc writer.  If not
              specified, stdout is used.  Note that the output can also be a block device  for  a  regular  disk
              partition,  in  which  case  the  ISO9660 filesystem can be mounted normally to verify that it was
              generated correctly.

       -pad   (not supported by pycdlib-genisoimage) Pad the end of the whole image by  150  sectors  (300  kB).
              This  option  is  enabled by default.  If used in combination with -B, padding is inserted between
              the ISO9660 partition and the boot partitions, such that the first  boot  partition  starts  on  a
              sector number that is a multiple of 16.

              The  padding  is  needed as many operating systems (e.g. Linux) implement read-ahead bugs in their
              filesystem I/O. These bugs result in read errors on files that are  located  near  the  end  of  a
              track,  particularly  if  the  disc  is  written  in Track At Once mode, or where a CD audio track
              follows the data track.

       -no-pad
              (not supported by pycdlib-genisoimage) Do not pad the end by 150 sectors (300 kB) and do not  make
              the the boot partitions start on a multiple of 16 sectors.

       -path-list file
              A  file  containing  a  list  of  pathspec  directories  and  filenames to be added to the ISO9660
              filesystem. This list of pathspecs are processed after any that appear on the command line. If the
              argument is -, the list is read from the standard input.

       -P     Outdated option; use -publisher instead.

       -publisher publisher_id
              Specifies a text string that will be written into the volume header.   This  should  describe  the
              publisher  of the CD-ROM, usually with a mailing address and phone number.  There is space for 128
              characters.

       -p preparer_id

       -preparer preparer_id
              Specifies a text string that will be written into the volume header.   This  should  describe  the
              preparer  of  the  CD-ROM, usually with a mailing address and phone number.  There is space on the
              disc for 128 characters of information.  The related Joliet entry is limited to 64 characters.

       -posix-H
              (not supported by pycdlib-genisoimage) Follow all symbolic links encountered on command line  when
              generating the filesystem.

       -posix-L
              (not  supported  by pycdlib-genisoimage) Follow all symbolic links when generating the filesystem.
              When this option is not in use, symbolic links will  be  entered  using  Rock  Ridge  if  enabled,
              otherwise the file will be ignored.

       -posix-P
              (not supported by pycdlib-genisoimage) Do not follow symbolic links when generating the filesystem
              (this  is  the default).  If -posix-P is specified after -posix-H or -posix-L, the effect of these
              options will be reset.

       -print-size
              Print estimated filesystem size in multiples of the sector size (2048 bytes) and exit. This option
              is needed for Disk At Once mode and with some CD-R drives when piping directly into  wodim,  cases
              where  wodim  needs  to know the size of the filesystem image in advance.  Old versions of mkisofs
              wrote this information (among other information) to stderr.  As this  turns  out  to  be  hard  to
              parse,  the  number  without  any  other information is now printed on stdout too.  If you like to
              write a simple shell script, redirect stderr and catch the number from stdout.  This may  be  done
              with:

                   cdblocks=` pycdlib-genisoimage -print-size -quiet ... `
                   pycdlib-genisoimage ... | wodim ... tsize=${cdblocks}s -

       -quiet This makes pycdlib-genisoimage even less verbose.  No progress output will be provided.

       -R

       -rock  Generate  SUSP  and  RR records using the Rock Ridge protocol to further describe the files on the
              ISO9660 filesystem.

       -r

       -rational-rock
              This is like the -R option, but file ownership and modes are set to more useful values.   The  uid
              and  gid  are  set  to  zero, because they are usually only useful on the author's system, and not
              useful to the client.  All the file read bits are set true, so  that  files  and  directories  are
              globally  readable  on  the  client.  If any execute bit is set for a file, set all of the execute
              bits, so that executables are globally executable on the client.  If any search bit is set  for  a
              directory,  set all of the search bits, so that directories are globally searchable on the client.
              All write bits are cleared, because the filesystem will be mounted read-only in any case.  If  any
              of  the  special  mode  bits are set, clear them, because file locks are not useful on a read-only
              filesystem, and set-id bits are not desirable for uid 0 or gid 0.  When used on Win32, the execute
              bit is set on all files. This is a result of the lack of file permissions on Win32 and the  Cygwin
              POSIX emulation layer.  See also -uid, -gid, -dir-mode, -file-mode and -new-dir-mode.

       -relaxed-filenames
              (not  supported  by  pycdlib-genisoimage)  Allows  ISO9660  filenames  to  include all 7-bit ASCII
              characters except lowercase letters.
              This violates the ISO9660 standard, but it happens to work on many systems.  Use with caution.

       -root dir
              (not supported by pycdlib-genisoimage) Moves all files and directories into dir in the image. This
              is essentially the same as using -graft-points and adding dir in front of every pathspec,  but  is
              easier  to  use.  dir may actually be several levels deep. It is created with the same permissions
              as other graft points.

       -rrip110
              Create ISO-9660 file system images that follow the old Rrip Version-1.10 standard from 1993.  This
              option  may be needed if you know of systems that do not implement the Rrip protocol correctly and
              like the file system to be read by such a system.  Currently no such system is known.

              If a file system has been created with -rrip110, the Rock Ridge attributes do  not  include  inode
              number information.

       -rrip112
              Create ISO-9660 file system images that follow the new Rrip Version-1.12 standard from 1994.

       -old-root dir
              (not  supported by pycdlib-genisoimage) This option is necessary when writing a multisession image
              and the previous (or even older) session was written with -root dir.  Using a directory  name  not
              found  in  the  previous  session causes pycdlib-genisoimage to abort with an error.  Without this
              option, pycdlib-genisoimage would not be able to find unmodified files  and  would  be  forced  to
              write  their  data into the image once more.  -root and -old-root are meant to be used together to
              do incremental backups.  The initial session would e.g. use:  pycdlib-genisoimage  -root  backup_1
              dirs.  The next incremental backup with pycdlib-genisoimage -root backup_2 -old-root backup_1 dirs
              would  take  another snapshot of these directories. The first snapshot would be found in backup_1,
              the second one in backup_2, but only modified or new files need to  be  written  into  the  second
              session.  Without these options, new files would be added and old ones would be preserved. But old
              ones  would  be  overwritten  if  the file was modified. Recovering the files by copying the whole
              directory back from CD would also restore files that were deleted intentionally. Accessing several
              older versions of a file requires support by the operating system to choose which sessions are  to
              be mounted.

       -s sector type

       -sectype sector type
              (not supported by pycdlib-genisoimage) Set output sector type to e.g. data/xa1/raw.

       -sort sort_file
              (not  supported by pycdlib-genisoimage) Sort file locations on the media. Sorting is controlled by
              a file that contains pairs of filenames and sorting offset weighting.  If the weighting is higher,
              the file will be located closer to the beginning of the media, if the weighting is lower, the file
              will be located closer to the end of the media. There must be only one  space  or  tabs  character
              between  the  filename  and  the  weight and the weight must be the last characters on a line. The
              filename is taken to include all the characters up to, but not including the  last  space  or  tab
              character  on a line. This is to allow for space characters to be in, or at the end of a filename.
              This option does not sort the order of the filenames that appear  in  the  ISO9660  directory.  It
              sorts  the  order  in  which the file data is written to the CD image, which is useful in order to
              optimize the data layout on a CD. See README.sort for more details.

       -sparc-boot img_sun4,img_sun4c,img_sun4m,img_sun4d,img_sun4e
              (not supported by pycdlib-genisoimage) See -B above.

       -sparc-label label
              (not supported by pycdlib-genisoimage) Set the Sun disk label name for the Sun disk label that  is
              created with -sparc-boot.

       -split-output
              (not  supported by pycdlib-genisoimage) Split the output image into several files of approximately
              1 GB each.  This helps to create DVD-sized ISO9660 images on operating systems without large  file
              support.   wodim  will concatenate more than one file into a single track if writing to a DVD.  To
              make -split-output work, -o filename must be specified. The resulting output images will be named:
              filename_00, filename_01, filename_02....

       -stream-media-size #
              (not supported by pycdlib-genisoimage) Select streaming operation and set  the  media  size  to  #
              sectors.  This allows you to pipe the output of the tar(1) program into pycdlib-genisoimage and to
              create an ISO9660 filesystem without the need of an intermediate tar archive file.  If this option
              has  been  specified,  pycdlib-genisoimage  reads  from  stdin  and  creates  a file with the name
              STREAM.IMG.  The maximum size of the file (with padding) is 200 sectors less  than  the  specified
              media  size.  If  -no-pad  has been specified, the file size is 50 sectors less than the specified
              media size.  If the file is smaller, pycdlib-genisoimage will write padding. This may take awhile.

              The option -stream-media-size creates simple ISO9660 filesystems only and may  not  used  together
              with multisession or hybrid filesystem options.

       -stream-file-name name
              Reserved for future use.

       -sunx86-boot UFS_img,,,AUX1_img
              (not  supported by pycdlib-genisoimage) Specifies a comma-separated list of filesystem images that
              are needed to make a bootable CD for Solaris x86 systems.

              Note that partition 1 is used for the ISO9660 image and that partition 2 is  the  whole  disk,  so
              partition  1  and 2 may not be used by external partition data.  The first image file is mapped to
              partition 0.  There may be empty  fields  in  the  comma-separated  list,  and  list  entries  for
              partition  1  and  2 must be empty.  The maximum number of supported partitions is 8 (although the
              Solaris x86 partition table could support up to 16 partitions), so it  is  impossible  to  specify
              more  than  6  partition  images.   This  option is required to make a bootable CD for Solaris x86
              systems.

              If -sunx86-boot has been specified, the first sector of the resulting  image  will  contain  a  PC
              fdisk label with a Solaris type 0x82 fdisk partition that starts at offset 512 and spans the whole
              CD.   In addition, for the Solaris type 0x82 fdisk partition, there is a SVr4 disk label at offset
              1024 in the first sector of the CD.  This disk label specifies slice 0 for the first (usually  UFS
              type)  filesystem  image  that  is used to boot the PC and slice 1 for the ISO9660 image.  Slice 2
              spans the whole CD slice 3 ... slice 7 may be used for additional filesystem images that have been
              specified with this option.

              A Solaris x86 boot CD uses a 1024 byte sized primary boot that  uses  the  El-Torito  no-emulation
              boot  mode  and  a  secondary  generic boot that is in CD sectors 1..15.  For this reason, both -b
              bootimage -no-emul-boot and -G genboot must be specified.

       -sunx86-label label
              (not supported by pycdlib-genisoimage) Set the SVr4 disk label name for the SVr4 disk  label  that
              is created with -sunx86-boot.

       -sysid ID
              Specifies the system ID.  There is space for 32 characters.

       -T

       -translation-table
              (not  supported by pycdlib-genisoimage) Generate a file TRANS.TBL in each directory on the CD-ROM,
              which can be used on non-Rock Ridge-capable systems  to  help  establish  the  correct  filenames.
              There is also information present in the file that indicates the major and minor numbers for block
              and character devices, and each symlink has the name of the link file given.

       -table-name table_name
              (not supported by pycdlib-genisoimage) Alternative translation table filename (see above). Implies
              -T.   If  you  are  creating  a  multisession  image you must use the same name as in the previous
              session.

       -ucs-level level
              Set Unicode conformance level in the Joliet SVD. The default level is 3.  It may be  set  to  1..3
              using this option.

       -UDF   Include  a  UDF hybrid in the generated filesystem image.  As pycdlib-genisoimage always creates a
              ISO-9660 filesystem, it is not possible to create UDF only images.  Note that UDF wastes the space
              from sector ~20 to sector 256 at the beginning of the disk in addition to  the  space  needed  for
              real UDF data structures.

       -udf   Rationalized  UDF with user and group set to 0 and with simplified permissions.  See -r option for
              more information.

       -udf-symlinks
              Support symlinks in UDF filesystems. This is the default.

       -no-udf-symlinks
              Do not support symlinks in UDF filesystems.

       -uid uid
              (not supported by pycdlib-genisoimage) Overrides the uid read from the source files to  the  value
              of uid.  Specifying this option automatically enables Rock Ridge extensions.

       -use-fileversion
              (not  supported  by pycdlib-genisoimage) The option -use-fileversion allows pycdlib-genisoimage to
              use file version numbers from the filesystem.  If the option is not specified, pycdlib-genisoimage
              creates a version number of 1 for all files.  File versions are strings in the range ;1 to  ;32767
              This option is the default on VMS.

       -U

       -untranslated-filenames
              (not  supported  by pycdlib-genisoimage) Allows "untranslated" filenames, completely violating the
              ISO9660 standards described above.  Enables the following  flags:  -d  -l  -N  -allow-leading-dots
              -relaxed-filenames  -allow-lowercase  -allow-multidot -no-iso-translate.  Allows more than one `.'
              character in the filename, as well as mixed-case filenames.  This is useful on  HP-UX,  where  the
              built-in cdfs filesystem does not recognize any extensions. Use with extreme caution.

       -no-iso-translate
              (not  supported  by  pycdlib-genisoimage)  Do  not  translate the characters `#' and `~' which are
              invalid for ISO9660 filenames.  Although invalid, these characters are  often  used  by  Microsoft
              systems.
              This violates the ISO9660 standard, but it happens to work on many systems.  Use with caution.

       -V volid
              Specifies  the  volume  ID  (volume  name or label) to be written into the master block.  There is
              space for 32 characters.  The volume ID is used as the mount point by the Solaris  volume  manager
              and as a label assigned to a disc on various other platforms such as Windows and Apple Mac OS.

       -volset ID
              Specifies the volume set ID.  There is space for 128 characters.

       -volset-size #
              Sets  the  volume set size to #.  The volume set size is the number of CDs that are in a CD volume
              set.  A volume set is a collection of one or more volumes, on which a set of files is recorded.

              Volume Sets are not intended to be used to create a set numbered CDs  that  are  part  of  e.g.  a
              Operation  System  installation set of CDs.  Volume Sets are rather used to record a big directory
              tree that would not fit on a single volume.  Each volume of a Volume Set contains a description of
              all the directories and files that are recorded on the volumes where the sequence numbers are less
              than, or equal to, the assigned Volume Set Size of the current volume.

              pycdlib-genisoimage currently does not support a -volset-size that is larger than 1.

              The option -volset-size must be specified before -volset-seqno on each command line.

       -volset-seqno #
              Sets the volume set sequence number to #.  The volume set sequence number is the index  number  of
              the  current  CD  in  a CD set.  The option -volset-size must be specified before -volset-seqno on
              each command line.

       -v

       -verbose
              Verbose execution. If given twice on the command line, extra debug information will be printed.

       -x glob
              Identical to -m glob.

       -XA    Generate XA directory attruibutes.

       -xa    Generate rationalized XA directory attruibutes.

       -z

       -transparent-compression
              (not supported by pycdlib-genisoimage) Generate special RRIP records for transparently  compressed
              files.  This is only of use and interest for hosts that support transparent decompression, such as
              Linux  2.4.14  or  later.  You must specify -R or -r to enable Rock Ridge, and generate compressed
              files using the mkzftree  utility  before  running  pycdlib-genisoimage.   Note  that  transparent
              compression  is  a  nonstandard  Rock Ridge extension.  The resulting disks are only transparently
              readable if used on Linux.  On other operating systems you will need to call mkzftree by  hand  to
              decompress the files.

       -scan-for-duplicates
              Keep  a  running list of file hashes, attempting to link as many files together as possible.  This
              results in the smallest possible ISO image, but may be very slow, particular with large files.

HFS OPTIONS

       -hfs   (not supported by pycdlib-genisoimage) Create an ISO9660/HFS hybrid CD. This option should be used
              in conjunction with the -map, -magic and/or the various double dash options given below.

       -no-hfs
              Do not create an ISO-9660/HFS hybrid CD even though other options may imply to do so.

       -apple (not supported by pycdlib-genisoimage) Create an ISO9660 CD with Apple's  extensions.  Similar  to
              -hfs,  except  that  the  Apple  Extensions to ISO9660 are added instead of creating an HFS hybrid
              volume.  Former pycdlib-genisoimage versions did include  Rock  Ridge  attributes  by  default  if
              -apple  was  specified. This versions of pycdlib-genisoimage does not do this anymore. If you like
              to have Rock Ridge attributes, you need to specify this separately.

       -map mapping_file
              (not supported  by  pycdlib-genisoimage)  Use  the  mapping_file  to  set  the  CREATOR  and  TYPE
              information  for  a file based on the filename's extension. A filename is mapped only if it is not
              one of the know Apple/Unix file formats.

       -magic magic_file
              (not supported by pycdlib-genisoimage) The CREATOR and TYPE information is set by using  a  file's
              magic number (usually the first few bytes of a file). The magic_file is only used if a file is not
              one  of  the  known  Apple/Unix  file formats, or the filename extension has not been mapped using
              -map.

       -hfs-creator creator
              (not supported by pycdlib-genisoimage) Set the default CREATOR for all files. Must  be  exactly  4
              characters.

       -hfs-type type
              (not  supported  by  pycdlib-genisoimage)  Set  the  default TYPE for all files. Must be exactly 4
              characters.

       -probe (not supported by pycdlib-genisoimage) Search the contents of files for all the  known  Apple/Unix
              file  formats.   However, the only way to check for MacBinary and AppleSingle files is to open and
              read them, so this option may increase processing time. It is better to use  one  or  more  double
              dash options given below if the Apple/Unix formats in use are known.

       -no-desktop
              (not  supported by pycdlib-genisoimage) Do not create (empty) Desktop files. New HFS Desktop files
              will be created when the CD is used on a Macintosh (and stored in the System Folder).  By default,
              empty Desktop files are added to the HFS volume.

       -mac-name
              (not supported by pycdlib-genisoimage) Use the HFS filename as the starting point for the ISO9660,
              Joliet and Rock Ridge filenames.

       -boot-hfs-file driver_file
              (not supported by pycdlib-genisoimage) Installs the driver_file that may make the CD bootable on a
              Macintosh.

       -part  (not supported by pycdlib-genisoimage) Generate an HFS partition table. By default,  no  partition
              table is generated, but some older Macintosh CD-ROM drivers need an HFS partition table on the CD-
              ROM to be able to recognize a hybrid CD-ROM.

       -auto AutoStart_file
              (not  supported by pycdlib-genisoimage) Make the HFS CD use the QuickTime 2.0 Autostart feature to
              launch an application or document.  The  given  filename  must  be  the  name  of  a  document  or
              application  located  at  the  top  level of the CD. The filename must be less than 12 characters.
              (Alpha).

       -cluster-size size
              (not supported by pycdlib-genisoimage) Set the size in bytes of the cluster or allocation units of
              PC Exchange files. Implies --exchange.

       -hide-hfs glob
              (not supported by pycdlib-genisoimage) Hide glob, a shell wildcard pattern, from the  HFS  volume.
              The file or directory will still exist in the ISO9660 and/or Joliet directory.  glob may match any
              part of the filename.  Multiple globs may be excluded.  Example:

                   pycdlib-genisoimage -o rom -hfs -hide-hfs '*.o' -hide-hfs foobar

              would  exclude all files ending in `.o' or called foobar from the HFS volume. Note that if you had
              a directory called foobar, it too (and of course all its descendants) would be excluded.  The glob
              can also be a path name relative to the source directories given on the command line. Example:

                   pycdlib-genisoimage -o rom -hfs -hide-hfs src/html src

              would exclude just the file or directory called html from the src directory.  Any  other  file  or
              directory  called  html  in  the  tree  will  not  be  excluded.  Should be used with -hide and/or
              -hide-joliet.  In order to match a directory name, make  sure  the  pattern  does  not  include  a
              trailing `/' character. See README.hide for more details.

       -hide-hfs-list file
              (not supported by pycdlib-genisoimage) Specify a file containing a list of wildcard patterns to be
              hidden as in -hide-hfs.

       -hfs-volid hfs_volid
              (not supported by pycdlib-genisoimage) Volume name for the HFS partition. This is the name that is
              assigned to the disc on a Macintosh and replaces the volid used with -V.

       -icon-position
              (not  supported  by pycdlib-genisoimage) Use the icon position information, if it exists, from the
              Apple/Unix file.  The icons will appear in the same position as they would on a Macintosh desktop.
              Folder location and size on screen, its scroll positions, folder View (view as Icons, Small Icons,
              etc.) are also preserved.  (Alpha).

       -root-info file
              (not supported by pycdlib-genisoimage) Set the location, size on screen, scroll positions,  folder
              View etc. for the root folder of an HFS volume. See README.rootinfo for more information.  (Alpha)

       -prep-boot file
              (not  supported  by  pycdlib-genisoimage)  PReP  boot  image  file.  Up  to  4  are  allowed.  See
              README.prep_boot for more information.  (Alpha)

       -chrp-boot
              (not supported by pycdlib-genisoimage) Add CHRP boot header.

       -input-hfs-charset charset
              (not supported by pycdlib-genisoimage) Input charset that  defines  the  characters  used  in  HFS
              filenames when used with -mac-name.  The default charset is cp10000 (Mac Roman).

       -output-hfs-charset charset
              (not  supported  by  pycdlib-genisoimage)  Output charset that defines the characters that will be
              used in the HFS filenames. Defaults to the input charset.

       -hfs-unlock
              (not supported by pycdlib-genisoimage) By default, pycdlib-genisoimage will create an  HFS  volume
              that  is  locked.   This  option  leaves  the  volume  unlocked  so  that other applications (e.g.
              hfsutils) can modify the volume.

       -hfs-bless folder_name
              (not supported by pycdlib-genisoimage) "Bless" the given directory (folder). This is  usually  the
              System  Folder  and  is  used  in creating HFS bootable CDs. The name of the directory must be the
              whole path name as pycdlib-genisoimage sees it.  E.g., if the given pathspec is ./cddata  and  the
              required  folder is called System Folder, the whole path name is "/cddata/System Folder" (remember
              to use quotes if the name contains spaces).

       -hfs-parms parameters
              (not supported by  pycdlib-genisoimage)  Override  certain  parameters  used  to  create  the  HFS
              filesystem. Unlikely to be used in normal circumstances.

       --cap  (not  supported  by  pycdlib-genisoimage)  Look  for  AUFS  CAP  Macintosh  files.  Search for CAP
              Apple/Unix file formats only.  Searching  for  the  other  possible  Apple/Unix  file  formats  is
              disabled, unless other double dash options are given.

       --netatalk
              (not supported by pycdlib-genisoimage) Look for NETATALK Macintosh files

       --double
              (not supported by pycdlib-genisoimage) Look for AppleDouble Macintosh files

       --ethershare
              (not supported by pycdlib-genisoimage) Look for Helios EtherShare Macintosh files

       --ushare
              (not supported by pycdlib-genisoimage) Look for IPT UShare Macintosh files

       --exchange
              (not supported by pycdlib-genisoimage) Look for PC Exchange Macintosh files

       --sgi  (not supported by pycdlib-genisoimage) Look for SGI Macintosh files

       --xinet
              (not supported by pycdlib-genisoimage) Look for XINET Macintosh files

       --macbin
              (not supported by pycdlib-genisoimage) Look for MacBinary Macintosh files

       --single
              (not supported by pycdlib-genisoimage) Look for AppleSingle Macintosh files

       --dave (not supported by pycdlib-genisoimage) Look for Thursby Software Systems DAVE Macintosh files

       --sfm  (not supported by pycdlib-genisoimage) Look for Microsoft's Services for Macintosh files (NT only)
              (Alpha)

       --osx-double
              (not supported by pycdlib-genisoimage) Look for Mac OS X AppleDouble Macintosh files

       --osx-hfs
              (not supported by pycdlib-genisoimage) Look for Mac OS X HFS Macintosh files

SEE ALSO

       genisoimage(1), pycdlib-explorer(1), pycdlib-extract-files(1)

AUTHOR

       Chris Lalancette <clalancette@gmail.com>

pycdlib-genisoimage                                 Sep 2017                              PYCDLIB-GENISOIMAGE(1)