Some adjustments in xorriso man page
This commit is contained in:
@ -390,7 +390,7 @@ Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images.
|
||||
makes such an image bootable. For details see option \-boot_image.
|
||||
.br
|
||||
It is possible to make ISO images bootable from USB stick or other
|
||||
hard\-disk\-like media by \-boot_image argument system_area= . This installs
|
||||
hard\-disk\-like media by \-boot_image parameter system_area= . This installs
|
||||
a Master Boot Record which may get adjusted according to the needs
|
||||
of GRUB resp. ISOLINUX.
|
||||
An \fBMBR\fR contains boot code and a partition table. It does not hamper
|
||||
@ -460,7 +460,7 @@ or an end of an input line.
|
||||
.PP
|
||||
At program start the list delimiter is the word "\-\-".
|
||||
This may be changed by option \-list_delimiter in order to allow
|
||||
"\-\-" as argument in a list of variable length.
|
||||
"\-\-" as parameter in a list of variable length.
|
||||
It is advised to reset the delimiter to "\-\-" immediately
|
||||
afterwards.
|
||||
.br
|
||||
@ -469,7 +469,7 @@ throughout this text.
|
||||
.br
|
||||
The list delimiter is silently tolerated if it appears after the parameters of
|
||||
a command with a fixed list length. It is handled as normal text if it
|
||||
appears among the arguments of such a command.
|
||||
appears among the parameters of such a command.
|
||||
.PP
|
||||
\fBPattern expansion\fR
|
||||
converts a list of pattern words into a list of existing file addresses.
|
||||
@ -480,7 +480,7 @@ and respects '/' as separator which may only be matched literally.
|
||||
.br
|
||||
It is a property of some particular commands and not a general
|
||||
feature. It gets controlled by commands \-iso_rr_pattern and \-disk_pattern.
|
||||
Commands which may use pattern expansion all have variable argument
|
||||
Commands which may use pattern expansion all have variable parameter
|
||||
lists which are marked in this man page by "[***]" rather than "[...]".
|
||||
.br
|
||||
Some other commands perform pattern matching unconditionally.
|
||||
@ -974,7 +974,7 @@ to replace it.
|
||||
The commands in this section alter the ISO image and not the local filesystem.
|
||||
.TP
|
||||
\fB\-disk_pattern\fR "on"|"ls"|"off"
|
||||
Set the pattern expansion mode for the disk_path arguments of several
|
||||
Set the pattern expansion mode for the disk_path parameters of several
|
||||
commands which support this feature.
|
||||
.br
|
||||
Setting "off" disables this feature for all commands which are marked in this
|
||||
@ -1042,7 +1042,7 @@ is a directory then its whole sub tree is inserted into the ISO image.
|
||||
Like \-map, but if disk_path is a directory then its sub tree is not inserted.
|
||||
.TP
|
||||
\fB\-map_l\fR disk_prefix iso_rr_prefix disk_path [***]
|
||||
Perform \-map with each of the disk_path arguments. iso_rr_path will be
|
||||
Perform \-map with each of the disk_path parameters. iso_rr_path will be
|
||||
composed from disk_path by replacing disk_prefix by iso_rr_prefix.
|
||||
.TP
|
||||
\fB\-update\fR disk_path iso_rr_path
|
||||
@ -1070,7 +1070,7 @@ If iso_rr_path does not exist yet, then it gets added. If disk_path does not
|
||||
exist, then iso_rr_path gets deleted.
|
||||
.TP
|
||||
\fB\-update_l\fR disk_prefix iso_rr_prefix disk_path [***]
|
||||
Perform \-update_r with each of the disk_path arguments. iso_rr_path will be
|
||||
Perform \-update_r with each of the disk_path parameters. iso_rr_path will be
|
||||
composed from disk_path by replacing disk_prefix by iso_rr_prefix.
|
||||
.TP
|
||||
\fB\-cut_out\fR disk_path byte_offset byte_count iso_rr_path
|
||||
@ -1153,7 +1153,7 @@ command \-cpr (see above) resp. shell command cp \-r. Other than with \-cpr,
|
||||
relative iso_rr_path_original will get prepended the \-cd path and not
|
||||
the \-cdx path. Consider to \-mkdir iso_rr_path_dest before \-cp_clone
|
||||
so the copy address does not depend on the number of iso_rr_path_original
|
||||
arguments.
|
||||
parameters.
|
||||
.TP
|
||||
.B Settings for file insertion:
|
||||
.TP
|
||||
@ -1229,12 +1229,12 @@ disk leafnames. These patterns are evaluated when the exclusion checks are
|
||||
made.
|
||||
.TP
|
||||
\fB\-not_list\fR disk_path
|
||||
Read lines from disk_path and use each of them either as \-not_paths argument,
|
||||
Read lines from disk_path and use each of them either as \-not_paths parameter,
|
||||
if they contain a / character, or as \-not_leaf pattern.
|
||||
.TP
|
||||
\fB\-quoted_not_list\fR disk_path
|
||||
Like \-not_list but with quoted input reading rules. Each word is
|
||||
handled as one argument for \-not_paths resp. \-not_leaf.
|
||||
handled as one parameter for \-not_paths resp. \-not_leaf.
|
||||
.TP
|
||||
\fB\-follow\fR occasion[:occasion[...]]
|
||||
Enable or disable resolution of symbolic links and mountpoints under
|
||||
@ -1350,7 +1350,7 @@ E.g: /file/part_1_of_3_at_0_with_2047m_of_5753194821
|
||||
.br
|
||||
No other files are allowed in the directory. All parts have to be present and
|
||||
their numbers have to be plausible. E.g. byte_count must be valid as \-cut_out
|
||||
argument and their contents may not overlap.
|
||||
parameter and their contents may not overlap.
|
||||
.TP
|
||||
.B File manipulations:
|
||||
.PP
|
||||
@ -1359,7 +1359,7 @@ they stem from the loaded image or were newly inserted.
|
||||
.PP
|
||||
.TP
|
||||
\fB\-iso_rr_pattern\fR "on"|"ls"|"off"
|
||||
Set the pattern expansion mode for the iso_rr_path arguments of several
|
||||
Set the pattern expansion mode for the iso_rr_path parameters of several
|
||||
commands which support this feature.
|
||||
.br
|
||||
Setting "off" disables pattern expansion for all commands which are marked
|
||||
@ -1390,9 +1390,9 @@ Delete empty directories.
|
||||
.TP
|
||||
\fB\-mv\fR iso_rr_path [***] iso_rr_path
|
||||
Rename the given file objects in the ISO tree to the last
|
||||
argument in the list. Use the same rules as with shell command mv.
|
||||
parameter in the list. Use the same rules as with shell command mv.
|
||||
.br
|
||||
If pattern expansion is enabled and if the last argument contains wildcard
|
||||
If pattern expansion is enabled and if the last parameter contains wildcard
|
||||
characters then it must match exactly one existing file address, or else the
|
||||
command fails with a FAILURE event.
|
||||
.TP
|
||||
@ -1577,7 +1577,7 @@ Rather use: \-boot_image "any" "cat_hidden=on"
|
||||
A restricted substitute for shell command find in the ISO image.
|
||||
It performs an action on matching file objects at or below iso_rr_path.
|
||||
.br
|
||||
If not used as last command in the line then the argument list
|
||||
If not used as last command in the line then the parameter list
|
||||
needs to get terminated by "\-\-".
|
||||
.br
|
||||
Tests are optional. If they are omitted then action is applied to all file
|
||||
@ -1722,7 +1722,7 @@ prints file information like shell command ls \-dl.
|
||||
.br
|
||||
\fBcompare\fR
|
||||
performs command \-compare with the found file address as
|
||||
iso_rr_path and the corresponding file address below its argument
|
||||
iso_rr_path and the corresponding file address below its parameter
|
||||
disk_path_start. For this the iso_rr_path of the \-find command gets
|
||||
replaced by the disk_path_start.
|
||||
.br
|
||||
@ -2507,7 +2507,7 @@ Define the handling of a set of El Torito boot images which
|
||||
has been read from an existing ISO image or define how to make a prepared
|
||||
boot image file set bootable. Such file sets get produced by ISOLINUX or GRUB.
|
||||
.br
|
||||
Each \-boot_image command has two arguments: type and setting. More than one
|
||||
Each \-boot_image command has two parameters: type and setting. More than one
|
||||
\-boot_image command may be used to define the handling of one or more boot
|
||||
images. Sequence matters.
|
||||
.br
|
||||
@ -3049,7 +3049,8 @@ file content stems from the loaded ISO image and is not filtered.
|
||||
.B Dialog mode control:
|
||||
.TP
|
||||
\fB\-dialog\fR "on"|"off"|"single_line"
|
||||
Enable or disable to enter dialog mode after all arguments are processed.
|
||||
Enable or disable to enter dialog mode after all program arguments are
|
||||
processed.
|
||||
In dialog mode input lines get prompted via readline or from stdin.
|
||||
.br
|
||||
If no \-abort_on severity was set when dialog starts, then "NEVER" is set
|
||||
@ -3329,7 +3330,7 @@ Similar to shell command du \-sk.
|
||||
Like \-find but operating on local filesystem and not on the ISO image.
|
||||
This is subject to the settings of \-follow.
|
||||
.br
|
||||
\-findx accepts the same \-type arguments as \-find. Additionally it recognizes
|
||||
\-findx accepts the same \-type parameters as \-find. Additionally it recognizes
|
||||
type "mountpoint" (or "m") which matches subdirectories which reside on a
|
||||
different device than their parent. It never matches the disk_path
|
||||
given as start address for \-findx.
|
||||
@ -3395,7 +3396,7 @@ addresses get compared whether they have counterparts below the other address
|
||||
and whether both counterparts match.
|
||||
.TP
|
||||
\fB\-compare_l\fR disk_prefix iso_rr_prefix disk_path [***]
|
||||
Perform \-compare_r with each of the disk_path arguments. iso_rr_path will be
|
||||
Perform \-compare_r with each of the disk_path parameters. iso_rr_path will be
|
||||
composed from disk_path by replacing disk_prefix by iso_rr_prefix.
|
||||
.TP
|
||||
\fB\-show_stream\fR iso_rr_path [***]
|
||||
@ -3686,7 +3687,7 @@ Like \-extract, but if iso_rr_path is a directory then its sub tree gets not
|
||||
restored.
|
||||
.TP
|
||||
\fB\-extract_l\fR iso_rr_prefix disk_prefix iso_rr_path [***]
|
||||
Perform \-extract with each of the iso_rr_path arguments. disk_path will be
|
||||
Perform \-extract with each of the iso_rr_path parameters. disk_path will be
|
||||
composed from iso_rr_path by replacing iso_rr_prefix by disk_prefix.
|
||||
.TP
|
||||
\fB\-extract_cut\fR iso_rr_path byte_offset byte_count disk_path
|
||||
@ -3820,15 +3821,15 @@ Not original mkisofs options are \-\-quoted_path_list ,
|
||||
\-\-hardlinks , \-\-acl ,
|
||||
\-\-xattr , \-\-md5 , \-\-stdio_sync .
|
||||
They work like the \fBxorriso\fR options with the
|
||||
same name and hardcoded argument "on", e.g. \-acl "on".
|
||||
Explicit arguments are expected by \-\-stdio_sync
|
||||
same name and hardcoded parameter "on", e.g. \-acl "on".
|
||||
Explicit parameters are expected by \-\-stdio_sync
|
||||
and \-\-scdbackup_tag.
|
||||
.br
|
||||
The capability to preserve multi\-session history on overwriteable media
|
||||
gets disabled by default. It can be enabled by using \-\-emul\-toc
|
||||
with the first session. See \-compliance no_emul_toc.
|
||||
.br
|
||||
\-\-sort\-weight gets as arguments a number and an iso_rr_path.
|
||||
\-\-sort\-weight gets as parameters a number and an iso_rr_path.
|
||||
The number becomes the LBA sorting weight of regular file iso_rr_path or
|
||||
of all regular files underneath directory iso_rr_path.
|
||||
(See \-find \-exec sort_weight).
|
||||
@ -3874,7 +3875,7 @@ and "\fBgenisofs\fR" are aliases for "mkisofs".
|
||||
If \fBxorriso\fR is started with one of the leafnames "xorrisofs",
|
||||
"genisofs",
|
||||
"mkisofs", or "genisoimage", then it performs \-read_mkisofsrc and prepends
|
||||
\-as "genisofs" to the command line arguments.
|
||||
\-as "genisofs" to the program arguments.
|
||||
I.e. all arguments will be interpreted mkisofs style until "\-\-"
|
||||
is encountered.
|
||||
From then on, options are interpreted as \fBxorriso\fR options.
|
||||
@ -3921,7 +3922,7 @@ are aliases for "cdrecord".
|
||||
.br
|
||||
If \fBxorriso\fR is started with one of the leafnames "xorrecord",
|
||||
"cdrskin", "cdrecord", or "wodim", then it automatically prepends \-as "cdrskin"
|
||||
to the command line arguments. I.e. all arguments will be interpreted cdrecord
|
||||
to the program arguments. I.e. all arguments will be interpreted cdrecord
|
||||
style until "\-\-" is encountered.
|
||||
From then on, options are interpreted as \fBxorriso\fR options.
|
||||
.br
|
||||
@ -3975,13 +3976,13 @@ Program scdbackup_verify will recognize and verify tag resp. record.
|
||||
.TP
|
||||
\fB\-no_rc\fR
|
||||
.br
|
||||
Only if used as first command line argument this option
|
||||
Only if used as first program argument this option
|
||||
prevents reading and interpretation of startup files. See section FILES below.
|
||||
.TP
|
||||
\fB\-options_from_file\fR fileaddress
|
||||
Read quoted input from fileaddress and execute it like dialog lines.
|
||||
Empty lines and lines which begin by # are ignored. Normally one line
|
||||
should hold one \fBxorriso\fR command and all its arguments.
|
||||
should hold one \fBxorriso\fR command and all its parameters.
|
||||
Nevertheless lines may be concatenated by a trailing backslash.
|
||||
.br
|
||||
See also section "Command processing", paragraph "Quoted input".
|
||||
@ -4123,7 +4124,7 @@ begin with "\-" is used as path for a file to append the log lines.
|
||||
.br
|
||||
Problematic files can be recorded multiple times during one program run.
|
||||
If the program run aborts then the list might not be complete because
|
||||
some input file arguments might not have been processed at all.
|
||||
some input files might not have been processed at all.
|
||||
.br
|
||||
The errfile paths are transported as messages of very low severity "ERRFILE".
|
||||
This transport becomes visible with \-report_about "ALL".
|
||||
@ -4179,7 +4180,7 @@ a blank follows the payload text.
|
||||
.br
|
||||
Example:
|
||||
.br
|
||||
I:1: enter option and arguments :
|
||||
I:1: enter option and parameters :
|
||||
.TP
|
||||
\fB\-logfile\fR channel fileaddress
|
||||
Copy output of a channel to the given file. Channel may be one of: "." for all
|
||||
@ -4294,7 +4295,7 @@ $ xorriso \-outdev /dev/sr2 \\
|
||||
Note that '/pictures/*private*' is a pattern for iso_rr_paths
|
||||
while pictures/confidential/work* gets expanded by the shell
|
||||
with addresses from the hard disk. Options \-add and \-map have different
|
||||
argument rules but finally the same effect: they put files into the image.
|
||||
parameter rules but finally the same effect: they put files into the image.
|
||||
.SS
|
||||
.B A dialog session doing about the same
|
||||
.br
|
||||
|
Reference in New Issue
Block a user