libburnia/legacy
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Corrections in xorriso manual. Proposed by Paul Menzel.

Browse Source
This commit is contained in:
Thomas Schmitt 2012-11-05 09:37:47 +00:00
parent b0f8246ff2
commit 7353d3534e
3 changed files with 226 additions and 215 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
libisoburn/trunk/xorriso/xorriso.1
View File

@ -771,7 +771,7 @@ prevent inadverted mishaps. For reliably blocking access to a device file you
have to deny its rw\-permissions in the filesystem. have to deny its rw\-permissions in the filesystem.
.TP .TP
\fB\-assert_volid\fR pattern severity \fB\-assert_volid\fR pattern severity
Refuse to load ISO images with volume ids which do not match the given Refuse to load ISO images with volume IDs which do not match the given
search pattern. When refusing an image, give up the input drive and issue search pattern. When refusing an image, give up the input drive and issue
an event of the given severity (like FAILURE, see \-abort_on). An empty search an event of the given severity (like FAILURE, see \-abort_on). An empty search
pattern accepts any image. pattern accepts any image.
@ -2467,49 +2467,54 @@ The name must not contain a '/' character and must not be longer than
255 bytes. 255 bytes.
.TP .TP
\fB\-volid\fR text \fB\-volid\fR text
Specify the volume ID. \fBxorriso\fR accepts any text up to 32 characters, Specify the volume ID, which can be considered to be the name of the image.
\fBxorriso\fR accepts any text up to 32 characters,
but according to rarely obeyed specs stricter rules apply: but according to rarely obeyed specs stricter rules apply:
.br .br
ECMA\-119 demands ASCII characters out of [A\-Z0\-9_]. Like: "IMAGE_23" ECMA\-119 demands ASCII characters out of [A\-Z0\-9_]. Like:
.br .br
Joliet allows 16 UCS\-2 characters. Like: "Windows name" "IMAGE_23"
.br .br
Be aware that the volume id might get used automatically as name of the Joliet allows 16 UCS\-2 characters. Like:
.br
"Windows name"
.br
Be aware that the volume id might get used automatically as the name of the
mount point when the medium is inserted into a playful computer system. mount point when the medium is inserted into a playful computer system.
.br .br
If an ISO image gets loaded while the volume ID is set to default "ISOIMAGE" If an ISO image gets loaded while the volume ID is set to default "ISOIMAGE"
or to "", then the volume ID of the loaded image will become the effective or to "", then the volume ID of the loaded image will become the effective
volume id for the next write run. But as soon as command \-volid is performed volume id for the next write run. But as soon as command \-volid is performed
afterwards, this pending id is overridden by the new setting. afterwards, this pending ID is overridden by the new setting.
.br .br
Consider this when setting \-volid "ISOIMAGE" before executing \-dev, \-indev, Consider this when setting \-volid "ISOIMAGE" before executing \-dev, \-indev,
or \-rollback. or \-rollback.
If you insist in \-volid "ISOIMAGE", set it again after those commands. If you insist in \-volid "ISOIMAGE", set it again after those commands.
.TP .TP
\fB\-volset_id\fR text \fB\-volset_id\fR text
Set the volume set id string to be written with the next \-commit. Set the volume set ID string to be written with the next \-commit.
Permissible are up to 128 characters. This setting gets overridden by Permissible are up to 128 characters. This setting gets overridden by
image loading. image loading.
.TP .TP
\fB\-publisher\fR text \fB\-publisher\fR text
Set the publisher id string to be written with the next \-commit. This may Set the publisher ID string to be written with the next \-commit. This may
identify the person or organisation who specified what shall be recorded. identify the person or organisation who specified what shall be recorded.
Permissible are up to 128 characters. This setting gets overridden by Permissible are up to 128 characters. This setting gets overridden by
image loading. image loading.
.TP .TP
\fB\-application_id\fR text \fB\-application_id\fR text
Set the application id string to be written with the next \-commit. This may Set the application ID string to be written with the next \-commit. This may
identify the specification of how the data are recorded. identify the specification of how the data are recorded.
Permissible are up to 128 characters. This setting gets overridden by Permissible are up to 128 characters. This setting gets overridden by
image loading. image loading.
.br .br
The special text "@xorriso@" gets converted to the id string of The special text "@xorriso@" gets converted to the ID string of
\fBxorriso\fR \fBxorriso\fR
which is normally written as \-preparer_id. It is a wrong tradition to write which is normally written as \-preparer_id. It is a wrong tradition to write
the program id as \-application_id. the program ID as \-application_id.
.TP .TP
\fB\-system_id\fR text \fB\-system_id\fR text
Set the system id string to be written with the next \-commit. This may Set the system ID string to be written with the next \-commit. This may
identify the system which can recognize and act upon the content of the identify the system which can recognize and act upon the content of the
System Area in image blocks 0 to 15. System Area in image blocks 0 to 15.
Permissible are up to 32 characters. This setting gets overridden by Permissible are up to 32 characters. This setting gets overridden by
@ -2564,16 +2569,16 @@ Permissible are up to 37 characters. This setting gets overridden by
image loading. image loading.
.TP .TP
\fB\-preparer_id\fR \fB\-preparer_id\fR
Set the preparer id string to be written with the next \-commit. This may Set the preparer ID string to be written with the next \-commit. This may
identify the person or other entity which controls the preparation of the data identify the person or other entity which controls the preparation of the data
which shall be recorded. Normally this should be the id of \fBxorriso\fR which shall be recorded. Normally this should be the ID of \fBxorriso\fR
and not of the person or program which operates \fBxorriso\fR. and not of the person or program which operates \fBxorriso\fR.
Please avoid to change it. Permissible are up to 128 characters. Please avoid to change it. Permissible are up to 128 characters.
.br .br
The special text "@xorriso@" gets converted to the id string of The special text "@xorriso@" gets converted to the ID string of
\fBxorriso\fR which is default at program startup. \fBxorriso\fR which is default at program startup.
.br .br
Unlike other id strings, this setting is not influenced by image loading. Unlike other ID strings, this setting is not influenced by image loading.
.TP .TP
\fB\-out_charset\fR character_set_name \fB\-out_charset\fR character_set_name
Set the character set to which file names get converted when writing an Set the character set to which file names get converted when writing an
@ -3474,9 +3479,9 @@ Print available space on the output medium and the free space after
subtracting already foreseeable consumption by next \-commit. subtracting already foreseeable consumption by next \-commit.
.TP .TP
\fB\-pvd_info\fR \fB\-pvd_info\fR
Print various id strings which can be found in loaded ISO images. Some of Print various ID strings which can be found in loaded ISO images. Some of
them may be changed by commands like \-volid or \-publisher. For these them may be changed by commands like \-volid or \-publisher. For these
ids \-pvd_info reports what would be written with the next \-commit. IDs \-pvd_info reports what would be written with the next \-commit.
.TP .TP
.B Navigation in ISO image and disk filesystem: .B Navigation in ISO image and disk filesystem:
.TP .TP
@ -3820,7 +3825,7 @@ and their start block addresses, followed by binary bitmap data.
.br .br
\fBmap_with_volid="on"\fR \fBmap_with_volid="on"\fR
examines tracks whether they are ISO images and examines tracks whether they are ISO images and
prints their volume ids into the human readable TOC of sector_map=. prints their volume IDs into the human readable TOC of sector_map=.
.br .br
\fBpatch_lba0="on"\fR \fBpatch_lba0="on"\fR
transfers within the data_to= file a copy of the currently transfers within the data_to= file a copy of the currently
@ -4400,11 +4405,11 @@ This transport becomes visible with \-report_about "ALL".
If path is not empty it gives the address of a plain text file where If path is not empty it gives the address of a plain text file where
a log record gets appended after each session. This log can be used to a log record gets appended after each session. This log can be used to
determine the start_lba of a session for mount options \-o sbsector= determine the start_lba of a session for mount options \-o sbsector=
resp. \-s from date or volume id. resp. \-s from date or volume ID.
.br .br
Record format is: timestamp start_lba size volume\-id Record format is: timestamp start_lba size volume\-id
.br .br
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.
.TP .TP
\fB\-scsi_log\fR "on"|"off" \fB\-scsi_log\fR "on"|"off"
Mode "on" enables very verbous logging of SCSI commands and drive replies. Mode "on" enables very verbous logging of SCSI commands and drive replies.
@ -4840,7 +4845,7 @@ accordingly.
.br .br
ACL, xattr, hard links and MD5 checksums will be recorded. ACL, xattr, hard links and MD5 checksums will be recorded.
Accelerated comparison is enabled at the expense of potentially larger backup Accelerated comparison is enabled at the expense of potentially larger backup
size. Only media with the expected volume id or blank media are accepted. size. Only media with the expected volume ID or blank media are accepted.
Files with names matching *.o or *.swp get excluded explicitly. Files with names matching *.o or *.swp get excluded explicitly.
.br .br
When done with writing the new session gets checked by its recorded MD5. When done with writing the new session gets checked by its recorded MD5.

287
libisoburn/trunk/xorriso/xorriso.info
View File

@ -31,7 +31,7 @@ images with Rock Ridge extensions.
* Extras:: Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr * Extras:: Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr
* Processing:: Command processing * Processing:: Command processing
* Dialog:: Dialog, Readline, Result pager * Dialog:: Dialog, Readline, Result pager
* Options:: Reference of commands * Commands:: Reference of commands
* Examples:: Examples * Examples:: Examples
* Files:: Files * Files:: Files
* Seealso:: See also * Seealso:: See also
@ -467,7 +467,7 @@ arguments if dialog mode has not been enabled at that point, or by a
problem event which triggers the threshold of command -abort_on. problem event which triggers the threshold of command -abort_on.
 
File: xorriso.info, Node: Dialog, Next: Options, Prev: Processing, Up: Top File: xorriso.info, Node: Dialog, Next: Commands, Prev: Processing, Up: Top
8 Dialog, Readline, Result pager 8 Dialog, Readline, Result pager
******************************** ********************************
@ -502,10 +502,10 @@ The request to abort may or may not be obeyed by the current action.
All actions try to abort as soon as possible. All actions try to abort as soon as possible.
 
File: xorriso.info, Node: Options, Next: Examples, Prev: Dialog, Up: Top File: xorriso.info, Node: Commands, Next: Examples, Prev: Dialog, Up: Top
9 Options 9 Commands
********* **********
All command words are shown with a leading dash although this dash is All command words are shown with a leading dash although this dash is
not mandatory for the command to be recognized. Nevertheless within not mandatory for the command to be recognized. Nevertheless within
@ -539,7 +539,7 @@ inner dashes are interpreted as underscores.
* Frontend:: Support for frontend programs via stdin and stdout * Frontend:: Support for frontend programs via stdin and stdout
 
File: xorriso.info, Node: ArgSort, Next: AqDrive, Prev: Options, Up: Options File: xorriso.info, Node: ArgSort, Next: AqDrive, Prev: Commands, Up: Commands
9.1 Execution order of program arguments 9.1 Execution order of program arguments
======================================== ========================================
@ -572,7 +572,7 @@ loss of expressivity.
listed sorting order may well make sense, though. listed sorting order may well make sense, though.
 
File: xorriso.info, Node: AqDrive, Next: Loading, Prev: ArgSort, Up: Options File: xorriso.info, Node: AqDrive, Next: Loading, Prev: ArgSort, Up: Commands
9.2 Acquiring source and target drive 9.2 Acquiring source and target drive
===================================== =====================================
@ -632,7 +632,7 @@ commands which acquire the drive.
output begins. The output drive is given up when writing is done. output begins. The output drive is given up when writing is done.
 
File: xorriso.info, Node: Loading, Next: Insert, Prev: AqDrive, Up: Options File: xorriso.info, Node: Loading, Next: Insert, Prev: AqDrive, Up: Commands
9.3 Influencing the behavior of image loading 9.3 Influencing the behavior of image loading
============================================= =============================================
@ -715,7 +715,7 @@ activate them only after image loading.
filesystem. filesystem.
-assert_volid pattern severity -assert_volid pattern severity
Refuse to load ISO images with volume ids which do not match the Refuse to load ISO images with volume IDs which do not match the
given search pattern. When refusing an image, give up the input given search pattern. When refusing an image, give up the input
drive and issue an event of the given severity (like FAILURE, see drive and issue an event of the given severity (like FAILURE, see
-abort_on). An empty search pattern accepts any image. -abort_on). An empty search pattern accepts any image.
@ -915,7 +915,7 @@ activate them only after image loading.
numbers. Currently the default is 32 tiles of 32 blocks = 2 MiB. numbers. Currently the default is 32 tiles of 32 blocks = 2 MiB.
 
File: xorriso.info, Node: Insert, Next: SetInsert, Prev: Loading, Up: Options File: xorriso.info, Node: Insert, Next: SetInsert, Prev: Loading, Up: Commands
9.4 Inserting files into ISO image 9.4 Inserting files into ISO image
================================== ==================================
@ -1116,7 +1116,7 @@ filesystem.
depend on the number of iso_rr_path_original parameters. depend on the number of iso_rr_path_original parameters.
 
File: xorriso.info, Node: SetInsert, Next: Manip, Prev: Insert, Up: Options File: xorriso.info, Node: SetInsert, Next: Manip, Prev: Insert, Up: Commands
9.5 Settings for file insertion 9.5 Settings for file insertion
=============================== ===============================
@ -1285,7 +1285,7 @@ File: xorriso.info, Node: SetInsert, Next: Manip, Prev: Insert, Up: Options
overlap. overlap.
 
File: xorriso.info, Node: Manip, Next: CmdFind, Prev: SetInsert, Up: Options File: xorriso.info, Node: Manip, Next: CmdFind, Prev: SetInsert, Up: Commands
9.6 File manipulations 9.6 File manipulations
====================== ======================
@ -1471,7 +1471,7 @@ whether they stem from the loaded image or were newly inserted.
-boot_image "any" "cat_hidden=on" -boot_image "any" "cat_hidden=on"
 
File: xorriso.info, Node: CmdFind, Next: Filter, Prev: Manip, Up: Options File: xorriso.info, Node: CmdFind, Next: Filter, Prev: Manip, Up: Commands
9.7 Tree traversal command -find 9.7 Tree traversal command -find
================================ ================================
@ -1769,7 +1769,7 @@ File: xorriso.info, Node: CmdFind, Next: Filter, Prev: Manip, Up: Options
chmod a-w,a+r -- chmod a-w,a+r --
 
File: xorriso.info, Node: Filter, Next: Writing, Prev: CmdFind, Up: Options File: xorriso.info, Node: Filter, Next: Writing, Prev: CmdFind, Up: Commands
9.8 Filters for data file content 9.8 Filters for data file content
================================= =================================
@ -1861,7 +1861,7 @@ there are many small files.
directories. directories.
 
File: xorriso.info, Node: Writing, Next: SetWrite, Prev: Filter, Up: Options File: xorriso.info, Node: Writing, Next: SetWrite, Prev: Filter, Up: Commands
9.9 Writing the result, drive control 9.9 Writing the result, drive control
===================================== =====================================
@ -2034,7 +2034,7 @@ File: xorriso.info, Node: Writing, Next: SetWrite, Prev: Filter, Up: Options
"(current)". "(current)".
 
File: xorriso.info, Node: SetWrite, Next: Bootable, Prev: Writing, Up: Options File: xorriso.info, Node: SetWrite, Next: Bootable, Prev: Writing, Up: Commands
9.10 Settings for result writing 9.10 Settings for result writing
================================ ================================
@ -2193,46 +2193,47 @@ according to the setting of command -acl.
than 255 bytes. than 255 bytes.
-volid text -volid text
Specify the volume ID. `xorriso' accepts any text up to 32 Specify the volume ID, which can be considered to be the name of
characters, but according to rarely obeyed specs stricter rules the image. `xorriso' accepts any text up to 32 characters, but
apply: according to rarely obeyed specs stricter rules apply:
ECMA-119 demands ASCII characters out of [A-Z0-9_]. Like: ECMA-119 demands ASCII characters out of [A-Z0-9_]. Like:
"IMAGE_23" "IMAGE_23"
Joliet allows 16 UCS-2 characters. Like: "Windows name" Joliet allows 16 UCS-2 characters. Like:
Be aware that the volume id might get used automatically as name "Windows name"
of the mount point when the medium is inserted into a playful Be aware that the volume id might get used automatically as the
name of the mount point when the medium is inserted into a playful
computer system. computer system.
If an ISO image gets loaded while the volume ID is set to default If an ISO image gets loaded while the volume ID is set to default
"ISOIMAGE" or to "", then the volume ID of the loaded image will "ISOIMAGE" or to "", then the volume ID of the loaded image will
become the effective volume id for the next write run. But as soon become the effective volume id for the next write run. But as soon
as command -volid is performed afterwards, this pending id is as command -volid is performed afterwards, this pending ID is
overridden by the new setting. overridden by the new setting.
Consider this when setting -volid "ISOIMAGE" before executing Consider this when setting -volid "ISOIMAGE" before executing
-dev, -indev, or -rollback. If you insist in -volid "ISOIMAGE", -dev, -indev, or -rollback. If you insist in -volid "ISOIMAGE",
set it again after those commands. set it again after those commands.
-volset_id text -volset_id text
Set the volume set id string to be written with the next -commit. Set the volume set ID string to be written with the next -commit.
Permissible are up to 128 characters. This setting gets overridden Permissible are up to 128 characters. This setting gets overridden
by image loading. by image loading.
-publisher text -publisher text
Set the publisher id string to be written with the next -commit. Set the publisher ID string to be written with the next -commit.
This may identify the person or organisation who specified what This may identify the person or organisation who specified what
shall be recorded. Permissible are up to 128 characters. This shall be recorded. Permissible are up to 128 characters. This
setting gets overridden by image loading. setting gets overridden by image loading.
-application_id text -application_id text
Set the application id string to be written with the next -commit. Set the application ID string to be written with the next -commit.
This may identify the specification of how the data are recorded. This may identify the specification of how the data are recorded.
Permissible are up to 128 characters. This setting gets overridden Permissible are up to 128 characters. This setting gets overridden
by image loading. by image loading.
The special text "@xorriso@" gets converted to the id string of The special text "@xorriso@" gets converted to the ID string of
`xorriso' which is normally written as -preparer_id. It is a wrong `xorriso' which is normally written as -preparer_id. It is a wrong
tradition to write the program id as -application_id. tradition to write the program ID as -application_id.
-system_id text -system_id text
Set the system id string to be written with the next -commit. This Set the system ID string to be written with the next -commit. This
may identify the system which can recognize and act upon the may identify the system which can recognize and act upon the
content of the System Area in image blocks 0 to 15. Permissible content of the System Area in image blocks 0 to 15. Permissible
are up to 32 characters. This setting gets overridden by image are up to 32 characters. This setting gets overridden by image
@ -2277,15 +2278,15 @@ according to the setting of command -acl.
setting gets overridden by image loading. setting gets overridden by image loading.
-preparer_id -preparer_id
Set the preparer id string to be written with the next -commit. Set the preparer ID string to be written with the next -commit.
This may identify the person or other entity which controls the This may identify the person or other entity which controls the
preparation of the data which shall be recorded. Normally this preparation of the data which shall be recorded. Normally this
should be the id of `xorriso' and not of the person or program should be the ID of `xorriso' and not of the person or program
which operates `xorriso'. Please avoid to change it. Permissible which operates `xorriso'. Please avoid to change it. Permissible
are up to 128 characters. are up to 128 characters.
The special text "@xorriso@" gets converted to the id string of The special text "@xorriso@" gets converted to the ID string of
`xorriso' which is default at program startup. `xorriso' which is default at program startup.
Unlike other id strings, this setting is not influenced by image Unlike other ID strings, this setting is not influenced by image
loading. loading.
-out_charset character_set_name -out_charset character_set_name
@ -2394,7 +2395,7 @@ according to the setting of command -acl.
by -padding mode "included". by -padding mode "included".
 
File: xorriso.info, Node: Bootable, Next: Jigdo, Prev: SetWrite, Up: Options File: xorriso.info, Node: Bootable, Next: Jigdo, Prev: SetWrite, Up: Commands
9.11 Bootable ISO images 9.11 Bootable ISO images
======================== ========================
@ -2656,7 +2657,7 @@ filesystem and announced by an MBR partition table entry.
the next lower valid one. the next lower valid one.
 
File: xorriso.info, Node: Jigdo, Next: Charset, Prev: Bootable, Up: Options File: xorriso.info, Node: Jigdo, Next: Charset, Prev: Bootable, Up: Commands
9.12 Jigdo Template Extraction 9.12 Jigdo Template Extraction
============================== ==============================
@ -2735,7 +2736,7 @@ emulation, and padding will be counted as part of the ISO image.
Alias: -checksum_algorithm_template Alias: -checksum_algorithm_template
 
File: xorriso.info, Node: Charset, Next: Exception, Prev: Jigdo, Up: Options File: xorriso.info, Node: Charset, Next: Exception, Prev: Jigdo, Up: Commands
9.13 Character sets 9.13 Character sets
=================== ===================
@ -2787,7 +2788,7 @@ display on your terminal.
being sent to the terminal. being sent to the terminal.
 
File: xorriso.info, Node: Exception, Next: DialogCtl, Prev: Charset, Up: Options File: xorriso.info, Node: Exception, Next: DialogCtl, Prev: Charset, Up: Commands
9.14 Exception processing 9.14 Exception processing
========================= =========================
@ -2902,7 +2903,7 @@ failed unexpectedly.
filtered. filtered.
 
File: xorriso.info, Node: DialogCtl, Next: Inquiry, Prev: Exception, Up: Options File: xorriso.info, Node: DialogCtl, Next: Inquiry, Prev: Exception, Up: Commands
9.15 Dialog mode control 9.15 Dialog mode control
======================== ========================
@ -2957,7 +2958,7 @@ File: xorriso.info, Node: DialogCtl, Next: Inquiry, Prev: Exception, Up: Opt
session. session.
 
File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Options File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Commands
9.16 Drive and media related inquiry actions 9.16 Drive and media related inquiry actions
============================================ ============================================
@ -3049,13 +3050,13 @@ File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Opti
subtracting already foreseeable consumption by next -commit. subtracting already foreseeable consumption by next -commit.
-pvd_info -pvd_info
Print various id strings which can be found in loaded ISO images. Print various ID strings which can be found in loaded ISO images.
Some of them may be changed by commands like -volid or -publisher. Some of them may be changed by commands like -volid or -publisher.
For these ids -pvd_info reports what would be written with the For these IDs -pvd_info reports what would be written with the
next -commit. next -commit.
 
File: xorriso.info, Node: Navigate, Next: Verify, Prev: Inquiry, Up: Options File: xorriso.info, Node: Navigate, Next: Verify, Prev: Inquiry, Up: Commands
9.17 Navigation in ISO image and disk filesystem 9.17 Navigation in ISO image and disk filesystem
================================================ ================================================
@ -3240,7 +3241,7 @@ File: xorriso.info, Node: Navigate, Next: Verify, Prev: Inquiry, Up: Options
Like -show_stream but working recursively. Like -show_stream but working recursively.
 
File: xorriso.info, Node: Verify, Next: Restore, Prev: Navigate, Up: Options File: xorriso.info, Node: Verify, Next: Restore, Prev: Navigate, Up: Commands
9.18 Evaluation of readability and recovery 9.18 Evaluation of readability and recovery
=========================================== ===========================================
@ -3359,7 +3360,7 @@ transmission errors.
start block addresses, followed by binary bitmap data. start block addresses, followed by binary bitmap data.
map_with_volid="on" map_with_volid="on"
examines tracks whether they are ISO images and prints their examines tracks whether they are ISO images and prints their
volume ids into the human readable TOC of sector_map=. volume IDs into the human readable TOC of sector_map=.
patch_lba0="on" patch_lba0="on"
transfers within the data_to= file a copy of the currently transfers within the data_to= file a copy of the currently
loaded session head to the start of that file and patches it loaded session head to the start of that file and patches it
@ -3413,7 +3414,7 @@ transmission errors.
paths. Only mismatching data files will be reported. paths. Only mismatching data files will be reported.
 
File: xorriso.info, Node: Restore, Next: Emulation, Prev: Verify, Up: Options File: xorriso.info, Node: Restore, Next: Emulation, Prev: Verify, Up: Commands
9.19 osirrox ISO-to-disk restore commands 9.19 osirrox ISO-to-disk restore commands
========================================= =========================================
@ -3546,7 +3547,7 @@ The directory permissions on disk have to allow rwx.
/sbin/mount. /sbin/mount.
 
File: xorriso.info, Node: Emulation, Next: Scripting, Prev: Restore, Up: Options File: xorriso.info, Node: Emulation, Next: Scripting, Prev: Restore, Up: Commands
9.20 Command compatibility emulations (cdrtools) 9.20 Command compatibility emulations (cdrtools)
================================================ ================================================
@ -3724,7 +3725,7 @@ said programs trigger comparable actions.
record. record.
 
File: xorriso.info, Node: Scripting, Next: Frontend, Prev: Emulation, Up: Options File: xorriso.info, Node: Scripting, Next: Frontend, Prev: Emulation, Up: Commands
9.21 Scripting, dialog and program control features 9.21 Scripting, dialog and program control features
=================================================== ===================================================
@ -3864,10 +3865,10 @@ File: xorriso.info, Node: Scripting, Next: Frontend, Prev: Emulation, Up: Op
If path is not empty it gives the address of a plain text file If path is not empty it gives the address of a plain text file
where a log record gets appended after each session. This log can where a log record gets appended after each session. This log can
be used to determine the start_lba of a session for mount options be used to determine the start_lba of a session for mount options
-o sbsector= resp. -s from date or volume id. -o sbsector= resp. -s 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 first three items are single words, the rest of the line is
the volume id. the volume ID.
-scsi_log "on"|"off" -scsi_log "on"|"off"
Mode "on" enables very verbous logging of SCSI commands and drive Mode "on" enables very verbous logging of SCSI commands and drive
@ -3890,7 +3891,7 @@ File: xorriso.info, Node: Scripting, Next: Frontend, Prev: Emulation, Up: Op
readline history. readline history.
 
File: xorriso.info, Node: Frontend, Next: ExDevices, Prev: Scripting, Up: Options File: xorriso.info, Node: Frontend, Next: ExDevices, Prev: Scripting, Up: Commands
9.22 Support for frontend programs via stdin and stdout 9.22 Support for frontend programs via stdin and stdout
======================================================= =======================================================
@ -3925,7 +3926,7 @@ File: xorriso.info, Node: Frontend, Next: ExDevices, Prev: Scripting, Up: Op
Use text as name of this program and perform -help. Use text as name of this program and perform -help.
 
File: xorriso.info, Node: Examples, Next: Files, Prev: Options, Up: Top File: xorriso.info, Node: Examples, Next: Files, Prev: Commands, Up: Top
10 Examples 10 Examples
*********** ***********
@ -4278,7 +4279,7 @@ counterparts. ISO file objects get created, deleted or get their
attributes adjusted accordingly. attributes adjusted accordingly.
ACL, xattr, hard links and MD5 checksums will be recorded. Accelerated ACL, xattr, hard links and MD5 checksums will be recorded. Accelerated
comparison is enabled at the expense of potentially larger backup size. comparison is enabled at the expense of potentially larger backup size.
Only media with the expected volume id or blank media are accepted. Only media with the expected volume ID or blank media are accepted.
Files with names matching *.o or *.swp get excluded explicitly. Files with names matching *.o or *.swp get excluded explicitly.
When done with writing the new session gets checked by its recorded MD5. When done with writing the new session gets checked by its recorded MD5.
@ -4529,7 +4530,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* # starts a comment line: Scripting. (line 162) * # starts a comment line: Scripting. (line 162)
* -abort_on controls abort on error: Exception. (line 27) * -abort_on controls abort on error: Exception. (line 27)
* -abstract_file sets abstract file name: SetWrite. (line 231) * -abstract_file sets abstract file name: SetWrite. (line 232)
* -acl controls handling of ACLs: Loading. (line 143) * -acl controls handling of ACLs: Loading. (line 143)
* -add inserts one or more paths: Insert. (line 45) * -add inserts one or more paths: Insert. (line 45)
* -add_plainly inserts one or more paths: Insert. (line 64) * -add_plainly inserts one or more paths: Insert. (line 64)
@ -4537,13 +4538,13 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -alter_date_r sets timestamps in ISO image: Manip. (line 167) * -alter_date_r sets timestamps in ISO image: Manip. (line 167)
* -append_partition adds arbitrary file after image end: Bootable. * -append_partition adds arbitrary file after image end: Bootable.
(line 234) (line 234)
* -application_id sets application id: SetWrite. (line 190) * -application_id sets application id: SetWrite. (line 191)
* -as emulates mkisofs or cdrecord: Emulation. (line 13) * -as emulates mkisofs or cdrecord: Emulation. (line 13)
* -assert_volid rejects undesired images: Loading. (line 84) * -assert_volid rejects undesired images: Loading. (line 84)
* -auto_charset learns character set from image: Loading. (line 98) * -auto_charset learns character set from image: Loading. (line 98)
* -backslash_codes enables backslash conversion: Scripting. (line 67) * -backslash_codes enables backslash conversion: Scripting. (line 67)
* -ban_stdio_write demands real drive: Loading. (line 251) * -ban_stdio_write demands real drive: Loading. (line 251)
* -biblio_file sets biblio file name: SetWrite. (line 238) * -biblio_file sets biblio file name: SetWrite. (line 239)
* -blank erases media: Writing. (line 61) * -blank erases media: Writing. (line 61)
* -boot_image controls bootability: Bootable. (line 26) * -boot_image controls bootability: Bootable. (line 26)
* -calm_drive reduces drive activity: Loading. (line 240) * -calm_drive reduces drive activity: Loading. (line 240)
@ -4562,7 +4563,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -chown sets ownership in ISO image: Manip. (line 42) * -chown sets ownership in ISO image: Manip. (line 42)
* -chown_r sets ownership in ISO image: Manip. (line 47) * -chown_r sets ownership in ISO image: Manip. (line 47)
* -clone copies ISO directory tree: Insert. (line 179) * -clone copies ISO directory tree: Insert. (line 179)
* -close controls media closing: SetWrite. (line 333) * -close controls media closing: SetWrite. (line 334)
* -close_damaged closes damaged track and session: Writing. (line 155) * -close_damaged closes damaged track and session: Writing. (line 155)
* -close_filter_list bans filter registration: Filter. (line 52) * -close_filter_list bans filter registration: Filter. (line 52)
* -commit writes pending ISO image: Writing. (line 29) * -commit writes pending ISO image: Writing. (line 29)
@ -4571,7 +4572,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -compare_l reports ISO/disk differences: Navigate. (line 164) * -compare_l reports ISO/disk differences: Navigate. (line 164)
* -compare_r reports ISO/disk differences: Navigate. (line 159) * -compare_r reports ISO/disk differences: Navigate. (line 159)
* -compliance controls standard compliance: SetWrite. (line 58) * -compliance controls standard compliance: SetWrite. (line 58)
* -copyright_file sets copyright file name: SetWrite. (line 225) * -copyright_file sets copyright file name: SetWrite. (line 226)
* -cp_clone copies ISO directory tree: Insert. (line 191) * -cp_clone copies ISO directory tree: Insert. (line 191)
* -cp_rx copies file trees to disk: Restore. (line 108) * -cp_rx copies file trees to disk: Restore. (line 108)
* -cpax copies files to disk: Restore. (line 104) * -cpax copies files to disk: Restore. (line 104)
@ -4589,11 +4590,11 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
(line 36) (line 36)
* -drive_class controls drive accessability: Loading. (line 54) * -drive_class controls drive accessability: Loading. (line 54)
* -du show directory size in ISO image: Navigate. (line 89) * -du show directory size in ISO image: Navigate. (line 89)
* -dummy controls write simulation: SetWrite. (line 322) * -dummy controls write simulation: SetWrite. (line 323)
* -dus show directory size in ISO image: Navigate. (line 93) * -dus show directory size in ISO image: Navigate. (line 93)
* -dusx show directory size on disk: Navigate. (line 102) * -dusx show directory size on disk: Navigate. (line 102)
* -dux show directory size on disk: Navigate. (line 97) * -dux show directory size on disk: Navigate. (line 97)
* -dvd_obs set write block size: SetWrite. (line 309) * -dvd_obs set write block size: SetWrite. (line 310)
* -early_stdio_test classifies stdio drives: Loading. (line 256) * -early_stdio_test classifies stdio drives: Loading. (line 256)
* -eject ejects drive tray: Writing. (line 52) * -eject ejects drive tray: Writing. (line 52)
* -end writes pending session and ends program: Scripting. (line 156) * -end writes pending session and ends program: Scripting. (line 156)
@ -4611,12 +4612,12 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -follow softlinks and mount points: SetInsert. (line 76) * -follow softlinks and mount points: SetInsert. (line 76)
* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 185) * -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 185)
* -format formats media: Writing. (line 91) * -format formats media: Writing. (line 91)
* -fs sets size of fifo: SetWrite. (line 326) * -fs sets size of fifo: SetWrite. (line 327)
* -getfacl shows ACL in ISO image: Navigate. (line 70) * -getfacl shows ACL in ISO image: Navigate. (line 70)
* -getfacl_r shows ACL in ISO image: Navigate. (line 77) * -getfacl_r shows ACL in ISO image: Navigate. (line 77)
* -getfattr shows xattr in ISO image: Navigate. (line 81) * -getfattr shows xattr in ISO image: Navigate. (line 81)
* -getfattr_r shows xattr in ISO image: Navigate. (line 85) * -getfattr_r shows xattr in ISO image: Navigate. (line 85)
* -gid sets global ownership: SetWrite. (line 266) * -gid sets global ownership: SetWrite. (line 267)
* -grow_blindly overides next writeable address: AqDrive. (line 46) * -grow_blindly overides next writeable address: AqDrive. (line 46)
* -hardlinks controls handling of hard links: Loading. (line 110) * -hardlinks controls handling of hard links: Loading. (line 110)
* -help prints help text: Scripting. (line 20) * -help prints help text: Scripting. (line 20)
@ -4664,17 +4665,17 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -not_paths sets absolute exclusion paths: SetInsert. (line 55) * -not_paths sets absolute exclusion paths: SetInsert. (line 55)
* -options_from_file reads commands from file: Scripting. (line 12) * -options_from_file reads commands from file: Scripting. (line 12)
* -osirrox enables ISO-to-disk copying: Restore. (line 18) * -osirrox enables ISO-to-disk copying: Restore. (line 18)
* -out_charset sets output character set: SetWrite. (line 256) * -out_charset sets output character set: SetWrite. (line 257)
* -outdev acquires a drive for output: AqDrive. (line 31) * -outdev acquires a drive for output: AqDrive. (line 31)
* -overwrite enables overwriting in ISO: SetInsert. (line 127) * -overwrite enables overwriting in ISO: SetInsert. (line 127)
* -pacifier controls pacifier text form: Emulation. (line 158) * -pacifier controls pacifier text form: Emulation. (line 158)
* -padding sets amount or mode of image padding: SetWrite. (line 347) * -padding sets amount or mode of image padding: SetWrite. (line 348)
* -page set terminal geometry: DialogCtl. (line 19) * -page set terminal geometry: DialogCtl. (line 19)
* -paste_in copies file into disk file: Restore. (line 121) * -paste_in copies file into disk file: Restore. (line 121)
* -path_list inserts paths from disk file: Insert. (line 78) * -path_list inserts paths from disk file: Insert. (line 78)
* -pathspecs sets meaning of = with -add: SetInsert. (line 118) * -pathspecs sets meaning of = with -add: SetInsert. (line 118)
* -pkt_output consolidates text output: Frontend. (line 7) * -pkt_output consolidates text output: Frontend. (line 7)
* -preparer_id sets preparer id: SetWrite. (line 244) * -preparer_id sets preparer id: SetWrite. (line 245)
* -print prints result text line: Scripting. (line 99) * -print prints result text line: Scripting. (line 99)
* -print_info prints message text line: Scripting. (line 102) * -print_info prints message text line: Scripting. (line 102)
* -print_mark prints synchronizing text line: Scripting. (line 105) * -print_mark prints synchronizing text line: Scripting. (line 105)
@ -4682,7 +4683,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -prog sets program name: Frontend. (line 30) * -prog sets program name: Frontend. (line 30)
* -prog_help prints help text: Frontend. (line 33) * -prog_help prints help text: Frontend. (line 33)
* -prompt prompts for enter key: Scripting. (line 110) * -prompt prompts for enter key: Scripting. (line 110)
* -publisher sets publisher id: SetWrite. (line 184) * -publisher sets publisher id: SetWrite. (line 185)
* -pvd_info shows image id strings: Inquiry. (line 93) * -pvd_info shows image id strings: Inquiry. (line 93)
* -pwd tells working directory in ISO: Navigate. (line 20) * -pwd tells working directory in ISO: Navigate. (line 20)
* -pwdx tells working directory on disk: Navigate. (line 23) * -pwdx tells working directory on disk: Navigate. (line 23)
@ -4720,30 +4721,30 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -signal_handling controls handling of system signals: Exception. * -signal_handling controls handling of system signals: Exception.
(line 69) (line 69)
* -sleep waits for a given time span: Scripting. (line 114) * -sleep waits for a given time span: Scripting. (line 114)
* -speed set write speed: SetWrite. (line 282) * -speed set write speed: SetWrite. (line 283)
* -split_size enables large file splitting: SetInsert. (line 140) * -split_size enables large file splitting: SetInsert. (line 140)
* -status shows current settings: Scripting. (line 47) * -status shows current settings: Scripting. (line 47)
* -status_history_max curbs -status history: Scripting. (line 56) * -status_history_max curbs -status history: Scripting. (line 56)
* -stdio_sync controls stdio buffer: SetWrite. (line 316) * -stdio_sync controls stdio buffer: SetWrite. (line 317)
* -stream_recording controls defect management: SetWrite. (line 297) * -stream_recording controls defect management: SetWrite. (line 298)
* -system_id sets system id: SetWrite. (line 199) * -system_id sets system id: SetWrite. (line 200)
* -tell_media_space reports free space: Inquiry. (line 89) * -tell_media_space reports free space: Inquiry. (line 89)
* -temp_mem_limit curbs memory consumption: Scripting. (line 92) * -temp_mem_limit curbs memory consumption: Scripting. (line 92)
* -toc shows list of sessions: Inquiry. (line 28) * -toc shows list of sessions: Inquiry. (line 28)
* -uid sets global ownership: SetWrite. (line 262) * -uid sets global ownership: SetWrite. (line 263)
* -update inserts path if different: Insert. (line 102) * -update inserts path if different: Insert. (line 102)
* -update_l inserts paths if different: Insert. (line 124) * -update_l inserts paths if different: Insert. (line 124)
* -update_r inserts paths if different: Insert. (line 113) * -update_r inserts paths if different: Insert. (line 113)
* -use_readline enables readline for dialog: DialogCtl. (line 28) * -use_readline enables readline for dialog: DialogCtl. (line 28)
* -version prints help text: Scripting. (line 23) * -version prints help text: Scripting. (line 23)
* -volid sets volume id: SetWrite. (line 160) * -volid sets volume id: SetWrite. (line 160)
* -volset_id sets volume set id: SetWrite. (line 179) * -volset_id sets volume set id: SetWrite. (line 180)
* -volume_date sets volume timestamp: SetWrite. (line 206) * -volume_date sets volume timestamp: SetWrite. (line 207)
* -write_type chooses TAO or SAO/DAO: SetWrite. (line 339) * -write_type chooses TAO or SAO/DAO: SetWrite. (line 340)
* -x enables automatic execution order of arguments: ArgSort. * -x enables automatic execution order of arguments: ArgSort.
(line 16) (line 16)
* -xattr controls handling of xattr (EA): Loading. (line 151) * -xattr controls handling of xattr (EA): Loading. (line 151)
* -zisofs controls zisofs production: SetWrite. (line 270) * -zisofs controls zisofs production: SetWrite. (line 271)
 
File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
@ -4778,7 +4779,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Character Set, _definition: Charset. (line 6) * Character Set, _definition: Charset. (line 6)
* Character Set, for input, -in_charset: Loading. (line 92) * Character Set, for input, -in_charset: Loading. (line 92)
* Character Set, for input/output, -charset: Charset. (line 43) * Character Set, for input/output, -charset: Charset. (line 43)
* Character Set, for output, -out_charset: SetWrite. (line 256) * Character Set, for output, -out_charset: SetWrite. (line 257)
* Character set, learn from image, -auto_charset: Loading. (line 98) * Character set, learn from image, -auto_charset: Loading. (line 98)
* Character Set, of terminal, -local_charset: Charset. (line 47) * Character Set, of terminal, -local_charset: Charset. (line 47)
* CHRP partition, _definition: Bootable. (line 148) * CHRP partition, _definition: Bootable. (line 148)
@ -4835,9 +4836,9 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Filter, show chain, -show_stream: Navigate. (line 169) * Filter, show chain, -show_stream: Navigate. (line 169)
* Filter, show chains of tree, -show_stream_r: Navigate. (line 183) * Filter, show chains of tree, -show_stream_r: Navigate. (line 183)
* Filter, unregister, -unregister_filter: Filter. (line 48) * Filter, unregister, -unregister_filter: Filter. (line 48)
* Filter, zisofs parameters, -zisofs: SetWrite. (line 270) * Filter, zisofs parameters, -zisofs: SetWrite. (line 271)
* GPT, _definition: Extras. (line 38) * GPT, _definition: Extras. (line 38)
* Group, global in ISO image, -gid: SetWrite. (line 266) * Group, global in ISO image, -gid: SetWrite. (line 267)
* Group, in ISO image, -chgrp: Manip. (line 50) * Group, in ISO image, -chgrp: Manip. (line 50)
* Group, in ISO image, -chgrp_r: Manip. (line 55) * Group, in ISO image, -chgrp_r: Manip. (line 55)
* Growing, _definition: Methods. (line 19) * Growing, _definition: Methods. (line 19)
@ -4847,19 +4848,19 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* hidden, set in ISO image, -hide: Manip. (line 171) * hidden, set in ISO image, -hide: Manip. (line 171)
* Image reading, cache size, -data_cache_size: Loading. (line 269) * Image reading, cache size, -data_cache_size: Loading. (line 269)
* Image, _definition: Model. (line 9) * Image, _definition: Model. (line 9)
* Image, demand volume id, -assert_volid: Loading. (line 84) * Image, demand volume ID, -assert_volid: Loading. (line 84)
* Image, discard pending changes, -rollback: Writing. (line 9) * Image, discard pending changes, -rollback: Writing. (line 9)
* Image, override change status, -changes_pending: Writing. (line 13) * Image, override change status, -changes_pending: Writing. (line 13)
* Image, set abstract file name, -abstract_file: SetWrite. (line 231) * Image, set abstract file name, -abstract_file: SetWrite. (line 232)
* Image, set application id, -application_id: SetWrite. (line 190) * Image, set application id, -application_id: SetWrite. (line 191)
* Image, set biblio file name, -biblio_file: SetWrite. (line 238) * Image, set biblio file name, -biblio_file: SetWrite. (line 239)
* Image, set copyright file name, -copyright_file: SetWrite. (line 225) * Image, set copyright file name, -copyright_file: SetWrite. (line 226)
* Image, set preparer id, -preparer_id: SetWrite. (line 244) * Image, set preparer id, -preparer_id: SetWrite. (line 245)
* Image, set publisher id, -publisher: SetWrite. (line 184) * Image, set publisher id, -publisher: SetWrite. (line 185)
* Image, set system id, -system_id: SetWrite. (line 199) * Image, set system id, -system_id: SetWrite. (line 200)
* Image, set volume id, -volid: SetWrite. (line 160) * Image, set volume id, -volid: SetWrite. (line 160)
* Image, set volume set id, -volset_id: SetWrite. (line 179) * Image, set volume set id, -volset_id: SetWrite. (line 180)
* Image, set volume timestamp, -volume_date: SetWrite. (line 206) * Image, set volume timestamp, -volume_date: SetWrite. (line 207)
* Image, show id strings, -pvd_info: Inquiry. (line 93) * Image, show id strings, -pvd_info: Inquiry. (line 93)
* Insert, enable overwriting, -overwrite: SetInsert. (line 127) * Insert, enable overwriting, -overwrite: SetInsert. (line 127)
* Insert, file exclusion absolute, -not_paths: SetInsert. (line 55) * Insert, file exclusion absolute, -not_paths: SetInsert. (line 55)
@ -4918,7 +4919,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Navigate, tell ISO working directory, -pwd: Navigate. (line 20) * Navigate, tell ISO working directory, -pwd: Navigate. (line 20)
* Next writeable address, -grow_blindly: AqDrive. (line 46) * Next writeable address, -grow_blindly: AqDrive. (line 46)
* Overwriteable media, _definition: Media. (line 14) * Overwriteable media, _definition: Media. (line 14)
* Ownership, global in ISO image, -uid: SetWrite. (line 262) * Ownership, global in ISO image, -uid: SetWrite. (line 263)
* Ownership, in ISO image, -chown: Manip. (line 42) * Ownership, in ISO image, -chown: Manip. (line 42)
* Ownership, in ISO image, -chown_r: Manip. (line 47) * Ownership, in ISO image, -chown_r: Manip. (line 47)
* Partition offset, _definition: Bootable. (line 167) * Partition offset, _definition: Bootable. (line 167)
@ -5000,25 +5001,25 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Verify, file checksum, -check_md5: Verify. (line 154) * Verify, file checksum, -check_md5: Verify. (line 154)
* Verify, file tree checksums, -check_md5_r: Verify. (line 170) * Verify, file tree checksums, -check_md5_r: Verify. (line 170)
* Verify, preset -check_media, -check_media_defaults: Verify. (line 41) * Verify, preset -check_media, -check_media_defaults: Verify. (line 41)
* Write, block size, -dvd_obs: SetWrite. (line 309) * Write, block size, -dvd_obs: SetWrite. (line 310)
* Write, bootability, -boot_image: Bootable. (line 26) * Write, bootability, -boot_image: Bootable. (line 26)
* Write, buffer syncing, -stdio_sync: SetWrite. (line 316) * Write, buffer syncing, -stdio_sync: SetWrite. (line 317)
* Write, close media, -close: SetWrite. (line 333) * Write, close media, -close: SetWrite. (line 334)
* Write, compliance to specs, -compliance: SetWrite. (line 58) * Write, compliance to specs, -compliance: SetWrite. (line 58)
* Write, defect management, -stream_recording: SetWrite. (line 297) * Write, defect management, -stream_recording: SetWrite. (line 298)
* Write, disable Rock Ridge, -rockridge: SetWrite. (line 52) * Write, disable Rock Ridge, -rockridge: SetWrite. (line 52)
* Write, enable HFS+, -hfsplus: SetWrite. (line 14) * Write, enable HFS+, -hfsplus: SetWrite. (line 14)
* Write, enable Joliet, -joliet: SetWrite. (line 10) * Write, enable Joliet, -joliet: SetWrite. (line 10)
* Write, fifo size, -fs: SetWrite. (line 326) * Write, fifo size, -fs: SetWrite. (line 327)
* Write, free space, -tell_media_space: Inquiry. (line 89) * Write, free space, -tell_media_space: Inquiry. (line 89)
* Write, log problematic disk files, -errfile_log: Scripting. (line 118) * Write, log problematic disk files, -errfile_log: Scripting. (line 118)
* Write, log written sessions, -session_log: Scripting. (line 138) * Write, log written sessions, -session_log: Scripting. (line 138)
* Write, padding image, -padding: SetWrite. (line 347) * Write, padding image, -padding: SetWrite. (line 348)
* Write, pending ISO image, -commit: Writing. (line 29) * Write, pending ISO image, -commit: Writing. (line 29)
* Write, predict image size, -print_size: Inquiry. (line 80) * Write, predict image size, -print_size: Inquiry. (line 80)
* Write, set speed, -speed: SetWrite. (line 282) * Write, set speed, -speed: SetWrite. (line 283)
* Write, simulation, -dummy: SetWrite. (line 322) * Write, simulation, -dummy: SetWrite. (line 323)
* Write, TAO or SAO/DAO, -write_type: SetWrite. (line 339) * Write, TAO or SAO/DAO, -write_type: SetWrite. (line 340)
* xattr, _definition: Extras. (line 65) * xattr, _definition: Extras. (line 65)
* xattr, control handling, -xattr: Loading. (line 151) * xattr, control handling, -xattr: Loading. (line 151)
* xattr, set in ISO image, -setfattr: Manip. (line 111) * xattr, set in ISO image, -setfattr: Manip. (line 111)
@ -5039,51 +5040,51 @@ Node: Drives11416
Node: Extras14731 Node: Extras14731
Node: Processing19183 Node: Processing19183
Node: Dialog22803 Node: Dialog22803
Node: Options24480 Node: Commands24481
Node: ArgSort26154 Node: ArgSort26158
Node: AqDrive27644 Node: AqDrive27650
Node: Loading30688 Node: Loading30695
Node: Insert46143 Node: Insert46151
Node: SetInsert56278 Node: SetInsert56287
Node: Manip64854 Node: Manip64864
Node: CmdFind73677 Node: CmdFind73688
Node: Filter88381 Node: Filter88393
Node: Writing92936 Node: Writing92949
Node: SetWrite102114 Node: SetWrite102128
Node: Bootable120753 Node: Bootable120831
Node: Jigdo136146 Node: Jigdo136225
Node: Charset140392 Node: Charset140472
Node: Exception143153 Node: Exception143234
Node: DialogCtl149272 Node: DialogCtl149354
Node: Inquiry151869 Node: Inquiry151952
Node: Navigate156735 Node: Navigate156819
Node: Verify165032 Node: Verify165117
Node: Restore174063 Node: Restore174149
Node: Emulation180972 Node: Emulation181059
Node: Scripting190783 Node: Scripting190871
Node: Frontend197943 Node: Frontend198032
Node: Examples199243 Node: Examples199333
Node: ExDevices200420 Node: ExDevices200511
Node: ExCreate201079 Node: ExCreate201170
Node: ExDialog202364 Node: ExDialog202455
Node: ExGrowing203629 Node: ExGrowing203720
Node: ExModifying204434 Node: ExModifying204525
Node: ExBootable204938 Node: ExBootable205029
Node: ExCharset205490 Node: ExCharset205581
Node: ExPseudo206311 Node: ExPseudo206402
Node: ExCdrecord207209 Node: ExCdrecord207300
Node: ExMkisofs207526 Node: ExMkisofs207617
Node: ExGrowisofs208866 Node: ExGrowisofs208957
Node: ExException210001 Node: ExException210092
Node: ExTime210455 Node: ExTime210546
Node: ExIncBackup210914 Node: ExIncBackup211005
Node: ExRestore214906 Node: ExRestore214997
Node: ExRecovery215866 Node: ExRecovery215957
Node: Files216436 Node: Files216527
Node: Seealso217735 Node: Seealso217826
Node: Bugreport218458 Node: Bugreport218549
Node: Legal219039 Node: Legal219130
Node: CommandIdx220050 Node: CommandIdx220141
Node: ConceptIdx235995 Node: ConceptIdx236086
 
End Tag Table End Tag Table

105
libisoburn/trunk/xorriso/xorriso.texi
View File

@ -102,7 +102,7 @@ with Rock Ridge extensions.
* Extras:: Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr * Extras:: Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr
* Processing:: Command processing * Processing:: Command processing
* Dialog:: Dialog, Readline, Result pager * Dialog:: Dialog, Readline, Result pager
* Options:: Reference of commands * Commands:: Reference of commands
* Examples:: Examples * Examples:: Examples
* Files:: Files * Files:: Files
* Seealso:: See also * Seealso:: See also
@ -696,7 +696,7 @@ The program ends either by command -end, or by the end of program arguments
if dialog mode has not been enabled at that point, or by a problem if dialog mode has not been enabled at that point, or by a problem
event which triggers the threshold of command -abort_on. event which triggers the threshold of command -abort_on.
@c man .SS @c man .SS
@node Dialog, Options, Processing, top @node Dialog, Commands, Processing, top
@chapter Dialog, Readline, Result pager @chapter Dialog, Readline, Result pager
@c man .B Dialog, Readline, Result pager: @c man .B Dialog, Readline, Result pager:
@c man .br @c man .br
@ -742,8 +742,8 @@ Some actions apply paging to their info output, too.
@* @*
The request to abort may or may not be obeyed by the current action. The request to abort may or may not be obeyed by the current action.
All actions try to abort as soon as possible. All actions try to abort as soon as possible.
@node Options, Examples, Dialog, top @node Commands, Examples, Dialog, top
@chapter Options @chapter Commands
@c man .br @c man .br
@c man .SH OPTIONS @c man .SH OPTIONS
@c man .br @c man .br
@ -778,7 +778,7 @@ inner dashes are interpreted as underscores.
* Frontend:: Support for frontend programs via stdin and stdout * Frontend:: Support for frontend programs via stdin and stdout
@end menu @end menu
@c man .TP @c man .TP
@node ArgSort, AqDrive, Options, Options @node ArgSort, AqDrive, Commands, Commands
@section Execution order of program arguments @section Execution order of program arguments
@c man .B Execution order of program arguments: @c man .B Execution order of program arguments:
@c man .PP @c man .PP
@ -820,7 +820,7 @@ well make sense, though.
@end table @end table
@c man .PP @c man .PP
@c man .TP @c man .TP
@node AqDrive, Loading, ArgSort, Options @node AqDrive, Loading, ArgSort, Commands
@section Acquiring source and target drive @section Acquiring source and target drive
@c man .B Acquiring source and target drive: @c man .B Acquiring source and target drive:
@c man .PP @c man .PP
@ -896,7 +896,7 @@ begins. The output drive is given up when writing is done.
@end table @end table
@c man .TP @c man .TP
@c man .B Influencing the behavior of image loading: @c man .B Influencing the behavior of image loading:
@node Loading, Insert, AqDrive, Options @node Loading, Insert, AqDrive, Commands
@section Influencing the behavior of image loading @section Influencing the behavior of image loading
@c man .PP @c man .PP
The following commands should normally be performed before loading an image The following commands should normally be performed before loading an image
@ -995,8 +995,8 @@ have to deny its rw-permissions in the filesystem.
@c man .TP @c man .TP
@item -assert_volid pattern severity @item -assert_volid pattern severity
@kindex -assert_volid rejects undesired images @kindex -assert_volid rejects undesired images
@cindex Image, demand volume id, -assert_volid @cindex Image, demand volume ID, -assert_volid
Refuse to load ISO images with volume ids which do not match the given Refuse to load ISO images with volume IDs which do not match the given
search pattern. When refusing an image, give up the input drive and issue search pattern. When refusing an image, give up the input drive and issue
an event of the given severity (like FAILURE, see -abort_on). An empty search an event of the given severity (like FAILURE, see -abort_on). An empty search
pattern accepts any image. pattern accepts any image.
@ -1235,7 +1235,7 @@ Currently the default is 32 tiles of 32 blocks = 2 MiB.
@end table @end table
@c man .TP @c man .TP
@c man .B Inserting files into ISO image: @c man .B Inserting files into ISO image:
@node Insert, SetInsert, Loading, Options @node Insert, SetInsert, Loading, Commands
@section Inserting files into ISO image @section Inserting files into ISO image
@c man .PP @c man .PP
The following commands expect file addresses of two kinds: The following commands expect file addresses of two kinds:
@ -1502,7 +1502,7 @@ parameters.
@end table @end table
@c man .TP @c man .TP
@c man .B Settings for file insertion: @c man .B Settings for file insertion:
@node SetInsert, Manip, Insert, Options @node SetInsert, Manip, Insert, Commands
@section Settings for file insertion @section Settings for file insertion
@c man .TP @c man .TP
@table @asis @table @asis
@ -1725,7 +1725,7 @@ parameter and their contents may not overlap.
@end table @end table
@c man .TP @c man .TP
@c man .B File manipulations: @c man .B File manipulations:
@node Manip, CmdFind, SetInsert, Options @node Manip, CmdFind, SetInsert, Commands
@section File manipulations @section File manipulations
@c man .PP @c man .PP
The following commands manipulate files in the ISO image, regardless whether The following commands manipulate files in the ISO image, regardless whether
@ -1992,7 +1992,7 @@ Rather use: -boot_image "any" "cat_hidden=on"
@end table @end table
@c man .TP @c man .TP
@c man .B Tree traversal command -find: @c man .B Tree traversal command -find:
@node CmdFind, Filter, Manip, Options @node CmdFind, Filter, Manip, Commands
@section Tree traversal command -find @section Tree traversal command -find
@c man .PP @c man .PP
@table @asis @table @asis
@ -2387,7 +2387,7 @@ E.g.:
@c man .TP @c man .TP
@c man .B Filters for data file content: @c man .B Filters for data file content:
@c man .PP @c man .PP
@node Filter, Writing, CmdFind, Options @node Filter, Writing, CmdFind, Commands
@section Filters for data file content @section Filters for data file content
@cindex Filter, _definition @cindex Filter, _definition
@strong{Filters} may be installed between data files in the ISO image and their @strong{Filters} may be installed between data files in the ISO image and their
@ -2505,7 +2505,7 @@ Like -set_filter but affecting all data files below eventual directories.
@end table @end table
@c man .TP @c man .TP
@c man .B Writing the result, drive control: @c man .B Writing the result, drive control:
@node Writing, SetWrite, Filter, Options @node Writing, SetWrite, Filter, Commands
@section Writing the result, drive control @section Writing the result, drive control
@c man .PP @c man .PP
(see also paragraph about settings below) (see also paragraph about settings below)
@ -2730,7 +2730,7 @@ The currently recognized type is marked by text "(current)".
@end table @end table
@c man .TP @c man .TP
@c man .B Settings for result writing: @c man .B Settings for result writing:
@node SetWrite, Bootable, Writing, Options @node SetWrite, Bootable, Writing, Commands
@section Settings for result writing @section Settings for result writing
@c man .PP @c man .PP
Rock Ridge info will be generated by default. Rock Ridge info will be generated by default.
@ -2924,20 +2924,25 @@ The name must not contain a '/' character and must not be longer than
@item -volid text @item -volid text
@kindex -volid sets volume id @kindex -volid sets volume id
@cindex Image, set volume id, -volid @cindex Image, set volume id, -volid
Specify the volume ID. @command{xorriso} accepts any text up to 32 characters, Specify the volume ID, which can be considered to be the name of the image.
@command{xorriso} accepts any text up to 32 characters,
but according to rarely obeyed specs stricter rules apply: but according to rarely obeyed specs stricter rules apply:
@* @*
ECMA-119 demands ASCII characters out of [A-Z0-9_]. Like: "IMAGE_23" ECMA-119 demands ASCII characters out of [A-Z0-9_]. Like:
@* @*
Joliet allows 16 UCS-2 characters. Like: "Windows name" "IMAGE_23"
@* @*
Be aware that the volume id might get used automatically as name of the Joliet allows 16 UCS-2 characters. Like:
@*
"Windows name"
@*
Be aware that the volume id might get used automatically as the name of the
mount point when the medium is inserted into a playful computer system. mount point when the medium is inserted into a playful computer system.
@* @*
If an ISO image gets loaded while the volume ID is set to default "ISOIMAGE" If an ISO image gets loaded while the volume ID is set to default "ISOIMAGE"
or to "", then the volume ID of the loaded image will become the effective or to "", then the volume ID of the loaded image will become the effective
volume id for the next write run. But as soon as command -volid is performed volume id for the next write run. But as soon as command -volid is performed
afterwards, this pending id is overridden by the new setting. afterwards, this pending ID is overridden by the new setting.
@* @*
Consider this when setting -volid "ISOIMAGE" before executing -dev, -indev, Consider this when setting -volid "ISOIMAGE" before executing -dev, -indev,
or -rollback. or -rollback.
@ -2946,14 +2951,14 @@ If you insist in -volid "ISOIMAGE", set it again after those commands.
@item -volset_id text @item -volset_id text
@kindex -volset_id sets volume set id @kindex -volset_id sets volume set id
@cindex Image, set volume set id, -volset_id @cindex Image, set volume set id, -volset_id
Set the volume set id string to be written with the next -commit. Set the volume set ID string to be written with the next -commit.
Permissible are up to 128 characters. This setting gets overridden by Permissible are up to 128 characters. This setting gets overridden by
image loading. image loading.
@c man .TP @c man .TP
@item -publisher text @item -publisher text
@kindex -publisher sets publisher id @kindex -publisher sets publisher id
@cindex Image, set publisher id, -publisher @cindex Image, set publisher id, -publisher
Set the publisher id string to be written with the next -commit. This may Set the publisher ID string to be written with the next -commit. This may
identify the person or organisation who specified what shall be recorded. identify the person or organisation who specified what shall be recorded.
Permissible are up to 128 characters. This setting gets overridden by Permissible are up to 128 characters. This setting gets overridden by
image loading. image loading.
@ -2961,20 +2966,20 @@ image loading.
@item -application_id text @item -application_id text
@kindex -application_id sets application id @kindex -application_id sets application id
@cindex Image, set application id, -application_id @cindex Image, set application id, -application_id
Set the application id string to be written with the next -commit. This may Set the application ID string to be written with the next -commit. This may
identify the specification of how the data are recorded. identify the specification of how the data are recorded.
Permissible are up to 128 characters. This setting gets overridden by Permissible are up to 128 characters. This setting gets overridden by
image loading. image loading.
@* @*
The special text "@@xorriso@@" gets converted to the id string of The special text "@@xorriso@@" gets converted to the ID string of
@command{xorriso} @command{xorriso}
which is normally written as -preparer_id. It is a wrong tradition to write which is normally written as -preparer_id. It is a wrong tradition to write
the program id as -application_id. the program ID as -application_id.
@c man .TP @c man .TP
@item -system_id text @item -system_id text
@kindex -system_id sets system id @kindex -system_id sets system id
@cindex Image, set system id, -system_id @cindex Image, set system id, -system_id
Set the system id string to be written with the next -commit. This may Set the system ID string to be written with the next -commit. This may
identify the system which can recognize and act upon the content of the identify the system which can recognize and act upon the content of the
System Area in image blocks 0 to 15. System Area in image blocks 0 to 15.
Permissible are up to 32 characters. This setting gets overridden by Permissible are up to 32 characters. This setting gets overridden by
@ -3039,16 +3044,16 @@ image loading.
@item -preparer_id @item -preparer_id
@kindex -preparer_id sets preparer id @kindex -preparer_id sets preparer id
@cindex Image, set preparer id, -preparer_id @cindex Image, set preparer id, -preparer_id
Set the preparer id string to be written with the next -commit. This may Set the preparer ID string to be written with the next -commit. This may
identify the person or other entity which controls the preparation of the data identify the person or other entity which controls the preparation of the data
which shall be recorded. Normally this should be the id of @command{xorriso} which shall be recorded. Normally this should be the ID of @command{xorriso}
and not of the person or program which operates @command{xorriso}. and not of the person or program which operates @command{xorriso}.
Please avoid to change it. Permissible are up to 128 characters. Please avoid to change it. Permissible are up to 128 characters.
@* @*
The special text "@@xorriso@@" gets converted to the id string of The special text "@@xorriso@@" gets converted to the ID string of
@command{xorriso} which is default at program startup. @command{xorriso} which is default at program startup.
@* @*
Unlike other id strings, this setting is not influenced by image loading. Unlike other ID strings, this setting is not influenced by image loading.
@c man .TP @c man .TP
@item -out_charset character_set_name @item -out_charset character_set_name
@kindex -out_charset sets output character set @kindex -out_charset sets output character set
@ -3195,7 +3200,7 @@ The same effect is achieved by -padding mode "included".
@end table @end table
@c man .TP @c man .TP
@c man .B Bootable ISO images: @c man .B Bootable ISO images:
@node Bootable, Jigdo, SetWrite, Options @node Bootable, Jigdo, SetWrite, Commands
@section Bootable ISO images @section Bootable ISO images
@c man .PP @c man .PP
Contrary to published specifications many BIOSes will load an El Torito Contrary to published specifications many BIOSes will load an El Torito
@ -3541,7 +3546,7 @@ lower valid one.
@end table @end table
@c man .TP @c man .TP
@c man .B Jigdo Template Extraction: @c man .B Jigdo Template Extraction:
@node Jigdo, Charset, Bootable, Options @node Jigdo, Charset, Bootable, Commands
@section Jigdo Template Extraction @section Jigdo Template Extraction
@c man .PP @c man .PP
@cindex Jigdo Template Extraction, _definition @cindex Jigdo Template Extraction, _definition
@ -3649,7 +3654,7 @@ Alias: -checksum_algorithm_template
@end table @end table
@c man .TP @c man .TP
@c man .B Character sets: @c man .B Character sets:
@node Charset, Exception, Jigdo, Options @node Charset, Exception, Jigdo, Commands
@section Character sets @section Character sets
@c man .PP @c man .PP
@cindex Character Set, _definition @cindex Character Set, _definition
@ -3713,7 +3718,7 @@ If this appears necessary, one should consider to set -backslash_codes to
@end table @end table
@c man .TP @c man .TP
@c man .B Exception processing: @c man .B Exception processing:
@node Exception, DialogCtl, Charset, Options @node Exception, DialogCtl, Charset, Commands
@section Exception processing @section Exception processing
@c man .PP @c man .PP
Since the tasks of @command{xorriso} are manifold and prone to external Since the tasks of @command{xorriso} are manifold and prone to external
@ -3874,7 +3879,7 @@ file content stems from the loaded ISO image and is not filtered.
@end table @end table
@c man .TP @c man .TP
@c man .B Dialog mode control: @c man .B Dialog mode control:
@node DialogCtl, Inquiry, Exception, Options @node DialogCtl, Inquiry, Exception, Commands
@section Dialog mode control @section Dialog mode control
@table @asis @table @asis
@c man .TP @c man .TP
@ -3949,7 +3954,7 @@ use -rollback to revoke the whole session.
@end table @end table
@c man .TP @c man .TP
@c man .B Drive and media related inquiry actions: @c man .B Drive and media related inquiry actions:
@node Inquiry, Navigate, DialogCtl, Options @node Inquiry, Navigate, DialogCtl, Commands
@section Drive and media related inquiry actions @section Drive and media related inquiry actions
@table @asis @table @asis
@c man .TP @c man .TP
@ -4073,13 +4078,13 @@ subtracting already foreseeable consumption by next -commit.
@item -pvd_info @item -pvd_info
@kindex -pvd_info shows image id strings @kindex -pvd_info shows image id strings
@cindex Image, show id strings, -pvd_info @cindex Image, show id strings, -pvd_info
Print various id strings which can be found in loaded ISO images. Some of Print various ID strings which can be found in loaded ISO images. Some of
them may be changed by commands like -volid or -publisher. For these them may be changed by commands like -volid or -publisher. For these
ids -pvd_info reports what would be written with the next -commit. IDs -pvd_info reports what would be written with the next -commit.
@end table @end table
@c man .TP @c man .TP
@c man .B Navigation in ISO image and disk filesystem: @c man .B Navigation in ISO image and disk filesystem:
@node Navigate, Verify, Inquiry, Options @node Navigate, Verify, Inquiry, Commands
@section Navigation in ISO image and disk filesystem @section Navigation in ISO image and disk filesystem
@table @asis @table @asis
@c man .TP @c man .TP
@ -4345,7 +4350,7 @@ Like -show_stream but working recursively.
@end table @end table
@c man .TP @c man .TP
@c man .B Evaluation of readability and recovery: @c man .B Evaluation of readability and recovery:
@node Verify, Restore, Navigate, Options @node Verify, Restore, Navigate, Commands
@section Evaluation of readability and recovery @section Evaluation of readability and recovery
@c man .PP @c man .PP
It is not uncommon that optical media produce read errors. The reasons may be It is not uncommon that optical media produce read errors. The reasons may be
@ -4490,7 +4495,7 @@ and their start block addresses, followed by binary bitmap data.
@* @*
@item map_with_volid="on" @item map_with_volid="on"
examines tracks whether they are ISO images and examines tracks whether they are ISO images and
prints their volume ids into the human readable TOC of sector_map=. prints their volume IDs into the human readable TOC of sector_map=.
@* @*
@item patch_lba0="on" @item patch_lba0="on"
transfers within the data_to= file a copy of the currently transfers within the data_to= file a copy of the currently
@ -4552,7 +4557,7 @@ Only mismatching data files will be reported.
@end table @end table
@c man .TP @c man .TP
@c man .B osirrox ISO-to-disk restore commands: @c man .B osirrox ISO-to-disk restore commands:
@node Restore, Emulation, Verify, Options @node Restore, Emulation, Verify, Commands
@section osirrox ISO-to-disk restore commands @section osirrox ISO-to-disk restore commands
@c man .PP @c man .PP
Normally @command{xorriso} only writes to disk files which were given as stdio: Normally @command{xorriso} only writes to disk files which were given as stdio:
@ -4714,7 +4719,7 @@ reachable as /bin/mount or /sbin/mount.
@end table @end table
@c man .TP @c man .TP
@c man .B Command compatibility emulations: @c man .B Command compatibility emulations:
@node Emulation, Scripting, Restore, Options @node Emulation, Scripting, Restore, Commands
@section Command compatibility emulations (cdrtools) @section Command compatibility emulations (cdrtools)
@c man .PP @c man .PP
Writing of ISO 9660 on CD is traditionally done by program mkisofs Writing of ISO 9660 on CD is traditionally done by program mkisofs
@ -4963,7 +4968,7 @@ Program scdbackup_verify will recognize and verify tag resp. record.
@end table @end table
@c man .TP @c man .TP
@c man .B Scripting, dialog and program control features: @c man .B Scripting, dialog and program control features:
@node Scripting, Frontend, Emulation, Options @node Scripting, Frontend, Emulation, Commands
@section Scripting, dialog and program control features @section Scripting, dialog and program control features
@table @asis @table @asis
@c man .TP @c man .TP
@ -5163,11 +5168,11 @@ This transport becomes visible with -report_about "ALL".
If path is not empty it gives the address of a plain text file where If path is not empty it gives the address of a plain text file where
a log record gets appended after each session. This log can be used to a log record gets appended after each session. This log can be used to
determine the start_lba of a session for mount options -o sbsector= determine the start_lba of a session for mount options -o sbsector=
resp. -s from date or volume id. resp. -s 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
@ -5203,7 +5208,7 @@ Do not execute the line but store it in readline history.
@end table @end table
@c man .TP @c man .TP
@c man .B Support for frontend programs via stdin and stdout: @c man .B Support for frontend programs via stdin and stdout:
@node Frontend, ExDevices, Scripting, Options @node Frontend, ExDevices, Scripting, Commands
@section Support for frontend programs via stdin and stdout @section Support for frontend programs via stdin and stdout
@table @asis @table @asis
@c man .TP @c man .TP
@ -5252,7 +5257,7 @@ Use text as name of this program in subsequent messages
Use text as name of this program and perform -help. Use text as name of this program and perform -help.
@end table @end table
@c man .br @c man .br
@node Examples, Files, Options, Top @node Examples, Files, Commands, Top
@chapter Examples @chapter Examples
@c man .SH EXAMPLES @c man .SH EXAMPLES
@c man .SS @c man .SS
@ -5758,7 +5763,7 @@ accordingly.
@* @*
ACL, xattr, hard links and MD5 checksums will be recorded. ACL, xattr, hard links and MD5 checksums will be recorded.
Accelerated comparison is enabled at the expense of potentially larger backup Accelerated comparison is enabled at the expense of potentially larger backup
size. Only media with the expected volume id or blank media are accepted. size. Only media with the expected volume ID or blank media are accepted.
Files with names matching *.o or *.swp get excluded explicitly. Files with names matching *.o or *.swp get excluded explicitly.
@* @*
When done with writing the new session gets checked by its recorded MD5. When done with writing the new session gets checked by its recorded MD5.