libburnia/libisoburn
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 635b3126a7
commit 58ee616700
3 changed files with 226 additions and 215 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
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.
.TP
\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
an event of the given severity (like FAILURE, see \-abort_on). An empty search
pattern accepts any image.
@ -2467,49 +2467,54 @@ The name must not contain a '/' character and must not be longer than
255 bytes.
.TP
\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:
.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
Joliet allows 16 UCS\-2 characters. Like: "Windows name"
"IMAGE_23"
.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.
.br
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
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
Consider this when setting \-volid "ISOIMAGE" before executing \-dev, \-indev,
or \-rollback.
If you insist in \-volid "ISOIMAGE", set it again after those commands.
.TP
\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
image loading.
.TP
\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.
Permissible are up to 128 characters. This setting gets overridden by
image loading.
.TP
\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.
Permissible are up to 128 characters. This setting gets overridden by
image loading.
.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 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
\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
System Area in image blocks 0 to 15.
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.
.TP
\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
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.
Please avoid to change it. Permissible are up to 128 characters.
.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.
.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
\fB\-out_charset\fR character_set_name
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.
.TP
\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
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
.B Navigation in ISO image and disk filesystem:
.TP
@ -3820,7 +3825,7 @@ and their start block addresses, followed by binary bitmap data.
.br
\fBmap_with_volid="on"\fR
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
\fBpatch_lba0="on"\fR
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
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=
resp. \-s from date or volume id.
resp. \-s from date or volume ID.
.br
Record format is: timestamp start_lba size volume\-id
.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
\fB\-scsi_log\fR "on"|"off"
Mode "on" enables very verbous logging of SCSI commands and drive replies.
@ -4840,7 +4845,7 @@ accordingly.
.br
ACL, xattr, hard links and MD5 checksums will be recorded.
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.
.br
When done with writing the new session gets checked by its recorded MD5.

287
xorriso/xorriso.info
View File

@ -31,7 +31,7 @@ images with Rock Ridge extensions.
* Extras:: Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr
* Processing:: Command processing
* Dialog:: Dialog, Readline, Result pager
* Options:: Reference of commands
* Commands:: Reference of commands
* Examples:: Examples
* Files:: Files
* 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.

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
********************************
@ -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.

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
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

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
========================================
@ -572,7 +572,7 @@ loss of expressivity.
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
=====================================
@ -632,7 +632,7 @@ commands which acquire the drive.
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
=============================================
@ -715,7 +715,7 @@ activate them only after image loading.
filesystem.
-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
drive and issue an event of the given severity (like FAILURE, see
-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.

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
==================================
@ -1116,7 +1116,7 @@ filesystem.
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
===============================
@ -1285,7 +1285,7 @@ File: xorriso.info, Node: SetInsert, Next: Manip, Prev: Insert, Up: Options
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
======================
@ -1471,7 +1471,7 @@ whether they stem from the loaded image or were newly inserted.
-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
================================
@ -1769,7 +1769,7 @@ File: xorriso.info, Node: CmdFind, Next: Filter, Prev: Manip, Up: Options
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
=================================
@ -1861,7 +1861,7 @@ there are many small files.
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
=====================================
@ -2034,7 +2034,7 @@ File: xorriso.info, Node: Writing, Next: SetWrite, Prev: Filter, Up: Options
"(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
================================
@ -2193,46 +2193,47 @@ according to the setting of command -acl.
than 255 bytes.
-volid text
Specify the volume ID. `xorriso' accepts any text up to 32
characters, but according to rarely obeyed specs stricter rules
apply:
Specify the volume ID, which can be considered to be the name of
the image. `xorriso' accepts any text up to 32 characters, but
according to rarely obeyed specs stricter rules apply:
ECMA-119 demands ASCII characters out of [A-Z0-9_]. Like:
"IMAGE_23"
Joliet allows 16 UCS-2 characters. Like: "Windows name"
Be aware that the volume id might get used automatically as name
of the mount point when the medium is inserted into a playful
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.
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 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.
Consider this when setting -volid "ISOIMAGE" before executing
-dev, -indev, or -rollback. If you insist in -volid "ISOIMAGE",
set it again after those commands.
-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
by image loading.
-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
shall be recorded. Permissible are up to 128 characters. This
setting gets overridden by image loading.
-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.
Permissible are up to 128 characters. This setting gets overridden
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
tradition to write the program id as -application_id.
tradition to write the program ID as -application_id.
-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
content of the System Area in image blocks 0 to 15. Permissible
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.
-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
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
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.
Unlike other id strings, this setting is not influenced by image
Unlike other ID strings, this setting is not influenced by image
loading.
-out_charset character_set_name
@ -2394,7 +2395,7 @@ according to the setting of command -acl.
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
========================
@ -2656,7 +2657,7 @@ filesystem and announced by an MBR partition table entry.
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
==============================
@ -2735,7 +2736,7 @@ emulation, and padding will be counted as part of the ISO image.
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
===================
@ -2787,7 +2788,7 @@ display on your 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
=========================
@ -2902,7 +2903,7 @@ failed unexpectedly.
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
========================
@ -2957,7 +2958,7 @@ File: xorriso.info, Node: DialogCtl, Next: Inquiry, Prev: Exception, Up: Opt
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
============================================
@ -3049,13 +3050,13 @@ File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Opti
subtracting already foreseeable consumption by next -commit.
-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.
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.

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
================================================
@ -3240,7 +3241,7 @@ File: xorriso.info, Node: Navigate, Next: Verify, Prev: Inquiry, Up: Options
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
===========================================
@ -3359,7 +3360,7 @@ transmission errors.
start block addresses, followed by binary bitmap data.
map_with_volid="on"
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"
transfers within the data_to= file a copy of the currently
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.

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
=========================================
@ -3546,7 +3547,7 @@ The directory permissions on disk have to allow rwx.
/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)
================================================
@ -3724,7 +3725,7 @@ said programs trigger comparable actions.
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
===================================================
@ -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
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
-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
The first three items are single words, the rest of the line is
the volume id.
the volume ID.
-scsi_log "on"|"off"
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.

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
=======================================================
@ -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.

File: xorriso.info, Node: Examples, Next: Files, Prev: Options, Up: Top
File: xorriso.info, Node: Examples, Next: Files, Prev: Commands, Up: Top
10 Examples
***********
@ -4278,7 +4279,7 @@ counterparts. ISO file objects get created, deleted or get their
attributes adjusted accordingly.
ACL, xattr, hard links and MD5 checksums will be recorded. Accelerated
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.
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)
* -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)
* -add inserts one or more paths: Insert. (line 45)
* -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)
* -append_partition adds arbitrary file after image end: Bootable.
(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)
* -assert_volid rejects undesired images: Loading. (line 84)
* -auto_charset learns character set from image: Loading. (line 98)
* -backslash_codes enables backslash conversion: Scripting. (line 67)
* -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)
* -boot_image controls bootability: Bootable. (line 26)
* -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_r sets ownership in ISO image: Manip. (line 47)
* -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_filter_list bans filter registration: Filter. (line 52)
* -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_r reports ISO/disk differences: Navigate. (line 159)
* -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_rx copies file trees to disk: Restore. (line 108)
* -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)
* -drive_class controls drive accessability: Loading. (line 54)
* -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)
* -dusx show directory size on disk: Navigate. (line 102)
* -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)
* -eject ejects drive tray: Writing. (line 52)
* -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)
* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 185)
* -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_r shows ACL in ISO image: Navigate. (line 77)
* -getfattr shows xattr in ISO image: Navigate. (line 81)
* -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)
* -hardlinks controls handling of hard links: Loading. (line 110)
* -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)
* -options_from_file reads commands from file: Scripting. (line 12)
* -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)
* -overwrite enables overwriting in ISO: SetInsert. (line 127)
* -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)
* -paste_in copies file into disk file: Restore. (line 121)
* -path_list inserts paths from disk file: Insert. (line 78)
* -pathspecs sets meaning of = with -add: SetInsert. (line 118)
* -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_info prints message text line: Scripting. (line 102)
* -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_help prints help text: Frontend. (line 33)
* -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)
* -pwd tells working directory in ISO: Navigate. (line 20)
* -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.
(line 69)
* -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)
* -status shows current settings: Scripting. (line 47)
* -status_history_max curbs -status history: Scripting. (line 56)
* -stdio_sync controls stdio buffer: SetWrite. (line 316)
* -stream_recording controls defect management: SetWrite. (line 297)
* -system_id sets system id: SetWrite. (line 199)
* -stdio_sync controls stdio buffer: SetWrite. (line 317)
* -stream_recording controls defect management: SetWrite. (line 298)
* -system_id sets system id: SetWrite. (line 200)
* -tell_media_space reports free space: Inquiry. (line 89)
* -temp_mem_limit curbs memory consumption: Scripting. (line 92)
* -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_l inserts paths if different: Insert. (line 124)
* -update_r inserts paths if different: Insert. (line 113)
* -use_readline enables readline for dialog: DialogCtl. (line 28)
* -version prints help text: Scripting. (line 23)
* -volid sets volume id: SetWrite. (line 160)
* -volset_id sets volume set id: SetWrite. (line 179)
* -volume_date sets volume timestamp: SetWrite. (line 206)
* -write_type chooses TAO or SAO/DAO: SetWrite. (line 339)
* -volset_id sets volume set id: SetWrite. (line 180)
* -volume_date sets volume timestamp: SetWrite. (line 207)
* -write_type chooses TAO or SAO/DAO: SetWrite. (line 340)
* -x enables automatic execution order of arguments: ArgSort.
(line 16)
* -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
@ -4778,7 +4779,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Character Set, _definition: Charset. (line 6)
* Character Set, for input, -in_charset: Loading. (line 92)
* 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, of terminal, -local_charset: Charset. (line 47)
* 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 chains of tree, -show_stream_r: Navigate. (line 183)
* 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)
* 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_r: Manip. (line 55)
* 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)
* Image reading, cache size, -data_cache_size: Loading. (line 269)
* 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, override change status, -changes_pending: Writing. (line 13)
* Image, set abstract file name, -abstract_file: SetWrite. (line 231)
* Image, set application id, -application_id: SetWrite. (line 190)
* Image, set biblio file name, -biblio_file: SetWrite. (line 238)
* Image, set copyright file name, -copyright_file: SetWrite. (line 225)
* Image, set preparer id, -preparer_id: SetWrite. (line 244)
* Image, set publisher id, -publisher: SetWrite. (line 184)
* Image, set system id, -system_id: SetWrite. (line 199)
* Image, set abstract file name, -abstract_file: SetWrite. (line 232)
* Image, set application id, -application_id: SetWrite. (line 191)
* Image, set biblio file name, -biblio_file: SetWrite. (line 239)
* Image, set copyright file name, -copyright_file: SetWrite. (line 226)
* Image, set preparer id, -preparer_id: SetWrite. (line 245)
* Image, set publisher id, -publisher: SetWrite. (line 185)
* Image, set system id, -system_id: SetWrite. (line 200)
* Image, set volume id, -volid: SetWrite. (line 160)
* Image, set volume set id, -volset_id: SetWrite. (line 179)
* Image, set volume timestamp, -volume_date: SetWrite. (line 206)
* Image, set volume set id, -volset_id: SetWrite. (line 180)
* Image, set volume timestamp, -volume_date: SetWrite. (line 207)
* Image, show id strings, -pvd_info: Inquiry. (line 93)
* Insert, enable overwriting, -overwrite: SetInsert. (line 127)
* 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)
* Next writeable address, -grow_blindly: AqDrive. (line 46)
* 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_r: Manip. (line 47)
* 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 tree checksums, -check_md5_r: Verify. (line 170)
* 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, buffer syncing, -stdio_sync: SetWrite. (line 316)
* Write, close media, -close: SetWrite. (line 333)
* Write, buffer syncing, -stdio_sync: SetWrite. (line 317)
* Write, close media, -close: SetWrite. (line 334)
* 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, enable HFS+, -hfsplus: SetWrite. (line 14)
* 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, log problematic disk files, -errfile_log: Scripting. (line 118)
* 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, predict image size, -print_size: Inquiry. (line 80)
* Write, set speed, -speed: SetWrite. (line 282)
* Write, simulation, -dummy: SetWrite. (line 322)
* Write, TAO or SAO/DAO, -write_type: SetWrite. (line 339)
* Write, set speed, -speed: SetWrite. (line 283)
* Write, simulation, -dummy: SetWrite. (line 323)
* Write, TAO or SAO/DAO, -write_type: SetWrite. (line 340)
* xattr, _definition: Extras. (line 65)
* xattr, control handling, -xattr: Loading. (line 151)
* xattr, set in ISO image, -setfattr: Manip. (line 111)
@ -5039,51 +5040,51 @@ Node: Drives11416
Node: Extras14731
Node: Processing19183
Node: Dialog22803
Node: Options24480
Node: ArgSort26154
Node: AqDrive27644
Node: Loading30688
Node: Insert46143
Node: SetInsert56278
Node: Manip64854
Node: CmdFind73677
Node: Filter88381
Node: Writing92936
Node: SetWrite102114
Node: Bootable120753
Node: Jigdo136146
Node: Charset140392
Node: Exception143153
Node: DialogCtl149272
Node: Inquiry151869
Node: Navigate156735
Node: Verify165032
Node: Restore174063
Node: Emulation180972
Node: Scripting190783
Node: Frontend197943
Node: Examples199243
Node: ExDevices200420
Node: ExCreate201079
Node: ExDialog202364
Node: ExGrowing203629
Node: ExModifying204434
Node: ExBootable204938
Node: ExCharset205490
Node: ExPseudo206311
Node: ExCdrecord207209
Node: ExMkisofs207526
Node: ExGrowisofs208866
Node: ExException210001
Node: ExTime210455
Node: ExIncBackup210914
Node: ExRestore214906
Node: ExRecovery215866
Node: Files216436
Node: Seealso217735
Node: Bugreport218458
Node: Legal219039
Node: CommandIdx220050
Node: ConceptIdx235995
Node: Commands24481
Node: ArgSort26158
Node: AqDrive27650
Node: Loading30695
Node: Insert46151
Node: SetInsert56287
Node: Manip64864
Node: CmdFind73688
Node: Filter88393
Node: Writing92949
Node: SetWrite102128
Node: Bootable120831
Node: Jigdo136225
Node: Charset140472
Node: Exception143234
Node: DialogCtl149354
Node: Inquiry151952
Node: Navigate156819
Node: Verify165117
Node: Restore174149
Node: Emulation181059
Node: Scripting190871
Node: Frontend198032
Node: Examples199333
Node: ExDevices200511
Node: ExCreate201170
Node: ExDialog202455
Node: ExGrowing203720
Node: ExModifying204525
Node: ExBootable205029
Node: ExCharset205581
Node: ExPseudo206402
Node: ExCdrecord207300
Node: ExMkisofs207617
Node: ExGrowisofs208957
Node: ExException210092
Node: ExTime210546
Node: ExIncBackup211005
Node: ExRestore214997
Node: ExRecovery215957
Node: Files216527
Node: Seealso217826
Node: Bugreport218549
Node: Legal219130
Node: CommandIdx220141
Node: ConceptIdx236086

End Tag Table

105
xorriso/xorriso.texi
View File

@ -102,7 +102,7 @@ with Rock Ridge extensions.
* Extras:: Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr
* Processing:: Command processing
* Dialog:: Dialog, Readline, Result pager
* Options:: Reference of commands
* Commands:: Reference of commands
* Examples:: Examples
* Files:: Files
* 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
event which triggers the threshold of command -abort_on.
@c man .SS
@node Dialog, Options, Processing, top
@node Dialog, Commands, Processing, top
@chapter Dialog, Readline, Result pager
@c man .B Dialog, Readline, Result pager:
@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.
All actions try to abort as soon as possible.
@node Options, Examples, Dialog, top
@chapter Options
@node Commands, Examples, Dialog, top
@chapter Commands
@c man .br
@c man .SH OPTIONS
@c man .br
@ -778,7 +778,7 @@ inner dashes are interpreted as underscores.
* Frontend:: Support for frontend programs via stdin and stdout
@end menu
@c man .TP
@node ArgSort, AqDrive, Options, Options
@node ArgSort, AqDrive, Commands, Commands
@section Execution order of program arguments
@c man .B Execution order of program arguments:
@c man .PP
@ -820,7 +820,7 @@ well make sense, though.
@end table
@c man .PP
@c man .TP
@node AqDrive, Loading, ArgSort, Options
@node AqDrive, Loading, ArgSort, Commands
@section Acquiring source and target drive
@c man .B Acquiring source and target drive:
@c man .PP
@ -896,7 +896,7 @@ begins. The output drive is given up when writing is done.
@end table
@c man .TP
@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
@c man .PP
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
@item -assert_volid pattern severity
@kindex -assert_volid rejects undesired images
@cindex Image, demand volume id, -assert_volid
Refuse to load ISO images with volume ids which do not match the given
@cindex Image, demand volume ID, -assert_volid
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
an event of the given severity (like FAILURE, see -abort_on). An empty search
pattern accepts any image.
@ -1235,7 +1235,7 @@ Currently the default is 32 tiles of 32 blocks = 2 MiB.
@end table
@c man .TP
@c man .B Inserting files into ISO image:
@node Insert, SetInsert, Loading, Options
@node Insert, SetInsert, Loading, Commands
@section Inserting files into ISO image
@c man .PP
The following commands expect file addresses of two kinds:
@ -1502,7 +1502,7 @@ parameters.
@end table
@c man .TP
@c man .B Settings for file insertion:
@node SetInsert, Manip, Insert, Options
@node SetInsert, Manip, Insert, Commands
@section Settings for file insertion
@c man .TP
@table @asis
@ -1725,7 +1725,7 @@ parameter and their contents may not overlap.
@end table
@c man .TP
@c man .B File manipulations:
@node Manip, CmdFind, SetInsert, Options
@node Manip, CmdFind, SetInsert, Commands
@section File manipulations
@c man .PP
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
@c man .TP
@c man .B Tree traversal command -find:
@node CmdFind, Filter, Manip, Options
@node CmdFind, Filter, Manip, Commands
@section Tree traversal command -find
@c man .PP
@table @asis
@ -2387,7 +2387,7 @@ E.g.:
@c man .TP
@c man .B Filters for data file content:
@c man .PP
@node Filter, Writing, CmdFind, Options
@node Filter, Writing, CmdFind, Commands
@section Filters for data file content
@cindex Filter, _definition
@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
@c man .TP
@c man .B Writing the result, drive control:
@node Writing, SetWrite, Filter, Options
@node Writing, SetWrite, Filter, Commands
@section Writing the result, drive control
@c man .PP
(see also paragraph about settings below)
@ -2730,7 +2730,7 @@ The currently recognized type is marked by text "(current)".
@end table
@c man .TP
@c man .B Settings for result writing:
@node SetWrite, Bootable, Writing, Options
@node SetWrite, Bootable, Writing, Commands
@section Settings for result writing
@c man .PP
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
@kindex -volid sets volume id
@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:
@*
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.
@*
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
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,
or -rollback.
@ -2946,14 +2951,14 @@ If you insist in -volid "ISOIMAGE", set it again after those commands.
@item -volset_id text
@kindex -volset_id sets volume set 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
image loading.
@c man .TP
@item -publisher text
@kindex -publisher sets publisher id
@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.
Permissible are up to 128 characters. This setting gets overridden by
image loading.
@ -2961,20 +2966,20 @@ image loading.
@item -application_id text
@kindex -application_id sets 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.
Permissible are up to 128 characters. This setting gets overridden 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
@command{xorriso}
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
@item -system_id text
@kindex -system_id sets 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
System Area in image blocks 0 to 15.
Permissible are up to 32 characters. This setting gets overridden by
@ -3039,16 +3044,16 @@ image loading.
@item -preparer_id
@kindex -preparer_id sets 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
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}.
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.
@*
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
@item -out_charset character_set_name
@kindex -out_charset sets output character set
@ -3195,7 +3200,7 @@ The same effect is achieved by -padding mode "included".
@end table
@c man .TP
@c man .B Bootable ISO images:
@node Bootable, Jigdo, SetWrite, Options
@node Bootable, Jigdo, SetWrite, Commands
@section Bootable ISO images
@c man .PP
Contrary to published specifications many BIOSes will load an El Torito
@ -3541,7 +3546,7 @@ lower valid one.
@end table
@c man .TP
@c man .B Jigdo Template Extraction:
@node Jigdo, Charset, Bootable, Options
@node Jigdo, Charset, Bootable, Commands
@section Jigdo Template Extraction
@c man .PP
@cindex Jigdo Template Extraction, _definition
@ -3649,7 +3654,7 @@ Alias: -checksum_algorithm_template
@end table
@c man .TP
@c man .B Character sets:
@node Charset, Exception, Jigdo, Options
@node Charset, Exception, Jigdo, Commands
@section Character sets
@c man .PP
@cindex Character Set, _definition
@ -3713,7 +3718,7 @@ If this appears necessary, one should consider to set -backslash_codes to
@end table
@c man .TP
@c man .B Exception processing:
@node Exception, DialogCtl, Charset, Options
@node Exception, DialogCtl, Charset, Commands
@section Exception processing
@c man .PP
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
@c man .TP
@c man .B Dialog mode control:
@node DialogCtl, Inquiry, Exception, Options
@node DialogCtl, Inquiry, Exception, Commands
@section Dialog mode control
@table @asis
@c man .TP
@ -3949,7 +3954,7 @@ use -rollback to revoke the whole session.
@end table
@c man .TP
@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
@table @asis
@c man .TP
@ -4073,13 +4078,13 @@ subtracting already foreseeable consumption by next -commit.
@item -pvd_info
@kindex -pvd_info shows image id strings
@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
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
@c man .TP
@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
@table @asis
@c man .TP
@ -4345,7 +4350,7 @@ Like -show_stream but working recursively.
@end table
@c man .TP
@c man .B Evaluation of readability and recovery:
@node Verify, Restore, Navigate, Options
@node Verify, Restore, Navigate, Commands
@section Evaluation of readability and recovery
@c man .PP
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"
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"
transfers within the data_to= file a copy of the currently
@ -4552,7 +4557,7 @@ Only mismatching data files will be reported.
@end table
@c man .TP
@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
@c man .PP
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
@c man .TP
@c man .B Command compatibility emulations:
@node Emulation, Scripting, Restore, Options
@node Emulation, Scripting, Restore, Commands
@section Command compatibility emulations (cdrtools)
@c man .PP
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
@c man .TP
@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
@table @asis
@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
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=
resp. -s from date or volume id.
resp. -s from date or 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
@item -scsi_log "on"|"off"
@kindex -scsi_log reports SCSI commands
@ -5203,7 +5208,7 @@ Do not execute the line but store it in readline history.
@end table
@c man .TP
@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
@table @asis
@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.
@end table
@c man .br
@node Examples, Files, Options, Top
@node Examples, Files, Commands, Top
@chapter Examples
@c man .SH EXAMPLES
@c man .SS
@ -5758,7 +5763,7 @@ accordingly.
@*
ACL, xattr, hard links and MD5 checksums will be recorded.
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.
@*
When done with writing the new session gets checked by its recorded MD5.