"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "xorriso/xorriso.texi" between
xorriso-1.4.6.tar.gz and xorriso-1.4.8.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.

xorriso.texi  (xorriso-1.4.6):xorriso.texi  (xorriso-1.4.8)
\input texinfo @c -*-texinfo-*- \input texinfo @c -*-texinfo-*-
@c %**start of header @c %**start of header
@setfilename xorriso.info @setfilename xorriso.info
@settitle GNU xorriso 1.4.6 @settitle GNU xorriso 1.4.8
@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
* Xorriso: (xorriso). Burns ISO 9660 on CD, DVD, BD. * Xorriso: (xorriso). Burns ISO 9660 on CD, DVD, BD.
@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/xorriso.texi @c man .\" The original of this file is kept in xorriso/xorriso.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 XORRISO 1 "Version 1.4.6, Sep 16, 2016" @c man .TH XORRISO 1 "Version 1.4.8, Sep 12, 2017"
@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
xorriso - creates, loads, manipulates and writes ISO 9660 filesystem images xorriso - creates, loads, manipulates and writes ISO 9660 filesystem images
with Rock Ridge extensions. with Rock Ridge extensions.
Copyright @copyright{} 2007 - 2016 Thomas Schmitt Copyright @copyright{} 2007 - 2017 Thomas Schmitt
@quotation @quotation
Permission is granted to distrubute this text freely. Permission is granted to distrubute 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 1.4.6 @title Manual of GNU xorriso 1.4.8
@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 GNU xorriso 1.4.6 @top GNU xorriso 1.4.8
@c man-ignore-lines 1 @c man-ignore-lines 1
@c man .SH NAME @c man .SH NAME
xorriso - creates, loads, manipulates and writes ISO 9660 filesystem images xorriso - creates, loads, manipulates and writes ISO 9660 filesystem images
with Rock Ridge extensions. with Rock Ridge extensions.
@end ifnottex @end ifnottex
@menu @menu
* Overview:: Overview * Overview:: Overview
* Model:: Session model * Model:: Session model
* Media:: Media types and states * Media:: Media types and states
skipping to change at line 1566 skipping to change at line 1566
@* @*
If iso_rr_path does not exist yet, then it gets added. If disk_path does not If iso_rr_path does not exist yet, then it gets added. If disk_path does not
exist, then iso_rr_path gets deleted. exist, then iso_rr_path gets deleted.
@c man .TP @c man .TP
@item -update_l disk_prefix iso_rr_prefix disk_path [***] @item -update_l disk_prefix iso_rr_prefix disk_path [***]
@kindex -update_l inserts paths if different @kindex -update_l inserts paths if different
@cindex Insert, if different, -update_l @cindex Insert, if different, -update_l
Perform -update_r with each of the disk_path parameters. iso_rr_path will be Perform -update_r with each of the disk_path parameters. iso_rr_path will be
composed from disk_path by replacing disk_prefix by iso_rr_prefix. composed from disk_path by replacing disk_prefix by iso_rr_prefix.
@c man .TP @c man .TP
@item -update_li iso_rr_prefix disk_prefix iso_rr_path [***]
@kindex -update_li inserts paths if different
@cindex Insert, if different, -update_li
Perform -update_r with each of the iso_rr_path parameters. disk_path will be
composed from iso_rr_path by replacing iso_rr_prefix by disk_prefix.
@c man .TP
@item -update_lxi disk_prefix iso_rr_prefix disk_path [***]
@kindex -update_l inserts paths if different
@cindex Insert, if different, -update_lxi
Perform -update_r with each of the disk_path parameters and with iso_rr_paths
in the ISO filesystem which are derived from the disk_path parameters after
exchanging disk_prefix by iso_rr_prefix. So, other than -update_l, this detects
missing matches of disk_path and deletes the corresponding iso_rr_path.
@*
Note that relative disk_paths and disk_path patterns are interpreted as
sub paths of the current disk working directory -cdx. The corresponding
iso_rr_paths are derived by exchanging disk_prefix by iso_rr_prefix before
pattern expansion happens. The current -cdi directory has no influence.
@c man .TP
@item -cut_out disk_path byte_offset byte_count iso_rr_path @item -cut_out disk_path byte_offset byte_count iso_rr_path
@kindex -cut_out inserts piece of data file @kindex -cut_out inserts piece of data file
@cindex Insert, piece of data file, -cut_out @cindex Insert, piece of data file, -cut_out
Map a byte interval of a regular disk file into a regular file in the ISO Map a byte interval of a regular disk file into a regular file in the ISO
image. image.
This may be necessary if the disk file is larger than a single medium, or if This may be necessary if the disk file is larger than a single medium, or if
it exceeds the traditional limit of 2 GiB - 1 for old operating systems, it exceeds the traditional limit of 2 GiB - 1 for old operating systems,
or the limit of 4 GiB - 1 for newer ones. Only the newest Linux kernels or the limit of 4 GiB - 1 for newer ones. Only the newest Linux kernels
seem to read properly files >= 4 GiB - 1. seem to read properly files >= 4 GiB - 1.
@* @*
skipping to change at line 1858 skipping to change at line 1877
@* @*
Mode "off" disables pathspecs of the form target=source Mode "off" disables pathspecs of the form target=source
and re-enables -disk_pattern expansion. and re-enables -disk_pattern expansion.
@c man .TP @c man .TP
@item -overwrite "on"|"nondir"|"off" @item -overwrite "on"|"nondir"|"off"
@kindex -overwrite enables overwriting in ISO @kindex -overwrite enables overwriting in ISO
@cindex Insert, enable overwriting, -overwrite @cindex Insert, enable overwriting, -overwrite
Allow or disallow overwriting of existing files in the Allow or disallow overwriting of existing files in the
ISO image by files with the same name. ISO image by files with the same name.
@* @*
With setting "off", name collisions cause FAILURE events. With setting "off", name collisions with at least one non-directory file
cause FAILURE events. Collisions of two directories lead to merging of their
file lists.
@*
With setting "nondir", only directories are protected by such events, other With setting "nondir", only directories are protected by such events, other
existing file types get treated with -rm before the new file gets added. existing file types get treated with -rm before the new file gets added.
Setting "on" enables automatic -rm_r. I.e. a non-directory can replace an Setting "on" enables automatic -rm_r. I.e. a non-directory can replace an
existing directory and all its subordinates. existing directory and all its subordinates.
@* @*
If restoring of files is enabled, then the overwrite rule applies to the If restoring of files is enabled, then the overwrite rule applies to the
target file objects on disk as well, but "on" is downgraded to "nondir". target file objects on disk as well, but "on" is downgraded to "nondir".
@c man .TP @c man .TP
@item -split_size number["k"|"m"] @item -split_size number["k"|"m"]
@kindex -split_size enables large file splitting @kindex -split_size enables large file splitting
skipping to change at line 2261 skipping to change at line 2283
Matches if the given disk_path is equal to the path of the file source Matches if the given disk_path is equal to the path of the file source
on disk. The same restrictions apply as with -disk_name. on disk. The same restrictions apply as with -disk_name.
@* @*
@item -type type_letter : @item -type type_letter :
Matches files of the given type: Matches files of the given type:
"block", "char", "dir", "pipe", "file", "link", "socket", "eltorito", "block", "char", "dir", "pipe", "file", "link", "socket", "eltorito",
and "Xotic" which matches what is not matched by the other types. and "Xotic" which matches what is not matched by the other types.
@* @*
Only the first letter is interpreted. E.g.: -find / -type d Only the first letter is interpreted. E.g.: -find / -type d
@* @*
@item -maxdepth number :
Matches only files which are at most at the given depth level relative to
the iso_rr_path where -find starts. That path itself is at depth 0, its
directory children are at 1, their directory children at 2, and so on.
@*
@item -mindepth number :
Matches only files which are at least at the given depth level.
@*
@item -damaged : @item -damaged :
Matches files which use data blocks marked as damaged by a previous Matches files which use data blocks marked as damaged by a previous
run of -check_media. The damage info vanishes when a new ISO image gets run of -check_media. The damage info vanishes when a new ISO image gets
loaded. loaded.
@* @*
Note that a MD5 session mismatch marks all files of the session as damaged. Note that a MD5 session mismatch marks all files of the session as damaged.
If finer distinction is desired, perform -md5 off before -check_media. If finer distinction is desired, perform -md5 off before -check_media.
@* @*
@item -pending_data : @item -pending_data :
Matches files which get their content from outside the loaded ISO image. Matches files which get their content from outside the loaded ISO image.
skipping to change at line 3868 skipping to change at line 3898
EFI booting. This is normally a FAT filesystem image not larger than EFI booting. This is normally a FAT filesystem image not larger than
65535 blocks of 512 bytes (= 32 MiB - 512). 65535 blocks of 512 bytes (= 32 MiB - 512).
Its load_size is determined automatically, no boot info table gets Its load_size is determined automatically, no boot info table gets
written, no boot medium gets emulated, platform_id is 0xef. written, no boot medium gets emulated, platform_id is 0xef.
@* @*
@strong{emul_type=} can be one of "no_emulation", "hard_disk", "diskette". @strong{emul_type=} can be one of "no_emulation", "hard_disk", "diskette".
It controls the boot medium emulation code of a boot image. It controls the boot medium emulation code of a boot image.
The default "no_emulation" is suitable for ISOLINUX, GRUB, FreeBSD cdboot. The default "no_emulation" is suitable for ISOLINUX, GRUB, FreeBSD cdboot.
@* @*
@strong{load_size=} is a value which depends on the boot image. @strong{load_size=} is a value which depends on the boot image.
Default 2048 should be overridden only if a better value is known. Default is 2048 which matches the expectations of most boot images.
The special value "full" means the full size of the boot image file
rounded up to a multiple of 2048 bytes. Maximum is 33,552,384 bytes.
@* @*
@strong{boot_info_table=on} causes address patching to bytes 8 to 63 @strong{boot_info_table=on} causes address patching to bytes 8 to 63
of the boot image which is given by "any" "bin_path=". of the boot image which is given by "any" "bin_path=".
"boot_info_table=off" disables this patching. "boot_info_table=off" disables this patching.
@* @*
@strong{grub2_boot_info=on} causes address patching to byte 2548 @strong{grub2_boot_info=on} causes address patching to byte 2548
of the boot image which is given by "any" "bin_path=". of the boot image which is given by "any" "bin_path=".
The address is written as 64 bit little-endian number. It is the The address is written as 64 bit little-endian number. It is the
2KB block address of the boot image content, multiplied by 4, 2KB block address of the boot image content, multiplied by 4,
and then incremented by 5. and then incremented by 5.
skipping to change at line 3953 skipping to change at line 3985
@* @*
The partition GUIDs get generated by minimally varying the disk GUID. The partition GUIDs get generated by minimally varying the disk GUID.
@* @*
@strong{-boot_image any part_like_isohybrid=on} enables @strong{-boot_image any part_like_isohybrid=on} enables
-boot_image isolinux partition_entry= even if no -boot_image isolinux partition_entry= even if no
-boot_image isolinux system_area= is given. -boot_image isolinux system_area= is given.
No MBR partition of type 0xee emerges, even if GPT gets produced. No MBR partition of type 0xee emerges, even if GPT gets produced.
Gaps between GPT and APM partitions will not be filled by more partitions. Gaps between GPT and APM partitions will not be filled by more partitions.
Appended partitions get mentioned in APM if other APM partitions emerge. Appended partitions get mentioned in APM if other APM partitions emerge.
@* @*
@strong{-boot_image any iso_mbr_part_type=}number sets the partition type
of the MBR partition which represents the ISO or at least protects it.
Number may be 0x00 to 0xff. The text "default" re-enables the default types
of the various occasions to create an ISO MBR partition.
@*
This is without effect if no such partition emerges by other settings or
if the partition type is prescribed mandatorily like 0xee for GPT protective
MBR or 0x96 for CHRP.
@*
@strong{grub2_mbr=}disk_path works like "any" system_area= with additional @strong{grub2_mbr=}disk_path works like "any" system_area= with additional
patching for modern GRUB MBRs. The content start address of the first boot patching for modern GRUB MBRs. The content start address of the first boot
image is converted to a count of 512 byte blocks, and an offset of 4 is added. image is converted to a count of 512 byte blocks, and an offset of 4 is added.
The result is written as 64 bit little-endian number to byte address 0x1b0. The result is written as 64 bit little-endian number to byte address 0x1b0.
@* @*
This feature can be revoked either by grub2_mbr= with empty disk path, This feature can be revoked either by grub2_mbr= with empty disk path,
or by submitting a disk_path via system_area=. or by submitting a disk_path via system_area=.
@* @*
@cindex Partition table, _definition @cindex Partition table, _definition
@strong{partition_table=on} causes a simple partition table to be written @strong{partition_table=on} causes a simple partition table to be written
skipping to change at line 4079 skipping to change at line 4120
@* @*
Mode "off" disables alignment for any type. Mode "off" disables alignment for any type.
@* @*
@cindex MBR bootable/active flag, enforce @cindex MBR bootable/active flag, enforce
@strong{mbr_force_bootable=}mode enforces an MBR partition with @strong{mbr_force_bootable=}mode enforces an MBR partition with
"bootable/active" flag if options like partition_table= or grub2_mbr= "bootable/active" flag if options like partition_table= or grub2_mbr=
indicate production of a bootable MBR. indicate production of a bootable MBR.
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
mbr_force_bootable= forces creation of a dummy partition mbr_force_bootable="on" forces creation of a dummy partition
of type 0x00 which covers only the first block of the ISO image. of type 0x00 which covers only the first block of the ISO image.
@* @*
If no bootable MBR is indicated and a partition gets created by
-append_partition, then mbr_force_bootable="on" causes a bootflag like it
would do with a bootable MBR.
@*
@cindex MIPS boot file, activation @cindex MIPS boot file, activation
@strong{mips_path=}iso_rr_path declares a data file in the image to be a @strong{mips_path=}iso_rr_path declares a data file in the image to be a
MIPS Big Endian boot file and causes production of a MIPS Big Endian Volume MIPS Big Endian boot file and causes production of a MIPS Big Endian Volume
Header. This is mutually exclusive with production of other boot blocks Header. This is mutually exclusive with production of other boot blocks
like MBR. like MBR.
It will overwrite the first 512 bytes of any data provided by system_area=. It will overwrite the first 512 bytes of any data provided by system_area=.
Up to 15 boot files can be declared by mips_path=. Up to 15 boot files can be declared by mips_path=.
@* @*
@strong{mipsel_path=}iso_rr_path declares a data file in the image to be the @strong{mipsel_path=}iso_rr_path declares a data file in the image to be the
MIPS Little Endian boot file. This is mutually exclusive with other boot MIPS Little Endian boot file. This is mutually exclusive with other boot
skipping to change at line 4709 skipping to change at line 4754
@kindex -mount_cmd composes mount command line @kindex -mount_cmd composes mount command line
@cindex Session, mount command line, -mount_cmd @cindex Session, mount command line, -mount_cmd
Emit an appropriate command line for mounting the ISO session Emit an appropriate command line for mounting the ISO session
indicated by drive, entity and id. indicated by drive, entity and id.
The result will be different on GNU/Linux and on FreeBSD or NetBSD. The result will be different on GNU/Linux and on FreeBSD or NetBSD.
@* @*
drive can be "indev" or "outdev" to indicate already acquired drives, drive can be "indev" or "outdev" to indicate already acquired drives,
or it can be the path of a not yet acquired drive. or it can be the path of a not yet acquired drive.
Prefix "stdio:" for non-MMC drives is not mandatory. Prefix "stdio:" for non-MMC drives is not mandatory.
@* @*
entity must be either "sbsector" with the superblock sector address as id, For entity and id, see also command -load. They must be either "sbsector" with
the superblock sector address as id,
or "track" with a track number as id, or "session" with a session number, or "track" with a track number as id, or "session" with a session number,
or "volid" with a search pattern for the volume id, or "auto" with any text or "volid" with a search pattern for the volume id, or "auto" with which
as id. any text as id mounts the first track of the last session.
@* @*
path will be used as mount point and must already exist as a directory on disk. path will be used as mount point and must already exist as a directory on disk.
@* @*
The command gets printed to the result channel. See command -mount The command gets printed to the result channel. See command -mount
for direct execution of this command. for direct execution of this command.
@c man .TP @c man .TP
@item -mount_opts option[:option...] @item -mount_opts option[:option...]
@kindex -mount_cmd controls mount command @kindex -mount_cmd controls mount command
@cindex Session, mount parameters, -mount_opts @cindex Session, mount parameters, -mount_opts
Set options which influence -mount and -mount_cmd. Currently there is only Set options which influence -mount and -mount_cmd. Currently there is only
skipping to change at line 7026 skipping to change at line 7072
@sp 1 @sp 1
/var/opt/xorriso/do_abort_check_media /var/opt/xorriso/do_abort_check_media
@* @*
@sp 1 @sp 1
@c man .SS @c man .SS
@c man .SH ENVIRONMENT @c man .SH ENVIRONMENT
@node Environ, Seealso, Files, Top @node Environ, Seealso, Files, Top
@chapter Environ @chapter Environ
The following environment variables influence the program behavior: The following environment variables influence the program behavior:
@* @*
HOME is used to find xorriso and mkisofs startup files. HOME is used to find startup files of xorriso and mkisofs.
@* @*
SOURCE_DATE_EPOCH belongs to the specs of reproducible-builds.org. SOURCE_DATE_EPOCH belongs to the specs of reproducible-builds.org.
It is supposed to be either undefined or to contain a decimal number It is supposed to be either undefined or to contain a decimal number
which tells the seconds since january 1st 1970. If it contains a number, which tells the seconds since january 1st 1970. If it contains a number,
then it is used as time value to set the default of then it is used as time value to set the default of
-volume date "uuid", sets -boot_image "any" "gpt_disk_guid=" to -volume date "uuid", sets -boot_image "any" "gpt_disk_guid=" to
"volume_date_uuid", and -volume_date "all_file_dates" to "set_to_mtime", "volume_date_uuid", and -volume_date "all_file_dates" to "set_to_mtime",
@* @*
Startup files and program options can override the effect of SOURCE_DATE_EPOCH. Startup files and program options can override the effect of SOURCE_DATE_EPOCH.
@* @*
skipping to change at line 7135 skipping to change at line 7181
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) 2007 - 2016 Thomas Schmitt Copyright (c) 2007 - 2017 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 @command{xorriso}. modified in sync with the technical properties of @command{xorriso}.
If you make use of the license to derive modified versions of If you make use of the license to derive modified versions of
@command{xorriso} then you are entitled to modify this text under that @command{xorriso} then you are entitled to modify this text under that
same license. same license.
@c man .SH CREDITS @c man .SH CREDITS
@section Credits @section Credits
@command{xorriso} is in part based on work by Vreixo Formoso who provides @command{xorriso} 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.
 End of changes. 16 change blocks. 
13 lines changed or deleted 59 lines changed or added

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