Revised the use of "option" and "ASCII" in xorriso.texi

master
Thomas Schmitt 11 years ago
parent 2d52e9427d
commit c6869a0925
  1. 2
      xorriso/man_xorriso_to_html.sh
  2. 214
      xorriso/xorriso.1
  3. 515
      xorriso/xorriso.info
  4. 220
      xorriso/xorriso.texi

@ -86,7 +86,7 @@ then
-e 's/<b>Navigation in ISO image/\&nbsp;<BR><A NAME="Navigate"><\/A><b>Navigation in ISO image/' \
-e 's/^filesystem:<\/b>/filesystem:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Evaluation of readability and recovery:<\/b>/\&nbsp;<BR><A NAME="Verify"><\/A><b>Evaluation of readability and recovery:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>osirrox ISO-to-disk restore options:<\/b>/\&nbsp;<BR><A NAME="Restore"><\/A><b>osirrox ISO-to-disk restore options:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>osirrox ISO-to-disk restore commands:<\/b>/\&nbsp;<BR><A NAME="Restore"><\/A><b>osirrox ISO-to-disk restore commands:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Command compatibility emulations:<\/b>/\&nbsp;<BR><A NAME="Emulation"><\/A><b>Command compatibility emulations:<\/b><BR>\&nbsp;<BR>/' \
-e 's/^<p><b>&minus;as</<p>\&nbsp;<BR><b>\&minus;as</' \
-e 's/<b>Scripting, dialog and/\&nbsp;<BR><A NAME="Scripting"><\/A><b>Scripting, dialog and/' \

@ -9,7 +9,7 @@
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH XORRISO 1 "Version 1.2.1, Feb 03, 2012"
.TH XORRISO 1 "Version 1.2.1, Feb 05, 2012"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -169,11 +169,11 @@ There are two families of media in the MMC standard:
.br
\fBMulti\-session media\fR are CD\-R, CD\-RW, DVD\-R, DVD+R, DVD+R/DL, BD\-R, and
unformatted DVD\-RW. These media provide a table of content which
describes their existing sessions. See option \fB\-toc\fR.
describes their existing sessions. See command \fB\-toc\fR.
.br
Similar to multi\-session media are DVD\-R DL and minimally blanked DVD\-RW.
They allow only a single session of which the size must be known in advance.
\fBxorriso\fR will write onto them only if option \-close is set to "on".
\fBxorriso\fR will write onto them only if command \-close is set to "on".
.br
\fBOverwriteable media\fR are DVD\-RAM, DVD+RW, BD\-RE, and formatted DVD\-RW.
They allow random write access but do not provide information about their
@ -204,13 +204,13 @@ media, or to apply mandatory formatting to new media if necessary.
multi\-session media in appendable state, or they are overwriteable media
which contain an ISO image suitable for \fBxorriso\fR.
.br
Appendable is the state after writing a session with option \-close off.
Appendable is the state after writing a session with command \-close off.
.br
\fBClosed\fR media cannot be written. They may contain an ISO image suitable
for \fBxorriso\fR.
.br
Closed is the state of DVD\-ROM media and of multi\-session media which were
written with option \-close on. If the drive is read\-only hardware then it will
written with command \-close on. If the drive is read\-only hardware then it will
probably show any media as closed CD\-ROM resp. DVD\-ROM.
.br
Overwriteable media assume this state in such read\-only drives or if they
@ -218,14 +218,14 @@ contain unrecognizable data in the first 32 data blocks.
.br
Read\-only drives may or may not show session histories of multi\-session
media. Often only the first and the last session are visible. Sometimes
not even that. Option \-rom_toc_scan might or might not help in such cases.
not even that. Command \-rom_toc_scan might or might not help in such cases.
.SS
.B Creating, Growing, Modifying, Blind Growing:
.br
A new empty ISO image gets \fBcreated\fR
if there is no input drive with a valid ISO 9660 image when the first time
an output drive is defined. This is achieved by option \-dev on blank media
or by option \-outdev on media in any state.
an output drive is defined. This is achieved by command \-dev on blank media
or by command \-outdev on media in any state.
.br
The new empty image can be populated with directories and files.
Before it can be written, the medium in the output drive must get into
@ -242,7 +242,7 @@ ISO 9660 + Rock Ridge directory tree. It is possible to hide files from
previous sessions but they still exist on the medium and with many types of
optical media it is quite easy to recover them by mounting older sessions.
.br
Growing is achieved by option \-dev.
Growing is achieved by command \-dev.
.PP
The write method of \fBmodifying\fR produces compact filesystem
images with no outdated files or directory trees. Modifying can write its
@ -256,10 +256,10 @@ So for this method one needs either two optical drives or has to work with
filesystem objects as source and/or target medium.
.br
Modifying takes place if input drive and output drive are not the same and
if option \-grow_blindly is set to its default "off".
This is achieved by options \-indev and \-outdev.
if command \-grow_blindly is set to its default "off".
This is achieved by commands \-indev and \-outdev.
.PP
If option \-grow_blindly is set to a non\-negative number and if \-indev and
If command \-grow_blindly is set to a non\-negative number and if \-indev and
\-outdev are both set to different drives, then \fBblind growing\fR is
performed. It produces an add\-on session which is ready for being written
to the given block address. This is the usage model of
@ -354,13 +354,13 @@ device by using its path with the "stdio:" prefix. By default any address
in the /dev tree without prefix "stdio:" will work only if it leads to a MMC
drive.
.br
One may use option
One may use command
\fB\-ban_stdio_write\fR
to surely prevent this risk and to allow only MMC drives.
.br
One may prepend "mmc:" to a path to surely disallow any automatic "stdio:".
.br
By option \-drive_class one may ban certain paths or allow access without
By command \-drive_class one may ban certain paths or allow access without
prefix "stdio:" to other paths.
.SS
.B Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr:
@ -387,7 +387,7 @@ The content of the boot image files is not in the scope of El Torito.
.br
Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images.
\fBxorriso\fR is able to create or maintain an El Torito object which
makes such an image bootable. For details see option \-boot_image.
makes such an image bootable. For details see command \-boot_image.
.br
It is possible to make ISO images bootable from USB stick or other
hard\-disk\-like media by \-boot_image parameter system_area= . This installs
@ -409,7 +409,7 @@ EFI, MIPS Big Endian (SGI), MIPS Little Endian (DEC), SUN SPARC.
are an advanced way of controlling access permissions to file objects. Neither
ISO 9660 nor Rock Ridge specify a way to record ACLs. So libisofs has
introduced a standard conformant extension named AAIP for that purpose.
It uses this extension if enabled by option
It uses this extension if enabled by command
\fB\-acl\fR.
.br
AAIP enhanced images are supposed to be mountable normally, but one cannot
@ -434,7 +434,7 @@ pairs which
have names out of the user namespace. I.e. those which begin with "user.",
like "user.x" or "user.whatever". Name has to be a 0 terminated string.
Value may be any array of bytes which does not exceed the size of 4095 bytes.
xattr processing happens only if it is enabled by option
xattr processing happens only if it is enabled by command
\fB\-xattr\fR.
.br
As with ACL, currently only \fBxorriso\fR is able to retrieve xattr
@ -448,7 +448,7 @@ only on GNU/Linux and FreeBSD, where they are known as extattr.
.br
Commands are either actions which happen immediately or settings which
influence following actions. So their sequence does matter, unless they are
given as program arguments and option
given as program arguments and command
\fB\-x\fR
is among them.
.br
@ -459,7 +459,7 @@ terminated by either the \fBlist delimiter\fR, occur at the end of
the argument list, or occur at the end of an input line.
.PP
At program start the list delimiter is the string "\-\-".
This may be changed with the \-list_delimiter option in order to allow
This may be changed with the \-list_delimiter command in order to allow
"\-\-" as parameter in a variable length list.
However, it is advised to reset the delimiter to "\-\-"
immediately afterwards.
@ -501,15 +501,15 @@ enclose whitespace and make it part of words (e.g. of file names). Each mark
type can enclose the marks of the other type. A trailing backslash \\ outside
quotations or an open quotation cause the next input line to be appended.
.br
Quoted input accepts any ASCII character except NUL (0) as the content of
Quoted input accepts any 8\-bit character except NUL (0) as the content of
the quotes.
Nevertheless it can be cumbersome for the user to produce those characters
directly. Therefore quoted input and program arguments allow optional
\fBBackslash Interpretation\fR
which can represent all ASCII characters except NUL (0) via backslash codes
which can represent all 8\-bit characters except NUL (0) via backslash codes
as in $'...' of bash.
.br
This is not enabled by default. See option \-backslash_codes.
This is not enabled by default. See command \-backslash_codes.
.PP
When the program starts then it first looks for argument \-no_rc. If this is
not present then it looks for its startup files and
@ -542,7 +542,7 @@ the history of previous input lines.
See man readline
for more info about libreadline.
.PP
Option \-page activates a built\-in result text pager which may be convenient in
Command \-page activates a built\-in result text pager which may be convenient in
dialog mode. After an action has output the given number of terminal lines,
the pager prompts the user for a line of input.
.br
@ -564,8 +564,8 @@ All actions try to abort as soon as possible.
.SH OPTIONS
.br
All command words are shown with a leading dash although this dash is not
mandatory for the option to be recognized. Nevertheless within option \-as
the dashes of the emulated options are mandatory.
mandatory for the command to be recognized. Nevertheless within command \-as
the dashes of the emulated commands are mandatory.
.br
Normally any number of leading dashes is ignored with command words and
inner dashes are interpreted as underscores.
@ -595,7 +595,8 @@ with a single dash (i.e. "\-x"). It will not work in startup files, nor with
It affects only the commands given as program arguments.
.TP
\fB\-list_arg_sorting\fR
List all xorriso commands in the order which applies if option \-x is in effect.
List all xorriso commands in the order which applies if command \-x is in
effect.
.br
This list may also be helpful without \-x for a user who ponders over the
sequence in which to put commands. Deviations from the listed sorting order may
@ -604,7 +605,7 @@ well make sense, though.
.TP
.B Acquiring source and target drive:
.PP
The effect of acquiring a drive may depend on several options in the
The effect of acquiring a drive may depend on several commands in the
next paragraph "Influencing the behavior of image loading".
If desired, their enabling commands have to be performed before the
commands which acquire the drive.
@ -666,13 +667,13 @@ begins. The output drive is given up when writing is done.
.TP
.B Influencing the behavior of image loading:
.PP
The following options should normally be performed before loading an image
The following commands should normally be performed before loading an image
by acquiring an input drive. In rare cases it is desirable to activate
them only after image loading.
.TP
\fB\-load\fR entity id
Load a particular (possibly outdated) ISO session from \-dev or \-indev.
Usually all available sessions are shown with option \-toc.
Usually all available sessions are shown with command \-toc.
.br
entity depicts the kind of addressing. id depicts the particular
address. The following entities are defined:
@ -758,7 +759,7 @@ 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.
.br
This option does not hamper the creation of an empty image from blank
This command does not hamper the creation of an empty image from blank
input media and does not discard an already loaded image.
.TP
\fB\-in_charset\fR character_set_name
@ -822,12 +823,12 @@ If enabled, then \fBxorriso\fR will obtain ACLs from disk file objects,
store ACLs in the ISO image using the libisofs specific AAIP format,
load AAIP data from ISO images, test ACL during file comparison,
and restore ACLs to disk files when extracting them from ISO images.
See also options \-getfacl, \-setfacl.
See also commands \-getfacl, \-setfacl.
.TP
\fB\-xattr\fR "on"|"off"
Enable or disable processing of xattr attributes in user namespace.
If enabled, then \fBxorriso\fR will handle xattr similar to ACL.
See also options \-getfattr, \-setfattr and above paragraph about xattr.
See also commands \-getfattr, \-setfattr and above paragraph about xattr.
.TP
\fB\-md5\fR "on"|"all"|"off"|"load_check_off"
Enable or disable processing of MD5 checksums for the overall session and for
@ -836,7 +837,7 @@ only if the tags of superblock and directory tree match properly. The MD5
checksums of data files and whole session get loaded from the image if there
are any.
.br
With options \-compare and \-update the recorded MD5 of a file
With commands \-compare and \-update the recorded MD5 of a file
will be used to avoid content reading from the image. Only the disk file
content will be read and compared with that MD5. This can save much time
if \-disk_dev_ino "on" is not suitable.
@ -859,7 +860,7 @@ option \-M is performed.
.br
The test can be re\-enabled by mode "load_check_on".
.br
Checksums can be exploited via options \-check_md5, \-check_md5_r, via find
Checksums can be exploited via commands \-check_md5, \-check_md5_r, via find
actions get_md5, check_md5, and via \-check_media.
.TP
\fB\-for_backup\fR
@ -1052,7 +1053,7 @@ composed from disk_path by replacing disk_prefix by iso_rr_prefix.
Compare file object disk_path with file object iso_rr_path. If they do not
match, then perform the necessary image manipulations to make iso_rr_path
a matching copy of disk_path. By default this comparison will imply lengthy
content reading before a decision is made. Options \-disk_dev_ino or \-md5 may
content reading before a decision is made. Commands \-disk_dev_ino or \-md5 may
accelerate comparison if they were already in effect when the loaded session
was recorded.
.br
@ -1066,7 +1067,7 @@ addresses get compared whether they have counterparts below the other address
and whether both counterparts match. If there is a mismatch then the necessary
update manipulation is done.
.br
Note that the comparison result may depend on option \-follow. Its setting
Note that the comparison result may depend on command \-follow. Its setting
should always be the same as with the first adding of disk_path as iso_rr_path.
.br
If iso_rr_path does not exist yet, then it gets added. If disk_path does not
@ -1104,12 +1105,12 @@ E.g:
.br
/file/part_3_of_3_at_4094m_with_2047m_of_5753194821
.br
While option \-split_size is set larger than 0, and if all pieces of a file
While command \-split_size is set larger than 0, and if all pieces of a file
reside in the same ISO directory with no other files, and if the names look
like above, then their ISO directory will be recognized and handled like a
regular file. This affects options \-compare*, \-update*, and overwrite
regular file. This affects commands \-compare*, \-update*, and overwrite
situations.
See option \-split_size for details.
See command \-split_size for details.
.TP
\fB\-cpr\fR disk_path [***] iso_rr_path
Insert the given files or directory trees from filesystem
@ -1331,10 +1332,10 @@ FAILURE event.
A well tested \-split_size is 2047m. Sizes above \-file_size_limit are not
permissible.
.br
While option \-split_size is set larger than 0 such a directory with split
file pieces will be recognized and handled like a regular file by options
While command \-split_size is set larger than 0 such a directory with split
file pieces will be recognized and handled like a regular file by commands
\-compare* , \-update*, and in overwrite situations. There are \-ossirox
options "concat_split_on" and "concat_split_off" which control the handling
parameters "concat_split_on" and "concat_split_off" which control the handling
when files get restored to disk.
.br
In order to be recognizable, the names of the part files have to
@ -1386,7 +1387,7 @@ medium in modification mode.
.TP
\fB\-rm_r\fR iso_rr_path [***]
Delete the given files or directory trees from the ISO image.
See also the note with option \-rm.
See also the note with command \-rm.
.TP
\fB\-rmdir\fR iso_rr_path [***]
Delete empty directories.
@ -1489,7 +1490,7 @@ Only names from the user namespace are allowed. I.e. a name has to begin with
"user.", like "user.x" or "user.whatever".
.br
Values and names undergo the normal input processing of \fBxorriso\fR.
See also option \-backslash_codes. Other than with option \-setfattr_list,
See also command \-backslash_codes. Other than with command \-setfattr_list,
the byte value 0 cannot be expressed via \-setfattr.
.TP
\fB\-setfattr_r\fR [-]name value iso_rr_path [***]
@ -1514,7 +1515,7 @@ Name must be from user namespace. I.e. user.xyz where xyz should consist of
printable characters only. The separator "=" is not allowed in names.
Value may contain any kind of bytes. It must be in quotes. Trailing
whitespace after the end quote will be ignored. Non\-printables bytes and quotes
must be represented as \\XYZ by their octal ASCII code XYZ.
must be represented as \\XYZ by their octal 8\-bit code XYZ.
Use code \\000 for 0\-bytes.
.TP
\fB\-alter_date\fR type timestring iso_rr_path [***]
@ -1780,7 +1781,7 @@ prints access permissions in ACL text form to the result channel.
.br
\fBsetfacl\fR
attaches ACLs after removing existing ones. The new
ACL is given in text form as defined with option \-setfacl.
ACL is given in text form as defined with command \-setfacl.
.br
E.g.: \-exec setfacl u:lisa:rw,u::rw,g::r,o::\-,m::rw \-\-
.br
@ -1807,7 +1808,7 @@ Mode "b" prints backslash encoding. Not suitable for shell parsing.
.br
E.g. \-exec list_extattr e \-\-
.br
Option \-backslash_codes does not affect the output.
Command \-backslash_codes does not affect the output.
.br
\fBget_md5\fR
prints the MD5 sum, if recorded, together with file path.
@ -2014,7 +2015,7 @@ Switch to growing mode.
are uncommitted manipulations pending.
.br
So, to perform a final write operation with no new \-dev
and no new loading of image, rather execute option \-end.
and no new loading of image, rather execute command \-end.
If you want to go on without image loading, execute \-commit_eject "none".
To eject after write without image loading, use \-commit_eject "all".
.br
@ -2068,7 +2069,7 @@ but produces media which are only suitable for a single session.
Some drives announce this state by not offering feature 21h,
but some drives offer it anyway.
If feature 21h is missing, then \fBxorriso\fR
will refuse to write on DVD\-RW if not option \-close is set to "on".
will refuse to write on DVD\-RW if not command \-close is set to "on".
.br
The progress reports issued by some drives while blanking are
quite unrealistic. Do not conclude success or failure from the
@ -2090,7 +2091,7 @@ unformatted BD\-R. Other media are left untouched.
.br
"fast" does the same as "full" but tries to be quicker.
.br
"by_index_" selects a format out of the descriptor list issued by option
"by_index_" selects a format out of the descriptor list issued by command
\-list_formats. The index number from that list is to be appended to the
mode word. E.g: "by_index_3".
.br
@ -2159,7 +2160,7 @@ or BD\-R media. It is indicated by warning messages when the drive gets
acquired, and by a remark "but next track is damaged" with the line
"Media status :" of command \-toc.
.br
The setting of option \-close determines whether the medium stays appendable.
The setting of command \-close determines whether the medium stays appendable.
.br
Mode "as_needed" gracefully refuses on media which are not reported as
damaged. Mode "force" attempts the close operation even with media which
@ -2175,7 +2176,7 @@ The currently recognized type is marked by text "(current)".
.B Settings for result writing:
.PP
Rock Ridge info will be generated by the program unconditionally.
ACLs will be written according to the setting of option \-acl.
ACLs will be written according to the setting of command \-acl.
.TP
\fB\-joliet\fR "on"|"off"
If enabled by "on", generate Joliet tree additional to ISO 9660 + Rock Ridge
@ -2188,7 +2189,7 @@ cases it is worth to deviate a bit in order to circumvent bugs of the intended
reader system or to get unofficial extra features.
.br
There are several adjustable rules which have a keyword each. If they
are mentioned with this option then their rule gets added to the relaxation
are mentioned with this command then their rule gets added to the relaxation
list. This list can be erased by rules "strict" or "clear". It can be reset
to its start setting by "default". All of the following relaxation rules
can be revoked individually by appending "_off". Like "deep_paths_off".
@ -2223,11 +2224,12 @@ not 8.3.
.br
"lowercase" allows lowercase characters in ISO file names.
.br
"full_ascii" allows all ASCII characters in ISO file names.
"full_ascii" allows all 8\-bit characters except 0x0 and '/'
in ISO file names.
.br
"untranslated_names" might be dangerous for inadverted reader programs
which rely on the restriction to at most 37 characters in ISO file names.
This option allows ISO file names up to 96 characters with no character
This rule allows ISO file names up to 96 characters with no character
conversion. If a file name has more characters, then image production will
fail deliberately.
.br
@ -2348,7 +2350,7 @@ It is supposed to match this GRUB line:
.br
E.g. 2010040711405800 is 7 Apr 2010 11:40:58 (+0 centiseconds).
.br
Timestrings for the other types may be given as with option \-alter_date.
Timestrings for the other types may be given as with command \-alter_date.
They are prone to timezone computations. The timestrings "default" or
"overridden" cause default settings: "c" and "m" will show the current time
of image creation. "x" and "f" will be marked as insignificant.
@ -2402,7 +2404,7 @@ Group id to be used for all files when the new ISO tree gets written to media.
\fB\-zisofs\fR option[:options]
Set global parameters for zisofs compression. This data format is recognized
and transparently uncompressed by some Linux kernels. It is to be applied
via option \-set_filter with built\-in filter "\-\-zisofs".
via command \-set_filter with built\-in filter "\-\-zisofs".
Parameters are:
.br
"level="[0\-9] zlib compression: 0=none, 1=fast,..., 9=slow
@ -2453,7 +2455,7 @@ written and writing of file content blocks begins.
GNU/Linux specific:
Set the number of bytes to be transmitted with each write operation to DVD
or BD media. A number of 64 KB may improve throughput with bus systems which
show latency problems. The default depends on media type, on option
show latency problems. The default depends on media type, on command
\-stream_recording , and on compile time options.
.TP
\fB\-stdio_sync\fR "on"|"off"|number
@ -2477,7 +2479,7 @@ which means unit is kiB (= 1024) or MiB (= 1024 kiB).
If "on" then mark the written medium as not appendable
any more (if possible at all with the given type of target media).
.br
This is the contrary of cdrecord, wodim, cdrskin option \-multi,
This is the contrary of cdrecord, wodim, cdrskin command \-multi,
and is one aspect of growisofs option \-dvd\-compat.
.TP
\fB\-padding\fR number["k"|"m"]|"included"|"appended"
@ -2727,7 +2729,7 @@ Only a single boot file can be declared by mipsel_path=.
\fBsparc_label=\fRtext causes the production of a SUN Disk Label with the
given text as ASCII label. This boot block format allows to append images
for partitions 2 to 8. Partition 1 will always be the ISO image.
See option \-append_partition.
See command \-append_partition.
The first 512 bytes of any data provided by system_area= will be overwritten.
.br
\fBmips_discard\fR and \fBsparc_discard\fR revoke any boot file
@ -2888,7 +2890,7 @@ convert byte codes.
There is an input conversion from input character set to the local character
set which applies when an ISO image gets loaded. A conversion from local
character set to the output character set is performed when an
image tree gets written. The sets can be defined independently by options
image tree gets written. The sets can be defined independently by commands
\-in_charset and \-out_charset. Normally one will have both identical, if ever.
.br
If conversions are desired then \fBxorriso\fR needs to know the name of the
@ -2904,7 +2906,7 @@ filesystem
names and emerging names in the image. The situation stays ambigous and the
reader has to riddle what character set was used.
.br
By option \-auto_charset it is possible to attribute the output charset name
By command \-auto_charset it is possible to attribute the output charset name
to the image. This makes the situation unambigous. But if your terminal
character set does not match the character set of the local file names,
then this attribute can become plainly wrong and cause problems at read time.
@ -2966,10 +2968,10 @@ Set the severity threshold for events to abort the program.
Useful: "NEVER", "ABORT", "FATAL", "FAILURE" , "MISHAP", "SORRY"
.br
It may become necessary to abort the program anyway, despite
the setting by this option. Expect not many "ABORT" events to
the setting by this command. Expect not many "ABORT" events to
be ignorable.
.br
A special property of this option is that it works preemptive if given as
A special property of this command is that it works preemptive if given as
program start argument. I.e. the first \-abort_on setting among the
start arguments is in effect already when the first operations of
\fBxorriso\fR begin. Only "\-abort_on" with dash "\-" is recognized that way.
@ -3008,7 +3010,7 @@ Event messages are sent to the info channel "I" which is usually stderr
but may be influenced by command \-pkt_output.
Info messages which belong to no event get attributed severity "NOTE".
.br
A special property of this option is that the first \-report_about setting
A special property of this command is that the first \-report_about setting
among the start arguments is in effect already when the first operations
of \fBxorriso\fR begin. Only "\-report_about" with dash "\-" is
recognized that way.
@ -3040,7 +3042,7 @@ kill \-9 then imposes the risk that the drive is left in unusable state and
needs poweroff to be reset. So during burning, blanking, and formatting
wait for at least their normal run time before killing externally.
.br
A special property of this option is that the first \-signal_handling setting
A special property of this command is that the first \-signal_handling setting
among the start arguments is in effect already when the first operations
of \fBxorriso\fR begin. Only "\-signal_handling" with dash "\-" is
recognized that way.
@ -3049,12 +3051,12 @@ recognized that way.
Control the program behavior at problem event occasions.
For now this applies to occasions "image_loading" which is given while
an image tree is read from the input device, and to "file_extraction" which
is given with osirrox options like \-extract.
is given with osirrox commands like \-extract.
.br
With "image_loading" there are three behaviors available:
.br
"best_effort" goes on with reading after events with severity below FAILURE
if the threshold of option \-abort_on allows this.
if the threshold of command \-abort_on allows this.
.br
"failure" aborts image tree reading on first event of at least SORRY.
It issues an own FAILURE event.
@ -3124,9 +3126,9 @@ directory only once and not for each file in its whole subtree.
Setting "off" silently kills any kind of image file object resp. performs
above irrevocable actions.
.br
To really produce user prompts, option \-dialog needs to be set to "on".
To really produce user prompts, command \-dialog needs to be set to "on".
Note that the prompt does not appear in situations where file removal
is forbidden by option \-overwrite. \-reassure only imposes an additional
is forbidden by command \-overwrite. \-reassure only imposes an additional
curb for removing existing file objects.
.br
Be aware that file objects get deleted from the ISO image immediately
@ -3141,7 +3143,7 @@ Show list of available MMC drives with the addresses of
their libburn standard device files.
.br
This is only possible when no ISO image changes are pending.
After this option was executed, there is no drive current
After this command was executed, there is no drive current
and no image loaded.
.br
In order to be visible, a device has to offer rw\-permissions
@ -3177,7 +3179,7 @@ with only one or two sessions on it. The last of these sessions is supposed
to be the most recent real session then.
.br
Some read\-only drives and media show no usable session history at all.
Option \-rom_toc_scan might help.
Command \-rom_toc_scan might help.
.TP
\fB\-mount_cmd\fR drive entity id path
Emit an appropriate command line for mounting the ISO session
@ -3195,7 +3197,7 @@ as id.
.br
path will be used as mount point and must already exist as a directory on disk.
.br
The command gets printed to the result channel. See option \-mount
The command gets printed to the result channel. See command \-mount
for direct execution of this command.
.TP
\fB\-mount_opts\fR option[:option...]
@ -3228,9 +3230,9 @@ session number, resp. volume id of the depicted session.
\fB\-print_size\fR
Print the foreseeable consumption of 2048 byte blocks
by next \-commit. This can last a while as a \-commit gets
prepared and only in last moment is revoked by this option.
prepared and only in last moment is revoked by this command.
The result depends on several settings and also on the kind of output device.
If no \-jidgo options are given and not command \-as "mkisofs" was used,
If no \-jidgo options are set and not command \-as "mkisofs" was used,
then \-padding (300 kB by default) is not counted as part of the image size.
.TP
\fB\-tell_media_space\fR
@ -3239,7 +3241,7 @@ 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
them may be changed by options 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.
.TP
.B Navigation in ISO image and disk filesystem:
@ -3318,7 +3320,7 @@ Output format resembles shell command ls \-dln.
Print the access permissions of the given files in the ISO image using the
format of shell command getfacl. If a file has no ACL then it gets fabricated
from the \-chmod settings. A file may have a real ACL if it was introduced into
the ISO image while option \-acl was set to "on".
the ISO image while command \-acl was set to "on".
.TP
\fB\-getfacl_r\fR iso_rr_pattern [***]
Like \-gefacl but listing recursively the whole file trees underneath eventual
@ -3461,7 +3463,7 @@ according
to their read speed, save them to a file, and keep track of successfuly saved
blocks for further tries on the same medium.
.br
By option \-md5 checksums may get recorded with data files and whole
By command \-md5 checksums may get recorded with data files and whole
sessions. These checksums are reachable only via indev and a loaded image.
They work independently of the media type and can detect transmission errors.
.TP
@ -3470,9 +3472,9 @@ Try to read data blocks from the indev drive, optionally copy them to a
disk file, and finally report about the encountered quality. Several options
may be used to modify the default behavior.
.br
The options given with this command override the default settings which
may have been changed by option \-check_media_defaults. See there for a
description of options.
The parameters given with this command override the default settings which
may have been changed by command \-check_media_defaults. See there for a
description of available options.
.br
The result list tells intervals of 2 KiB blocks with start address, number
of blocks and quality. Qualities which begin with "+" are
@ -3618,10 +3620,10 @@ This gets rounded down to full blocks of 2048 bytes. 0 means automatic size.
Compare the data content of the given files in the loaded image with their
recorded MD5 checksums, if there are any. In case of any mismatch an event of
the given severity is issued. It may then be handled by appropriate settings of
options \-abort_on or \-return_with which both can cause non\-zero exit values
commands \-abort_on or \-return_with which both can cause non\-zero exit values
of the program run. Severity ALL suppresses that event.
.br
This option reports match and mismatch of data files to the result channel.
This command reports match and mismatch of data files to the result channel.
Non\-data files cause NOTE events. There will also be UPDATE events from
data reading.
.br
@ -3633,7 +3635,7 @@ if there are older sessions.
Like \-check_md5 but checking all data files underneath the given paths.
Only mismatching data files will be reported.
.TP
.B osirrox ISO-to-disk restore options:
.B osirrox ISO-to-disk restore commands:
.PP
Normally \fBxorriso\fR only writes to disk files which were given as stdio:
pseudo\-drives or as log files.
@ -3759,7 +3761,7 @@ ownership and group as in ISO image.
\fB\-paste_in\fR iso_rr_path disk_path byte_offset byte_count
Read the content of a ISO data file and write it into a data file on disk
beginning at the byte_offset. Write at most byte_count bytes.
This is the inverse of option \-cut_out.
This is the inverse of command \-cut_out.
.TP
\fB\-mount\fR drive entity id path
Produce the same line as \-mount_cmd and then execute it as external program run
@ -3807,7 +3809,7 @@ persists until things happen like \-commit, \-rollback, \-dev, or end of
\-pacifier gets set to "mkisofs" if files are added to the image.
.br
\-graft\-points is equivalent to \-pathspecs on. Note that pathspecs without "="
are interpreted differently than with \fBxorriso\fR option \-add.
are interpreted differently than with \fBxorriso\fR command \-add.
Directories get
merged with the root directory of the ISO image, other filetypes get mapped
into that root directory.
@ -3816,7 +3818,7 @@ If pathspecs are given and if no output file was chosen before or during the
"mkisofs" option list, then standard output (\-outdev "\-") will get into effect.
If \-o points to a regular file, then it will be truncated to 0 bytes
when finally writing begins. This truncation does not happen if the drive
is chosen by \fBxorriso\fR options before \-as mkisofs or after its
is chosen by \fBxorriso\fR commands before \-as mkisofs or after its
list delimiter. Directories and symbolic links are no valid \-o targets.
.br
Writing to stdout is possible only if \-as "mkisofs" was among the start
@ -3845,7 +3847,7 @@ resp. to "on" by \-\-old\-root\-devno .
Not original mkisofs options are \-\-quoted_path_list ,
\-\-hardlinks , \-\-acl ,
\-\-xattr , \-\-md5 , \-\-stdio_sync .
They work like the \fBxorriso\fR options with the
They work like the \fBxorriso\fR commands with the
same name and hardcoded parameter "on", e.g. \-acl "on".
Explicit parameters are expected by \-\-stdio_sync
and \-\-scdbackup_tag.
@ -3882,7 +3884,7 @@ instead of \-G to apply the effect of \-boot_image isolinux partition_table=on.
\-partition_offset number is
\-boot_image any partition_offset=number.
.br
Option \-append_partition is supported.
Command \-append_partition is supported.
.br
\-untranslated_name_len number is
\-compliance untranslated_name_len=number.
@ -3890,7 +3892,7 @@ Option \-append_partition is supported.
\-\-old\-empty is \-compliance old_empty.
.br
The options of genisoimage Jigdo Template Extraction are recognized and
performed via \fBxorriso\fR option \-jigdo. See the "Alias:" names there
performed via \fBxorriso\fR command \-jigdo. See the "Alias:" names there
for the meaning of the genisoimage options.
.br
@ -3903,7 +3905,7 @@ If \fBxorriso\fR is started with one of the leafnames "xorrisofs",
\-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.
From then on, arguments are interpreted as \fBxorriso\fR commands.
.br
\-\-no_rc as first argument of such a program start
prevents interpretation of startup files. See section FILES below.
@ -3949,7 +3951,7 @@ If \fBxorriso\fR is started with one of the leafnames "xorrecord",
"cdrskin", "cdrecord", or "wodim", then it automatically prepends \-as "cdrskin"
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.
From then on, arguments are interpreted as \fBxorriso\fR commands.
.br
\-\-no_rc as first argument of such a program start
prevents interpretation of \fBxorriso\fR startup files.
@ -4001,7 +4003,7 @@ Program scdbackup_verify will recognize and verify tag resp. record.
.TP
\fB\-no_rc\fR
.br
Only if used as first program argument this option
Only if used as first program argument this command
prevents reading and interpretation of startup files. See section FILES below.
.TP
\fB\-options_from_file\fR fileaddress
@ -4099,8 +4101,8 @@ With the start program arguments there is mode:
.br
Mode "encode_output" encodes output characters. It combines "encode_results"
with "encode_infos". Inside single or double quotation marks encoding applies
to ASCII characters octal 001 to 037 , 177 to 377 and to backslash(134).
Outside quotation marks some harmless control characters stay unencoded:
to 8\-bit characters octal 001 to 037 , 177 to 377 and to backslash(134).
Outside quotation marks some harmless ASCII control characters stay unencoded:
bell(007), backspace(010), tab(011), linefeed(012), formfeed(014),
carriage_return(015).
.br
@ -4169,7 +4171,7 @@ Mode "on" enables very verbous logging of SCSI commands and drive replies.
Logging messages get printed to stderr, not to any of the \fBxorriso\fR
output channels.
.br
A special property of this option is that the first \-scsi_log setting
A special property of this command is that the first \-scsi_log setting
among the start arguments is in effect already when the first operations
of \fBxorriso\fR begin.
Only "\-scsi_log" with dash "\-" is recognized that way.
@ -4319,7 +4321,7 @@ $ xorriso \-outdev /dev/sr2 \\
.br
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
with addresses from the hard disk. Commands \-add and \-map have different
parameter rules but finally the same effect: they put files into the image.
.SS
.B A dialog session doing about the same
@ -4327,8 +4329,8 @@ parameter rules but finally the same effect: they put files into the image.
Some settings are already given as start argument. The other activities
are done as dialog input. The pager gets set to 20 lines of 80 characters.
.br
The drive is acquired by option \-dev rather than \-outdev in order to see
the message about its current content. By option \-blank this content is
The drive is acquired by command \-dev rather than \-outdev in order to see
the message about its current content. By command \-blank this content is
made ready for being overwritten and the loaded ISO image is made empty.
.br
In order to be able to eject the medium, the session needs to be committed
@ -4438,7 +4440,7 @@ the same files gets added with converted file names.
In order to avoid any weaknesses of the local character set, this command
pretends that it uses already the final target set UTF\-8.
Therefore strange file names may appear in messages, which
will be made terminal\-safe by option \-backslash_codes.
will be made terminal\-safe by command \-backslash_codes.
.br
$ xorriso \-in_charset ISO\-8859\-1 \-local_charset UTF\-8 \\
.br
@ -4631,13 +4633,13 @@ the old one.
This makes sense if the full backup leaves substantial remaining capacity
on media and if the expected changes are much smaller than the full backup.
To apply zisofs compression to those data files which get newly copied from
the local filesystem, insert these options immediately before \-commit :
the local filesystem, insert these commands immediately before \-commit :
.br
\-hardlinks perform_update \\
.br
\-find / \-type f \-pending_data \-exec set_filter \-\-zisofs \-\- \\
.br
Options \-disk_dev_ino and \-for_backup depend on stable device and inode numbers
Commands \-disk_dev_ino and \-for_backup depend on stable device and inode numbers
on disk. Without them, an update run may use \-md5 "on" to match recorded MD5
sums against the current file content on hard disk. This is usually much faster
than the default which compares both contents directly.
@ -4649,13 +4651,13 @@ versions. With CD media, GNU/Linux mount accepts session numbers directly by
its option "session=".
.br
Multi\-session media and most overwriteable media written by \fBxorriso\fR
can tell the sbsectors of their sessions by \fBxorriso\fR option \-toc.
Used after \-commit the following option prints the matching mount command for
can tell the sbsectors of their sessions by \fBxorriso\fR command \-toc.
Used after \-commit the following command prints the matching mount command for
the newly written session (here for mount point /mnt):
.br
\-mount_cmd "indev" "auto" "auto" /mnt
.br
Options \-mount_cmd and \-mount are also able to produce the mount commands for
Commands \-mount_cmd and \-mount are also able to produce the mount commands for
older sessions in the table\-of\-content. E.g. as superuser:
.br
# osirrox \-mount /dev/sr0 "volid" '*2008_12_05*' /mnt
@ -4746,7 +4748,7 @@ program name pre\-select certain settings:
\fBxorrecord\fR starts \fBxorriso\fR with \-as cdrecord emulation.
.br
\fBosirrox\fR starts with \-osirrox "on:o_excl_off" which allows
to copy files from ISO image to disk and to apply option \-mount to
to copy files from ISO image to disk and to apply command \-mount to
one or more of the existing ISO sessions.
.SS
.B Startup files:

File diff suppressed because it is too large Load Diff

@ -272,11 +272,11 @@ There are two families of media in the MMC standard:
@cindex Multi-session media, _definition
@strong{Multi-session media} are CD-R, CD-RW, DVD-R, DVD+R, DVD+R/DL, BD-R, and
unformatted DVD-RW. These media provide a table of content which
describes their existing sessions. See option @strong{-toc}.
describes their existing sessions. See command @strong{-toc}.
@*
Similar to multi-session media are DVD-R DL and minimally blanked DVD-RW.
They allow only a single session of which the size must be known in advance.
@command{xorriso} will write onto them only if option -close is set to "on".
@command{xorriso} will write onto them only if command -close is set to "on".
@*
@cindex Overwriteable media, _definition
@strong{Overwriteable media} are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW.
@ -313,7 +313,7 @@ media, or to apply mandatory formatting to new media if necessary.
multi-session media in appendable state, or they are overwriteable media
which contain an ISO image suitable for @command{xorriso}.
@*
Appendable is the state after writing a session with option -close off.
Appendable is the state after writing a session with command -close off.
@*
@sp 1
@cindex Closed media, _definition
@ -321,7 +321,7 @@ Appendable is the state after writing a session with option -close off.
for @command{xorriso}.
@*
Closed is the state of DVD-ROM media and of multi-session media which were
written with option -close on. If the drive is read-only hardware then it will
written with command -close on. If the drive is read-only hardware then it will
probably show any media as closed CD-ROM resp. DVD-ROM.
@*
Overwriteable media assume this state in such read-only drives or if they
@ -329,7 +329,7 @@ contain unrecognizable data in the first 32 data blocks.
@*
Read-only drives may or may not show session histories of multi-session
media. Often only the first and the last session are visible. Sometimes
not even that. Option -rom_toc_scan might or might not help in such cases.
not even that. Command -rom_toc_scan might or might not help in such cases.
@c man .SS
@node Methods, Drives, Media, top
@chapter Creating, Growing, Modifying, Blind Growing:
@ -338,8 +338,8 @@ not even that. Option -rom_toc_scan might or might not help in such cases.
@cindex Create, new ISO image, _definiton
A new empty ISO image gets @strong{created}
if there is no input drive with a valid ISO 9660 image when the first time
an output drive is defined. This is achieved by option -dev on blank media
or by option -outdev on media in any state.
an output drive is defined. This is achieved by command -dev on blank media
or by command -outdev on media in any state.
@*
The new empty image can be populated with directories and files.
Before it can be written, the medium in the output drive must get into
@ -359,7 +359,7 @@ ISO 9660 + Rock Ridge directory tree. It is possible to hide files from
previous sessions but they still exist on the medium and with many types of
optical media it is quite easy to recover them by mounting older sessions.
@*
Growing is achieved by option -dev.
Growing is achieved by command -dev.
@c man .PP
@sp 1
@cindex Modifying, _definition
@ -375,12 +375,12 @@ So for this method one needs either two optical drives or has to work with
filesystem objects as source and/or target medium.
@*
Modifying takes place if input drive and output drive are not the same and
if option -grow_blindly is set to its default "off".
This is achieved by options -indev and -outdev.
if command -grow_blindly is set to its default "off".
This is achieved by commands -indev and -outdev.
@c man .PP
@sp 1
@cindex Blind growing, _definition
If option -grow_blindly is set to a non-negative number and if -indev and
If command -grow_blindly is set to a non-negative number and if -indev and
-outdev are both set to different drives, then @strong{blind growing} is
performed. It produces an add-on session which is ready for being written
to the given block address. This is the usage model of
@ -483,13 +483,13 @@ device by using its path with the "stdio:" prefix. By default any address
in the /dev tree without prefix "stdio:" will work only if it leads to a MMC
drive.
@*
One may use option
One may use command
@strong{-ban_stdio_write}
to surely prevent this risk and to allow only MMC drives.
@*
One may prepend "mmc:" to a path to surely disallow any automatic "stdio:".
@c man .br
By option -drive_class one may ban certain paths or allow access without
By command -drive_class one may ban certain paths or allow access without
prefix "stdio:" to other paths.
@c man .SS
@node Extras, Processing, Drives, top
@ -522,7 +522,7 @@ The content of the boot image files is not in the scope of El Torito.
@*
Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images.
@command{xorriso} is able to create or maintain an El Torito object which
makes such an image bootable. For details see option -boot_image.
makes such an image bootable. For details see command -boot_image.
@*
@cindex MBR, _definiton
It is possible to make ISO images bootable from USB stick or other
@ -547,7 +547,7 @@ EFI, MIPS Big Endian (SGI), MIPS Little Endian (DEC), SUN SPARC.
are an advanced way of controlling access permissions to file objects. Neither
ISO 9660 nor Rock Ridge specify a way to record ACLs. So libisofs has
introduced a standard conformant extension named AAIP for that purpose.
It uses this extension if enabled by option
It uses this extension if enabled by command
@strong{-acl}.
@*
AAIP enhanced images are supposed to be mountable normally, but one cannot
@ -576,7 +576,7 @@ pairs which
have names out of the user namespace. I.e. those which begin with "user.",
like "user.x" or "user.whatever". Name has to be a 0 terminated string.
Value may be any array of bytes which does not exceed the size of 4095 bytes.
xattr processing happens only if it is enabled by option
xattr processing happens only if it is enabled by command
@strong{-xattr}.
@*
As with ACL, currently only @command{xorriso} is able to retrieve xattr
@ -592,7 +592,7 @@ only on GNU/Linux and FreeBSD, where they are known as extattr.
@c man .br
Commands are either actions which happen immediately or settings which
influence following actions. So their sequence does matter, unless they are
given as program arguments and option
given as program arguments and command
@strong{-x}
is among them.
@*
@ -605,7 +605,7 @@ the argument list, or occur at the end of an input line.
@c man .PP
@sp 1
At program start the list delimiter is the string "@minus{}@minus{}".
This may be changed with the -list_delimiter option in order to allow
This may be changed with the -list_delimiter command in order to allow
"@minus{}@minus{}" as parameter in a variable length list.
However, it is advised to reset the delimiter to "@minus{}@minus{}"
immediately afterwards.
@ -653,15 +653,15 @@ type can enclose the marks of the other type. A trailing backslash \ outside
quotations or an open quotation cause the next input line to be appended.
@*
@cindex Backslash Interpretation, _definition
Quoted input accepts any ASCII character except NUL (0) as the content of
Quoted input accepts any 8-bit character except NUL (0) as the content of
the quotes.
Nevertheless it can be cumbersome for the user to produce those characters
directly. Therefore quoted input and program arguments allow optional
@strong{Backslash Interpretation}
which can represent all ASCII characters except NUL (0) via backslash codes
which can represent all 8-bit characters except NUL (0) via backslash codes
as in $'...' of bash.
@*
This is not enabled by default. See option -backslash_codes.
This is not enabled by default. See command -backslash_codes.
@c man .PP
@sp 1
When the program starts then it first looks for argument -no_rc. If this is
@ -702,7 +702,7 @@ See info readline
for more info about libreadline.
@c man .PP
@sp 1
Option -page activates a built-in result text pager which may be convenient in
Command -page activates a built-in result text pager which may be convenient in
dialog mode. After an action has output the given number of terminal lines,
the pager prompts the user for a line of input.
@*
@ -727,8 +727,8 @@ All actions try to abort as soon as possible.
@c man .SH OPTIONS
@c man .br
All command words are shown with a leading dash although this dash is not
mandatory for the option to be recognized. Nevertheless within option -as
the dashes of the emulated options are mandatory.
mandatory for the command to be recognized. Nevertheless within command -as
the dashes of the emulated commands are mandatory.
@*
Normally any number of leading dashes is ignored with command words and
inner dashes are interpreted as underscores.
@ -751,7 +751,7 @@ inner dashes are interpreted as underscores.
* Inquiry:: Drive and media related inquiry actions
* Navigate:: Navigation in ISO image and disk filesystem
* Verify:: Evaluation of readability and recovery
* Restore:: osirrox ISO-to-disk restore options
* Restore:: osirrox ISO-to-disk restore commands
* Emulation:: Command compatibility emulations (cdrtools)
* Scripting:: Scripting, dialog and program control features
* Frontend:: Support for frontend programs via stdin and stdout
@ -774,8 +774,8 @@ at the cost of loss of expressivity.
@sp 1
@c man .TP
@item -x
@kindex -x enables automatic execution order of options
@cindex Automatic execution order, of options, -x
@kindex -x enables automatic execution order of arguments
@cindex Automatic execution order, of arguments, -x
Enable automatic sorting of program arguments into a sequence that
(most likely) is sensible.
This command may be given at any position among the commands
@ -790,7 +790,8 @@ It affects only the commands given as program arguments.
@item -list_arg_sorting
@kindex -list_arg_sorting prints sorting order of -x
@cindex Sorting order, for -x, -list_arg_sorting
List all xorriso commands in the order which applies if option -x is in effect.
List all xorriso commands in the order which applies if command -x is in
effect.
@*
This list may also be helpful without -x for a user who ponders over the
sequence in which to put commands. Deviations from the listed sorting order may
@ -802,7 +803,7 @@ well make sense, though.
@section Acquiring source and target drive
@c man .B Acquiring source and target drive:
@c man .PP
The effect of acquiring a drive may depend on several options in the
The effect of acquiring a drive may depend on several commands in the
next paragraph "Influencing the behavior of image loading".
If desired, their enabling commands have to be performed before the
commands which acquire the drive.
@ -877,7 +878,7 @@ begins. The output drive is given up when writing is done.
@node Loading, Insert, AqDrive, Options
@section Influencing the behavior of image loading
@c man .PP
The following options should normally be performed before loading an image
The following commands should normally be performed before loading an image
by acquiring an input drive. In rare cases it is desirable to activate
them only after image loading.
@table @asis
@ -887,7 +888,7 @@ them only after image loading.
@kindex -load addresses a particular session as input
@cindex Session, select as input, -load
Load a particular (possibly outdated) ISO session from -dev or -indev.
Usually all available sessions are shown with option -toc.
Usually all available sessions are shown with command -toc.
@*
entity depicts the kind of addressing. id depicts the particular
address. The following entities are defined:
@ -979,7 +980,7 @@ 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.
@*
This option does not hamper the creation of an empty image from blank
This command does not hamper the creation of an empty image from blank
input media and does not discard an already loaded image.
@c man .TP
@item -in_charset character_set_name
@ -1051,14 +1052,14 @@ If enabled, then @command{xorriso} will obtain ACLs from disk file objects,
store ACLs in the ISO image using the libisofs specific AAIP format,
load AAIP data from ISO images, test ACL during file comparison,
and restore ACLs to disk files when extracting them from ISO images.
See also options -getfacl, -setfacl.
See also commands -getfacl, -setfacl.
@c man .TP
@item -xattr "on"|"off"
@kindex -xattr controls handling of xattr (EA)
@cindex xattr, control handling, -xattr
Enable or disable processing of xattr attributes in user namespace.
If enabled, then @command{xorriso} will handle xattr similar to ACL.
See also options -getfattr, -setfattr and above paragraph about xattr.
See also commands -getfattr, -setfattr and above paragraph about xattr.
@c man .TP
@item -md5 "on"|"all"|"off"|"load_check_off"
@kindex -md5 controls handling of MD5 sums
@ -1069,7 +1070,7 @@ only if the tags of superblock and directory tree match properly. The MD5
checksums of data files and whole session get loaded from the image if there
are any.
@*
With options -compare and -update the recorded MD5 of a file
With commands -compare and -update the recorded MD5 of a file
will be used to avoid content reading from the image. Only the disk file
content will be read and compared with that MD5. This can save much time
if -disk_dev_ino "on" is not suitable.
@ -1092,7 +1093,7 @@ option -M is performed.
@*
The test can be re-enabled by mode "load_check_on".
@*
Checksums can be exploited via options -check_md5, -check_md5_r, via find
Checksums can be exploited via commands -check_md5, -check_md5_r, via find
actions get_md5, check_md5, and via -check_media.
@c man .TP
@item -for_backup
@ -1325,7 +1326,7 @@ composed from disk_path by replacing disk_prefix by iso_rr_prefix.
Compare file object disk_path with file object iso_rr_path. If they do not
match, then perform the necessary image manipulations to make iso_rr_path
a matching copy of disk_path. By default this comparison will imply lengthy
content reading before a decision is made. Options -disk_dev_ino or -md5 may
content reading before a decision is made. Commands -disk_dev_ino or -md5 may
accelerate comparison if they were already in effect when the loaded session
was recorded.
@*
@ -1341,7 +1342,7 @@ addresses get compared whether they have counterparts below the other address
and whether both counterparts match. If there is a mismatch then the necessary
update manipulation is done.
@*
Note that the comparison result may depend on option -follow. Its setting
Note that the comparison result may depend on command -follow. Its setting
should always be the same as with the first adding of disk_path as iso_rr_path.
@*
If iso_rr_path does not exist yet, then it gets added. If disk_path does not
@ -1383,12 +1384,12 @@ E.g:
@*
/file/part_3_of_3_at_4094m_with_2047m_of_5753194821
@*
While option -split_size is set larger than 0, and if all pieces of a file
While command -split_size is set larger than 0, and if all pieces of a file
reside in the same ISO directory with no other files, and if the names look
like above, then their ISO directory will be recognized and handled like a
regular file. This affects options -compare*, -update*, and overwrite
regular file. This affects commands -compare*, -update*, and overwrite
situations.
See option -split_size for details.
See command -split_size for details.
@c man .TP
@item -cpr disk_path [***] iso_rr_path
@kindex -cpr inserts like with cp -r
@ -1644,10 +1645,10 @@ FAILURE event.
A well tested -split_size is 2047m. Sizes above -file_size_limit are not
permissible.
@*
While option -split_size is set larger than 0 such a directory with split
file pieces will be recognized and handled like a regular file by options
While command -split_size is set larger than 0 such a directory with split
file pieces will be recognized and handled like a regular file by commands
-compare* , -update*, and in overwrite situations. There are -ossirox
options "concat_split_on" and "concat_split_off" which control the handling
parameters "concat_split_on" and "concat_split_off" which control the handling
when files get restored to disk.
@*
In order to be recognizable, the names of the part files have to
@ -1710,7 +1711,7 @@ medium in modification mode.
@kindex -rm_r deletes trees from ISO image
@cindex Delete, from ISO image, -rm_r
Delete the given files or directory trees from the ISO image.
See also the note with option -rm.
See also the note with command -rm.
@c man .TP
@item -rmdir iso_rr_path [***]
@kindex -rmdir deletes ISO directory
@ -1838,7 +1839,7 @@ Only names from the user namespace are allowed. I.e. a name has to begin with
"user.", like "user.x" or "user.whatever".
@*
Values and names undergo the normal input processing of @command{xorriso}.
See also option -backslash_codes. Other than with option -setfattr_list,
See also command -backslash_codes. Other than with command -setfattr_list,
the byte value 0 cannot be expressed via -setfattr.
@c man .TP
@item -setfattr_r [-]name value iso_rr_path [***]
@ -1867,7 +1868,7 @@ Name must be from user namespace. I.e. user.xyz where xyz should consist of
printable characters only. The separator "=" is not allowed in names.
Value may contain any kind of bytes. It must be in quotes. Trailing
whitespace after the end quote will be ignored. Non-printables bytes and quotes
must be represented as \XYZ by their octal ASCII code XYZ.
must be represented as \XYZ by their octal 8-bit code XYZ.
Use code \000 for 0-bytes.
@c man .TP
@item -alter_date type timestring iso_rr_path [***]
@ -2165,7 +2166,7 @@ prints access permissions in ACL text form to the result channel.
@*
@item setfacl
attaches ACLs after removing existing ones. The new
ACL is given in text form as defined with option -setfacl.
ACL is given in text form as defined with command -setfacl.
@*
E.g.: -exec setfacl u:lisa:rw,u::rw,g::r,o::@minus{},m::rw @minus{}@minus{}
@*
@ -2192,7 +2193,7 @@ Mode "b" prints backslash encoding. Not suitable for shell parsing.
@*
E.g. -exec list_extattr e --
@*
Option -backslash_codes does not affect the output.
Command -backslash_codes does not affect the output.
@*
@item get_md5
prints the MD5 sum, if recorded, together with file path.
@ -2428,7 +2429,7 @@ Switch to growing mode.
are uncommitted manipulations pending.
@*
So, to perform a final write operation with no new -dev
and no new loading of image, rather execute option -end.
and no new loading of image, rather execute command -end.
If you want to go on without image loading, execute -commit_eject "none".
To eject after write without image loading, use -commit_eject "all".
@*
@ -2488,7 +2489,7 @@ but produces media which are only suitable for a single session.
Some drives announce this state by not offering feature 21h,
but some drives offer it anyway.
If feature 21h is missing, then @command{xorriso}
will refuse to write on DVD-RW if not option -close is set to "on".
will refuse to write on DVD-RW if not command -close is set to "on".
@*
The progress reports issued by some drives while blanking are
quite unrealistic. Do not conclude success or failure from the
@ -2512,7 +2513,7 @@ unformatted BD-R. Other media are left untouched.
@*
"fast" does the same as "full" but tries to be quicker.
@*
"by_index_" selects a format out of the descriptor list issued by option
"by_index_" selects a format out of the descriptor list issued by command
-list_formats. The index number from that list is to be appended to the
mode word. E.g: "by_index_3".
@*
@ -2587,7 +2588,7 @@ or BD-R media. It is indicated by warning messages when the drive gets
acquired, and by a remark "but next track is damaged" with the line
"Media status :" of command -toc.
@*
The setting of option -close determines whether the medium stays appendable.
The setting of command -close determines whether the medium stays appendable.
@*
Mode "as_needed" gracefully refuses on media which are not reported as
damaged. Mode "force" attempts the close operation even with media which
@ -2608,7 +2609,7 @@ The currently recognized type is marked by text "(current)".
@section Settings for result writing
@c man .PP
Rock Ridge info will be generated by the program unconditionally.
ACLs will be written according to the setting of option -acl.
ACLs will be written according to the setting of command -acl.
@table @asis
@sp 1
@c man .TP
@ -2627,7 +2628,7 @@ cases it is worth to deviate a bit in order to circumvent bugs of the intended
reader system or to get unofficial extra features.
@*
There are several adjustable rules which have a keyword each. If they
are mentioned with this option then their rule gets added to the relaxation
are mentioned with this command then their rule gets added to the relaxation
list. This list can be erased by rules "strict" or "clear". It can be reset
to its start setting by "default". All of the following relaxation rules
can be revoked individually by appending "_off". Like "deep_paths_off".
@ -2662,11 +2663,12 @@ not 8.3.
@*
"lowercase" allows lowercase characters in ISO file names.
@*
"full_ascii" allows all ASCII characters in ISO file names.
"full_ascii" allows all 8-bit characters except 0x0 and '/'
in ISO file names.
@*
"untranslated_names" might be dangerous for inadverted reader programs