"Fossies" - the Fresh Open Source Software Archive  

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

About: libisoburn is a frontend for the libraries libburn and libisofs which enables creation and expansion of ISO-9660 filesystems on all media and file types supported by libburn. It implements the API and command interpreter of program xorriso, and installs this program as small dynamically linked binary. xorriso is suitable for incremental data backup and for production of bootable ISO 9660 images. A statically linked version is available as GNU xorriso.

xorriso.texi  (libisoburn-1.5.0):xorriso.texi  (libisoburn-1.5.2)
\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.5.0 @settitle GNU xorriso 1.5.2
@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.5.0, Sep 15, 2018" @c man .TH XORRISO 1 "Version 1.5.2, Oct 26, 2019"
@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 - 2017 Thomas Schmitt Copyright @copyright{} 2007 - 2019 Thomas Schmitt
@quotation @quotation
Permission is granted to distrubute 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 1.5.0 @title Manual of GNU xorriso 1.5.2
@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.5.0 @top GNU xorriso 1.5.2
@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 906 skipping to change at line 906
empty ISO image with no changes pending is created. It can either be populated empty ISO image with no changes pending is created. It can either be populated
by help of -map, -add et.al. or it can be discarded silently if -dev or -indev by help of -map, -add et.al. or it can be discarded silently if -dev or -indev
are performed afterwards. are performed afterwards.
@* @*
Special address string "-" means standard output, to which several restrictions Special address string "-" means standard output, to which several restrictions
apply. See above paragraph "Libburn drives". apply. See above paragraph "Libburn drives".
@* @*
An empty address string "" gives up the current output drive An empty address string "" gives up the current output drive
without acquiring a new one. No writing is possible without an output drive. without acquiring a new one. No writing is possible without an output drive.
@c man .TP @c man .TP
@item -drive_class "harmless"|"banned"|"caution"|"clear_list" disk_pattern
@kindex -drive_class controls drive accessability
@cindex Drive, accessability, -drive_class
Add a drive path pattern to one of the safety lists or make those lists empty.
There are three lists defined which get tested in the following sequence:
@*
If a drive address path matches the "harmless" list then the drive will be
accepted. If it is not a MMC device then the prefix "stdio:" will be prepended
automatically. This list is empty by default.
@*
Else if the path matches the "banned" list then the drive will not be
accepted by @command{xorriso} but rather lead to a FAILURE event.
This list is empty by default.
@*
Else if the path matches the "caution" list and if it is not a MMC device,
then its address must have the prefix "stdio:" or it will be rejected.
This list has by default one entry: "/dev".
@*
If a drive path matches no list then it is considered "harmless". By default
these are all paths which do not begin with directory "/dev".
@*
A path matches a list if one of its parent paths or itself matches a list
entry. Address prefix "stdio:" or "mmc:" will be ignored when
testing for matches.
@*
By pseudo-class "clear_list" and pseudo-patterns "banned", "caution",
"harmless", or "all", the lists may be made empty.
@*
E.g.: -drive_class clear_list banned
@*
One will normally define the -drive_class lists in one of the @command{xorriso}
Startup Files.
@*
Note: This is not a security feature but rather a bumper for the superuser to
prevent inadverted mishaps. For reliably blocking access to a device file you
have to deny its rw-permissions in the filesystem.
@c man .TP
@item -drive_access "exclusive"|"shared":"unrestricted"|"readonly"
@kindex -drive_access control device file locking
@cindex Device file locking, -drive_access
Control whether device file locking mechanisms shall be used when acquiring a
drive, and whether status or content of the medium in the drive may be
altered. Useful and most harmless are the setting "shared:readonly"
and the default setting "exclusive:unrestricted".
@*
"exclusive" enables tests and locks when acquiring the drive. It depends on the
operating system which locking mechanisms get applied, if any. On GNU/Linux
it is open(O_EXCL). On FreeBSD it is flock(LOCK_EX).
@*
"shared" disables the use of these mechanisms to become able to acquire drives
which are mounted, or opened by some process, or guarded by /dev/pktcdvd*.
@*
"unrestricted" enables all technically appropriate operations on an acquired
drive. "shared:unrestricted" risks to get own burn runs spoiled by other
processes or to vice versa spoil activities of such processes. So use
"exclusive:unrestricted" unless you know for sure that "shared" is safe.
@*
"readonly" disables operations which might surprise a co-user of the drive.
For -outdev these are formatting, blanking, writing, ejecting. For -indev
this is ejecting. Be aware that even reading and drive status inquiries can
disturb an ongoing burn run on CD-R[W] and DVD-R[W].
@c man .TP
@item -scsi_dev_family "default"|"sr"|"scd"|"sg" @item -scsi_dev_family "default"|"sr"|"scd"|"sg"
@kindex -scsi_dev_family choose Linux device file type @kindex -scsi_dev_family choose Linux device file type
@cindex Linux device type, -scsi_dev_family @cindex Linux device type, -scsi_dev_family
GNU/Linux specific: GNU/Linux specific:
@* @*
By default, xorriso tries to map Linux drive addresses to /dev/sr* before By default, xorriso tries to map Linux drive addresses to /dev/sr* before
they get opened for operating the drive. This coordinates well with they get opened for operating the drive. This coordinates well with
other use cases of optical drives, like mount(8). But since year 2010 other use cases of optical drives, like mount(8). But since year 2010
all /dev/sr* share a global lock which allows only one drive to process all /dev/sr* share a global lock which allows only one drive to process
an SCSI command while all others have to wait for its completion. an SCSI command while all others have to wait for its completion.
skipping to change at line 1047 skipping to change at line 1109
If an ISO image was written onto a partition with offset of 640000 blocks of If an ISO image was written onto a partition with offset of 640000 blocks of
512 bytes, then it can be loaded from the base device by 512 bytes, then it can be loaded from the base device by
-load sbsector 160000 -displacement 160000 -load sbsector 160000 -displacement 160000
@* @*
(If the partition start address is not divisible by 4, then you will have (If the partition start address is not divisible by 4, then you will have
to employ a loop device instead.) to employ a loop device instead.)
@* @*
In both cases, the ISO sessions should be self contained, i.e. not add-on In both cases, the ISO sessions should be self contained, i.e. not add-on
sessions to an ISO image outside their track or partition. sessions to an ISO image outside their track or partition.
@c man .TP @c man .TP
@item -drive_class "harmless"|"banned"|"caution"|"clear_list" disk_pattern
@kindex -drive_class controls drive accessability
@cindex Drive, accessability, -drive_class
Add a drive path pattern to one of the safety lists or make those lists empty.
There are three lists defined which get tested in the following sequence:
@*
If a drive address path matches the "harmless" list then the drive will be
accepted. If it is not a MMC device then the prefix "stdio:" will be prepended
automatically. This list is empty by default.
@*
Else if the path matches the "banned" list then the drive will not be
accepted by @command{xorriso} but rather lead to a FAILURE event.
This list is empty by default.
@*
Else if the path matches the "caution" list and if it is not a MMC device,
then its address must have the prefix "stdio:" or it will be rejected.
This list has by default one entry: "/dev".
@*
If a drive path matches no list then it is considered "harmless". By default
these are all paths which do not begin with directory "/dev".
@*
A path matches a list if one of its parent paths or itself matches a list
entry. Address prefix "stdio:" or "mmc:" will be ignored when
testing for matches.
@*
By pseudo-class "clear_list" and pseudo-patterns "banned", "caution",
"harmless", or "all", the lists may be made empty.
@*
E.g.: -drive_class clear_list banned
@*
One will normally define the -drive_class lists in one of the @command{xorriso}
Startup Files.
@*
Note: This is not a security feature but rather a bumper for the superuser to
prevent inadverted mishaps. For reliably blocking access to a device file you
have to deny its rw-permissions in the filesystem.
@c man .TP
@item -read_fs "any"|"norock"|"nojoliet"|"ecma119" @item -read_fs "any"|"norock"|"nojoliet"|"ecma119"
@kindex -read_fs filesystem type for image loading @kindex -read_fs filesystem type for image loading
@cindex Image, filesystem to load, -read_fs @cindex Image, filesystem to load, -read_fs
Specify which kind of filesystem tree to load if present. If the wish cannot Specify which kind of filesystem tree to load if present. If the wish cannot
be fulfilled, then ECMA-119 names are loaded and converted according be fulfilled, then ECMA-119 names are loaded and converted according
to -ecma119_map. to -ecma119_map.
@* @*
"any" first tries to read Rock Ridge. If not present, Joliet is tried. "any" first tries to read Rock Ridge. If not present, Joliet is tried.
@* @*
"norock" does not try Rock Ridge. "norock" does not try Rock Ridge.
skipping to change at line 1194 skipping to change at line 1219
@c man .TP @c man .TP
@item -xattr "on"|"user"|"any"|"off" @item -xattr "on"|"user"|"any"|"off"
@kindex -xattr controls handling of xattr (EA) @kindex -xattr controls handling of xattr (EA)
@cindex xattr, control handling, -xattr @cindex xattr, control handling, -xattr
Enable or disable processing of xattr attributes. Enable or disable processing of xattr attributes.
If enabled, then @command{xorriso} will handle xattr similar to ACL. If enabled, then @command{xorriso} will handle xattr similar to ACL.
See also commands -getfattr, -setfattr and above paragraph about xattr. See also commands -getfattr, -setfattr and above paragraph about xattr.
@* @*
Modes "on" and "user" read and write only attributes from namespace "user". Modes "on" and "user" read and write only attributes from namespace "user".
@* @*
Mode "any" processes attributes of all namespaces. This might need adminstrator Mode "any" processes attributes of all namespaces. This might need
privileges, even if the owner of the disk file tries to read or write the administrator privileges, even if the owner of the disk file tries to read or
attributes. write the attributes.
@* @*
Note that xattr from namespace "isofs." are never read from disk or restored Note that xattr from namespace "isofs." are never read from disk or restored
to disk. Further it is not possible to set them via xorriso xattr manipulation to disk. Further it is not possible to set them via xorriso xattr manipulation
commands. commands.
@c man .TP @c man .TP
@item -md5 "on"|"all"|"off"|"load_check_off" @item -md5 "on"|"all"|"off"|"load_check_off"
@kindex -md5 controls handling of MD5 sums @kindex -md5 controls handling of MD5 sums
@cindex MD5, control handling, -md5 @cindex MD5, control handling, -md5
Enable or disable processing of MD5 checksums for the overall session and for Enable or disable processing of MD5 checksums for the overall session and for
each single data file. If enabled then images with checksum tags get loaded each single data file. If enabled then images with checksum tags get loaded
skipping to change at line 1272 skipping to change at line 1297
removes trailing ";1" or ".;1" if present. removes trailing ";1" or ".;1" if present.
@* @*
Mode "unmapped" shows names as found without removing characters. Mode "unmapped" shows names as found without removing characters.
@* @*
Mode "lowercase" is like "stripped" but also maps uppercase letters to Mode "lowercase" is like "stripped" but also maps uppercase letters to
lowercase letters. This is compatible to default GNU/Linux mount behavior. lowercase letters. This is compatible to default GNU/Linux mount behavior.
@* @*
Mode "uppercase" is like "stripped" but maps lowercase letters to uppercase, Mode "uppercase" is like "stripped" but maps lowercase letters to uppercase,
if any occur despite the prescriptions of ECMA-119. if any occur despite the prescriptions of ECMA-119.
@c man .TP @c man .TP
@item -iso_nowtime "dynamic"|timestring
@kindex -iso_nowtime fixed "now" time for ISO 9660 objects
@cindex libisofs, fixed "now" time
Choose whether to use the current time ("dynamic") or a fixed time point
for timestamps of ISO 9660 nodes without a disk source file and as default
for superblock timestamps.
@*
If a timestring is given, then it is used for such timestamps. For the formats
of timestrings see command @strong{-alter_date}.
@c man .TP
@item -disk_dev_ino "on"|"ino_only"|"off" @item -disk_dev_ino "on"|"ino_only"|"off"
@kindex -disk_dev_ino fast incremental backup @kindex -disk_dev_ino fast incremental backup
@cindex Backup, enable fast incremental, -disk_dev_ino @cindex Backup, enable fast incremental, -disk_dev_ino
Enable or disable processing of recorded file identification numbers Enable or disable processing of recorded file identification numbers
(dev_t and ino_t). If enabled they are stored as xattr and can (dev_t and ino_t). If enabled they are stored as xattr and can
substantially accelerate file comparison. The root node gets a global start substantially accelerate file comparison. The root node gets a global start
timestamp. If during comparison a file with younger timestamps is found in the timestamp. If during comparison a file with younger timestamps is found in the
ISO image, then it is suspected to have inconsistent content. ISO image, then it is suspected to have inconsistent content.
@* @*
If device numbers and inode numbers of the disk filesystems are persistent If device numbers and inode numbers of the disk filesystems are persistent
skipping to change at line 1936 skipping to change at line 1971
Older operating systems can handle files in mounted ISO 9660 filesystems Older operating systems can handle files in mounted ISO 9660 filesystems
only if they are smaller than 2 GiB or in other cases 4 GiB. only if they are smaller than 2 GiB or in other cases 4 GiB.
@* @*
Default is 0 which will exclude files larger than -file_size_limit by a Default is 0 which will exclude files larger than -file_size_limit by a
FAILURE event. FAILURE event.
A well tested -split_size is 2047m. Sizes above -file_size_limit are not A well tested -split_size is 2047m. Sizes above -file_size_limit are not
permissible. permissible.
@* @*
While command -split_size is set larger than 0 such a directory with split While command -split_size is set larger than 0 such a directory with split
file pieces will be recognized and handled like a regular file by commands file pieces will be recognized and handled like a regular file by commands
-compare* , -update*, and in overwrite situations. There are -ossirox -compare* , -update*, and in overwrite situations. There are -osirrox
parameters "concat_split_on" and "concat_split_off" which control the handling parameters "concat_split_on" and "concat_split_off" which control the handling
when files get restored to disk. when files get restored to disk.
@* @*
In order to be recognizable, the names of the part files have to In order to be recognizable, the names of the part files have to
describe the splitting by 5 numbers: describe the splitting by 5 numbers:
@* @*
part_number,total_parts,byte_offset,byte_count,disk_file_size part_number,total_parts,byte_offset,byte_count,disk_file_size
@* @*
which are embedded in the following text form: which are embedded in the following text form:
@* @*
skipping to change at line 3765 skipping to change at line 3800
The component Flags modifies the further interpretation: The component Flags modifies the further interpretation:
@* @*
"local_fs" demands to read from a file depicted by the path in Source. "local_fs" demands to read from a file depicted by the path in Source.
@* @*
"imported_iso" demands to read from the -indev. This works only if -outdev "imported_iso" demands to read from the -indev. This works only if -outdev
is not the same as -indev. The Source component is ignored. is not the same as -indev. The Source component is ignored.
@* @*
"appended_partition_NNN" with a decimal number NNN works only for -boot_image "appended_partition_NNN" with a decimal number NNN works only for -boot_image
bootspecs which announce El Torito boot image paths: bin_path=, efi_path=. bootspecs which announce El Torito boot image paths: bin_path=, efi_path=.
The number gives the partition number as used with the corresponding The number gives the partition number as used with the corresponding
option -append_partition. command -append_partition.
@* @*
The component Interval consists of two byte address numbers separated by a "-" character. E.g. "0-429" means to read bytes 0 to 429. The component Interval consists of two byte address numbers separated by a "-" character. E.g. "0-429" means to read bytes 0 to 429.
@* @*
The component Zeroizers consists of zero or more comma separated strings. The component Zeroizers consists of zero or more comma separated strings.
They define which part of the read data to zeroize. Byte number 0 means They define which part of the read data to zeroize. Byte number 0 means
the byte read from the Interval start address. the byte read from the Interval start address.
Each string may be one of: Each string may be one of:
@* @*
"zero_mbrpt" demands to zeroize the MBR partition table if "zero_mbrpt" demands to zeroize the MBR partition table if
bytes 510 and 511 bear the MBR signature 0x55 0xaa. bytes 510 and 511 bear the MBR signature 0x55 0xaa.
skipping to change at line 4024 skipping to change at line 4059
@* @*
@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 @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. 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 Number may be 0x00 to 0xff. The text "default" re-enables the default types
of the various occasions to create an ISO MBR partition. of the various occasions to create an ISO MBR partition.
@*
This is without effect if no such partition emerges by other settings or 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 if the partition type is prescribed mandatorily like 0xee for GPT protective
MBR or 0x96 for CHRP. MBR or 0x96 for CHRP.
@* @*
If instead a type_guid is given by a 32-digit hex string like
a2a0d0ebe5b9334487c068b6b72699c7 or by a structured text like
EBD0A0A2-B9E5-4433-87C0-68B6B72699C7, then it will be used as partition type
if the ISO filesystem appears as partition in GPT.
In MBR, C12A7328-F81F-11D2-BA4B-00A0C93EC93B will be mapped to 0xef.
Any other GUID will be mapped to 0x83.
@*
@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 4268 skipping to change at line 4310
Partitions may be appended with boot block type MBR and with SUN Disk Label. Partitions may be appended with boot block type MBR and with SUN Disk Label.
@* @*
With MBR: With MBR:
@* @*
partition_number may be 1 to 4. Number 1 will put the whole ISO image into partition_number may be 1 to 4. Number 1 will put the whole ISO image into
the unclaimed space before partition 1. So together with most @command{xorriso} the unclaimed space before partition 1. So together with most @command{xorriso}
MBR features, number 2 would be the most natural choice. MBR features, number 2 would be the most natural choice.
@* @*
The type_code may be "FAT12", "FAT16", "Linux", The type_code may be "FAT12", "FAT16", "Linux",
or a hexadecimal number between 0x00 and 0xff. Not all those numbers will or a hexadecimal number between 0x00 and 0xff. Not all those numbers will
yield usable results. For a list of codes search the Internet for yield usable results. For a list of MBR partition type codes search the
"Partition Types" or run fdisk command "L". Internet for "Partition Types" or run fdisk command "L".
@*
type_code may also be a type GUID as plain hex string like
a2a0d0ebe5b9334487c068b6b72699c7 or as structured text like
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
to 0xef. Any other GUID will be mapped to 0x83.
@* @*
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. partitions will be mentioned there too.
@* @*
The disk_path must provide the necessary data bytes at commit time. The disk_path must provide the necessary data bytes at commit time.
An empty disk_path disables this feature for the given partition number. An empty disk_path disables this feature for the given partition number.
@* @*
@cindex SUN SPARC boot images, activation @cindex SUN SPARC boot images, activation
With SUN Disk Label (selected by -boot_image any sparc_label=): With SUN Disk Label (selected by -boot_image any sparc_label=):
@* @*
skipping to change at line 5383 skipping to change at line 5431
@* @*
"valid" and "invalid" are qualities imported from a sector_map file. "valid" and "invalid" are qualities imported from a sector_map file.
"tao_end" and "off_track" are intentionally not readable, but not bad either. "tao_end" and "off_track" are intentionally not readable, but not bad either.
"partial" are blocks retrieved from a partially readable chunk. They are "partial" are blocks retrieved from a partially readable chunk. They are
supposed to be ok but stem from a suspicious neighborhood. supposed to be ok but stem from a suspicious neighborhood.
@* @*
"md5_match" and "md5_mismatch" regions overlap with regions of other quality. "md5_match" and "md5_mismatch" regions overlap with regions of other quality.
The former is a strong confirmation for quality, the latter only tells that The former is a strong confirmation for quality, the latter only tells that
one or more blocks of the region must be wrong. one or more blocks of the region must be wrong.
@* @*
By default bad_limit is set higher than md5_mismatch, so that mismatches are
classified as quality class "0" rather than "-". This means that the sectors
of a MD5 mismatch range are recorded in the sector_map as successfully read,
if the drive handed them out at all. Set "bad_limit=md5_mismatch" to let the
sector_map record the whole mismatching range as yet not retrieved.
@*
@item slow_limit=threshold @item slow_limit=threshold
sets the time threshold for a single read chunk to be considered sets the time threshold for a single read chunk to be considered
slow. This may be a fractional number like 0.1 or 1.5. slow. This may be a fractional number like 0.1 or 1.5.
@* @*
@item async_chunks=number @item async_chunks=number
enables asynchronous MD5 processing if number is 2 or larger. enables asynchronous MD5 processing if number is 2 or larger.
In this case the given number of read chunks is allocated as fifo buffer. In this case the given number of read chunks is allocated as fifo buffer.
On very fast MMC drives try: chunk_size=64s async_chunks=16. On very fast MMC drives try: chunk_size=64s async_chunks=16.
@end table @end table
@c man .TP @c man .TP
skipping to change at line 5478 skipping to change at line 5532
@* @*
Option "sort_lba_on" may improve read performance with optical drives. It Option "sort_lba_on" may improve read performance with optical drives. It
can restore large numbers of hard links without exhausting can restore large numbers of hard links without exhausting
-temp_mem_limit. It does not preserve directory mtime and it needs -temp_mem_limit. It does not preserve directory mtime and it needs
-osirrox option auto_chmod_on in order to extract directories which offer no -osirrox option auto_chmod_on in order to extract directories which offer no
write permission. Default is "sort_lba_off". write permission. Default is "sort_lba_off".
@* @*
Option "o_excl_on" is the default unless the program was started with leafname Option "o_excl_on" is the default unless the program was started with leafname
"osirrox". On GNU/Linux it tries to avoid using drives which are mounted or in "osirrox". On GNU/Linux it tries to avoid using drives which are mounted or in
use by other libburn programs. use by other libburn programs.
Option "o_excl_off" on GNU/Linux enables access to such drives. Drives which Option "o_excl_off" on GNU/Linux enables access to such drives by the
equivalent of -drive_access "shared:readonly". I.e. drives which
get acquired while "o_excl_off" will refuse to get blanked, formatted, get acquired while "o_excl_off" will refuse to get blanked, formatted,
written, or ejected. But be aware that even harmless inquiries can spoil written, or ejected. But be aware that even harmless inquiries can spoil
ongoing burns of CD-R[W] and DVD-R[W]. ongoing burns of CD-R[W] and DVD-R[W].
@* @*
Option "strict_acl_off" is default. It tolerates on FreeBSD the presence of Option "strict_acl_off" is default. It tolerates on FreeBSD the presence of
directory "default" ACLs in the ISO image. With "strict_acl_on" these directory "default" ACLs in the ISO image. With "strict_acl_on" these
GNU/Linux ACLs cause on FreeBSD a FAILURE event during restore with -acl "on". GNU/Linux ACLs cause on FreeBSD a FAILURE event during restore with -acl "on".
@c man .TP @c man .TP
@item -extract iso_rr_path disk_path @item -extract iso_rr_path disk_path
@kindex -extract copies file tree to disk @kindex -extract copies file tree to disk
skipping to change at line 6110 skipping to change at line 6165
determine the start_lba of a session for mount options -o sbsector= determine the start_lba of a session for mount options -o sbsector=
(on GNU/Linux) or -s (on FreeBSD) from date or volume ID. (on GNU/Linux) or -s (on FreeBSD) from date or volume ID.
@* @*
Record format is: timestamp start_lba size volume-id Record format is: timestamp start_lba size volume-id
@* @*
The first three items are single words, the rest of the line is the volume ID. The first three items are single words, the rest of the line is the volume ID.
@c man .TP @c man .TP
@item -scsi_log "on"|"off" @item -scsi_log "on"|"off"
@kindex -scsi_log reports SCSI commands @kindex -scsi_log reports SCSI commands
@cindex Drive, report SCSI commands, -scsi_log @cindex Drive, report SCSI commands, -scsi_log
Mode "on" enables very verbous logging of SCSI commands and drive replies. Mode "on" enables very verbose logging of SCSI commands and drive replies.
Logging messages get printed to stderr, not to any of the @command{xorriso} Logging messages get printed to stderr, not to any of the @command{xorriso}
output channels. output channels.
@* @*
A special property of this command is that the first -scsi_log setting A special property of this command is that the first -scsi_log setting
among the start arguments is in effect already when the first operations among the start arguments is in effect already when the first operations
of @command{xorriso} begin. of @command{xorriso} begin.
Only "-scsi_log" with dash "-" is recognized that way. Only "-scsi_log" with dash "-" is recognized that way.
@c man .TP @c man .TP
@item -end @item -end
@kindex -end writes pending session and ends program @kindex -end writes pending session and ends program
skipping to change at line 6756 skipping to change at line 6811
or filtering. or filtering.
@* @*
The first session is written like this: The first session is written like this:
@* @*
@sp 1 @sp 1
$ xorriso -as mkisofs prepared_for_iso/tree1 | \ $ xorriso -as mkisofs 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 -
@* @*
@sp 1 @sp 1
Follow-up sessions are written like this: Follow-up sessions are written like this (the run of dd is only to give demons
a chance to spoil it):
@* @*
@sp 1 @sp 1
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
@*
$ m=$(xorriso -as cdrecord dev=/dev/sr0 -msinfo) $ m=$(xorriso -as cdrecord dev=/dev/sr0 -msinfo)
@* @*
$ dd if=/dev/sr0 count=1 >/dev/null 2>&1
@*
$ xorriso -as mkisofs -M /dev/sr0 -C $m prepared_for_iso/tree2 | \ $ xorriso -as mkisofs -M /dev/sr0 -C $m prepared_for_iso/tree2 | \
@* @*
xorriso -as cdrecord -v dev=/dev/sr0 -waiti -multi -eject - xorriso -as cdrecord -v dev=/dev/sr0 -waiti -multi -eject -
@* @*
@sp 1 @sp 1
Always eject the drive tray between sessions. The old sessions Always eject the drive tray between sessions.
get read via /dev/sr0. Its device driver might not be aware
of the changed content before it loads the medium again.
In this case the previous session would not be loaded and the
new session would contain only the newly added files.
@* @*
For the same reason do not let @command{xorriso} -as cdrecord load the medium, The run of xorriso -as mkisofs will read old sessions via the CD-ROM
but rather do this manually or by a program that reads from /dev/sr0. driver of /dev/sr0. This driver might not be aware of the changed content
as long as the medium is not loaded again. In this case the previous session
would not be properly assessed by xorriso and the new session would contain
only the newly added files.
@*
Some systems have not enough patience with automatic tray loading and some
demons may interfere with a first CD-ROM driver read attempt from a freshly
loaded medium.
@*
When loading the tray manually, wait 10 seconds after the drive has stopped
blinking.
@*
A safe automatic way seems to be a separate run of xorriso for loading
the tray with proper waiting, and a subsequent run of dd which shall offer
itself to any problems caused by demons assessing the changed drive status.
If this does not help, insert a run of "sleep 10" between xorriso and dd.
@* @*
@sp 1 @sp 1
This example works for multi-session media only. This example works for multi-session media only.
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 overwriteable media.
@c man .SS @c man .SS
@c man .B Let xorriso work underneath growisofs @c man .B Let xorriso work underneath growisofs
@node ExGrowisofs, ExException, ExMkisofs, Examples @node ExGrowisofs, ExException, ExMkisofs, Examples
@section Let @command{xorriso} work underneath growisofs @section Let @command{xorriso} work underneath growisofs
skipping to change at line 6825 skipping to change at line 6892
@* @*
$ growisofs -M /dev/dvd @minus{}@minus{} outdev - -update_r /my/files /files $ growisofs -M /dev/dvd @minus{}@minus{} outdev - -update_r /my/files /files
@* @*
@sp 1 @sp 1
growisofs has excellent burn capabilities with DVD and BD. growisofs has excellent burn capabilities with DVD and BD.
It does not emulate session history on overwriteable media, though. It does not emulate session history on overwriteable media, though.
@c man .SS @c man .SS
@c man .B Adjust thresholds for verbosity, exit value and program abort @c man .B Adjust thresholds for verbosity, exit value and program abort
@node ExException, ExTime, ExGrowisofs, Examples @node ExException, ExTime, ExGrowisofs, Examples
@section Adjust thresholds for verbosity, exit value and program abort @section Adjust thresholds for verbosity, exit value and program abort
Be quite verbous, exit 32 if severity "FAILURE" was encountered, Be quite verbose, exit 32 if severity "FAILURE" was encountered,
do not abort prematurely but forcibly go on until the end of commands. do not abort prematurely but forcibly go on until the end of commands.
@* @*
@sp 1 @sp 1
$ xorriso ... \ $ xorriso ... \
@* @*
-report_about UPDATE \ -report_about UPDATE \
@* @*
-return_with FAILURE 32 \ -return_with FAILURE 32 \
@* @*
-abort_on NEVER \ -abort_on NEVER \
skipping to change at line 7121 skipping to change at line 7188
@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 startup files of xorriso and mkisofs. 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", -volume_date "all_file_dates" to "set_to_mtime",
and -iso_nowtime to "=$SOURCE_DATE_EPOCH".
@* @*
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.
@* @*
@sp 1 @sp 1
@c man .SS @c man .SS
@c man .SH SEE ALSO @c man .SH SEE ALSO
@c man .TP @c man .TP
@c man For the mkisofs emulation of xorriso @c man For the mkisofs emulation of xorriso
@c man .BR xorrisofs(1) @c man .BR xorrisofs(1)
@c man .TP @c man .TP
skipping to change at line 7223 skipping to change at line 7291
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 - 2018 Thomas Schmitt Copyright (c) 2007 - 2019 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. 27 change blocks. 
66 lines changed or deleted 134 lines changed or added

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