OS Manuals

/usr/bin/genisoimage

Nova compute daemon (Kolla nova-compute image)

From openstack-nova-2025.2-compute 32.2.0_git20261104-r4 (enterprise-packages), captured 2026-11-08 by running genisoimage --help (exit 0). permalink

Usage: xorriso -as mkisofs [options] file...
Note: This is not mkisofs. See xorriso -help, xorriso -version, man xorrisofs
Options:
  -f, -follow-links           Follow symbolic links
  -graft-points               Allow to use graft points for filenames
  -help                       Print option help
  -hfsplus                    Generate HFS+ filesystem
  -hfsplus-file-creator-type CREATOR TYPE iso_rr_path
                              Attach creator and type to a File
  -hfs-bless FOLDER_NAME      Name of Folder to be blessed
  -hfs-bless-by BLESS_TYPE ISO_RR_PATH
                              Bless ISO_RR_PATH by BLESS_TYPE {p,i,s,9,x}
  -hfsplus-serial-no HEXSTRING
                              HFS serial number: 16 characters [0-9a-fA-F]
  -hfsplus-block-size NUMBER  Set HFS+ block size
  -apm-block-size NUMBER      Set Apple Partition Map block size
  -hide GLOBFILE              Hide ISO9660/RR file
  -hide-list FILE             File with list of ISO9660/RR files to hide
  -hide-joliet GLOBFILE       Hide Joliet file
  -hide-joliet-list FILE      File with list of Joliet files to hide
  -hide-hfsplus GLOBFILE      Hide HFS+ file
  -hide-hfsplus-list FILE     File with list of HFS+ files to hide
  -hide_iso_path HIDE_STATE ISO_RR_PATH
                              Hide file by its ISO path
  -input-charset CHARSET      Local input charset for file name conversion
  -output-charset CHARSET     Output charset for file name conversion
  -iso-level LEVEL            Set ISO9660 conformance level (1..3) or 4 for ISO9660 version 2
  -disallow_dir_id_ext        Do not allow dot in ISO directory names
  -J, -joliet                 Generate Joliet directory information
  -joliet-long                Allow Joliet file names to be 103 Unicode characters
  -joliet-utf16               Encode Joliet names in UTF-16BE rather than UCS-2
  -U, -untranslated-filenames Allow Untranslated filenames (for HPUX & AIX - violates ISO9660).
  -untranslated_name_len LEN  Allow up to LEN (1..96) name characters (heavily violates ISO9660).
  -allow-lowercase            Allow lower case characters in addition to the current character set (violates ISO9660)
  -relaxed-filenames          Allow 7 bit ASCII except lower case characters (violates ISO9660)
  -d, -omit-period            Omit trailing periods from filenames (violates ISO9660)
  -l, -full-iso9660-filenames Allow full 31 character filenames for ISO9660 names
  -max-iso9660-filenames      Allow 37 character filenames for ISO9660 names (violates ISO9660)
  -N, -omit-version-number    Omit version number from ISO9660 filename (violates ISO9660)
  -D, -disable-deep-relocation
                              Disable deep directory relocation (violates ISO9660)
  -hide-rr-moved              Relocate deep directories to /.rr_moved
  -rr_reloc_dir NAME          Set deep directory relocation target in root
  -long-rr-time               Use long Rock Ridge time format
  -short-rr-time              Enable use of short Rock Ridge time format
  -no-long-rr-time            Enable use of short Rock Ridge time format
  -rr-time-y1900              Restrict writing of old timestamps to year 1900
  -uid uid                    Make the owner of all files this uid.
  -gid gid                    Make the group owner of all files this gid.
  -o FILE, -output FILE       Set output file name
  -m GLOBFILE, -exclude GLOBFILE
                              Exclude file name
  -x FILE, -old-exclude FILE  Exclude file name
  -exclude-list FILE          File with list of file names to exclude
  -pad                        Pad output by 300k (default)
  -no-pad                     Do not pad output
  -M FILE, -prev-session FILE Set path to previous session to merge
  -C PARAMS, -cdrecord-params PARAMS
                              Magic paramters from cdrecord
  -dir-mode mode              Make the mode of all directories this mode.
  -file-mode mode             Make the mode of all plain files this mode.
  -path-list FILE             File with list of pathnames to process
  --quoted_path_list FILE     File with list of quoted pathnames to process
  -print-size                 Print estimated filesystem size and exit
  -quiet                      Run quietly
  -genisoimage_completion     Enable completion of genisoimage options
  -gui                        Switch behaviour for GUI
  -R, -rock                   Generate Rock Ridge directory information
  -r, -rational-rock          Generate rationalized Rock Ridge directory information
  --norock                    Disable Rock Ridge. (Strongly discouraged !)
  -file_name_limit LEN        Set truncation limit for Rock Ridge names
  --hardlinks                 Record eventual hard link relations of files
  --acl                       Record eventual ACLs of files
  --xattr                     Record eventual user space xattr of files
  --xattr-any                 Record xattr of any namespace, not only user.
  --lfa_flags                 Record Linux file attribute flags (chattr)
  --projid                    Record XFS-style project ids
  --md5                       Compute and record MD5 checksums of data files
  --scdbackup_tag PATH NAME   With --md5 record a scdbackup checksum tag
  --for_backup                Use all options which improve backup fidelity
  -V ID, -volid ID            Set Volume ID
  -volid_for FSLIST ID        Set Volume ID for filesystems of FSLIST
  -volset ID                  Set Volume set ID
  -publisher PUB              Set Volume publisher
  -A ID, -appid ID            Set Application ID
  -sysid ID                   Set System ID
  -p PREP, -preparer PREP     Set Volume preparer
  -abstract FILE              Set Abstract filename
  -biblio FILE                Set Bibliographic filename
  -copyright FILE             Set Copyright filename
  --application_use CHAR|PATH  Set content of Application Use field
  -relaxed_pvd_atts MODE      Control character set used in in PVD
  -jigdo-jigdo FILE           Produce a jigdo .jigdo file as well as the .iso
  -jigdo-template FILE        Produce a jigdo .template file as well as the .iso
  -jigdo-min-file-size SIZE   Minimum size for a file to be listed in the jigdo file
  -jigdo-force-checksum PTRN  Pattern(s) where files MUST match an externally-supplied checksum
  -jigdo-force-md5 PATTERN    Outdated alias of -jigdo-force-checksum
  -jigdo-exclude PATTERN      Pattern(s) to exclude from the jigdo file
  -jigdo-map PATTERN1=PATTERN2
                              Pattern(s) to map paths (e.g. Debian=/mirror/debian)
  -checksum-list FILE         File containing checksums of the files that should be checked
  -md5-list FILE              Outdated alias of -checksum-list
  -jigdo-checksum-algorithm ALGORITHM
                              Choose algorithm for file matching checksums: md5, sha256
                              Expected in the -checksum-list FILE, written into .jigdo file.
  -jigdo-template-compress ALGORITHM
                              Choose to use gzip or bzip2 compression for template data; default is gzip
  -checksum_algorithm_iso alg1,alg2,...
                              Specify the checksum types desired for the output image (in .jigdo)
  -checksum_algorithm_template alg1,alg2,...
                              Specify the checksum types desired for the output jigdo template
  -eltorito-platform          Set El Torito platform id for the next boot entry
  -b FILE, -eltorito-boot FILE
                              Set El Torito boot image name
  -eltorito-alt-boot          Start specifying alternative El Torito boot parameters
  --efi-boot FILE             Set El Torito EFI boot image name and type
  -e FILE                     Set EFI boot image name (more rawly)
  -c FILE, -eltorito-catalog FILE
                              Set El Torito boot catalog name
  --boot-catalog-hide         Hide boot catalog from ISO9660/RR and Joliet
  -boot-load-size #           Set numbers of load sectors
  -hard-disk-boot             Boot image is a hard disk image
  -no-emul-boot               Boot image is 'no emulation' image
  -boot-info-table            Patch boot image with info table
  --grub2-boot-info           Patch boot image at byte 2548
  -eltorito-id ID             Set El Torito Id String
  -eltorito-selcrit HEXBYTES  Set El Torito Selection Criteria
  -isohybrid-gpt-basdat       Mark El Torito boot image as Basic Data in GPT
  -isohybrid-gpt-hfsplus      Mark El Torito boot image as HFS+ in GPT
  -isohybrid-apm-hfsplus      Mark El Torito boot image as HFS+ in APM
  -part_like_isohybrid        Mark in MBR, GPT, APM without -isohybrid-mbr
  -iso_mbr_part_type          Set type byte or GUID of ISO partition in MBR
                              or type GUID if a GPT ISO partition emerges.
  --gpt_disk_guid GUID        Set GPT disk GUID or choose automatic GUID
  -G FILE, -generic-boot FILE Set generic boot image name
  --embedded-boot FILE        Alias of -G
  --protective-msdos-label    Patch System Area by partition table
  --mbr-force-bootable        Enforce existence of bootable flag in MBR
  --gpt-iso-bootable          Set Legacy BIOS bootable flag in ISO partition
  --gpt-iso-not-ro            Do not set Read-only flag in ISO partition
  -partition_offset LBA       Make image mountable by first partition, too
  -partition_sec_hd NUMBER    Define number of sectors per head
  -partition_hd_cyl NUMBER    Define number of heads per cylinder
  -partition_cyl_align MODE   Control cylinder alignment: off, on, auto, all
  -mips-boot FILE             Set mips boot image name (relative to image root)
  -mipsel-boot FILE           Set mipsel boot image name (relative to image root)
  -B FILES, -sparc-boot FILES Set sparc boot image names
  -sparc-label label text     Set sparc boot disk label
  -hppa-cmdline CMDLINE       Set hppa boot command line
  -hppa-kernel-32 FILE        Set hppa 32-bit image name (relative to image root)
  -hppa-kernel-64 FILE        Set hppa 64-bit image name (relative to image root)
  -hppa-bootloader FILE       Set hppa boot loader file name (relative to image root)
  -hppa-ramdisk FILE          Set hppa ramdisk file name (relative to image root)
  -hppa-hdrversion NUMBER     Set hppa PALO header version to 4 or 5
  -alpha-boot FILE            Set alpha boot image name (relative to image root)
  --grub2-sparc-core FILE     Set path of core file for disk label patching
  -efi-boot-part DISKFILE|--efi-boot-image
                              Set data source for EFI System Partition
  -chrp-boot-part             Mark ISO image size by MBR partition type 0x96
  -chrp-boot                  Alias of -chrp-boot-part
  -prep-boot-part DISKFILE    Set data source for MBR partition type 0x41
  -append_partition NUMBER TYPE FILE
                              Append FILE after image. TYPE is hex: 0x.. or
                              a GUID to be used if -appended_part_as_gpt.
  -appended_part_as_gpt       mark appended partitions in GPT instead of MBR.
  -appended_part_as_apm       mark appended partitions in APM.
  -cut_out DISK_PATH BYTE_OFFSET BYTE_COUNT ISO_RR_PATH
                              map a byte interval of a regular disk file
                              into a regular file in the ISO image
  --modification-date=YYYYMMDDhhmmsscc
                              Override date of creation and modification
  --set_all_file_dates TIME   Override mtime, atime, ctime in all files
  -isohybrid-mbr FILE         Set SYSLINUX mbr/isohdp[fp]x*.bin for isohybrid
  --grub2-mbr FILE            Set GRUB2 MBR for boot image address patching
  --sort-weight NUMBER FILE   Set LBA weight number to file or file tree
  --sort-weight-list DISKFILE Read list of NUMBER FILE pairs for --sort-weight
  --sort-weight-patterns DISKFILE  --sort-weight-list with pattern expansion
  --stdio_sync on|off|number  Control forced output to disk files
  --no-emul-toc               Save 64 kB size on random access output files
  --emul-toc                  Multi-session history on such output files
  --old-empty                 Use old style block addresses for empty files
  -z, -transparent-compression
                              Enable transparent compression of files
  --zisofs-version-2          Enable processing of zisofs version 2 files
  --zisofs2-susp-z2           Produce Z2 entries for zisofs version 2
  --zisofs2-susp-zf           Produce ZF entries for zisofs version 2
  -root DIR                   Set root directory for all new files and directories
  -old-root DIR               Set root directory in previous session that is searched for files
  --old-root-no-md5           Do not record and use MD5 with -old-root
  --old-root-no-ino           Do not use disk inode numbers with -old-root
  --old-root-devno            Use disk device numbers with -old-root
  -log-file LOG_FILE          Re-direct messages to LOG_FILE
  --no_rc                     Do not execute startup files
  -v, -verbose                Verbose
  -version                    Print the current version

Report any bugs to bug-xorriso@gnu.org or in private to scdbackup@gmx.net .
Options (154)
OptionDescriptionSource
-f, -follow-linksFollow symbolic linkshelp
-graft-pointsAllow to use graft points for filenameshelp
-helpPrint option helphelp
-hfsplusGenerate HFS+ filesystemhelp
-hfs-bless FOLDER_NAMEName of Folder to be blessedhelp
-hfsplus-serial-no HEXSTRINGHFS serial number: 16 characters [0-9a-fA-F]help
-hfsplus-block-size NUMBERSet HFS+ block sizehelp
-apm-block-size NUMBERSet Apple Partition Map block sizehelp
-hide GLOBFILEHide ISO9660/RR filehelp
-hide-list FILEFile with list of ISO9660/RR files to hidehelp
-hide-joliet GLOBFILEHide Joliet filehelp
-hide-joliet-list FILEFile with list of Joliet files to hidehelp
-hide-hfsplus GLOBFILEHide HFS+ filehelp
-hide-hfsplus-list FILEFile with list of HFS+ files to hidehelp
-input-charset CHARSETLocal input charset for file name conversionhelp
-output-charset CHARSETOutput charset for file name conversionhelp
-iso-level LEVELSet ISO9660 conformance level (1..3) or 4 for ISO9660 version 2help
-disallow_dir_id_extDo not allow dot in ISO directory nameshelp
-J, -jolietGenerate Joliet directory informationhelp
-joliet-longAllow Joliet file names to be 103 Unicode charactershelp
-joliet-utf16Encode Joliet names in UTF-16BE rather than UCS-2help
-untranslated_name_len LENAllow up to LEN (1..96) name characters (heavily violates ISO9660).help
-allow-lowercaseAllow lower case characters in addition to the current character set (violates ISO9660)help
-relaxed-filenamesAllow 7 bit ASCII except lower case characters (violates ISO9660)help
-d, -omit-periodOmit trailing periods from filenames (violates ISO9660)help
-max-iso9660-filenamesAllow 37 character filenames for ISO9660 names (violates ISO9660)help
-N, -omit-version-numberOmit version number from ISO9660 filename (violates ISO9660)help
-D, -disable-deep-relocationDisable deep directory relocation (violates ISO9660)help
-hide-rr-movedRelocate deep directories to /.rr_movedhelp
-rr_reloc_dir NAMESet deep directory relocation target in roothelp
-long-rr-timeUse long Rock Ridge time formathelp
-short-rr-timeEnable use of short Rock Ridge time formathelp
-no-long-rr-timeEnable use of short Rock Ridge time formathelp
-rr-time-y1900Restrict writing of old timestamps to year 1900help
-uid uidMake the owner of all files this uid.help
-gid gidMake the group owner of all files this gid.help
-o, -output FILESet output file namehelp
-x, -old-exclude FILEExclude file namehelp
-exclude-list FILEFile with list of file names to excludehelp
-padPad output by 300k (default)help
-no-padDo not pad outputhelp
-dir-mode modeMake the mode of all directories this mode.help
-file-mode modeMake the mode of all plain files this mode.help
-path-list FILEFile with list of pathnames to processhelp
--quoted_path_list FILEFile with list of quoted pathnames to processhelp
-print-sizePrint estimated filesystem size and exithelp
-quietRun quietlyhelp
-genisoimage_completionEnable completion of genisoimage optionshelp
-guiSwitch behaviour for GUIhelp
-R, -rockGenerate Rock Ridge directory informationhelp
-r, -rational-rockGenerate rationalized Rock Ridge directory informationhelp
--norockDisable Rock Ridge.help
-file_name_limit LENSet truncation limit for Rock Ridge nameshelp
--hardlinksRecord eventual hard link relations of fileshelp
--aclRecord eventual ACLs of fileshelp
--xattrRecord eventual user space xattr of fileshelp
--xattr-anyRecord xattr of any namespace, not only user.help
--lfa_flagsRecord Linux file attribute flags (chattr)help
--projidRecord XFS-style project idshelp
--md5Compute and record MD5 checksums of data fileshelp
--scdbackup_tag PATHWith --md5 record a scdbackup checksum taghelp
--for_backupUse all options which improve backup fidelityhelp
-V, -volid IDSet Volume IDhelp
-volid_for FSLISTSet Volume ID for filesystems of FSLISThelp
-volset IDSet Volume set IDhelp
-publisher PUBSet Volume publisherhelp
-A, -appid IDSet Application IDhelp
-sysid IDSet System IDhelp
-p, -preparer PREPSet Volume preparerhelp
-abstract FILESet Abstract filenamehelp
-biblio FILESet Bibliographic filenamehelp
-copyright FILESet Copyright filenamehelp
--application_use CHAR|PATHSet content of Application Use fieldhelp
-relaxed_pvd_atts MODEControl character set used in in PVDhelp
-jigdo-jigdo FILEProduce a jigdo .jigdo file as well as the .isohelp
-jigdo-template FILEProduce a jigdo .template file as well as the .isohelp
-jigdo-min-file-size SIZEMinimum size for a file to be listed in the jigdo filehelp
-jigdo-force-checksum PTRNPattern(s) where files MUST match an externally-supplied checksumhelp
-jigdo-force-md5 PATTERNOutdated alias of -jigdo-force-checksumhelp
-jigdo-exclude PATTERNPattern(s) to exclude from the jigdo filehelp
-jigdo-map PATTERN1=PATTERN2Pattern(s) to map paths (e.g. Debian=/mirror/debian)help
-checksum-list FILEFile containing checksums of the files that should be checkedhelp
-md5-list FILEOutdated alias of -checksum-listhelp
-jigdo-checksum-algorithm ALGORITHMChoose algorithm for file matching checksums: md5, sha256 Expected in the -checksum-list FILE, written into .jigdo file.help
-jigdo-template-compress ALGORITHMChoose to use gzip or bzip2 compression for template data;help
-checksum_algorithm_iso alg1Specify the checksum types desired for the output image (in .jigdo)help
-checksum_algorithm_template alg1Specify the checksum types desired for the output jigdo templatehelp
-eltorito-platformSet El Torito platform id for the next boot entryhelp
-eltorito-alt-bootStart specifying alternative El Torito boot parametershelp
--efi-boot FILESet El Torito EFI boot image name and typehelp
-e FILESet EFI boot image name (more rawly)help
--boot-catalog-hideHide boot catalog from ISO9660/RR and Joliethelp
-boot-load-size #Set numbers of load sectorshelp
-hard-disk-bootBoot image is a hard disk imagehelp
-no-emul-bootBoot image is 'no emulation' imagehelp
-boot-info-tablePatch boot image with info tablehelp
--grub2-boot-infoPatch boot image at byte 2548help
-eltorito-id IDSet El Torito Id Stringhelp
-eltorito-selcrit HEXBYTESSet El Torito Selection Criteriahelp
-isohybrid-gpt-basdatMark El Torito boot image as Basic Data in GPThelp
-isohybrid-gpt-hfsplusMark El Torito boot image as HFS+ in GPThelp
-isohybrid-apm-hfsplusMark El Torito boot image as HFS+ in APMhelp
-part_like_isohybridMark in MBR, GPT, APM without -isohybrid-mbrhelp
-iso_mbr_part_typeSet type byte or GUID of ISO partition in MBR or type GUID if a GPT ISO partition emerges.help
--gpt_disk_guid GUIDSet GPT disk GUID or choose automatic GUIDhelp
--embedded-boot FILEAlias of -Ghelp
--protective-msdos-labelPatch System Area by partition tablehelp
--mbr-force-bootableEnforce existence of bootable flag in MBRhelp
--gpt-iso-bootableSet Legacy BIOS bootable flag in ISO partitionhelp
--gpt-iso-not-roDo not set Read-only flag in ISO partitionhelp
-partition_offset LBAMake image mountable by first partition, toohelp
-partition_sec_hd NUMBERDefine number of sectors per headhelp
-partition_hd_cyl NUMBERDefine number of heads per cylinderhelp
-partition_cyl_align MODEControl cylinder alignment: off, on, auto, allhelp
-mips-boot FILESet mips boot image name (relative to image root)help
-mipsel-boot FILESet mipsel boot image name (relative to image root)help
-sparc-label labelSet sparc boot disk labelhelp
-hppa-cmdline CMDLINESet hppa boot command linehelp
-hppa-kernel-32 FILESet hppa 32-bit image name (relative to image root)help
-hppa-kernel-64 FILESet hppa 64-bit image name (relative to image root)help
-hppa-bootloader FILESet hppa boot loader file name (relative to image root)help
-hppa-ramdisk FILESet hppa ramdisk file name (relative to image root)help
-hppa-hdrversion NUMBERSet hppa PALO header version to 4 or 5help
-alpha-boot FILESet alpha boot image name (relative to image root)help
--grub2-sparc-core FILESet path of core file for disk label patchinghelp
-efi-boot-part DISKFILE|--efi-boot-imageSet data source for EFI System Partitionhelp
-chrp-boot-partMark ISO image size by MBR partition type 0x96help
-chrp-bootAlias of -chrp-boot-parthelp
-prep-boot-part DISKFILESet data source for MBR partition type 0x41help
-appended_part_as_gptmark appended partitions in GPT instead of MBR.help
-appended_part_as_apmmark appended partitions in APM.help
--modification-date YYYYMMDDhhmmssccOverride date of creation and modificationhelp
--set_all_file_dates TIMEOverride mtime, atime, ctime in all fileshelp
-isohybrid-mbr FILESet SYSLINUX mbr/isohdp[fp]x*.bin for isohybridhelp
--grub2-mbr FILESet GRUB2 MBR for boot image address patchinghelp
--sort-weight NUMBERSet LBA weight number to file or file treehelp
--sort-weight-patterns DISKFILE--sort-weight-list with pattern expansionhelp
--stdio_sync on|off|numberControl forced output to disk fileshelp
--no-emul-tocSave 64 kB size on random access output fileshelp
--emul-tocMulti-session history on such output fileshelp
--old-emptyUse old style block addresses for empty fileshelp
-z, -transparent-compressionEnable transparent compression of fileshelp
--zisofs-version-2Enable processing of zisofs version 2 fileshelp
--zisofs2-susp-z2Produce Z2 entries for zisofs version 2help
--zisofs2-susp-zfProduce ZF entries for zisofs version 2help
-root DIRSet root directory for all new files and directorieshelp
-old-root DIRSet root directory in previous session that is searched for fileshelp
--old-root-no-md5Do not record and use MD5 with -old-roothelp
--old-root-no-inoDo not use disk inode numbers with -old-roothelp
--old-root-devnoUse disk device numbers with -old-roothelp
-log-file LOG_FILERe-direct messages to LOG_FILEhelp
--no_rcDo not execute startup fileshelp
-v, -verboseVerbosehelp
-versionPrint the current versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.