"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "xorriso/xorrisofs.texi" between
xorriso-1.5.2.tar.gz and xorriso-1.5.4.tar.gz

About: GNU xorriso creates, loads, manipulates and writes ISO 9660 filesystem images with Rock Ridge extensions. It is suitable for incremental data backup and for production of bootable ISO 9660 images. GNU xorriso is a statical compilation of the libraries libburn, libisofs, libisoburn, and libjte.

xorrisofs.texi  (xorriso-1.5.2):xorrisofs.texi  (xorriso-1.5.4)
\input texinfo @c -*-texinfo-*- \input texinfo @c -*-texinfo-*-
@c %**start of header @c %**start of header
@setfilename xorrisofs.info @setfilename xorrisofs.info
@settitle GNU xorrisofs 1.5.2 @settitle GNU xorrisofs 1.5.4
@c %**end of header @c %**end of header
@c @c
@c man-ignore-lines begin @c man-ignore-lines begin
@dircategory Archiving @dircategory Archiving
@direntry @direntry
* Xorrisofs: (xorrisofs). Emulates ISO 9660 program mkisofs * Xorrisofs: (xorrisofs). Emulates ISO 9660 program mkisofs
@end direntry @end direntry
@c man-ignore-lines end @c man-ignore-lines end
@c @c
@c Notes about embedded man page: @c Notes about embedded man page:
skipping to change at line 53 skipping to change at line 53
@c man .\" @c man .\"
@c man .\" IMPORTANT NOTE: @c man .\" IMPORTANT NOTE:
@c man .\" @c man .\"
@c man .\" The original of this file is kept in xorriso/xorrisofs.texi @c man .\" The original of this file is kept in xorriso/xorrisofs.texi
@c man .\" This here was generated by program xorriso/make_xorriso_1 @c man .\" This here was generated by program xorriso/make_xorriso_1
@c man .\" @c man .\"
@c man .\" @c man .\"
@c man .\" First parameter, NAME, should be all caps @c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
@c man .\" other parameters are allowed: see man(7), man(1) @c man .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISOFS 1 "Version 1.5.2, Oct 26, 2019" @c man .TH XORRISOFS 1 "Version 1.5.4, Jan 30, 2021"
@c man .\" Please adjust this date whenever revising the manpage. @c man .\" Please adjust this date whenever revising the manpage.
@c man .\" @c man .\"
@c man .\" Some roff macros, for reference: @c man .\" Some roff macros, for reference:
@c man .\" .nh disable hyphenation @c man .\" .nh disable hyphenation
@c man .\" .hy enable hyphenation @c man .\" .hy enable hyphenation
@c man .\" .ad l left justify @c man .\" .ad l left justify
@c man .\" .ad b justify to both left and right margins @c man .\" .ad b justify to both left and right margins
@c man .\" .nf disable filling @c man .\" .nf disable filling
@c man .\" .fi enable filling @c man .\" .fi enable filling
@c man .\" .br insert line break @c man .\" .br insert line break
@c man .\" .sp <n> insert n+1 empty lines @c man .\" .sp <n> insert n+1 empty lines
@c man .\" for manpage-specific macros, see man(7) @c man .\" for manpage-specific macros, see man(7)
@c man .nh @c man .nh
@c man-ignore-lines begin @c man-ignore-lines begin
@copying @copying
xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso
Copyright @copyright{} 2011 - 2019 Thomas Schmitt Copyright @copyright{} 2011 - 2021 Thomas Schmitt
@quotation @quotation
Permission is granted to distribute this text freely. Permission is granted to distribute this text freely.
@end quotation @end quotation
@end copying @end copying
@c man-ignore-lines end @c man-ignore-lines end
@titlepage @titlepage
@title Manual of GNU xorriso personality xorrisofs 1.5.2 @title Manual of GNU xorriso personality xorrisofs 1.5.4
@author Thomas Schmitt @author Thomas Schmitt
@page @page
@vskip 0pt plus 1filll @vskip 0pt plus 1filll
@insertcopying @insertcopying
@end titlepage @end titlepage
@contents @contents
@ifnottex @ifnottex
@node Top @node Top
@top xorrisofs 1.5.2 @top xorrisofs 1.5.4
@c man-ignore-lines 1 @c man-ignore-lines 1
@c man .SH NAME @c man .SH NAME
xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso
@end ifnottex @end ifnottex
@menu @menu
* Overview:: Overview * Overview:: Overview
* Standards:: ISO 9660, Rock Ridge, Joliet * Standards:: ISO 9660, Rock Ridge, Joliet
* Insert:: Inserting files into the ISO image * Insert:: Inserting files into the ISO image
* Xorriso:: Relation to program xorriso * Xorriso:: Relation to program xorriso
skipping to change at line 297 skipping to change at line 297
The following options control loading of an existing ISO image for the purpose The following options control loading of an existing ISO image for the purpose
of preparing a suitable add-on session. of preparing a suitable add-on session.
If they are missing then a new image is composed from scratch. If they are missing then a new image is composed from scratch.
@table @asis @table @asis
@sp 1 @sp 1
@c man .TP @c man .TP
@item -M disk_path @item -M disk_path
@kindex -M set path for loading existing ISO image @kindex -M set path for loading existing ISO image
@cindex Session, select path, -M, -prev-session, -dev @cindex Session, select path, -M, -prev-session, -dev
Set the path from which to load the existing ISO image directory tree Set the path from which to load the existing ISO image directory tree
on which to base the upcomming directory tree as add-on session. on which to base the upcoming directory tree as add-on session.
The path must lead to a random-access readable file object. The path must lead to a random-access readable file object.
On GNU/Linux: regular data files or block device files. On GNU/Linux: regular data files or block device files.
@* @*
A special kind of pseudo disk_path has the form "/dev/fd/"number. A special kind of pseudo disk_path has the form "/dev/fd/"number.
It depicts the open file descriptor with the given number, regardless whether It depicts the open file descriptor with the given number, regardless whether
the operating system supports this feature by file nodes in /dev/fd or not. the operating system supports this feature by file nodes in /dev/fd or not.
E.g. /dev/fd/3 is file descriptor 3 which was opened by the program that E.g. /dev/fd/3 is file descriptor 3 which was opened by the program that
later started xorriso. later started xorriso.
@c man .TP @c man .TP
@item -prev-session disk_path @item -prev-session disk_path
skipping to change at line 427 skipping to change at line 427
@* @*
Enable recognition and proper processing of zisofs compressed files Enable recognition and proper processing of zisofs compressed files
as produced by program mkzftree. These files will get equipped with the as produced by program mkzftree. These files will get equipped with the
necessary meta data so that a Linux kernel will recognize them and necessary meta data so that a Linux kernel will recognize them and
deliver their content in uncompressed form. deliver their content in uncompressed form.
@c man .TP @c man .TP
@item -transparent-compression @item -transparent-compression
@kindex -transparent-compression enable recognition of zisofs files @kindex -transparent-compression enable recognition of zisofs files
Alias of -z. Alias of -z.
@c man .TP @c man .TP
@item --zisofs-version-2
@kindex --zisofs-version-2 enable recognition of zisofs2 files
@cindex zisofs2 file, enable recognition, --zisofs-version-2
@*
Enable the recognition and proper processing of experimental zisofs version 2
compressed files.
The Linux kernel (as of 5.9) does not yet know this format and will complain
like
@*
isofs: Unknown ZF compression algorithm: PZ
@*
This complaint can be prevented by option --zisofs2-susp-z2 .
@*
The files will be shown by unaware kernels as they were submitted to xorriso,
i.e. with zisofs2 header, block pointer list, and compressed data.
@*
--zisofs-version-2 also enables -z.
@c man .TP
@item --zisofs2-susp-z2
@kindex --zisofs2-susp-z2 produce Z2 for version 2 instead of ZF
@cindex Z2 instead of ZF for version 2, --zisofs2-susp-z2
Enable the production of SUSP entries "Z2" instead of "ZF" with zisofs2
compressed files. Unaware Linux kernels silently ignore "Z2" entries.
@c man .TP
@item --zisofs2-susp-zf
@kindex --zisofs2-susp-zf produce ZF for version 2 instead of Z2
@cindex ZF instead of Z2 for version 2, --zisofs2-susp-zf
Enable the production of SUSP entries "ZF" instead of "Z2" with zisofs2
compressed files. Unaware Linux kernels complain about zisofs2 "ZF" by
"Unknown ZF compression algorithm" and thus leave a mark in the system log.
@c man .TP
@item -root iso_rr_path @item -root iso_rr_path
@kindex -root redirect ISO root directory @kindex -root redirect ISO root directory
@cindex ISO root directory, redirect, -root @cindex ISO root directory, redirect, -root
Insert all files under the given iso_rr_path. If option -graft-points is given, Insert all files under the given iso_rr_path. If option -graft-points is given,
then iso_rr_path is prepended to each target part of a pathspec. then iso_rr_path is prepended to each target part of a pathspec.
@* @*
The default for -root is "/". The default for -root is "/".
@c man .TP @c man .TP
@item -old-root iso_rr_path @item -old-root iso_rr_path
@kindex -old-root enable incremental insertion @kindex -old-root enable incremental insertion
skipping to change at line 847 skipping to change at line 878
and have their last 33 bytes overwritten by a colon ':' and the and have their last 33 bytes overwritten by a colon ':' and the
hex representation of the MD5 of the first 4095 bytes of the whole hex representation of the MD5 of the first 4095 bytes of the whole
oversized name. Potential incomplete UTF-8 characters will get their oversized name. Potential incomplete UTF-8 characters will get their
leading bytes replaced by '_'. leading bytes replaced by '_'.
@* @*
Linux kernels up to at least 4.1 misrepresent names of length 254 and 255. Linux kernels up to at least 4.1 misrepresent names of length 254 and 255.
If you expect such names in or under disk_paths and plan to mount the ISO If you expect such names in or under disk_paths and plan to mount the ISO
by such Linux kernels, consider to set -file_name_limit 253. by such Linux kernels, consider to set -file_name_limit 253.
@c man .TP @c man .TP
@item -D @item -D
@kindex -D allow deep directory hierachies @kindex -D allow deep directory hierarchies
@cindex Deep directories, allow, -D, -disable-deep-relocation @cindex Deep directories, allow, -D, -disable-deep-relocation
The standard ECMA-119 demands that no path in the image shall have more The standard ECMA-119 demands that no path in the image shall have more
than 8 name components or 255 characters. Therefore it would be necessary than 8 name components or 255 characters. Therefore it would be necessary
to move deeper directory trees to a higher directory. Rock Ridge offers an to move deeper directory trees to a higher directory. Rock Ridge offers an
opportunity to let these relocated directories appear at their original opportunity to let these relocated directories appear at their original
deep position, but this feature might not be implemented properly by deep position, but this feature might not be implemented properly by
operating systems which mount the image. operating systems which mount the image.
@* @*
Option -D disables this deep directory relocation, and thus violates Option -D disables this deep directory relocation, and thus violates
ISO 9660 specs. ISO 9660 specs.
@* @*
xorrisofs has -D set by default. If given explicitly then it overrides xorrisofs has -D set by default. If given explicitly then it overrides
the options -rr_reloc_dir and -hide-rr-moved. the options -rr_reloc_dir and -hide-rr-moved.
@c man .TP @c man .TP
@item -disable-deep-relocation @item -disable-deep-relocation
@kindex -disable-deep-relocation allow deep directory hierachies @kindex -disable-deep-relocation allow deep directory hierarchies
Alias of -D. Alias of -D.
@c man .TP @c man .TP
@item -rr_reloc_dir name @item -rr_reloc_dir name
@kindex -rr_reloc_dir set deep directory relocation target @kindex -rr_reloc_dir set deep directory relocation target
@cindex Deep directories, relocation target, -rr_reloc_dir @cindex Deep directories, relocation target, -rr_reloc_dir
Enable the relocation of deep directories and thus avoid ECMA-119 file paths Enable the relocation of deep directories and thus avoid ECMA-119 file paths
of more than 8 name components or 255 characters. Directories which lead to of more than 8 name components or 255 characters. Directories which lead to
such file paths will get moved to a directory in the root directory of the such file paths will get moved to a directory in the root directory of the
image. Its name gets set by this option. image. Its name gets set by this option.
It is permissible to use the root directory itself. It is permissible to use the root directory itself.
skipping to change at line 1031 skipping to change at line 1062
metadata. The second one marks the range from HFS+ metadata to the end metadata. The second one marks the range from HFS+ metadata to the end
of file content data. If more ISO image data follow, then a third partition of file content data. If more ISO image data follow, then a third partition
entry gets produced. Other features of xorriso might cause the need for entry gets produced. Other features of xorriso might cause the need for
more APM entries. more APM entries.
@* @*
Be aware that HFS+ is case-insensitive although it can record file names Be aware that HFS+ is case-insensitive although it can record file names
with upper-case and lower-case letters. Therefore, file names from the iso_rr with upper-case and lower-case letters. Therefore, file names from the iso_rr
name tree may collide in the HFS+ name tree. In this case they get changed name tree may collide in the HFS+ name tree. In this case they get changed
by adding underscore characters and counting numbers. In case of very long by adding underscore characters and counting numbers. In case of very long
names, it might be necessary to map them to "MANGLED_...". names, it might be necessary to map them to "MANGLED_...".
@*
WARNING:
@*
The HFS+ implementation in libisofs has a limit of 125,829,120 bytes for the
size of the overall directory tree. This suffices for about 300,000 files
of normal name length. If the limit gets exceeded, a FAILURE event will be
issued and the ISO production will not happen.
@c man .TP @c man .TP
@item -hfsplus-serial-no @item -hfsplus-serial-no
@kindex -hfsplus-serial-no set HFS+ serial number @kindex -hfsplus-serial-no set HFS+ serial number
@cindex HFS+, set serial number @cindex HFS+, set serial number
Set a string of 16 digits "0" to "9" Set a string of 16 digits "0" to "9"
and letters "a" to "f", which will be used as unique serial number of and letters "a" to "f", which will be used as unique serial number of
an emerging HFS+ filesystem. an emerging HFS+ filesystem.
@c man .TP @c man .TP
@item -hfsplus-block-size number @item -hfsplus-block-size number
@kindex -hfsplus-block-size set HFS+ allocation block size @kindex -hfsplus-block-size set HFS+ allocation block size
skipping to change at line 1610 skipping to change at line 1648
The disk path should lead to one of the Syslinux files isohdp[fp]x*.bin . The disk path should lead to one of the Syslinux files isohdp[fp]x*.bin .
The MBR gets patched according to isohybrid needs. The first partition The MBR gets patched according to isohybrid needs. The first partition
describes the range of the ISO image. Its start is at block 0 by default, describes the range of the ISO image. Its start is at block 0 by default,
but may be set to 64 disk blocks by option -partition_offset 16. but may be set to 64 disk blocks by option -partition_offset 16.
@* @*
For the meaning of special disk_path "." see option -G. For the meaning of special disk_path "." see option -G.
@c man .TP @c man .TP
@item -isohybrid-gpt-basdat @item -isohybrid-gpt-basdat
@kindex -isohybrid-gpt-basdat Mark boot image in GPT @kindex -isohybrid-gpt-basdat Mark boot image in GPT
@cindex Bootability, mark boot image in GPT, -isohybrid-gpt-basdat @cindex Bootability, mark boot image in GPT, -isohybrid-gpt-basdat
Mark the current El Torito boot image (see options -b and -e) in GPT as Mark the current El Torito boot image (see options -b and -e) in an actually
partition of type Basic Data. This works only with -isohybrid-mbr and invalid GPT as partition of type Basic Data. This works only with
has the same impact on the system area as -efi-boot-part. It cannot be -isohybrid-mbr and has the same impact on the system area as -efi-boot-part.
combined with -efi-boot-part or -hfsplus. It cannot be combined with -efi-boot-part or -hfsplus.
@* @*
The first three boot images which are marked by GPT will also show up The first three boot images which are marked by GPT will also show up
as partition entries of type 0xef in MBR. as partition entries in MBR. The MBR partition of type 0xEF is what actually
is used by EFI firmware for booting from USB stick.
The MBR partition for PC-BIOS gets type 0x00 rather than 0x17 in this case. The MBR partition for PC-BIOS gets type 0x00 rather than 0x17 in this case.
Often the further MBR entries are the ones which actually get used by EFI. Often the further MBR entries are the ones which actually get used by EFI.
@c man .TP @c man .TP
@item -isohybrid-gpt-hfsplus @item -isohybrid-gpt-hfsplus
@kindex -isohybrid-gpt-hfsplus Mark boot image in GPT @kindex -isohybrid-gpt-hfsplus Mark boot image in GPT
@cindex Bootability, mark boot image in GPT, -isohybrid-gpt-hfsplus @cindex Bootability, mark boot image in GPT, -isohybrid-gpt-hfsplus
Mark the current El Torito boot image (see options -b and -e) in GPT as Mark the current El Torito boot image (see options -b and -e) in GPT as
partition of type HFS+. partition of type HFS+.
Impact and restrictions are like with -isohybrid-gpt-basdat. Impact and restrictions are like with -isohybrid-gpt-basdat.
@c man .TP @c man .TP
skipping to change at line 1672 skipping to change at line 1711
EBD0A0A2-B9E5-4433-87C0-68B6B72699C7, then it will be used as partition type EBD0A0A2-B9E5-4433-87C0-68B6B72699C7, then it will be used as partition type
if the ISO filesystem appears as partition in GPT. if the ISO filesystem appears as partition in GPT.
In MBR, C12A7328-F81F-11D2-BA4B-00A0C93EC93B will be mapped to 0xef. In MBR, C12A7328-F81F-11D2-BA4B-00A0C93EC93B will be mapped to 0xef.
Any other GUID will be mapped to 0x83. Any other GUID will be mapped to 0x83.
@c man .TP @c man .TP
@item @minus{}@minus{}protective-msdos-label @item @minus{}@minus{}protective-msdos-label
@kindex @minus{}@minus{}protective-msdos-label Patch System Area partition tab le @kindex @minus{}@minus{}protective-msdos-label Patch System Area partition tab le
@cindex Bootability, patch System Area partition table, @minus{}@minus{}protecti ve-msdos-label @cindex Bootability, patch System Area partition table, @minus{}@minus{}protecti ve-msdos-label
Patch the System Area by a simple PC-DOS partition table where partition 1 Patch the System Area by a simple PC-DOS partition table where partition 1
claims the range of the ISO image but leaves the first block unclaimed. claims the range of the ISO image but leaves the first block unclaimed.
This is mutally exclusive to option -isohybrid-mbr.
@c man .TP @c man .TP
@item @minus{}@minus{}mbr-force-bootable @item @minus{}@minus{}mbr-force-bootable
@kindex @minus{}@minus{}mbr-force-bootable Enforce MBR bootable/active flag @kindex @minus{}@minus{}mbr-force-bootable Enforce MBR bootable/active flag
@cindex Bootability, bootable MBR partition, @minus{}@minus{}mbr-force-bootable @cindex Bootability, bootable MBR partition, @minus{}@minus{}mbr-force-bootable
Enforce an MBR partition with "bootable/active" flag if options like Enforce an MBR partition with "bootable/active" flag if options like
@minus{}@minus{}protective-msdos-label or @minus{}@minus{}grub2-mbr are given. @minus{}@minus{}protective-msdos-label or @minus{}@minus{}grub2-mbr are given.
These options normally cause the flag to be set if there is an These options normally cause the flag to be set if there is an
MBR partition of type other than 0xee or 0xef. MBR partition of type other than 0xee or 0xef.
If no such partition exists, then no bootflag is set, unless If no such partition exists, then no bootflag is set, unless
@minus{}@minus{}mbr-force-bootable forces creation of a dummy partition @minus{}@minus{}mbr-force-bootable forces creation of a dummy partition
skipping to change at line 1773 skipping to change at line 1813
yield usable results. For a list of codes search the Internet for yield usable results. For a list of codes search the Internet for
"Partition Types" or run fdisk command "L". "Partition Types" or run fdisk command "L".
If the partition appears in GPT then type_code 0xef is mapped to the EFI System If the partition appears in GPT then type_code 0xef is mapped to the EFI System
Partition Type GUID. All others get mapped to Basic Data Type GUID. Partition Type GUID. All others get mapped to Basic Data Type GUID.
@* @*
type_code may also be a type GUID as plain hex string like type_code may also be a type GUID as plain hex string like
a2a0d0ebe5b9334487c068b6b72699c7 or as structured text like a2a0d0ebe5b9334487c068b6b72699c7 or as structured text like
EBD0A0A2-B9E5-4433-87C0-68B6B72699C7. It will be used if the partition is EBD0A0A2-B9E5-4433-87C0-68B6B72699C7. It will be used if the partition is
mentioned in GPT. In MBR, C12A7328-F81F-11D2-BA4B-00A0C93EC93B will be mapped mentioned in GPT. In MBR, C12A7328-F81F-11D2-BA4B-00A0C93EC93B will be mapped
to 0xef. Any other GUID will be mapped to 0x83. to 0xef. Any other GUID will be mapped to 0x83.
In APM, 48465300-0000-11AA-AA11-00306543ECAC will be mapped to partition
type "Apple_HFS", any other to "Data".
@* @*
If some other command causes the production of GPT, then the appended If some other command causes the production of GPT, then the appended
partitions will be mentioned there too, even if not -appended_part_as_gpt partitions will be mentioned there too, even if not -appended_part_as_gpt
is given. is given.
@c man .TP @c man .TP
@item -appended_part_as_gpt @item -appended_part_as_gpt
@kindex -appended_part_as_gpt Appended partitions in GPT @kindex -appended_part_as_gpt Appended partitions in GPT
@cindex GPT, mark appended partitions, -appended_part_as_gpt @cindex GPT, mark appended partitions, -appended_part_as_gpt
Marks partitions from -append_partition in GPT rather than in MBR. Marks partitions from -append_partition in GPT rather than in MBR.
In this case the MBR shows a single partition In this case the MBR shows a single partition
skipping to change at line 2007 skipping to change at line 2049
@sp 1 @sp 1
$ xorrisofs -version 2>&1 | grep '^libjte' && echo YES $ xorrisofs -version 2>&1 | grep '^libjte' && echo YES
@* @*
@sp 1 @sp 1
@c man .PP @c man .PP
The .jigdo file contains checksums and symbolic file addresses. The .jigdo file contains checksums and symbolic file addresses.
The .template file contains the compressed ISO image with reference tags The .template file contains the compressed ISO image with reference tags
instead of the content bytes of the listed files. instead of the content bytes of the listed files.
@* @*
Input for this process are the normal arguments for a @command{xorrisofs} Input for this process are the normal arguments for a @command{xorrisofs}
session session with no image loaded, and a checksum file which lists those
with no image loaded, and a .md5 file which lists those data files which may be data files which may be
listed in the .jigdo file and externally referenced in the .template file. listed in the .jigdo file and externally referenced in the .template file.
Each designated file is represented in the .md5 file by a single text line: Each designated file is represented in the checksum file by a single text line:
@* @*
MD5 as 32 hex digits, 2 blanks, size as 12 decimal digits or blanks, 2 blanks, Checksum as hex digits, 2 blanks, size as 12 decimal digits or blanks, 2 blanks,
symbolic file address symbolic file address
@* @*
The file address in an .md5 line has to bear the same basename as the The kind of checksum is chosen by -jigdo "checksum_algorithm" with values "md5"
(32 hex digits) or "sha256" (64 hex digits).
It will also be used for the file address lines in the .jigdo file.
The default is "md5".
@*
The file address in a checksum file line has to bear the same basename as the
disk_path of the file which it shall match. The directory path of disk_path of the file which it shall match. The directory path of
the file address is decisive for To=From mapping, not for file recognition. the file address is decisive for To=From mapping, not for file recognition.
After To=From mapping, the file address gets written into the .jigdo After To=From mapping, the file address gets written into the .jigdo
file. Jigdo restore tools will convert these addresses into really file. Jigdo restore tools will convert these addresses into really
reachable data source addresses from which they can read. reachable data source addresses from which they can read.
@* @*
If the list of jigdo parameters is not empty, then padding will be If the list of jigdo parameters is not empty, then padding will be
counted as part of the ISO image. counted as part of the ISO image.
@* @*
@table @asis @table @asis
@sp 1 @sp 1
@c man .TP @c man .TP
@item -jigdo-checksum-algorithm "md5"|"sha256"
@kindex -jigdo-checksum-algorithm set data file checksum algorithm
@cindex Jigdo Template Extraction, -jigdo-checksum-algorithm
Set the checksum algorithm which shall be used for the data file entries
in the .jigdo file and is expected in the checksum file. Default is "md5".
@c man .TP
@item -jigdo-jigdo disk_path @item -jigdo-jigdo disk_path
@kindex -jigdo-jigdo set name of .jigdo file @kindex -jigdo-jigdo set name of .jigdo file
@cindex Jigdo Template Extraction, -jigdo-jigdo @cindex Jigdo Template Extraction, -jigdo-jigdo
Set the disk_path for the .jigdo file with the checksums Set the disk_path for the .jigdo file with the checksums
and download addresses for filling the holes in .template. and download addresses for filling the holes in .template.
@c man .TP @c man .TP
@item -jigdo-template disk_path @item -jigdo-template disk_path
@kindex -jigdo-template set name of .template file @kindex -jigdo-template set name of .template file
@cindex Jigdo Template Extraction, -jigdo-template @cindex Jigdo Template Extraction, -jigdo-template
Set the disk_path for the .template file with the Set the disk_path for the .template file with the
skipping to change at line 2049 skipping to change at line 2102
@c man .TP @c man .TP
@item -jigdo-min-file-size size @item -jigdo-min-file-size size
@kindex -jigdo-min-file-size set minimum extract size @kindex -jigdo-min-file-size set minimum extract size
@cindex Jigdo Template Extraction, -jigdo-min-file-size @cindex Jigdo Template Extraction, -jigdo-min-file-size
Set the minimum size for a data file to be listed Set the minimum size for a data file to be listed
in the .jigdo file and being a hole in the .template file. in the .jigdo file and being a hole in the .template file.
size may be a plain number counting bytes, or a number with appended size may be a plain number counting bytes, or a number with appended
letter "k", "m", "g" to count KiB (1024 bytes), MiB (1024 KiB), or letter "k", "m", "g" to count KiB (1024 bytes), MiB (1024 KiB), or
GiB (1024 MiB). GiB (1024 MiB).
@c man .TP @c man .TP
@item -jigdo-force-md5 disk_path_pattern @item -jigdo-force-checksum disk_path_pattern
@kindex -jigdo-force-md5 add check pattern for .md5 @kindex -jigdo-force-checksum add check pattern for checksum file
@cindex Jigdo Template Extraction, -jigdo-force-md5 @cindex Jigdo Template Extraction, -jigdo-force-checksum
adds a regular expression pattern which will get compared adds a regular expression pattern which will get compared
with the absolute disk_path of any data file that was not found in the .md5 with the absolute disk_path of any data file that was not found in the
list. A match causes a MISHAP event, which normally does not abort the checksum file.
A match causes a MISHAP event, which normally does not abort the
program run but finally causes a non-zero exit value of the program. program run but finally causes a non-zero exit value of the program.
@c man .TP @c man .TP
@item -jigdo-force-md5 disk_path_pattern
@kindex -jigdo-force-md5 add check pattern for checksum file
@cindex Jigdo Template Extraction, -jigdo-force-md5
Outdated alias of -jigdo-force-checksum.
@c man .TP
@item -jigdo-exclude disk_path_pattern @item -jigdo-exclude disk_path_pattern
@kindex -jigdo-exclude add exclusion pattern for .md5 @kindex -jigdo-exclude add exclusion pattern for checksum file
@cindex Jigdo Template Extraction, -jigdo-exclude @cindex Jigdo Template Extraction, -jigdo-exclude
Add a regular expression pattern which will get compared Add a regular expression pattern which will get compared
with the absolute disk_path of any data file. A match causes the file to with the absolute disk_path of any data file. A match causes the file to
stay in .template in any case. stay in .template in any case.
@c man .TP @c man .TP
@item -jigdo-map To=From @item -jigdo-map To=From
@kindex -jigdo-map add address translation for .jigdo @kindex -jigdo-map add address translation for .jigdo
@cindex Jigdo Template Extraction, -jigdo-map @cindex Jigdo Template Extraction, -jigdo-map
Add a string pair of the form To=From to the parameter list. Add a string pair of the form To=From to the parameter list.
If a data file gets listed in the .jigdo file, then it is referred by the If a data file gets listed in the .jigdo file, then it is referred by the
file address from its line in the .md5 file. This file address gets checked file address from its line in the checksum file. This file address gets checked
whether it begins with the From string. If so, then this string will be whether it begins with the From string. If so, then this string will be
replaced by the To string and a ':' character, before it goes into the .jigdo replaced by the To string and a ':' character, before it goes into the .jigdo
file. The From string should end by a '/' character. file. The From string should end by a '/' character.
@c man .TP @c man .TP
@item -checksum-list disk_path
@kindex -checksum-list set path of input checksum file
@cindex Jigdo Template Extraction, -checksum-list
Set the disk_path where to find the checksum file file with
symbolic file addresses and checksums according to -jigdo-checksum-algorithm.
@c man .TP
@item -md5-list disk_path @item -md5-list disk_path
@kindex -md5-list set path of readable .md5 @kindex -md5-list set path of input checksum file
@cindex Jigdo Template Extraction, -md5-list @cindex Jigdo Template Extraction, -md5-list
Set the disk_path where to find the .md5 input file. Outdated alias of -checksum-list.
@c man .TP @c man .TP
@item -jigdo-template-compress "gzip"|"bzip2" @item -jigdo-template-compress "gzip"|"bzip2"
@kindex -jigdo-template-compress choose compression algorithm @kindex -jigdo-template-compress choose compression algorithm
@cindex Jigdo Template Extraction, -jigdo-template-compress @cindex Jigdo Template Extraction, -jigdo-template-compress
Choose one of "bzip2" or "gzip" for the compression of Choose one of "bzip2" or "gzip" for the compression of
the template file. The jigdo file is put out uncompressed. the template file. The jigdo file is put out uncompressed.
@c man .TP @c man .TP
@item -checksum_algorithm_iso list_of_names @item -checksum_algorithm_iso list_of_names
@kindex -checksum_algorithm_iso choose .jigdo checksums @kindex -checksum_algorithm_iso choose .jigdo checksums
@cindex Jigdo Template Extraction, -checksum_algorithm_iso @cindex Jigdo Template Extraction, -checksum_algorithm_iso
skipping to change at line 2295 skipping to change at line 2360
@sp 1 @sp 1
/with_=_and_\/file /with_=_and_\/file
@c man .SS @c man .SS
@c man .B Perform multi-session runs @c man .B Perform multi-session runs
@node ExMkisofs, ExGrowisofs, ExGraft, Examples @node ExMkisofs, ExGrowisofs, ExGraft, Examples
@section Perform multi-session runs @section Perform multi-session runs
This example works for multi-session media only: This example works for multi-session media only:
CD-R[W], DVD-R[W], DVD+R, BD-R. CD-R[W], DVD-R[W], DVD+R, BD-R.
Add cdrskin option @minus{}@minus{}grow_overwriteable_iso Add cdrskin option @minus{}@minus{}grow_overwriteable_iso
to all -as cdrecord runs to all -as cdrecord runs
in order to enable multi-session emulation on overwriteable media. in order to enable multi-session emulation on overwritable media.
@* @*
The first session is written like this: The first session is written like this:
@* @*
@sp 1 @sp 1
$ xorrisofs -graft-points \ $ xorrisofs -graft-points \
@* @*
/tree1=prepared_for_iso/tree1 \ /tree1=prepared_for_iso/tree1 \
@* @*
| xorriso -as cdrecord -v dev=/dev/sr0 blank=fast -multi -eject - | xorriso -as cdrecord -v dev=/dev/sr0 blank=fast -multi -eject -
@* @*
skipping to change at line 2459 skipping to change at line 2524
sums against the current file content on hard disk. sums against the current file content on hard disk.
@* @*
@sp 1 @sp 1
@c man .sp 1 @c man .sp 1
With @strong{mount} option @strong{-o "sbsector="} on GNU/Linux With @strong{mount} option @strong{-o "sbsector="} on GNU/Linux
or @strong{-s} on FreeBSD or NetBSD or @strong{-s} on FreeBSD or NetBSD
it is possible to access the session trees which represent the older backup it is possible to access the session trees which represent the older backup
versions. With CD media, GNU/Linux mount accepts session numbers directly by versions. With CD media, GNU/Linux mount accepts session numbers directly by
its option "session=". its option "session=".
@* @*
Multi-session media and most overwriteable media written by xorriso can tell Multi-session media and most overwritable media written by xorriso can tell
the sbsectors of their sessions by xorriso option -toc: the sbsectors of their sessions by xorriso option -toc:
@* @*
@sp 1 @sp 1
$ xorriso -dev /dev/sr0 -toc $ xorriso -dev /dev/sr0 -toc
@* @*
@sp 1 @sp 1
xorriso can print the matching mount command for a session number: xorriso can print the matching mount command for a session number:
@* @*
@sp 1 @sp 1
$ xorriso -mount_cmd /dev/sr0 session 12 /mnt $ xorriso -mount_cmd /dev/sr0 session 12 /mnt
skipping to change at line 2855 skipping to change at line 2920
Expect to get asked more questions before solutions can be proposed. Expect to get asked more questions before solutions can be proposed.
@c man .SH AUTHOR @c man .SH AUTHOR
@node Legal, CommandIdx, Bugreport, Top @node Legal, CommandIdx, Bugreport, Top
@chapter Author, Copyright, Credits @chapter Author, Copyright, Credits
@section Author @section Author
Thomas Schmitt <scdbackup@@gmx.net> Thomas Schmitt <scdbackup@@gmx.net>
@* @*
for libburnia-project.org for libburnia-project.org
@c man .SH COPYRIGHT @c man .SH COPYRIGHT
@section Copyright @section Copyright
Copyright (c) 2011 - 2019 Thomas Schmitt Copyright (c) 2011 - 2021 Thomas Schmitt
@* @*
Permission is granted to distribute this text freely. It shall only be Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of xorriso. If you make use modified in sync with the technical properties of xorriso. If you make use
of the license to derive modified versions of xorriso then you are entitled of the license to derive modified versions of xorriso then you are entitled
to modify this text under that same license. to modify this text under that same license.
@c man .SH CREDITS @c man .SH CREDITS
@section Credits @section Credits
@command{xorrisofs} is in part based on work by Vreixo Formoso who provides @command{xorrisofs} is in part based on work by Vreixo Formoso who provides
libisofs together with Mario Danic who also leads the libburnia team. libisofs together with Mario Danic who also leads the libburnia team.
Vladimir Serbinenko contributed the HFS+ filesystem code and related knowledge. Vladimir Serbinenko contributed the HFS+ filesystem code and related knowledge.
 End of changes. 30 change blocks. 
30 lines changed or deleted 95 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)