Patch by Mats Erik Anderson: wrap @command{} around the word xorriso

This commit is contained in:
Thomas Schmitt 2011-05-14 10:50:08 +00:00
parent 87321c252d
commit 8a6f217c42
4 changed files with 489 additions and 464 deletions

View File

@ -111,6 +111,23 @@ int Mx1_substitute(struct Mx1 *m, char line_in[256], char line_out[256],
strcpy(wpt, "\\fR"); strcpy(wpt, "\\fR");
wpt+= 3; wpt+= 3;
rpt+= ept - rpt; rpt+= ept - rpt;
} else if(strncmp(rpt, "@command{}", 9) == 0) {
/* @command{... } gets mapped to \fB...\fR . */
ept= strchr(rpt, '}');
if(ept == NULL) {
Mx1_report_error(m, "No closing bracket found for '@command{'", 0);
return(-1);
}
l= ept - rpt - 9;
if((wpt - line_out) + l + 6 + (rpt[9] == '-') > 255)
goto overflow;
strcpy(wpt, "\\fB");
wpt+= 3;
strncpy(wpt, rpt + 9, l);
wpt+= l;
strcpy(wpt, "\\fR");
wpt+= 3;
rpt+= ept - rpt;
} else if(strncmp(rpt, "@minus{}", 8) == 0) { } else if(strncmp(rpt, "@minus{}", 8) == 0) {
/* @minus{} will become "-". */ /* @minus{} will become "-". */
if((wpt - line_out) + 1 > 255) if((wpt - line_out) + 1 > 255)
@ -252,11 +269,13 @@ int Mx1_convert(struct Mx1 *m, char line_in[256], char line_out[256], int flag)
/* @strong{-...} gets mapped to \fB\-...\fR . */ /* @strong{-...} gets mapped to \fB\-...\fR . */
/* @strong{... } gets mapped to \fB...\fR . */ /* @strong{... } gets mapped to \fB...\fR . */
/* @command{... } gets mapped to \fB...\fR . */
/* @minus{} will become "-". */ /* @minus{} will become "-". */
/* @@ , @{, @} will get stripped of their first @. */ /* @@ , @{, @} will get stripped of their first @. */
/* "\" becomes "\\" */ /* "\" becomes "\\" */
if(line_in[0] != '@' || if(line_in[0] != '@' ||
strncmp(line_in, "@strong{", 8) == 0 || strncmp(line_in, "@strong{", 8) == 0 ||
strncmp(line_in, "@command{", 9) == 0 ||
strncmp(line_in, "@minus{}", 8) == 0 || strncmp(line_in, "@minus{}", 8) == 0 ||
strncmp(line_in, "@@", 2) == 0 || strncmp(line_in, "@@", 2) == 0 ||
strncmp(line_in, "@{", 2) == 0 || strncmp(line_in, "@{", 2) == 0 ||

View File

@ -39,9 +39,9 @@ session\-wise manipulation of such filesystems. It can load the management
information of existing ISO images and it writes the session results to information of existing ISO images and it writes the session results to
optical media or to filesystem objects. optical media or to filesystem objects.
.br .br
Vice versa xorriso is able to copy file objects out of ISO 9660 filesystems. Vice versa \fBxorriso\fR is able to copy file objects out of ISO 9660 filesystems.
.PP .PP
A special property of xorriso is that it needs neither an external ISO 9660 A special property of \fBxorriso\fR is that it needs neither an external ISO 9660
formatter program nor an external burn program for CD, DVD or BD but rather formatter program nor an external burn program for CD, DVD or BD but rather
incorporates the libraries of libburnia\-project.org . incorporates the libraries of libburnia\-project.org .
.SS .SS
@ -137,16 +137,16 @@ types. But program growisofs by Andy Polyakov showed how to extend this
functionality to overwriteable media or disk files which carry valid ISO 9660 functionality to overwriteable media or disk files which carry valid ISO 9660
filesystems. filesystems.
.PP .PP
xorriso provides growing as well as an own method named \fBxorriso\fR provides growing as well as an own method named
\fBmodifying\fR which produces a completely new ISO image from the old \fBmodifying\fR which produces a completely new ISO image from the old
one and the modifications. one and the modifications.
See paragraph Creating, Growing, Modifying, Blind Growing below. See paragraph Creating, Growing, Modifying, Blind Growing below.
.PP .PP
xorriso adopts the concept of multi\-session by loading an eventual image \fBxorriso\fR adopts the concept of multi\-session by loading an eventual image
directory tree, allowing to manipulate it by several actions, and to write directory tree, allowing to manipulate it by several actions, and to write
the new image to the target media. the new image to the target media.
.br .br
The first session of a xorriso run begins by the definition of the input The first session of a \fBxorriso\fR run begins by the definition of the input
drive with the eventual ISO image or by the definition of an output drive. drive with the eventual ISO image or by the definition of an output drive.
The session ends by command \-commit which triggers writing. A \-commit is The session ends by command \-commit which triggers writing. A \-commit is
done automatically when the program ends regularly. done automatically when the program ends regularly.
@ -170,12 +170,12 @@ describes their existing sessions. See option \fB\-toc\fR.
.br .br
Similar to multi\-session media are DVD\-R DL and minimally blanked DVD\-RW. 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. They allow only a single session of which the size must be known in advance.
xorriso will write onto them only if option \-close is set to "on". \fBxorriso\fR will write onto them only if option \-close is set to "on".
.br .br
\fBOverwriteable media\fR are DVD\-RAM, DVD+RW, BD\-RE, and formatted DVD\-RW. \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 They allow random write access but do not provide information about their
session history. If they contain one or more ISO 9660 sessions and if the session history. If they contain one or more ISO 9660 sessions and if the
first session was written by xorriso, then a table of content can first session was written by \fBxorriso\fR, then a table of content can
be emulated. Else only a single overall session will be visible. be emulated. Else only a single overall session will be visible.
.br .br
DVD\-RW media can be formatted by \-format "full". DVD\-RW media can be formatted by \-format "full".
@ -188,23 +188,23 @@ These media can assume several states in which they offer different
capabilities. capabilities.
.br .br
\fBBlank\fR media can be written from scratch. They contain no ISO image \fBBlank\fR media can be written from scratch. They contain no ISO image
suitable for xorriso. suitable for \fBxorriso\fR.
.br .br
Blank is the state of newly purchased optical media. Blank is the state of newly purchased optical media.
With used CD\-RW and DVD\-RW it can be achieved by action \-blank "as_needed". With used CD\-RW and DVD\-RW it can be achieved by action \-blank "as_needed".
Overwriteable media are considered blank if they are new or if they have Overwriteable media are considered blank if they are new or if they have
been marked as blank by xorriso. been marked as blank by \fBxorriso\fR.
Action \-blank "as_needed" can be used to do this marking on overwriteable Action \-blank "as_needed" can be used to do this marking on overwriteable
media, or to apply eventual mandatory formatting to new media. media, or to apply eventual mandatory formatting to new media.
.br .br
\fBAppendable\fR media accept further sessions. Either they are MMC \fBAppendable\fR media accept further sessions. Either they are MMC
multi\-session media in appendable state, or they are overwriteable media multi\-session media in appendable state, or they are overwriteable media
which contain an ISO image suitable for xorriso. which contain an ISO image suitable for \fBxorriso\fR.
.br .br
Appendable is the state after writing a session with option \-close off. Appendable is the state after writing a session with option \-close off.
.br .br
\fBClosed\fR media cannot be written. They may contain an ISO image suitable \fBClosed\fR media cannot be written. They may contain an ISO image suitable
for xorriso. for \fBxorriso\fR.
.br .br
Closed is the state of DVD\-ROM media and of multi\-session media which were 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 option \-close on. If the drive is read\-only hardware then it will
@ -264,7 +264,7 @@ to the given block address. This is the usage model of
mkisofs \-M $indev \-C $msc1,$msc2 \-o $outdev mkisofs \-M $indev \-C $msc1,$msc2 \-o $outdev
.br .br
which gives much room for wrong parameter combinations and should thus only be which gives much room for wrong parameter combinations and should thus only be
employed if a strict distinction between ISO formatter xorriso and the burn employed if a strict distinction between ISO formatter \fBxorriso\fR and the burn
program is desired. \-C $msc1,$msc2 is equivalent to: program is desired. \-C $msc1,$msc2 is equivalent to:
.br .br
\-load sbsector $msc1 \-grow_blindly $msc2 \-load sbsector $msc1 \-grow_blindly $msc2
@ -279,7 +279,7 @@ Output drive, i.e. target for writing, can be any libburn drive.
Some drive types do not support the method of growing but only the methods Some drive types do not support the method of growing but only the methods
of modifying and blind growing. They all are suitable for newly created images. of modifying and blind growing. They all are suitable for newly created images.
.br .br
All drive file objects have to offer rw\-permission to the user of xorriso. All drive file objects have to offer rw\-permission to the user of \fBxorriso\fR.
Even those which will not be useable for reading an ISO image. Even those which will not be useable for reading an ISO image.
.PP .PP
MMC compliant (i.e. optical) drives on GNU/Linux usually get addressed by MMC compliant (i.e. optical) drives on GNU/Linux usually get addressed by
@ -366,11 +366,11 @@ is the name of a set of additional information which enhance
an ISO 9660 filesystem so that it can represent a POSIX compliant filesystem an ISO 9660 filesystem so that it can represent a POSIX compliant filesystem
with ownership, access permissions, symbolic links, and other attributes. with ownership, access permissions, symbolic links, and other attributes.
.br .br
This is what xorriso uses for a decent representation of the disk files This is what \fBxorriso\fR uses for a decent representation of the disk files
within the ISO image. Rock Ridge information is produced with any xorriso within the ISO image. Rock Ridge information is produced with any \fBxorriso\fR
image. image.
.PP .PP
xorriso is not named "porriso" because POSIX only guarantees 14 characters \fBxorriso\fR is not named "porriso" because POSIX only guarantees 14 characters
of filename length. It is the X/Open System Interface standard XSI which of filename length. It is the X/Open System Interface standard XSI which
demands a file name length of up to 255 characters and paths of up to 1024 demands a file name length of up to 255 characters and paths of up to 1024
characters. Rock Ridge fulfills this demand. characters. Rock Ridge fulfills this demand.
@ -381,7 +381,7 @@ images, which are binary program files stored in the ISO image.
The content of the boot image files is not in the scope of El Torito. The content of the boot image files is not in the scope of El Torito.
.br .br
Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images. Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images.
xorriso is able to create or maintain an El Torito object which makes such \fBxorriso\fR is able to create or maintain an El Torito object which makes such
an image bootable. For details see option \-boot_image. an image bootable. For details see option \-boot_image.
.br .br
It is possible to make ISO images bootable from USB stick or other It is possible to make ISO images bootable from USB stick or other
@ -409,25 +409,25 @@ It uses this extension if enabled by option
.br .br
AAIP enhanced images are supposed to be mountable normally, but one cannot AAIP enhanced images are supposed to be mountable normally, but one cannot
expect that the mounted filesystem will show and respect the eventual ACLs. expect that the mounted filesystem will show and respect the eventual ACLs.
For now, only xorriso is able to retrieve those ACLs. It can bring them into For now, only \fBxorriso\fR is able to retrieve those ACLs. It can bring them into
effect when files get restored to an ACL enabled file system or it can effect when files get restored to an ACL enabled file system or it can
print them in a format suitable for tool setfacl. print them in a format suitable for tool setfacl.
.br .br
Files with ACL show as group permissions the setting of entry "mask::" if Files with ACL show as group permissions the setting of entry "mask::" if
that entry exists. Nevertheless the non\-listed group members get handled that entry exists. Nevertheless the non\-listed group members get handled
according to entry "group::". xorriso brings "group::" into effect before according to entry "group::". \fBxorriso\fR brings "group::" into effect before
eventually removing the ACL from a file. eventually removing the ACL from a file.
.PP .PP
\fBxattr\fR (aka EA) \fBxattr\fR (aka EA)
are pairs of name and value which can be attached to file objects. AAIP is are pairs of name and value which can be attached to file objects. AAIP is
able to represent them and xorriso allows to record and restore pairs which able to represent them and \fBxorriso\fR allows to record and restore pairs which
have names out of the user namespace. I.e. those which begin with "user.", 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. 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. 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 option
\fB\-xattr\fR. \fB\-xattr\fR.
.br .br
As with ACL, currently only xorriso is able to retrieve xattr from AAIP As with ACL, currently only \fBxorriso\fR is able to retrieve xattr from AAIP
enhanced images, to restore them to xattr capable file systems, or to print enhanced images, to restore them to xattr capable file systems, or to print
them. them.
.SS .SS
@ -473,9 +473,9 @@ Command and parameter words are either read from program arguments, where one
argument is one word, or from quoted input lines where words are recognized argument is one word, or from quoted input lines where words are recognized
similar to the quotation rules of a shell parser. similar to the quotation rules of a shell parser.
.br .br
xorriso is not a shell, although it might appear so on first glimpse. \fBxorriso\fR is not a shell, although it might appear so on first glimpse.
Be aware that the interaction of quotation marks and pattern symbols like "*" Be aware that the interaction of quotation marks and pattern symbols like "*"
differs from the usual shell parsers. In xorriso, a quotation mark does not differs from the usual shell parsers. In \fBxorriso\fR, a quotation mark does not
make a pattern symbol literal. make a pattern symbol literal.
.PP .PP
\fBQuoted input\fR \fBQuoted input\fR
@ -511,8 +511,8 @@ them as commands with their parameters. It provides assisting services
to make dialog more comfortable. to make dialog more comfortable.
.PP .PP
Readline is an enhancement for the input line. You may know it already from Readline is an enhancement for the input line. You may know it already from
the bash shell. Whether it is available in xorriso depends on the availability the bash shell. Whether it is available in \fBxorriso\fR depends on the availability
of package readline\-dev at the time when xorriso was built from its sourcecode. of package readline\-dev at the time when \fBxorriso\fR was built from its sourcecode.
.br .br
It allows to move the cursor over the text in the line by help of the It allows to move the cursor over the text in the line by help of the
Leftward and the Rightward arrow key. Leftward and the Rightward arrow key.
@ -527,7 +527,7 @@ Option \-page activates a built\-in result text pager which may be convenient in
dialog. After an action has put out the given number of terminal lines, dialog. After an action has put out the given number of terminal lines,
the pager prompts the user for a line of input. the pager prompts the user for a line of input.
.br .br
An empty line lets xorriso resume work until the next page is put out. An empty line lets \fBxorriso\fR resume work until the next page is put out.
.br .br
The single character "@" disables paging for the current action. The single character "@" disables paging for the current action.
.br .br
@ -602,7 +602,7 @@ predicted_nwa is the block address where the add\-on session of blind
growing will finally end up. It is the responsibility of the user to ensure growing will finally end up. It is the responsibility of the user to ensure
this final position and the presence of the older sessions. Else the this final position and the presence of the older sessions. Else the
overall ISO image will not be mountable or will produce read errors when overall ISO image will not be mountable or will produce read errors when
accessing file content. xorriso will write the session to the address accessing file content. \fBxorriso\fR will write the session to the address
as obtained from examining \-outdev and not necessarily to predicted_nwa. as obtained from examining \-outdev and not necessarily to predicted_nwa.
.br .br
During a run of blind growing, the input drive is given up before output During a run of blind growing, the input drive is given up before output
@ -670,7 +670,7 @@ accepted. If it is not a MMC device then the prefix "stdio:" will be prepended
automatically. This list is empty by default. automatically. This list is empty by default.
.br .br
Else if the path matches the "banned" list then the drive will not be Else if the path matches the "banned" list then the drive will not be
accepted by xorriso but rather lead to a FAILURE event. This list is empty by accepted by \fBxorriso\fR but rather lead to a FAILURE event. This list is empty by
default. default.
.br .br
Else if the path matches the "caution" list and if it is not a MMC device, Else if the path matches the "caution" list and if it is not a MMC device,
@ -689,7 +689,7 @@ By pseudo\-class "clear_list" and pseudo\-patterns "banned", "caution",
.br .br
E.g.: \-drive_class clear_list banned E.g.: \-drive_class clear_list banned
.br .br
One will normally define the \-drive_class lists in one of the xorriso One will normally define the \-drive_class lists in one of the \fBxorriso\fR
Startup Files. Startup Files.
.br .br
Note: This is not a security feature but rather a bumper for the superuser to Note: This is not a security feature but rather a bumper for the superuser to
@ -719,7 +719,7 @@ an eventual recorded character set name gets used as input character set
when reading an image. when reading an image.
.br .br
Note that the default output charset is the local character set of the Note that the default output charset is the local character set of the
terminal where xorriso runs. Before attributing this local character set terminal where \fBxorriso\fR runs. Before attributing this local character set
to the produced ISO image, check whether the terminal properly displays to the produced ISO image, check whether the terminal properly displays
all intended filenames, especially exotic national characters. all intended filenames, especially exotic national characters.
.TP .TP
@ -746,7 +746,7 @@ e.g. if you need to apply filters to all updated files.
Mode "without_update" avoids hardlink processing during update commands. Mode "without_update" avoids hardlink processing during update commands.
Use this if your filesystem situation does not allow \-disk_dev_ino "on". Use this if your filesystem situation does not allow \-disk_dev_ino "on".
.br .br
xorriso commands which extract files from an ISO image try to hardlink files \fBxorriso\fR commands which extract files from an ISO image try to hardlink files
with identical inode number. The normal scope of this operation is from with identical inode number. The normal scope of this operation is from
image load to image load. One may give up the accumulated hard link addresses image load to image load. One may give up the accumulated hard link addresses
by \-hardlinks "discard_extract". by \-hardlinks "discard_extract".
@ -760,7 +760,7 @@ wide and expensive hardlink accumulation.
.TP .TP
\fB\-acl\fR "on"|"off" \fB\-acl\fR "on"|"off"
Enable or disable processing of ACLs. Enable or disable processing of ACLs.
If enabled, then xorriso will obtain ACLs from disk file objects, If enabled, then \fBxorriso\fR will obtain ACLs from disk file objects,
store ACLs in the ISO image using the libisofs specific AAIP format, store ACLs in the ISO image using the libisofs specific AAIP format,
load AAIP data from ISO images, test ACL during file comparison, load AAIP data from ISO images, test ACL during file comparison,
and restore ACLs to disk files when extracting them from ISO images. and restore ACLs to disk files when extracting them from ISO images.
@ -768,7 +768,7 @@ See also options \-getfacl, \-setfacl.
.TP .TP
\fB\-xattr\fR "on"|"off" \fB\-xattr\fR "on"|"off"
Enable or disable processing of xattr attributes in user namespace. Enable or disable processing of xattr attributes in user namespace.
If enabled, then xorriso will handle xattr similar to ACL. If enabled, then \fBxorriso\fR will handle xattr similar to ACL.
See also options \-getfattr, \-setfattr and above paragraph about xattr. See also options \-getfattr, \-setfattr and above paragraph about xattr.
.TP .TP
\fB\-md5\fR "on"|"all"|"off"|"load_check_off" \fB\-md5\fR "on"|"all"|"off"|"load_check_off"
@ -796,7 +796,7 @@ Mode "load_check_off" together with "on" or "all" will load recorded MD5 sums
but not test the recorded checksum tags of superblock and directory tree. but not test the recorded checksum tags of superblock and directory tree.
This is necessary if growisofs was used as burn program, because it does This is necessary if growisofs was used as burn program, because it does
not overwrite the superblock checksum tag of the first session. not overwrite the superblock checksum tag of the first session.
Therefore load_check_off is in effect when xorriso \-as mkisofs option \-M Therefore load_check_off is in effect when \fBxorriso\fR \-as mkisofs option \-M
is performed. is performed.
.br .br
The test can be re\-enabled by mode "load_check_on". The test can be re\-enabled by mode "load_check_on".
@ -846,7 +846,7 @@ to invalid addresses and thus ugly drive behavior.
Setting "on" enables that scan for alleged read\-only media. Setting "on" enables that scan for alleged read\-only media.
.br .br
Some operating systems are not able to mount the most recent session of Some operating systems are not able to mount the most recent session of
multi\-session DVD or BD. If on such a system xorriso has no own MMC multi\-session DVD or BD. If on such a system \fBxorriso\fR has no own MMC
capabilities then it may still find that session from a scanned table of capabilities then it may still find that session from a scanned table of
content. Setting "force" handles any media like a ROM media with setting "on". content. Setting "force" handles any media like a ROM media with setting "on".
.br .br
@ -1103,7 +1103,7 @@ arguments.
\fB\-file_size_limit\fR value [value [...]] -- \fB\-file_size_limit\fR value [value [...]] --
Set the maximum permissible size for a single data file. The values get Set the maximum permissible size for a single data file. The values get
summed up for the actual limit. If the only value is "off" then the file summed up for the actual limit. If the only value is "off" then the file
size is not limited by xorriso. Default is a limit of 100 extents, 4g \-2k each: size is not limited by \fBxorriso\fR. Default is a limit of 100 extents, 4g \-2k each:
.br .br
\-file_size_limit 400g \-200k \-\- \-file_size_limit 400g \-200k \-\-
.br .br
@ -1112,7 +1112,7 @@ up to 2g \-1 \-\-. Newer ones are good up to 4g \-1 \-\-.
You need quite a new Linux kernel to read correctly the final bytes You need quite a new Linux kernel to read correctly the final bytes
of a file >= 4g if its size is not aligned to 2048 byte blocks. of a file >= 4g if its size is not aligned to 2048 byte blocks.
.br .br
xorriso's own data read capabilities are not affected by eventual \fBxorriso\fR's own data read capabilities are not affected by eventual
operating system size limits. They apply to mounting only. Nevertheless, operating system size limits. They apply to mounting only. Nevertheless,
the target filesystem of an \-extract must be able to take the file size. the target filesystem of an \-extract must be able to take the file size.
.TP .TP
@ -1234,7 +1234,7 @@ The number given with "limit=" can curb this workload at the risk of truncating
an intentional sequence of link hops. an intentional sequence of link hops.
.TP .TP
\fB\-pathspecs\fR "on"|"off" \fB\-pathspecs\fR "on"|"off"
Control parameter interpretation with xorriso actions \-add and \-path_list. Control parameter interpretation with \fBxorriso\fR actions \-add and \-path_list.
.br .br
"on" enables pathspecs of the form "on" enables pathspecs of the form
\fBtarget=source\fR \fBtarget=source\fR
@ -1426,7 +1426,7 @@ be an empty text.
Only names from the user namespace are allowed. I.e. a name has to begin with Only names from the user namespace are allowed. I.e. a name has to begin with
"user.", like "user.x" or "user.whatever". "user.", like "user.x" or "user.whatever".
.br .br
Values and names undergo the normal input processing of xorriso. Values and names undergo the normal input processing of \fBxorriso\fR.
See also option \-backslash_codes. Other than with option \-setfattr_list, See also option \-backslash_codes. Other than with option \-setfattr_list,
the byte value 0 cannot be expressed via \-setfattr. the byte value 0 cannot be expressed via \-setfattr.
.TP .TP
@ -1481,7 +1481,7 @@ Absolute seconds counted from Jan 1 1970:
.br .br
=Number =Number
.br .br
xorriso's own timestamps: \fBxorriso\fR's own timestamps:
.br .br
YYYY.MM.DD[.hh[mm[ss]]] YYYY.MM.DD[.hh[mm[ss]]]
.br .br
@ -1636,7 +1636,7 @@ If \-else is missing and would be hit, then the result is a non\-match.
Default action is \fBecho\fR, Default action is \fBecho\fR,
i.e. to print the address of the found file. Other actions are certain i.e. to print the address of the found file. Other actions are certain
xorriso commands which get performed on the found files. These commands \fBxorriso\fR commands which get performed on the found files. These commands
may have specific parameters. See also their particular descriptions. may have specific parameters. See also their particular descriptions.
.br .br
\fBchown\fR and \fBchown_r\fR \fBchown\fR and \fBchown_r\fR
@ -1862,8 +1862,8 @@ is not applied to any file in the ISO image.
Irrevocably ban commands \-external_filter and \-unregister_filter, Irrevocably ban commands \-external_filter and \-unregister_filter,
but not \-set_filter. Use this to prevent external filtering in general or but not \-set_filter. Use this to prevent external filtering in general or
when all intended filters are registered. when all intended filters are registered.
External filters may also be banned totally at compile time of xorriso. External filters may also be banned totally at compile time of \fBxorriso\fR.
By default they are banned if xorriso runs under setuid permission. By default they are banned if \fBxorriso\fR runs under setuid permission.
.TP .TP
\fB\-set_filter\fR name iso_rr_path [***] \fB\-set_filter\fR name iso_rr_path [***]
Apply an \-external_filter or a built\-in filter to the given data files in the Apply an \-external_filter or a built\-in filter to the given data files in the
@ -1923,7 +1923,7 @@ Writing can last quite a while. It is not unnormal with several
types of media that there is no progress visible for the first types of media that there is no progress visible for the first
few minutes or that the drive gnaws on the media for a few few minutes or that the drive gnaws on the media for a few
minutes after all data have been transmitted. minutes after all data have been transmitted.
xorriso and the drives are in a client\-server relationship. \fBxorriso\fR and the drives are in a client\-server relationship.
The drives have much freedom about what to do with the media. The drives have much freedom about what to do with the media.
Some combinations of drives and media simply do not work, Some combinations of drives and media simply do not work,
despite the promises by their vendors. despite the promises by their vendors.
@ -1963,7 +1963,7 @@ overwriteable ISO images. "all" might work more thoroughly and need more time.
.br .br
"deformat_quickest" is a faster way to deformat or blank DVD\-RW "deformat_quickest" is a faster way to deformat or blank DVD\-RW
but produces media which are only suitable for a single session. but produces media which are only suitable for a single session.
xorriso will write onto them only if option \-close is set to "on". \fBxorriso\fR will write onto them only if option \-close is set to "on".
.br .br
The progress reports issued by some drives while blanking are The progress reports issued by some drives while blanking are
quite unrealistic. Do not conclude success or failure from the quite unrealistic. Do not conclude success or failure from the
@ -2139,7 +2139,7 @@ Note: The term "ISO file" means the plain ISO 9660 names and attributes
which get visible if the reader ignores Rock Ridge. which get visible if the reader ignores Rock Ridge.
.TP .TP
\fB\-volid\fR text \fB\-volid\fR text
Specify the volume ID. xorriso accepts any text up to 32 characters, Specify the volume ID. \fBxorriso\fR accepts any text up to 32 characters,
but according to rarely obeyed specs stricter rules apply: but according to rarely obeyed specs stricter rules apply:
.br .br
ECMA 119 demands ASCII characters out of [A\-Z0\-9_]. Like: "IMAGE_23" ECMA 119 demands ASCII characters out of [A\-Z0\-9_]. Like: "IMAGE_23"
@ -2175,7 +2175,7 @@ identify the specification of how the data are recorded.
Permissible are up to 128 characters. This setting gets overridden by Permissible are up to 128 characters. This setting gets overridden by
image loading. image loading.
.br .br
The special text "@xorriso@" gets converted to the id string of xorriso 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 which is normally written as \-preparer_id. It is a wrong tradition to write
the program id as \-application_id. the program id as \-application_id.
.TP .TP
@ -2237,11 +2237,11 @@ image loading.
\fB\-preparer_id\fR \fB\-preparer_id\fR
Set the preparer id string to be written with the next \-commit. This may Set the preparer id string to be written with the next \-commit. This may
identify the person or other entity which controls the preparation of the data identify the person or other entity which controls the preparation of the data
which shall be recorded. Normally this should be the id of xorriso and not which shall be recorded. Normally this should be the id of \fBxorriso\fR and not
of the person or program which operates xorriso. Please avoid to change it. of the person or program which operates \fBxorriso\fR. Please avoid to change it.
Permissible are up to 128 characters. Permissible are up to 128 characters.
.br .br
The special text "@xorriso@" gets converted to the id string of xorriso The special text "@xorriso@" gets converted to the id string of \fBxorriso\fR
which is default at program startup. which is default at program startup.
.br .br
Unlike other id strings, this setting is not influenced by image loading. Unlike other id strings, this setting is not influenced by image loading.
@ -2344,7 +2344,7 @@ Append the given number of extra bytes to the image stream.
This is a traditional remedy for a traditional bug in block This is a traditional remedy for a traditional bug in block
device read drivers. Needed only for CD recordings in TAO mode. device read drivers. Needed only for CD recordings in TAO mode.
Since one can hardly predict on what media an image might end up, Since one can hardly predict on what media an image might end up,
xorriso adds the traditional 300k of padding by default to all images. \fBxorriso\fR adds the traditional 300k of padding by default to all images.
.br .br
For images which will never get to a CD it is safe to use \-padding 0 . For images which will never get to a CD it is safe to use \-padding 0 .
.br .br
@ -2613,7 +2613,7 @@ Partitions may be appended with boot block type MBR and with SUN Disk Label.
With MBR: With MBR:
.br .br
partition_number may be 1 to 4. Number 1 will put the whole ISO image into partition_number may be 1 to 4. Number 1 will put the whole ISO image into
the unclaimed space before partition 1. So together with most xorriso MBR the unclaimed space before partition 1. So together with most \fBxorriso\fR MBR
features, number 2 would be the most natural choice. features, number 2 would be the most natural choice.
.br .br
The type_code may be "FAT12", "FAT16", "Linux", The type_code may be "FAT12", "FAT16", "Linux",
@ -2641,13 +2641,13 @@ DVD images; see http://atterer.net/jigdo/ for more details. Debian CDs
and DVD ISO images are published on the web in jigdo format to allow and DVD ISO images are published on the web in jigdo format to allow
end users to download them more efficiently." end users to download them more efficiently."
.br .br
xorriso can produce a .jigdo and a .template file together with a \fBxorriso\fR can produce a .jigdo and a .template file together with a
single\-session ISO image. single\-session ISO image.
The .jigdo file contains checksums and symbolic file addresses. The .jigdo file contains checksums and symbolic file addresses.
The .template file contains the compressed ISO image with reference tags The .template file contains the compressed ISO image with reference tags
instead of the content bytes of the listed files. instead of the content bytes of the listed files.
.br .br
Input for this process are the normal arguments for a xorriso session Input for this process are the normal arguments for a \fBxorriso\fR session
on a blank \-outdev, and a .md5 file which lists those data files which may be on a blank \-outdev, and a .md5 file which lists those data files which may be
listed in the .jigdo file and externally referenced in the .template file. listed in the .jigdo file and externally referenced in the .template file.
Each designated file is represented in the .md5 file by a single text line: Each designated file is represented in the .md5 file by a single text line:
@ -2662,7 +2662,7 @@ After eventual To=From mapping, the file address gets written into the .jigdo
file. Jigdo restore tools will convert these addresses into really file. Jigdo restore tools will convert these addresses into really
reachable data source addresses from which they can read. reachable data source addresses from which they can read.
.br .br
If the list of jigdo parameters is not empty, then xorriso will refuse to If the list of jigdo parameters is not empty, then \fBxorriso\fR will refuse to
write to non\-blank targets, it will disable multi\-session emulation, and write to non\-blank targets, it will disable multi\-session emulation, and
eventual padding will be counted as part of the ISO image. eventual padding will be counted as part of the ISO image.
.br .br
@ -2743,7 +2743,7 @@ names. Shell command iconv \-l lists them.
Character sets should not matter as long as only english alphanumeric Character sets should not matter as long as only english alphanumeric
characters are used for file names or as long as all writers and readers characters are used for file names or as long as all writers and readers
of the media use the same character set. of the media use the same character set.
Outside these constraints it may be necessary to let xorriso convert byte Outside these constraints it may be necessary to let \fBxorriso\fR convert byte
codes. codes.
.br .br
There is an input conversion from input character set to the local character There is an input conversion from input character set to the local character
@ -2752,14 +2752,14 @@ 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 options
\-in_charset and \-out_charset. Normally one will have both identical, if ever. \-in_charset and \-out_charset. Normally one will have both identical, if ever.
.br .br
If conversions are desired then xorriso needs to know the name of the If conversions are desired then \fBxorriso\fR needs to know the name of the
local character set. xorriso can inquire the same info as shell command local character set. \fBxorriso\fR can inquire the same info as shell command
"locale" with argument "charmap". This may be influenced by environment "locale" with argument "charmap". This may be influenced by environment
variables LC_ALL, LC_CTYPE, or LANG and should match the expectations of variables LC_ALL, LC_CTYPE, or LANG and should match the expectations of
the terminal. the terminal.
.br .br
The default output charset is the local character set of the terminal where The default output charset is the local character set of the terminal where
xorriso runs. So by default no conversion happens between local filesystem \fBxorriso\fR runs. So by default no conversion happens between local filesystem
names and emerging names in the image. The situation stays ambigous and the names and emerging names in the image. The situation stays ambigous and the
reader has to riddle what character set was used. reader has to riddle what character set was used.
.br .br
@ -2786,8 +2786,8 @@ If this appears necessary, one should consider to set \-backslash_codes to
.TP .TP
.B Exception processing: .B Exception processing:
.PP .PP
Since the tasks of xorriso are manifold and prone to external influence, there Since the tasks of \fBxorriso\fR are manifold and prone to external influence, there
may arise the need for xorriso to report and handle problem events. may arise the need for \fBxorriso\fR to report and handle problem events.
.br .br
Those events get classified when they are detected by one of the software Those events get classified when they are detected by one of the software
modules and forwarded to reporting and evaluation modules which decide about modules and forwarded to reporting and evaluation modules which decide about
@ -2829,24 +2829,24 @@ be ignorable.
.br .br
A special property of this option is that it works preemptive if given as A special property of this option is that it works preemptive if given as
program start argument. I.e. the first \-abort_on setting among the program start argument. I.e. the first \-abort_on setting among the
start arguments is in effect already when the first operations of xorriso start arguments is in effect already when the first operations of \fBxorriso\fR
begin. Only "\-abort_on" with dash "\-" is recognized that way. begin. Only "\-abort_on" with dash "\-" is recognized that way.
.TP .TP
\fB\-return_with\fR severity exit_value \fB\-return_with\fR severity exit_value
Set the threshold and exit_value to be returned at program end if no abort Set the threshold and exit_value to be returned at program end if no abort
has happened. This is to allow xorriso to go on after problems but to get has happened. This is to allow \fBxorriso\fR to go on after problems but to get
a failure indicating exit value from the program, nevertheless. a failure indicating exit value from the program, nevertheless.
Useful is a value lower than the \-abort_on threshold, down to "WARNING". Useful is a value lower than the \-abort_on threshold, down to "WARNING".
.br .br
exit_value may be either 0 (indicating success to the starter of the program) exit_value may be either 0 (indicating success to the starter of the program)
or a number between 32 and 63. Some other exit_values are used by xorriso if or a number between 32 and 63. Some other exit_values are used by \fBxorriso\fR if
it decides to abort the program run: it decides to abort the program run:
.br .br
1=abort due to external signal 1=abort due to external signal
.br .br
2=no program arguments given 2=no program arguments given
.br .br
3=creation of xorriso main object failed 3=creation of \fBxorriso\fR main object failed
.br .br
4=failure to start libburnia\-project.org libraries 4=failure to start libburnia\-project.org libraries
.br .br
@ -2868,7 +2868,7 @@ Info messages which belong to no event get attributed severity "NOTE".
.br .br
A special property of this option is that the first \-report_about setting A special property of this option is that the first \-report_about setting
among the start arguments is in effect already when the first operations among the start arguments is in effect already when the first operations
of xorriso begin. Only "\-report_about" with dash "\-" is recognized that way. of \fBxorriso\fR begin. Only "\-report_about" with dash "\-" is recognized that way.
.TP .TP
\fB\-signal_handling\fR mode \fB\-signal_handling\fR mode
Control the installation of a signal handler which shall react on external Control the installation of a signal handler which shall react on external
@ -2877,10 +2877,10 @@ caused by severe program errors.
.br .br
Mode "on" is the default. It uses the signal handler of libburn which produces Mode "on" is the default. It uses the signal handler of libburn which produces
ugly messages but puts much effort in releasing eventually used optical drives ugly messages but puts much effort in releasing eventually used optical drives
before xorriso ends. before \fBxorriso\fR ends.
.br .br
Mode "off" as first \-signal_handling among the start arguments prevents all Mode "off" as first \-signal_handling among the start arguments prevents all
own signal precautions of xorriso. Eventually inherited signal handler settings own signal precautions of \fBxorriso\fR. Eventually inherited signal handler settings
stay as they are. stay as they are.
.br .br
It works like "sig_dfl" if given after other signal handling was already It works like "sig_dfl" if given after other signal handling was already
@ -2891,14 +2891,14 @@ normally a sudden abort of the program. To prevent stuck drives, the
libburn handler is used during burning, blanking, and formatting on MMC drives. libburn handler is used during burning, blanking, and formatting on MMC drives.
.br .br
Mode "sig_ign" tries to ignore as many signal types as possible. This imposes Mode "sig_ign" tries to ignore as many signal types as possible. This imposes
the risk that xorriso refuses to end until externally kill \-9 if performed. the risk that \fBxorriso\fR refuses to end until externally kill \-9 if performed.
kill \-9 then imposes the risk that the drive is left in unusable state and 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 needs poweroff to be reset. So during burning, blanking, and formatting
wait for at least their normal run time before killing externally. wait for at least their normal run time before killing externally.
.br .br
A special property of this option is that the first \-signal_handling setting A special property of this option is that the first \-signal_handling setting
among the start arguments is in effect already when the first operations among the start arguments is in effect already when the first operations
of xorriso begin. Only "\-signal_handling" with dash "\-" is recognized that way. of \fBxorriso\fR begin. Only "\-signal_handling" with dash "\-" is recognized that way.
.TP .TP
\fB\-error_behavior\fR occasion behavior \fB\-error_behavior\fR occasion behavior
Control the program behavior at problem event occasions. Control the program behavior at problem event occasions.
@ -3012,7 +3012,7 @@ not the ISO image directory tree.
.br .br
In case of overwriteable media holding a valid ISO image, it may happen that In case of overwriteable media holding a valid ISO image, it may happen that
only a single session gets shown. But if the first session on the only a single session gets shown. But if the first session on the
overwriteable media was written by xorriso then a complete overwriteable media was written by \fBxorriso\fR then a complete
session history can be emulated. session history can be emulated.
.br .br
A drive which is incapable of writing may show any media as CD\-ROM or DVD\-ROM A drive which is incapable of writing may show any media as CD\-ROM or DVD\-ROM
@ -3044,7 +3044,7 @@ for direct execution of this command.
\fB\-mount_opts\fR option[:option...] \fB\-mount_opts\fR option[:option...]
Set options which influence \-mount and \-mount_cmd. Currently there is only Set options which influence \-mount and \-mount_cmd. Currently there is only
option "exclusive" which is default and its counterpart "shared". The latter option "exclusive" which is default and its counterpart "shared". The latter
causes xorriso not to give up the affected drive with command \-mount. causes \fBxorriso\fR not to give up the affected drive with command \-mount.
On GNU/Linux it adds mount option "loop" which may allow to mount several On GNU/Linux it adds mount option "loop" which may allow to mount several
sessions of the same block device at the same time. One should not write sessions of the same block device at the same time. One should not write
to a mounted optical media, of course. Take care to umount all sessions to a mounted optical media, of course. Take care to umount all sessions
@ -3057,7 +3057,7 @@ format and the parameters of the addressed session.
Formats "linux:"path or "freebsd:"path produce the output of \-mount_cmd Formats "linux:"path or "freebsd:"path produce the output of \-mount_cmd
for the given operating systems. for the given operating systems.
.br .br
In other texts xorriso will substitute the following parameter names. In other texts \fBxorriso\fR will substitute the following parameter names.
An optional prefix "string:" will be removed. An optional prefix "string:" will be removed.
.br .br
"%device%" will be substituted by the mountable device path of the drive "%device%" will be substituted by the mountable device path of the drive
@ -3289,7 +3289,7 @@ and based on extra data on the media. If a drive returns data then one can
quite trust that they are valid. But at some degree of read problems the quite trust that they are valid. But at some degree of read problems the
correction will fail and the drive is supposed to indicate error. correction will fail and the drive is supposed to indicate error.
.br .br
xorriso can scan the media for readable data blocks, classify them according \fBxorriso\fR can scan the media for readable data blocks, classify them according
to their read speed, save them to a file, and keep track of successfuly saved to their read speed, save them to a file, and keep track of successfuly saved
blocks for further tries on the same media. blocks for further tries on the same media.
.br .br
@ -3379,7 +3379,7 @@ gives the path of the file which may abort a scan run. Abort
happens if the file exists and its mtime is not older than the start time happens if the file exists and its mtime is not older than the start time
of the run. Use shell command "touch" to trigger this. of the run. Use shell command "touch" to trigger this.
Other than an aborted program run, this will report the tested and untested Other than an aborted program run, this will report the tested and untested
blocks and go on with running xorriso. blocks and go on with running \fBxorriso\fR.
.br .br
\fBtime_limit=seconds\fR \fBtime_limit=seconds\fR
gives the number of seconds after which the scan shall be gives the number of seconds after which the scan shall be
@ -3422,7 +3422,7 @@ when it gets mounted or loaded as stdio: drive. But it usually makes
the original session 1 inaccessible. the original session 1 inaccessible.
.br .br
\fBpatch_lba0="force"\fR \fBpatch_lba0="force"\fR
performs patch_lba0="on" even if xorriso believes performs patch_lba0="on" even if \fBxorriso\fR believes
that the copied data are not valid. that the copied data are not valid.
.br .br
patch_lba0= may also bear a number. If it is 32 or higher it is taken as patch_lba0= may also bear a number. If it is 32 or higher it is taken as
@ -3463,7 +3463,7 @@ Only mismatching data files will be reported.
.TP .TP
.B osirrox ISO-to-disk restore options: .B osirrox ISO-to-disk restore options:
.PP .PP
Normally xorriso only writes to disk files which were given as stdio: Normally \fBxorriso\fR only writes to disk files which were given as stdio:
pseudo\-drives or as log files. pseudo\-drives or as log files.
But its alter ego osirrox is able to extract file objects But its alter ego osirrox is able to extract file objects
from ISO images and to create, overwrite, or delete file objects on disk. from ISO images and to create, overwrite, or delete file objects on disk.
@ -3500,7 +3500,7 @@ handled like any other ISO image directory.
.br .br
Option "auto_chmod_off" is default. If "auto_chmod_on" is set then access Option "auto_chmod_off" is default. If "auto_chmod_on" is set then access
restrictions for disk directories get circumvented if those directories restrictions for disk directories get circumvented if those directories
are owned by the effective user who runs xorriso. This happens by temporarily are owned by the effective user who runs \fBxorriso\fR. This happens by temporarily
granting rwx permission to the owner. granting rwx permission to the owner.
.br .br
Option "sort_lba_on" may improve read performance with optical drives. It Option "sort_lba_on" may improve read performance with optical drives. It
@ -3596,7 +3596,7 @@ reachable as /bin/mount or /sbin/mount.
.PP .PP
Writing of ISO 9660 on CD is traditionally done by program mkisofs Writing of ISO 9660 on CD is traditionally done by program mkisofs
as ISO 9660 image producer and cdrecord as burn program. as ISO 9660 image producer and cdrecord as burn program.
xorriso does not strive for their comprehensive emulation. \fBxorriso\fR does not strive for their comprehensive emulation.
Nevertheless it is ready to perform some of its core tasks under control Nevertheless it is ready to perform some of its core tasks under control
of commands which in said programs trigger comparable actions. of commands which in said programs trigger comparable actions.
.TP .TP
@ -3621,16 +3621,16 @@ emulation. Some are ignored, but better do not rely on this tolerance.
.br .br
The supported options are documented in detail in xorrisofs.info The supported options are documented in detail in xorrisofs.info
and in man xorrisofs. The description here is focused on the effect and in man xorrisofs. The description here is focused on the effect
of mkisofs emulation in the context of a xorriso run. of mkisofs emulation in the context of a \fBxorriso\fR run.
.br .br
Other than with the "cdrecord" personality there is no automatic \-commit at Other than with the "cdrecord" personality there is no automatic \-commit at
the end of a "mkisofs" option list. Verbosity settings \-v (= "UPDATE") and the end of a "mkisofs" option list. Verbosity settings \-v (= "UPDATE") and
\-quiet (= "SORRY") persist. The output file, eventually chosen with \-o, \-quiet (= "SORRY") persist. The output file, eventually chosen with \-o,
persists until things happen like \-commit, \-rollback, \-dev, or end of xorriso. persists until things happen like \-commit, \-rollback, \-dev, or end of \fBxorriso\fR.
\-pacifier gets set to "mkisofs" if files are added to the image. \-pacifier gets set to "mkisofs" if files are added to the image.
.br .br
\-graft\-points is equivalent to \-pathspecs on. Note that pathspecs without "=" \-graft\-points is equivalent to \-pathspecs on. Note that pathspecs without "="
are interpreted differently than with xorriso option \-add. Directories get are interpreted differently than with \fBxorriso\fR option \-add. Directories get
merged with the root directory of the ISO image, other filetypes get mapped merged with the root directory of the ISO image, other filetypes get mapped
into that root directory. into that root directory.
.br .br
@ -3638,7 +3638,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. "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 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 when finally writing begins. This truncation does not happen if the drive
is chosen by xorriso options before \-as mkisofs or after its list delimiter. is chosen by \fBxorriso\fR options before \-as mkisofs or after its list delimiter.
Directories and symbolic links are no valid \-o targets. Directories and symbolic links are no valid \-o targets.
.br .br
Writing to stdout is possible only if \-as "mkisofs" was among the start Writing to stdout is possible only if \-as "mkisofs" was among the start
@ -3656,7 +3656,7 @@ directory is added to the image. At the same occasion directory names get
allowed to violate the standard by \-compliance option allow_dir_id_ext. allowed to violate the standard by \-compliance option allow_dir_id_ext.
This may be avoided by option \-disallow_dir_id_ext. This may be avoided by option \-disallow_dir_id_ext.
.br .br
Option \-root is supported. Option \-old\-root is implemented by xorriso Option \-root is supported. Option \-old\-root is implemented by \fBxorriso\fR
commands \-mkdir, \-cp_clone, \-find update_merge, and \-find rm_merge. commands \-mkdir, \-cp_clone, \-find update_merge, and \-find rm_merge.
\-root and \-old\-root set command \-disk_dev_ino to "ino_only" and \-md5 to "on", \-root and \-old\-root set command \-disk_dev_ino to "ino_only" and \-md5 to "on",
by default. by default.
@ -3667,7 +3667,7 @@ resp. to "on" by \-\-old\-root\-devno .
Not original mkisofs options are \-\-quoted_path_list , Not original mkisofs options are \-\-quoted_path_list ,
\-\-hardlinks , \-\-acl , \-\-hardlinks , \-\-acl ,
\-\-xattr , \-\-md5 , \-\-stdio_sync . \-\-xattr , \-\-md5 , \-\-stdio_sync .
They work like the xorriso options with the They work like the \fBxorriso\fR options with the
same name and hardcoded argument "on", e.g. \-acl "on". same name and hardcoded argument "on", e.g. \-acl "on".
Explicit arguments are expected by \-\-stdio_sync Explicit arguments are expected by \-\-stdio_sync
and \-\-scdbackup_tag. and \-\-scdbackup_tag.
@ -3712,19 +3712,19 @@ Option \-append_partition is supported.
\-\-old\-empty is \-compliance old_empty. \-\-old\-empty is \-compliance old_empty.
.br .br
The options of genisoimage Jigdo Template Extraction are recognized and The options of genisoimage Jigdo Template Extraction are recognized and
performed via xorriso option \-jigdo. See the "Alias:" names there for the performed via \fBxorriso\fR option \-jigdo. See the "Alias:" names there for the
meaning of the genisoimage options. meaning of the genisoimage options.
.br .br
Personalities "\fBxorrisofs\fR", "\fBgenisoimage\fR", Personalities "\fBxorrisofs\fR", "\fBgenisoimage\fR",
and "\fBgenisofs\fR" are aliases for "mkisofs". and "\fBgenisofs\fR" are aliases for "mkisofs".
.br .br
If xorriso is started with one of the leafnames "xorrisofs", "genisofs", If \fBxorriso\fR is started with one of the leafnames "xorrisofs", "genisofs",
"mkisofs", or "genisoimage", then it performs \-read_mkisofsrc and prepends "mkisofs", or "genisoimage", then it performs \-read_mkisofsrc and prepends
\-as "genisofs" to the command line arguments. \-as "genisofs" to the command line arguments.
I.e. all arguments will be interpreted mkisofs style until "\-\-" I.e. all arguments will be interpreted mkisofs style until "\-\-"
is encountered. is encountered.
From then on, options are interpreted as xorriso options. From then on, options are interpreted as \fBxorriso\fR options.
.br .br
\-\-no_rc as first argument of such a program start \-\-no_rc as first argument of such a program start
prevents interpretation of startup files. See section FILES below. prevents interpretation of startup files. See section FILES below.
@ -3740,7 +3740,7 @@ write_start_address=,
track source file path or "\-" for standard input as track source. track source file path or "\-" for standard input as track source.
.br .br
It ignores most other options of cdrecord and cdrskin but refuses on It ignores most other options of cdrecord and cdrskin but refuses on
\-audio, \-scanbus, and on blanking modes unknown to xorriso. \-audio, \-scanbus, and on blanking modes unknown to \fBxorriso\fR.
.br .br
The scope is only a single data track per session to be written The scope is only a single data track per session to be written
to blank, overwriteable, or appendable media. The media gets closed if to blank, overwriteable, or appendable media. The media gets closed if
@ -3749,7 +3749,7 @@ closing is applicable and not option \-multi is present.
An eventually acquired input drive is given up. An eventually acquired input drive is given up.
This is only allowed if no image changes are pending. This is only allowed if no image changes are pending.
.br .br
dev= must be given as xorriso device address. Addresses like 0,0,0 or ATA:1,1,0 dev= must be given as \fBxorriso\fR device address. Addresses like 0,0,0 or ATA:1,1,0
are not supported. are not supported.
.br .br
If a track source is given, then an automatic \-commit happens at the end of If a track source is given, then an automatic \-commit happens at the end of
@ -3766,14 +3766,14 @@ A much more elaborate libburn based cdrecord emulator is the program cdrskin.
Personalites "\fBxorrecord\fR", "\fBwodim\fR", and "\fBcdrskin\fR" Personalites "\fBxorrecord\fR", "\fBwodim\fR", and "\fBcdrskin\fR"
are aliases for "cdrecord". are aliases for "cdrecord".
.br .br
If xorriso is started with one of the leafnames "xorrecord", "cdrskin", If \fBxorriso\fR is started with one of the leafnames "xorrecord", "cdrskin",
"cdrecord", or "wodim", then it automatically prepends \-as "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 command line arguments. I.e. all arguments will be interpreted cdrecord
style until "\-\-" is encountered and an eventual commit happens. style until "\-\-" is encountered and an eventual commit happens.
From then on, options are interpreted as xorriso options. From then on, options are interpreted as \fBxorriso\fR options.
.br .br
\-\-no_rc as first argument of such a program start \-\-no_rc as first argument of such a program start
prevents interpretation of xorriso startup files. See section FILES below. prevents interpretation of \fBxorriso\fR startup files. See section FILES below.
.TP .TP
\fB\-read_mkisofsrc\fR \fB\-read_mkisofsrc\fR
Try one by one to open for reading: Try one by one to open for reading:
@ -3828,7 +3828,7 @@ files. See section FILES below.
\fB\-options_from_file\fR fileaddress \fB\-options_from_file\fR fileaddress
Read quoted input from fileaddress and execute it like dialog lines. Read quoted input from fileaddress and execute it like dialog lines.
Empty lines and lines which begin by # are ignored. Normally one line Empty lines and lines which begin by # are ignored. Normally one line
should hold one xorriso command and all its arguments. Nevertheless lines should hold one \fBxorriso\fR command and all its arguments. Nevertheless lines
may be concatenated by a trailing backslash. may be concatenated by a trailing backslash.
.br .br
See also section "Command processing", paragraph "Quoted input". See also section "Command processing", paragraph "Quoted input".
@ -3844,7 +3844,7 @@ Print program name and version, component versions, license.
Copy textline into libreadline history. Copy textline into libreadline history.
.TP .TP
\fB\-status\fR mode|filter \fB\-status\fR mode|filter
Print the current settings of xorriso. Print the current settings of \fBxorriso\fR.
Modes: Modes:
.br .br
short... print only important or altered settings short... print only important or altered settings
@ -3960,12 +3960,12 @@ The first three items are single words, the rest of the line is the volume id.
.TP .TP
\fB\-scsi_log\fR "on"|"off" \fB\-scsi_log\fR "on"|"off"
Mode "on" enables very verbous logging of SCSI commands and drive replies. Mode "on" enables very verbous logging of SCSI commands and drive replies.
Logging messages get printed to stderr, not to any of the xorriso output Logging messages get printed to stderr, not to any of the \fBxorriso\fR output
channels. channels.
.br .br
A special property of this option is that the first \-scsi_log setting A special property of this option is that the first \-scsi_log setting
among the start arguments is in effect already when the first operations among the start arguments is in effect already when the first operations
of xorriso begin. Only "\-scsi_log" with dash "\-" is recognized that way. of \fBxorriso\fR begin. Only "\-scsi_log" with dash "\-" is recognized that way.
.TP .TP
\fB\-end\fR \fB\-end\fR
.br .br
@ -4005,8 +4005,8 @@ Copy output of a channel to the given file. Channel may be one of: "." for all
channels, "I" for info messages, "R" for result lines, "M" for \-mark texts. channels, "I" for info messages, "R" for result lines, "M" for \-mark texts.
.TP .TP
\fB\-mark\fR text \fB\-mark\fR text
If text is not empty it will get put out on "M" channel each time xorriso If text is not empty it will get put out on "M" channel each time \fBxorriso\fR
is ready for the next dialog line or before xorriso performs a command that is ready for the next dialog line or before \fBxorriso\fR performs a command that
was entered to the pager prompt. was entered to the pager prompt.
.TP .TP
\fB\-prog\fR text \fB\-prog\fR text
@ -4052,8 +4052,8 @@ Try to retrieve blocks from a damaged media
.SS .SS
.B As superuser learn about available drives .B As superuser learn about available drives
On Linux or FreeBSD consider to give rw\-permissions to those users or groups On Linux or FreeBSD consider to give rw\-permissions to those users or groups
which shall be able to use the drives with xorriso. which shall be able to use the drives with \fBxorriso\fR.
On Solaris use pfexec. Consider to restrict privileges of xorriso to On Solaris use pfexec. Consider to restrict privileges of \fBxorriso\fR to
"base,sys_devices" and to give r\-permission to user or group. "base,sys_devices" and to give r\-permission to user or group.
.br .br
$ xorriso \-devices $ xorriso \-devices
@ -4216,7 +4216,7 @@ $ xorriso \-indev /dev/sr2 \\
.B Bring a prepared ISOLINUX tree onto media and make it bootable .B Bring a prepared ISOLINUX tree onto media and make it bootable
The user has already created a suitable file tree on disk and copied the The user has already created a suitable file tree on disk and copied the
ISOLINUX files into subdirectory ./boot/isolinux of that tree. ISOLINUX files into subdirectory ./boot/isolinux of that tree.
Now xorriso can burn an El Torito bootable media: Now \fBxorriso\fR can burn an El Torito bootable media:
.br .br
$ xorriso \-outdev /dev/sr0 \-blank as_needed \\ $ xorriso \-outdev /dev/sr0 \-blank as_needed \\
.br .br
@ -4249,9 +4249,9 @@ Paths underneath /dev normally need prefix "stdio:"
$ xorriso \-dev stdio:/dev/sdb ... $ xorriso \-dev stdio:/dev/sdb ...
.br .br
If /dev/sdb is to be used frequently and /dev/sda is the system disk, If /dev/sdb is to be used frequently and /dev/sda is the system disk,
then consider to place the following lines in a xorriso Startup File. then consider to place the following lines in a \fBxorriso\fR Startup File.
They allow to use /dev/sdb without prefix and protect disk /dev/sda They allow to use /dev/sdb without prefix and protect disk /dev/sda
from xorriso: from \fBxorriso\fR:
.br .br
\-drive_class banned /dev/sda* \-drive_class banned /dev/sda*
.br .br
@ -4300,7 +4300,7 @@ of the changed content before it loads the media again.
In this case the previous session would not be loaded and the In this case the previous session would not be loaded and the
new session would contain only the newly added files. new session would contain only the newly added files.
.br .br
For the same reason do not let xorriso \-as cdrecord load the media, For the same reason do not let \fBxorriso\fR \-as cdrecord load the media,
but rather do this manually or by a program that reads from /dev/sr0. but rather do this manually or by a program that reads from /dev/sr0.
.br .br
This example works for multi\-session media only. This example works for multi\-session media only.
@ -4310,7 +4310,7 @@ in order to enable multi\-session emulation on overwriteable media.
.SS .SS
.B Let xorriso work underneath growisofs .B Let xorriso work underneath growisofs
growisofs expects an ISO formatter program which understands options \-C and growisofs expects an ISO formatter program which understands options \-C and
\-M. If xorriso gets started by name "xorrisofs" then it is suitable for that. \-M. If \fBxorriso\fR gets started by name "xorrisofs" then it is suitable for that.
.br .br
$ export MKISOFS="xorrisofs" $ export MKISOFS="xorrisofs"
.br .br
@ -4319,14 +4319,14 @@ $ growisofs \-Z /dev/dvd /some/files
$ growisofs \-M /dev/dvd /more/files $ growisofs \-M /dev/dvd /more/files
.br .br
If no "xorrisofs" is available on your system, then you will have to create If no "xorrisofs" is available on your system, then you will have to create
a link pointing to the xorriso binary and tell growisofs to use it. E.g. by: a link pointing to the \fBxorriso\fR binary and tell growisofs to use it. E.g. by:
.br .br
$ ln \-s $(which xorriso) "$HOME/xorrisofs" $ ln \-s $(which xorriso) "$HOME/xorrisofs"
.br .br
$ export MKISOFS="$HOME/xorrisofs" $ export MKISOFS="$HOME/xorrisofs"
.br .br
One may quit mkisofs emulation by argument "\-\-" and make One may quit mkisofs emulation by argument "\-\-" and make
use of all xorriso commands. growisofs dislikes options which use of all \fBxorriso\fR commands. growisofs dislikes options which
start with "\-o" but \-outdev must be set to "\-". start with "\-o" but \-outdev must be set to "\-".
So use "outdev" instead: So use "outdev" instead:
.br .br
@ -4439,8 +4439,8 @@ it is possible to access the session trees which represent the older backup
versions. With CD media, GNU/Linux mount accepts session numbers directly by versions. With CD media, GNU/Linux mount accepts session numbers directly by
its option "session=". its option "session=".
.br .br
Multi\-session media and most overwriteable media written by xorriso can tell Multi\-session media and most overwriteable media written by \fBxorriso\fR can tell
the sbsectors of their sessions by xorriso option \-toc. the sbsectors of their sessions by \fBxorriso\fR option \-toc.
Used after \-commit the following option prints the matching mount command for Used after \-commit the following option prints the matching mount command for
the newly written session (here for mount point /mnt): the newly written session (here for mount point /mnt):
.br .br
@ -4527,12 +4527,12 @@ resp. \-s.
.SS .SS
.B Program alias names: .B Program alias names:
.br .br
Normal installation of xorriso creates three links or copies which by their Normal installation of \fBxorriso\fR creates three links or copies which by their
program name pre\-select certain settings: program name pre\-select certain settings:
.br .br
\fBxorrisofs\fR starts xorriso with \-as mkisofs emulation. \fBxorrisofs\fR starts \fBxorriso\fR with \-as mkisofs emulation.
.br .br
\fBxorrecord\fR starts xorriso with \-as cdrecord emulation. \fBxorrecord\fR starts \fBxorriso\fR with \-as cdrecord emulation.
.br .br
\fBosirrox\fR starts with \-osirrox "on:o_excl_off" which allows \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 option \-mount to
@ -4540,7 +4540,7 @@ one or more of the existing ISO sessions.
.SS .SS
.B Startup files: .B Startup files:
.br .br
If not \-no_rc is given as the first argument then xorriso attempts on startup If not \-no_rc is given as the first argument then \fBxorriso\fR attempts on startup
to read and execute lines from the following files: to read and execute lines from the following files:
.br .br
/etc/default/xorriso /etc/default/xorriso
@ -4601,11 +4601,11 @@ for libburnia\-project.org
Copyright (c) 2007 \- 2011 Thomas Schmitt Copyright (c) 2007 \- 2011 Thomas Schmitt
.br .br
Permission is granted to distribute this text freely. It shall only be Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of xorriso. If you make use modified in sync with the technical properties of \fBxorriso\fR. If you make use
of the license to derive modified versions of xorriso then you are entitled of the license to derive modified versions of \fBxorriso\fR then you are entitled
to modify this text under that same license. to modify this text under that same license.
.SH CREDITS .SH CREDITS
xorriso is in part based on work by Vreixo Formoso who provides libisofs \fBxorriso\fR is in part based on work by Vreixo Formoso who provides libisofs
together with Mario Danic who also leads the libburnia team. together with Mario Danic who also leads the libburnia team.
Thanks to Andy Polyakov who invented emulated growing, Thanks to Andy Polyakov who invented emulated growing,
to Derek Foreman and Ben Jansens who once founded libburn. to Derek Foreman and Ben Jansens who once founded libburn.

File diff suppressed because it is too large Load Diff

View File

@ -27,6 +27,7 @@
@c "@item word words" becomes "\fBword\fR words". @c "@item word words" becomes "\fBword\fR words".
@c @strong{-...} gets mapped to \fB\-...\fR . @c @strong{-...} gets mapped to \fB\-...\fR .
@c @strong{...} gets mapped to \fB...\fR . @c @strong{...} gets mapped to \fB...\fR .
@c @command{...} gets mapped to \fB...\fR .
@c @minus{} will become "-". @c @minus{} will become "-".
@c @@ , @{, @} will get stripped of their first @. @c @@ , @{, @} will get stripped of their first @.
@c Other lines which begin by "@" will be discarded. @c Other lines which begin by "@" will be discarded.
@ -114,17 +115,17 @@ with Rock Ridge extensions.
@c man .br @c man .br
@c man .SH DESCRIPTION @c man .SH DESCRIPTION
@c man .PP @c man .PP
@strong{xorriso} @command{xorriso}
is a program which copies file objects from POSIX compliant is a program which copies file objects from POSIX compliant
filesystems into Rock Ridge enhanced ISO 9660 filesystems and allows filesystems into Rock Ridge enhanced ISO 9660 filesystems and allows
session-wise manipulation of such filesystems. It can load the management session-wise manipulation of such filesystems. It can load the management
information of existing ISO images and it writes the session results to information of existing ISO images and it writes the session results to
optical media or to filesystem objects. optical media or to filesystem objects.
@* @*
Vice versa xorriso is able to copy file objects out of ISO 9660 filesystems. Vice versa @command{xorriso} is able to copy file objects out of ISO 9660 filesystems.
@c man .PP @c man .PP
@sp 1 @sp 1
A special property of xorriso is that it needs neither an external ISO 9660 A special property of @command{xorriso} is that it needs neither an external ISO 9660
formatter program nor an external burn program for CD, DVD or BD but rather formatter program nor an external burn program for CD, DVD or BD but rather
incorporates the libraries of libburnia-project.org . incorporates the libraries of libburnia-project.org .
@c man .SS @c man .SS
@ -229,17 +230,17 @@ functionality to overwriteable media or disk files which carry valid ISO 9660
filesystems. filesystems.
@c man .PP @c man .PP
@sp 1 @sp 1
xorriso provides growing as well as an own method named @command{xorriso} provides growing as well as an own method named
@strong{modifying} which produces a completely new ISO image from the old @strong{modifying} which produces a completely new ISO image from the old
one and the modifications. one and the modifications.
See paragraph Creating, Growing, Modifying, Blind Growing below. See paragraph Creating, Growing, Modifying, Blind Growing below.
@c man .PP @c man .PP
@sp 1 @sp 1
xorriso adopts the concept of multi-session by loading an eventual image @command{xorriso} adopts the concept of multi-session by loading an eventual image
directory tree, allowing to manipulate it by several actions, and to write directory tree, allowing to manipulate it by several actions, and to write
the new image to the target media. the new image to the target media.
@c man .br @c man .br
The first session of a xorriso run begins by the definition of the input The first session of a @command{xorriso} run begins by the definition of the input
drive with the eventual ISO image or by the definition of an output drive. drive with the eventual ISO image or by the definition of an output drive.
The session ends by command -commit which triggers writing. A -commit is The session ends by command -commit which triggers writing. A -commit is
done automatically when the program ends regularly. done automatically when the program ends regularly.
@ -268,13 +269,13 @@ describes their existing sessions. See option @strong{-toc}.
@* @*
Similar to multi-session media are DVD-R DL and minimally blanked DVD-RW. 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. They allow only a single session of which the size must be known in advance.
xorriso will write onto them only if option -close is set to "on". @command{xorriso} will write onto them only if option -close is set to "on".
@* @*
@cindex Overwriteable media, _definition @cindex Overwriteable media, _definition
@strong{Overwriteable media} are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW. @strong{Overwriteable media} are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW.
They allow random write access but do not provide information about their They allow random write access but do not provide information about their
session history. If they contain one or more ISO 9660 sessions and if the session history. If they contain one or more ISO 9660 sessions and if the
first session was written by xorriso, then a table of content can first session was written by @command{xorriso}, then a table of content can
be emulated. Else only a single overall session will be visible. be emulated. Else only a single overall session will be visible.
@* @*
DVD-RW media can be formatted by -format "full". DVD-RW media can be formatted by -format "full".
@ -290,12 +291,12 @@ capabilities.
@sp 1 @sp 1
@cindex Blank media, _definition @cindex Blank media, _definition
@strong{Blank} media can be written from scratch. They contain no ISO image @strong{Blank} media can be written from scratch. They contain no ISO image
suitable for xorriso. suitable for @command{xorriso}.
@* @*
Blank is the state of newly purchased optical media. Blank is the state of newly purchased optical media.
With used CD-RW and DVD-RW it can be achieved by action -blank "as_needed". With used CD-RW and DVD-RW it can be achieved by action -blank "as_needed".
Overwriteable media are considered blank if they are new or if they have Overwriteable media are considered blank if they are new or if they have
been marked as blank by xorriso. been marked as blank by @command{xorriso}.
Action -blank "as_needed" can be used to do this marking on overwriteable Action -blank "as_needed" can be used to do this marking on overwriteable
media, or to apply eventual mandatory formatting to new media. media, or to apply eventual mandatory formatting to new media.
@* @*
@ -303,14 +304,14 @@ media, or to apply eventual mandatory formatting to new media.
@cindex Appendable media, _definition @cindex Appendable media, _definition
@strong{Appendable} media accept further sessions. Either they are MMC @strong{Appendable} media accept further sessions. Either they are MMC
multi-session media in appendable state, or they are overwriteable media multi-session media in appendable state, or they are overwriteable media
which contain an ISO image suitable for xorriso. 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 option -close off.
@* @*
@sp 1 @sp 1
@cindex Closed media, _definition @cindex Closed media, _definition
@strong{Closed} media cannot be written. They may contain an ISO image suitable @strong{Closed} media cannot be written. They may contain an ISO image suitable
for xorriso. for @command{xorriso}.
@* @*
Closed is the state of DVD-ROM media and of multi-session media which were 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 option -close on. If the drive is read-only hardware then it will
@ -380,7 +381,7 @@ to the given block address. This is the usage model of
mkisofs -M $indev -C $msc1,$msc2 -o $outdev mkisofs -M $indev -C $msc1,$msc2 -o $outdev
@* @*
which gives much room for wrong parameter combinations and should thus only be which gives much room for wrong parameter combinations and should thus only be
employed if a strict distinction between ISO formatter xorriso and the burn employed if a strict distinction between ISO formatter @command{xorriso} and the burn
program is desired. -C $msc1,$msc2 is equivalent to: program is desired. -C $msc1,$msc2 is equivalent to:
@* @*
-load sbsector $msc1 -grow_blindly $msc2 -load sbsector $msc1 -grow_blindly $msc2
@ -399,7 +400,7 @@ Output drive, i.e. target for writing, can be any libburn drive.
Some drive types do not support the method of growing but only the methods Some drive types do not support the method of growing but only the methods
of modifying and blind growing. They all are suitable for newly created images. of modifying and blind growing. They all are suitable for newly created images.
@* @*
All drive file objects have to offer rw-permission to the user of xorriso. All drive file objects have to offer rw-permission to the user of @command{xorriso}.
Even those which will not be useable for reading an ISO image. Even those which will not be useable for reading an ISO image.
@c man .PP @c man .PP
@sp 1 @sp 1
@ -493,12 +494,12 @@ is the name of a set of additional information which enhance
an ISO 9660 filesystem so that it can represent a POSIX compliant filesystem an ISO 9660 filesystem so that it can represent a POSIX compliant filesystem
with ownership, access permissions, symbolic links, and other attributes. with ownership, access permissions, symbolic links, and other attributes.
@* @*
This is what xorriso uses for a decent representation of the disk files This is what @command{xorriso} uses for a decent representation of the disk files
within the ISO image. Rock Ridge information is produced with any xorriso within the ISO image. Rock Ridge information is produced with any @command{xorriso}
image. image.
@c man .PP @c man .PP
@sp 1 @sp 1
xorriso is not named "porriso" because POSIX only guarantees 14 characters @command{xorriso} is not named "porriso" because POSIX only guarantees 14 characters
of filename length. It is the X/Open System Interface standard XSI which of filename length. It is the X/Open System Interface standard XSI which
demands a file name length of up to 255 characters and paths of up to 1024 demands a file name length of up to 255 characters and paths of up to 1024
characters. Rock Ridge fulfills this demand. characters. Rock Ridge fulfills this demand.
@ -511,7 +512,7 @@ images, which are binary program files stored in the ISO image.
The content of the boot image files is not in the scope of El Torito. 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. Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images.
xorriso is able to create or maintain an El Torito object which makes such @command{xorriso} is able to create or maintain an El Torito object which makes such
an image bootable. For details see option -boot_image. an image bootable. For details see option -boot_image.
@* @*
@cindex MBR, _definiton @cindex MBR, _definiton
@ -542,27 +543,27 @@ It uses this extension if enabled by option
@* @*
AAIP enhanced images are supposed to be mountable normally, but one cannot AAIP enhanced images are supposed to be mountable normally, but one cannot
expect that the mounted filesystem will show and respect the eventual ACLs. expect that the mounted filesystem will show and respect the eventual ACLs.
For now, only xorriso is able to retrieve those ACLs. It can bring them into For now, only @command{xorriso} is able to retrieve those ACLs. It can bring them into
effect when files get restored to an ACL enabled file system or it can effect when files get restored to an ACL enabled file system or it can
print them in a format suitable for tool setfacl. print them in a format suitable for tool setfacl.
@* @*
Files with ACL show as group permissions the setting of entry "mask::" if Files with ACL show as group permissions the setting of entry "mask::" if
that entry exists. Nevertheless the non-listed group members get handled that entry exists. Nevertheless the non-listed group members get handled
according to entry "group::". xorriso brings "group::" into effect before according to entry "group::". @command{xorriso} brings "group::" into effect before
eventually removing the ACL from a file. eventually removing the ACL from a file.
@c man .PP @c man .PP
@sp 1 @sp 1
@cindex xattr, _definiton @cindex xattr, _definiton
@strong{xattr} (aka EA) @strong{xattr} (aka EA)
are pairs of name and value which can be attached to file objects. AAIP is are pairs of name and value which can be attached to file objects. AAIP is
able to represent them and xorriso allows to record and restore pairs which able to represent them and @command{xorriso} allows to record and restore pairs which
have names out of the user namespace. I.e. those which begin with "user.", 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. 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. 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 option
@strong{-xattr}. @strong{-xattr}.
@* @*
As with ACL, currently only xorriso is able to retrieve xattr from AAIP As with ACL, currently only @command{xorriso} is able to retrieve xattr from AAIP
enhanced images, to restore them to xattr capable file systems, or to print enhanced images, to restore them to xattr capable file systems, or to print
them. them.
@c man .SS @c man .SS
@ -615,9 +616,9 @@ Command and parameter words are either read from program arguments, where one
argument is one word, or from quoted input lines where words are recognized argument is one word, or from quoted input lines where words are recognized
similar to the quotation rules of a shell parser. similar to the quotation rules of a shell parser.
@* @*
xorriso is not a shell, although it might appear so on first glimpse. @command{xorriso} is not a shell, although it might appear so on first glimpse.
Be aware that the interaction of quotation marks and pattern symbols like "*" Be aware that the interaction of quotation marks and pattern symbols like "*"
differs from the usual shell parsers. In xorriso, a quotation mark does not differs from the usual shell parsers. In @command{xorriso}, a quotation mark does not
make a pattern symbol literal. make a pattern symbol literal.
@c man .PP @c man .PP
@sp 1 @sp 1
@ -661,8 +662,8 @@ to make dialog more comfortable.
@c man .PP @c man .PP
@sp 1 @sp 1
Readline is an enhancement for the input line. You may know it already from Readline is an enhancement for the input line. You may know it already from
the bash shell. Whether it is available in xorriso depends on the availability the bash shell. Whether it is available in @command{xorriso} depends on the availability
of package readline-dev at the time when xorriso was built from its sourcecode. of package readline-dev at the time when @command{xorriso} was built from its sourcecode.
@* @*
It allows to move the cursor over the text in the line by help of the It allows to move the cursor over the text in the line by help of the
Leftward and the Rightward arrow key. Leftward and the Rightward arrow key.
@ -680,7 +681,7 @@ Option -page activates a built-in result text pager which may be convenient in
dialog. After an action has put out the given number of terminal lines, dialog. After an action has put out the given number of terminal lines,
the pager prompts the user for a line of input. the pager prompts the user for a line of input.
@* @*
An empty line lets xorriso resume work until the next page is put out. An empty line lets @command{xorriso} resume work until the next page is put out.
@* @*
The single character "@@" disables paging for the current action. The single character "@@" disables paging for the current action.
@* @*
@ -793,7 +794,7 @@ predicted_nwa is the block address where the add-on session of blind
growing will finally end up. It is the responsibility of the user to ensure growing will finally end up. It is the responsibility of the user to ensure
this final position and the presence of the older sessions. Else the this final position and the presence of the older sessions. Else the
overall ISO image will not be mountable or will produce read errors when overall ISO image will not be mountable or will produce read errors when
accessing file content. xorriso will write the session to the address accessing file content. @command{xorriso} will write the session to the address
as obtained from examining -outdev and not necessarily to predicted_nwa. as obtained from examining -outdev and not necessarily to predicted_nwa.
@* @*
During a run of blind growing, the input drive is given up before output During a run of blind growing, the input drive is given up before output
@ -872,7 +873,7 @@ accepted. If it is not a MMC device then the prefix "stdio:" will be prepended
automatically. This list is empty by default. automatically. This list is empty by default.
@* @*
Else if the path matches the "banned" list then the drive will not be Else if the path matches the "banned" list then the drive will not be
accepted by xorriso but rather lead to a FAILURE event. This list is empty by accepted by @command{xorriso} but rather lead to a FAILURE event. This list is empty by
default. default.
@* @*
Else if the path matches the "caution" list and if it is not a MMC device, Else if the path matches the "caution" list and if it is not a MMC device,
@ -891,7 +892,7 @@ By pseudo-class "clear_list" and pseudo-patterns "banned", "caution",
@* @*
E.g.: -drive_class clear_list banned E.g.: -drive_class clear_list banned
@* @*
One will normally define the -drive_class lists in one of the xorriso One will normally define the -drive_class lists in one of the @command{xorriso}
Startup Files. Startup Files.
@* @*
Note: This is not a security feature but rather a bumper for the superuser to Note: This is not a security feature but rather a bumper for the superuser to
@ -927,7 +928,7 @@ an eventual recorded character set name gets used as input character set
when reading an image. when reading an image.
@* @*
Note that the default output charset is the local character set of the Note that the default output charset is the local character set of the
terminal where xorriso runs. Before attributing this local character set terminal where @command{xorriso} runs. Before attributing this local character set
to the produced ISO image, check whether the terminal properly displays to the produced ISO image, check whether the terminal properly displays
all intended filenames, especially exotic national characters. all intended filenames, especially exotic national characters.
@c man .TP @c man .TP
@ -956,7 +957,7 @@ e.g. if you need to apply filters to all updated files.
Mode "without_update" avoids hardlink processing during update commands. Mode "without_update" avoids hardlink processing during update commands.
Use this if your filesystem situation does not allow -disk_dev_ino "on". Use this if your filesystem situation does not allow -disk_dev_ino "on".
@* @*
xorriso commands which extract files from an ISO image try to hardlink files @command{xorriso} commands which extract files from an ISO image try to hardlink files
with identical inode number. The normal scope of this operation is from with identical inode number. The normal scope of this operation is from
image load to image load. One may give up the accumulated hard link addresses image load to image load. One may give up the accumulated hard link addresses
by -hardlinks "discard_extract". by -hardlinks "discard_extract".
@ -972,7 +973,7 @@ wide and expensive hardlink accumulation.
@kindex -acl controls handling of ACLs @kindex -acl controls handling of ACLs
@cindex ACL, control handling, -acl @cindex ACL, control handling, -acl
Enable or disable processing of ACLs. Enable or disable processing of ACLs.
If enabled, then xorriso will obtain ACLs from disk file objects, If enabled, then @command{xorriso} will obtain ACLs from disk file objects,
store ACLs in the ISO image using the libisofs specific AAIP format, store ACLs in the ISO image using the libisofs specific AAIP format,
load AAIP data from ISO images, test ACL during file comparison, load AAIP data from ISO images, test ACL during file comparison,
and restore ACLs to disk files when extracting them from ISO images. and restore ACLs to disk files when extracting them from ISO images.
@ -982,7 +983,7 @@ See also options -getfacl, -setfacl.
@kindex -xattr controls handling of xattr (EA) @kindex -xattr controls handling of xattr (EA)
@cindex xattr, control handling, -xattr @cindex xattr, control handling, -xattr
Enable or disable processing of xattr attributes in user namespace. Enable or disable processing of xattr attributes in user namespace.
If enabled, then xorriso will handle xattr similar to ACL. If enabled, then @command{xorriso} will handle xattr similar to ACL.
See also options -getfattr, -setfattr and above paragraph about xattr. See also options -getfattr, -setfattr and above paragraph about xattr.
@c man .TP @c man .TP
@item -md5 "on"|"all"|"off"|"load_check_off" @item -md5 "on"|"all"|"off"|"load_check_off"
@ -1012,7 +1013,7 @@ Mode "load_check_off" together with "on" or "all" will load recorded MD5 sums
but not test the recorded checksum tags of superblock and directory tree. but not test the recorded checksum tags of superblock and directory tree.
This is necessary if growisofs was used as burn program, because it does This is necessary if growisofs was used as burn program, because it does
not overwrite the superblock checksum tag of the first session. not overwrite the superblock checksum tag of the first session.
Therefore load_check_off is in effect when xorriso -as mkisofs option -M Therefore load_check_off is in effect when @command{xorriso} -as mkisofs option -M
is performed. is performed.
@* @*
The test can be re-enabled by mode "load_check_on". The test can be re-enabled by mode "load_check_on".
@ -1068,7 +1069,7 @@ to invalid addresses and thus ugly drive behavior.
Setting "on" enables that scan for alleged read-only media. Setting "on" enables that scan for alleged read-only media.
@* @*
Some operating systems are not able to mount the most recent session of Some operating systems are not able to mount the most recent session of
multi-session DVD or BD. If on such a system xorriso has no own MMC multi-session DVD or BD. If on such a system @command{xorriso} has no own MMC
capabilities then it may still find that session from a scanned table of capabilities then it may still find that session from a scanned table of
content. Setting "force" handles any media like a ROM media with setting "on". content. Setting "force" handles any media like a ROM media with setting "on".
@* @*
@ -1379,7 +1380,7 @@ arguments.
@cindex Insert, limit data file size, -file_size_limit @cindex Insert, limit data file size, -file_size_limit
Set the maximum permissible size for a single data file. The values get Set the maximum permissible size for a single data file. The values get
summed up for the actual limit. If the only value is "off" then the file summed up for the actual limit. If the only value is "off" then the file
size is not limited by xorriso. Default is a limit of 100 extents, 4g -2k each: size is not limited by @command{xorriso}. Default is a limit of 100 extents, 4g -2k each:
@* @*
-file_size_limit 400g -200k @minus{}@minus{} -file_size_limit 400g -200k @minus{}@minus{}
@* @*
@ -1388,7 +1389,7 @@ up to 2g -1 @minus{}@minus{}. Newer ones are good up to 4g -1 @minus{}@minus{}.
You need quite a new Linux kernel to read correctly the final bytes You need quite a new Linux kernel to read correctly the final bytes
of a file >= 4g if its size is not aligned to 2048 byte blocks. of a file >= 4g if its size is not aligned to 2048 byte blocks.
@* @*
xorriso's own data read capabilities are not affected by eventual @command{xorriso}'s own data read capabilities are not affected by eventual
operating system size limits. They apply to mounting only. Nevertheless, operating system size limits. They apply to mounting only. Nevertheless,
the target filesystem of an -extract must be able to take the file size. the target filesystem of an -extract must be able to take the file size.
@c man .TP @c man .TP
@ -1525,7 +1526,7 @@ an intentional sequence of link hops.
@item -pathspecs "on"|"off" @item -pathspecs "on"|"off"
@kindex -pathspecs sets meaning of = with -add @kindex -pathspecs sets meaning of = with -add
@cindex Insert, meaning of = with -add, -pathspecs @cindex Insert, meaning of = with -add, -pathspecs
Control parameter interpretation with xorriso actions -add and -path_list. Control parameter interpretation with @command{xorriso} actions -add and -path_list.
@* @*
@cindex Pathspec, _definition @cindex Pathspec, _definition
"on" enables pathspecs of the form "on" enables pathspecs of the form
@ -1758,7 +1759,7 @@ be an empty text.
Only names from the user namespace are allowed. I.e. a name has to begin with Only names from the user namespace are allowed. I.e. a name has to begin with
"user.", like "user.x" or "user.whatever". "user.", like "user.x" or "user.whatever".
@* @*
Values and names undergo the normal input processing of xorriso. Values and names undergo the normal input processing of @command{xorriso}.
See also option -backslash_codes. Other than with option -setfattr_list, See also option -backslash_codes. Other than with option -setfattr_list,
the byte value 0 cannot be expressed via -setfattr. the byte value 0 cannot be expressed via -setfattr.
@c man .TP @c man .TP
@ -1819,7 +1820,7 @@ Absolute seconds counted from Jan 1 1970:
@* @*
=Number =Number
@* @*
xorriso's own timestamps: @command{xorriso}'s own timestamps:
@* @*
YYYY.MM.DD[.hh[mm[ss]]] YYYY.MM.DD[.hh[mm[ss]]]
@* @*
@ -1994,7 +1995,7 @@ If -else is missing and would be hit, then the result is a non-match.
Default action is @strong{echo}, Default action is @strong{echo},
i.e. to print the address of the found file. Other actions are certain i.e. to print the address of the found file. Other actions are certain
xorriso commands which get performed on the found files. These commands @command{xorriso} commands which get performed on the found files. These commands
may have specific parameters. See also their particular descriptions. may have specific parameters. See also their particular descriptions.
@c man .br @c man .br
@table @asis @table @asis
@ -2244,8 +2245,8 @@ is not applied to any file in the ISO image.
Irrevocably ban commands -external_filter and -unregister_filter, Irrevocably ban commands -external_filter and -unregister_filter,
but not -set_filter. Use this to prevent external filtering in general or but not -set_filter. Use this to prevent external filtering in general or
when all intended filters are registered. when all intended filters are registered.
External filters may also be banned totally at compile time of xorriso. External filters may also be banned totally at compile time of @command{xorriso}.
By default they are banned if xorriso runs under setuid permission. By default they are banned if @command{xorriso} runs under setuid permission.
@c man .TP @c man .TP
@item -set_filter name iso_rr_path [***] @item -set_filter name iso_rr_path [***]
@kindex -set_filter applies filter to file @kindex -set_filter applies filter to file
@ -2318,7 +2319,7 @@ Writing can last quite a while. It is not unnormal with several
types of media that there is no progress visible for the first types of media that there is no progress visible for the first
few minutes or that the drive gnaws on the media for a few few minutes or that the drive gnaws on the media for a few
minutes after all data have been transmitted. minutes after all data have been transmitted.
xorriso and the drives are in a client-server relationship. @command{xorriso} and the drives are in a client-server relationship.
The drives have much freedom about what to do with the media. The drives have much freedom about what to do with the media.
Some combinations of drives and media simply do not work, Some combinations of drives and media simply do not work,
despite the promises by their vendors. despite the promises by their vendors.
@ -2364,7 +2365,7 @@ overwriteable ISO images. "all" might work more thoroughly and need more time.
@* @*
"deformat_quickest" is a faster way to deformat or blank DVD-RW "deformat_quickest" is a faster way to deformat or blank DVD-RW
but produces media which are only suitable for a single session. but produces media which are only suitable for a single session.
xorriso will write onto them only if option -close is set to "on". @command{xorriso} will write onto them only if option -close is set to "on".
@* @*
The progress reports issued by some drives while blanking are The progress reports issued by some drives while blanking are
quite unrealistic. Do not conclude success or failure from the quite unrealistic. Do not conclude success or failure from the
@ -2557,7 +2558,7 @@ which get visible if the reader ignores Rock Ridge.
@item -volid text @item -volid text
@kindex -volid sets volume id @kindex -volid sets volume id
@cindex Image, set volume id, -volid @cindex Image, set volume id, -volid
Specify the volume ID. xorriso accepts any text up to 32 characters, Specify the volume ID. @command{xorriso} accepts any text up to 32 characters,
but according to rarely obeyed specs stricter rules apply: but according to rarely obeyed specs stricter rules apply:
@* @*
ECMA 119 demands ASCII characters out of [A-Z0-9_]. Like: "IMAGE_23" ECMA 119 demands ASCII characters out of [A-Z0-9_]. Like: "IMAGE_23"
@ -2599,7 +2600,7 @@ identify the specification of how the data are recorded.
Permissible are up to 128 characters. This setting gets overridden by Permissible are up to 128 characters. This setting gets overridden by
image loading. image loading.
@* @*
The special text "@@xorriso@@" gets converted to the id string of xorriso 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 which is normally written as -preparer_id. It is a wrong tradition to write
the program id as -application_id. the program id as -application_id.
@c man .TP @c man .TP
@ -2673,11 +2674,11 @@ image loading.
@cindex Image, set preparer id, -preparer_id @cindex Image, set preparer id, -preparer_id
Set the preparer id string to be written with the next -commit. This may Set the preparer id string to be written with the next -commit. This may
identify the person or other entity which controls the preparation of the data identify the person or other entity which controls the preparation of the data
which shall be recorded. Normally this should be the id of xorriso and not which shall be recorded. Normally this should be the id of @command{xorriso} and not
of the person or program which operates xorriso. Please avoid to change it. of the person or program which operates @command{xorriso}. Please avoid to change it.
Permissible are up to 128 characters. Permissible are up to 128 characters.
@* @*
The special text "@@xorriso@@" gets converted to the id string of xorriso The special text "@@xorriso@@" gets converted to the id string of @command{xorriso}
which is default at program startup. 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.
@ -2804,7 +2805,7 @@ Append the given number of extra bytes to the image stream.
This is a traditional remedy for a traditional bug in block This is a traditional remedy for a traditional bug in block
device read drivers. Needed only for CD recordings in TAO mode. device read drivers. Needed only for CD recordings in TAO mode.
Since one can hardly predict on what media an image might end up, Since one can hardly predict on what media an image might end up,
xorriso adds the traditional 300k of padding by default to all images. @command{xorriso} adds the traditional 300k of padding by default to all images.
@* @*
For images which will never get to a CD it is safe to use -padding 0 . For images which will never get to a CD it is safe to use -padding 0 .
@* @*
@ -3097,7 +3098,7 @@ Partitions may be appended with boot block type MBR and with SUN Disk Label.
With MBR: With MBR:
@* @*
partition_number may be 1 to 4. Number 1 will put the whole ISO image into partition_number may be 1 to 4. Number 1 will put the whole ISO image into
the unclaimed space before partition 1. So together with most xorriso MBR the unclaimed space before partition 1. So together with most @command{xorriso} MBR
features, number 2 would be the most natural choice. features, number 2 would be the most natural choice.
@* @*
The type_code may be "FAT12", "FAT16", "Linux", The type_code may be "FAT12", "FAT16", "Linux",
@ -3130,13 +3131,13 @@ DVD images; see http://atterer.net/jigdo/ for more details. Debian CDs
and DVD ISO images are published on the web in jigdo format to allow and DVD ISO images are published on the web in jigdo format to allow
end users to download them more efficiently." end users to download them more efficiently."
@* @*
xorriso can produce a .jigdo and a .template file together with a @command{xorriso} can produce a .jigdo and a .template file together with a
single-session ISO image. single-session ISO image.
The .jigdo file contains checksums and symbolic file addresses. The .jigdo file contains checksums and symbolic file addresses.
The .template file contains the compressed ISO image with reference tags The .template file contains the compressed ISO image with reference tags
instead of the content bytes of the listed files. instead of the content bytes of the listed files.
@* @*
Input for this process are the normal arguments for a xorriso session Input for this process are the normal arguments for a @command{xorriso} session
on a blank -outdev, and a .md5 file which lists those data files which may be on a blank -outdev, and a .md5 file which lists those data files which may be
listed in the .jigdo file and externally referenced in the .template file. listed in the .jigdo file and externally referenced in the .template file.
Each designated file is represented in the .md5 file by a single text line: Each designated file is represented in the .md5 file by a single text line:
@ -3151,7 +3152,7 @@ After eventual To=From mapping, the file address gets written into the .jigdo
file. Jigdo restore tools will convert these addresses into really file. Jigdo restore tools will convert these addresses into really
reachable data source addresses from which they can read. reachable data source addresses from which they can read.
@* @*
If the list of jigdo parameters is not empty, then xorriso will refuse to If the list of jigdo parameters is not empty, then @command{xorriso} will refuse to
write to non-blank targets, it will disable multi-session emulation, and write to non-blank targets, it will disable multi-session emulation, and
eventual padding will be counted as part of the ISO image. eventual padding will be counted as part of the ISO image.
@* @*
@ -3240,7 +3241,7 @@ names. Shell command iconv -l lists them.
Character sets should not matter as long as only english alphanumeric Character sets should not matter as long as only english alphanumeric
characters are used for file names or as long as all writers and readers characters are used for file names or as long as all writers and readers
of the media use the same character set. of the media use the same character set.
Outside these constraints it may be necessary to let xorriso convert byte Outside these constraints it may be necessary to let @command{xorriso} convert byte
codes. codes.
@* @*
There is an input conversion from input character set to the local character There is an input conversion from input character set to the local character
@ -3249,14 +3250,14 @@ 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 options
-in_charset and -out_charset. Normally one will have both identical, if ever. -in_charset and -out_charset. Normally one will have both identical, if ever.
@* @*
If conversions are desired then xorriso needs to know the name of the If conversions are desired then @command{xorriso} needs to know the name of the
local character set. xorriso can inquire the same info as shell command local character set. @command{xorriso} can inquire the same info as shell command
"locale" with argument "charmap". This may be influenced by environment "locale" with argument "charmap". This may be influenced by environment
variables LC_ALL, LC_CTYPE, or LANG and should match the expectations of variables LC_ALL, LC_CTYPE, or LANG and should match the expectations of
the terminal. the terminal.
@* @*
The default output charset is the local character set of the terminal where The default output charset is the local character set of the terminal where
xorriso runs. So by default no conversion happens between local filesystem @command{xorriso} runs. So by default no conversion happens between local filesystem
names and emerging names in the image. The situation stays ambigous and the names and emerging names in the image. The situation stays ambigous and the
reader has to riddle what character set was used. reader has to riddle what character set was used.
@* @*
@ -3292,8 +3293,8 @@ If this appears necessary, one should consider to set -backslash_codes to
@node Exception, DialogCtl, Charset, Options @node Exception, DialogCtl, Charset, Options
@section Exception processing @section Exception processing
@c man .PP @c man .PP
Since the tasks of xorriso are manifold and prone to external influence, there Since the tasks of @command{xorriso} are manifold and prone to external influence, there
may arise the need for xorriso to report and handle problem events. may arise the need for @command{xorriso} to report and handle problem events.
@* @*
Those events get classified when they are detected by one of the software Those events get classified when they are detected by one of the software
modules and forwarded to reporting and evaluation modules which decide about modules and forwarded to reporting and evaluation modules which decide about
@ -3339,26 +3340,26 @@ be ignorable.
@* @*
A special property of this option is that it works preemptive if given as A special property of this option is that it works preemptive if given as
program start argument. I.e. the first -abort_on setting among the program start argument. I.e. the first -abort_on setting among the
start arguments is in effect already when the first operations of xorriso start arguments is in effect already when the first operations of @command{xorriso}
begin. Only "-abort_on" with dash "-" is recognized that way. begin. Only "-abort_on" with dash "-" is recognized that way.
@c man .TP @c man .TP
@item -return_with severity exit_value @item -return_with severity exit_value
@kindex -return_with controls exit value @kindex -return_with controls exit value
@cindex Process, control exit value, -return_with @cindex Process, control exit value, -return_with
Set the threshold and exit_value to be returned at program end if no abort Set the threshold and exit_value to be returned at program end if no abort
has happened. This is to allow xorriso to go on after problems but to get has happened. This is to allow @command{xorriso} to go on after problems but to get
a failure indicating exit value from the program, nevertheless. a failure indicating exit value from the program, nevertheless.
Useful is a value lower than the -abort_on threshold, down to "WARNING". Useful is a value lower than the -abort_on threshold, down to "WARNING".
@* @*
exit_value may be either 0 (indicating success to the starter of the program) exit_value may be either 0 (indicating success to the starter of the program)
or a number between 32 and 63. Some other exit_values are used by xorriso if or a number between 32 and 63. Some other exit_values are used by @command{xorriso} if
it decides to abort the program run: it decides to abort the program run:
@* @*
1=abort due to external signal 1=abort due to external signal
@* @*
2=no program arguments given 2=no program arguments given
@* @*
3=creation of xorriso main object failed 3=creation of @command{xorriso} main object failed
@* @*
4=failure to start libburnia-project.org libraries 4=failure to start libburnia-project.org libraries
@* @*
@ -3382,7 +3383,7 @@ Info messages which belong to no event get attributed severity "NOTE".
@* @*
A special property of this option is that the first -report_about setting A special property of this option is that the first -report_about setting
among the start arguments is in effect already when the first operations among the start arguments is in effect already when the first operations
of xorriso begin. Only "-report_about" with dash "-" is recognized that way. of @command{xorriso} begin. Only "-report_about" with dash "-" is recognized that way.
@c man .TP @c man .TP
@item -signal_handling mode @item -signal_handling mode
@kindex -signal_handling controls handling of system signals @kindex -signal_handling controls handling of system signals
@ -3393,10 +3394,10 @@ caused by severe program errors.
@* @*
Mode "on" is the default. It uses the signal handler of libburn which produces Mode "on" is the default. It uses the signal handler of libburn which produces
ugly messages but puts much effort in releasing eventually used optical drives ugly messages but puts much effort in releasing eventually used optical drives
before xorriso ends. before @command{xorriso} ends.
@* @*
Mode "off" as first -signal_handling among the start arguments prevents all Mode "off" as first -signal_handling among the start arguments prevents all
own signal precautions of xorriso. Eventually inherited signal handler settings own signal precautions of @command{xorriso}. Eventually inherited signal handler settings
stay as they are. stay as they are.
@* @*
It works like "sig_dfl" if given after other signal handling was already It works like "sig_dfl" if given after other signal handling was already
@ -3407,14 +3408,14 @@ normally a sudden abort of the program. To prevent stuck drives, the
libburn handler is used during burning, blanking, and formatting on MMC drives. libburn handler is used during burning, blanking, and formatting on MMC drives.
@* @*
Mode "sig_ign" tries to ignore as many signal types as possible. This imposes Mode "sig_ign" tries to ignore as many signal types as possible. This imposes
the risk that xorriso refuses to end until externally kill -9 if performed. the risk that @command{xorriso} refuses to end until externally kill -9 if performed.
kill -9 then imposes the risk that the drive is left in unusable state and 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 needs poweroff to be reset. So during burning, blanking, and formatting
wait for at least their normal run time before killing externally. wait for at least their normal run time before killing externally.
@* @*
A special property of this option is that the first -signal_handling setting A special property of this option is that the first -signal_handling setting
among the start arguments is in effect already when the first operations among the start arguments is in effect already when the first operations
of xorriso begin. Only "-signal_handling" with dash "-" is recognized that way. of @command{xorriso} begin. Only "-signal_handling" with dash "-" is recognized that way.
@c man .TP @c man .TP
@item -error_behavior occasion behavior @item -error_behavior occasion behavior
@kindex -error_behavior controls error workarounds @kindex -error_behavior controls error workarounds
@ -3550,7 +3551,7 @@ not the ISO image directory tree.
@* @*
In case of overwriteable media holding a valid ISO image, it may happen that In case of overwriteable media holding a valid ISO image, it may happen that
only a single session gets shown. But if the first session on the only a single session gets shown. But if the first session on the
overwriteable media was written by xorriso then a complete overwriteable media was written by @command{xorriso} then a complete
session history can be emulated. session history can be emulated.
@* @*
A drive which is incapable of writing may show any media as CD-ROM or DVD-ROM A drive which is incapable of writing may show any media as CD-ROM or DVD-ROM
@ -3586,7 +3587,7 @@ for direct execution of this command.
@cindex Session, mount parameters, -mount_opts @cindex Session, mount parameters, -mount_opts
Set options which influence -mount and -mount_cmd. Currently there is only Set options which influence -mount and -mount_cmd. Currently there is only
option "exclusive" which is default and its counterpart "shared". The latter option "exclusive" which is default and its counterpart "shared". The latter
causes xorriso not to give up the affected drive with command -mount. causes @command{xorriso} not to give up the affected drive with command -mount.
On GNU/Linux it adds mount option "loop" which may allow to mount several On GNU/Linux it adds mount option "loop" which may allow to mount several
sessions of the same block device at the same time. One should not write sessions of the same block device at the same time. One should not write
to a mounted optical media, of course. Take care to umount all sessions to a mounted optical media, of course. Take care to umount all sessions
@ -3601,7 +3602,7 @@ format and the parameters of the addressed session.
Formats "linux:"path or "freebsd:"path produce the output of -mount_cmd Formats "linux:"path or "freebsd:"path produce the output of -mount_cmd
for the given operating systems. for the given operating systems.
@* @*
In other texts xorriso will substitute the following parameter names. In other texts @command{xorriso} will substitute the following parameter names.
An optional prefix "string:" will be removed. An optional prefix "string:" will be removed.
@* @*
"%device%" will be substituted by the mountable device path of the drive "%device%" will be substituted by the mountable device path of the drive
@ -3901,7 +3902,7 @@ and based on extra data on the media. If a drive returns data then one can
quite trust that they are valid. But at some degree of read problems the quite trust that they are valid. But at some degree of read problems the
correction will fail and the drive is supposed to indicate error. correction will fail and the drive is supposed to indicate error.
@* @*
xorriso can scan the media for readable data blocks, classify them according @command{xorriso} can scan the media for readable data blocks, classify them according
to their read speed, save them to a file, and keep track of successfuly saved to their read speed, save them to a file, and keep track of successfuly saved
blocks for further tries on the same media. blocks for further tries on the same media.
@* @*
@ -4000,7 +4001,7 @@ gives the path of the file which may abort a scan run. Abort
happens if the file exists and its mtime is not older than the start time happens if the file exists and its mtime is not older than the start time
of the run. Use shell command "touch" to trigger this. of the run. Use shell command "touch" to trigger this.
Other than an aborted program run, this will report the tested and untested Other than an aborted program run, this will report the tested and untested
blocks and go on with running xorriso. blocks and go on with running @command{xorriso}.
@* @*
@item time_limit=seconds @item time_limit=seconds
gives the number of seconds after which the scan shall be gives the number of seconds after which the scan shall be
@ -4043,7 +4044,7 @@ when it gets mounted or loaded as stdio: drive. But it usually makes
the original session 1 inaccessible. the original session 1 inaccessible.
@* @*
@item patch_lba0="force" @item patch_lba0="force"
performs patch_lba0="on" even if xorriso believes performs patch_lba0="on" even if @command{xorriso} believes
that the copied data are not valid. that the copied data are not valid.
@* @*
patch_lba0= may also bear a number. If it is 32 or higher it is taken as patch_lba0= may also bear a number. If it is 32 or higher it is taken as
@ -4092,7 +4093,7 @@ Only mismatching data files will be reported.
@node Restore, Emulation, Verify, Options @node Restore, Emulation, Verify, Options
@section osirrox ISO-to-disk restore options @section osirrox ISO-to-disk restore options
@c man .PP @c man .PP
Normally xorriso only writes to disk files which were given as stdio: Normally @command{xorriso} only writes to disk files which were given as stdio:
pseudo-drives or as log files. pseudo-drives or as log files.
But its alter ego osirrox is able to extract file objects But its alter ego osirrox is able to extract file objects
from ISO images and to create, overwrite, or delete file objects on disk. from ISO images and to create, overwrite, or delete file objects on disk.
@ -4133,7 +4134,7 @@ handled like any other ISO image directory.
@* @*
Option "auto_chmod_off" is default. If "auto_chmod_on" is set then access Option "auto_chmod_off" is default. If "auto_chmod_on" is set then access
restrictions for disk directories get circumvented if those directories restrictions for disk directories get circumvented if those directories
are owned by the effective user who runs xorriso. This happens by temporarily are owned by the effective user who runs @command{xorriso}. This happens by temporarily
granting rwx permission to the owner. granting rwx permission to the owner.
@* @*
Option "sort_lba_on" may improve read performance with optical drives. It Option "sort_lba_on" may improve read performance with optical drives. It
@ -4252,7 +4253,7 @@ reachable as /bin/mount or /sbin/mount.
@c man .PP @c man .PP
Writing of ISO 9660 on CD is traditionally done by program mkisofs Writing of ISO 9660 on CD is traditionally done by program mkisofs
as ISO 9660 image producer and cdrecord as burn program. as ISO 9660 image producer and cdrecord as burn program.
xorriso does not strive for their comprehensive emulation. @command{xorriso} does not strive for their comprehensive emulation.
Nevertheless it is ready to perform some of its core tasks under control Nevertheless it is ready to perform some of its core tasks under control
of commands which in said programs trigger comparable actions. of commands which in said programs trigger comparable actions.
@table @asis @table @asis
@ -4284,16 +4285,16 @@ emulation. Some are ignored, but better do not rely on this tolerance.
@* @*
The supported options are documented in detail in xorrisofs.info The supported options are documented in detail in xorrisofs.info
and in man xorrisofs. The description here is focused on the effect and in man xorrisofs. The description here is focused on the effect
of mkisofs emulation in the context of a xorriso run. of mkisofs emulation in the context of a @command{xorriso} run.
@* @*
Other than with the "cdrecord" personality there is no automatic -commit at Other than with the "cdrecord" personality there is no automatic -commit at
the end of a "mkisofs" option list. Verbosity settings -v (= "UPDATE") and the end of a "mkisofs" option list. Verbosity settings -v (= "UPDATE") and
-quiet (= "SORRY") persist. The output file, eventually chosen with -o, -quiet (= "SORRY") persist. The output file, eventually chosen with -o,
persists until things happen like -commit, -rollback, -dev, or end of xorriso. persists until things happen like -commit, -rollback, -dev, or end of @command{xorriso}.
-pacifier gets set to "mkisofs" if files are added to the image. -pacifier gets set to "mkisofs" if files are added to the image.
@* @*
-graft-points is equivalent to -pathspecs on. Note that pathspecs without "=" -graft-points is equivalent to -pathspecs on. Note that pathspecs without "="
are interpreted differently than with xorriso option -add. Directories get are interpreted differently than with @command{xorriso} option -add. Directories get
merged with the root directory of the ISO image, other filetypes get mapped merged with the root directory of the ISO image, other filetypes get mapped
into that root directory. into that root directory.
@* @*
@ -4301,7 +4302,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. "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 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 when finally writing begins. This truncation does not happen if the drive
is chosen by xorriso options before -as mkisofs or after its list delimiter. is chosen by @command{xorriso} options before -as mkisofs or after its list delimiter.
Directories and symbolic links are no valid -o targets. Directories and symbolic links are no valid -o targets.
@* @*
Writing to stdout is possible only if -as "mkisofs" was among the start Writing to stdout is possible only if -as "mkisofs" was among the start
@ -4319,7 +4320,7 @@ directory is added to the image. At the same occasion directory names get
allowed to violate the standard by -compliance option allow_dir_id_ext. allowed to violate the standard by -compliance option allow_dir_id_ext.
This may be avoided by option -disallow_dir_id_ext. This may be avoided by option -disallow_dir_id_ext.
@* @*
Option -root is supported. Option -old-root is implemented by xorriso Option -root is supported. Option -old-root is implemented by @command{xorriso}
commands -mkdir, -cp_clone, -find update_merge, and -find rm_merge. commands -mkdir, -cp_clone, -find update_merge, and -find rm_merge.
-root and -old-root set command -disk_dev_ino to "ino_only" and -md5 to "on", -root and -old-root set command -disk_dev_ino to "ino_only" and -md5 to "on",
by default. by default.
@ -4330,7 +4331,7 @@ resp. to "on" by @minus{}@minus{}old-root-devno .
Not original mkisofs options are @minus{}@minus{}quoted_path_list , Not original mkisofs options are @minus{}@minus{}quoted_path_list ,
@minus{}@minus{}hardlinks , @minus{}@minus{}acl , @minus{}@minus{}hardlinks , @minus{}@minus{}acl ,
@minus{}@minus{}xattr , @minus{}@minus{}md5 , @minus{}@minus{}stdio_sync . @minus{}@minus{}xattr , @minus{}@minus{}md5 , @minus{}@minus{}stdio_sync .
They work like the xorriso options with the They work like the @command{xorriso} options with the
same name and hardcoded argument "on", e.g. -acl "on". same name and hardcoded argument "on", e.g. -acl "on".
Explicit arguments are expected by @minus{}@minus{}stdio_sync Explicit arguments are expected by @minus{}@minus{}stdio_sync
and @minus{}@minus{}scdbackup_tag. and @minus{}@minus{}scdbackup_tag.
@ -4375,7 +4376,7 @@ Option @minus{}append_partition is supported.
@minus{}@minus{}old-empty is -compliance old_empty. @minus{}@minus{}old-empty is -compliance old_empty.
@* @*
The options of genisoimage Jigdo Template Extraction are recognized and The options of genisoimage Jigdo Template Extraction are recognized and
performed via xorriso option -jigdo. See the "Alias:" names there for the performed via @command{xorriso} option -jigdo. See the "Alias:" names there for the
meaning of the genisoimage options. meaning of the genisoimage options.
@* @*
@sp 1 @sp 1
@ -4383,12 +4384,12 @@ meaning of the genisoimage options.
Personalities "@strong{xorrisofs}", "@strong{genisoimage}", Personalities "@strong{xorrisofs}", "@strong{genisoimage}",
and "@strong{genisofs}" are aliases for "mkisofs". and "@strong{genisofs}" are aliases for "mkisofs".
@* @*
If xorriso is started with one of the leafnames "xorrisofs", "genisofs", If @command{xorriso} is started with one of the leafnames "xorrisofs", "genisofs",
"mkisofs", or "genisoimage", then it performs -read_mkisofsrc and prepends "mkisofs", or "genisoimage", then it performs -read_mkisofsrc and prepends
-as "genisofs" to the command line arguments. -as "genisofs" to the command line arguments.
I.e. all arguments will be interpreted mkisofs style until "@minus{}@minus{}" I.e. all arguments will be interpreted mkisofs style until "@minus{}@minus{}"
is encountered. is encountered.
From then on, options are interpreted as xorriso options. From then on, options are interpreted as @command{xorriso} options.
@* @*
@minus{}@minus{}no_rc as first argument of such a program start @minus{}@minus{}no_rc as first argument of such a program start
prevents interpretation of startup files. See section FILES below. prevents interpretation of startup files. See section FILES below.
@ -4407,7 +4408,7 @@ write_start_address=,
track source file path or "-" for standard input as track source. track source file path or "-" for standard input as track source.
@* @*
It ignores most other options of cdrecord and cdrskin but refuses on It ignores most other options of cdrecord and cdrskin but refuses on
-audio, -scanbus, and on blanking modes unknown to xorriso. -audio, -scanbus, and on blanking modes unknown to @command{xorriso}.
@* @*
The scope is only a single data track per session to be written The scope is only a single data track per session to be written
to blank, overwriteable, or appendable media. The media gets closed if to blank, overwriteable, or appendable media. The media gets closed if
@ -4416,7 +4417,7 @@ closing is applicable and not option -multi is present.
An eventually acquired input drive is given up. An eventually acquired input drive is given up.
This is only allowed if no image changes are pending. This is only allowed if no image changes are pending.
@* @*
dev= must be given as xorriso device address. Addresses like 0,0,0 or ATA:1,1,0 dev= must be given as @command{xorriso} device address. Addresses like 0,0,0 or ATA:1,1,0
are not supported. are not supported.
@* @*
If a track source is given, then an automatic -commit happens at the end of If a track source is given, then an automatic -commit happens at the end of
@ -4433,14 +4434,14 @@ A much more elaborate libburn based cdrecord emulator is the program cdrskin.
Personalites "@strong{xorrecord}", "@strong{wodim}", and "@strong{cdrskin}" Personalites "@strong{xorrecord}", "@strong{wodim}", and "@strong{cdrskin}"
are aliases for "cdrecord". are aliases for "cdrecord".
@* @*
If xorriso is started with one of the leafnames "xorrecord", "cdrskin", If @command{xorriso} is started with one of the leafnames "xorrecord", "cdrskin",
"cdrecord", or "wodim", then it automatically prepends -as "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 command line arguments. I.e. all arguments will be interpreted cdrecord
style until "@minus{}@minus{}" is encountered and an eventual commit happens. style until "@minus{}@minus{}" is encountered and an eventual commit happens.
From then on, options are interpreted as xorriso options. From then on, options are interpreted as @command{xorriso} options.
@* @*
@minus{}@minus{}no_rc as first argument of such a program start @minus{}@minus{}no_rc as first argument of such a program start
prevents interpretation of xorriso startup files. See section FILES below. prevents interpretation of @command{xorriso} startup files. See section FILES below.
@c man .TP @c man .TP
@item -read_mkisofsrc @item -read_mkisofsrc
@kindex -read_mkisofsrc searches and reads .mkisofsrc file @kindex -read_mkisofsrc searches and reads .mkisofsrc file
@ -4509,7 +4510,7 @@ files. See section FILES below.
@cindex Process, read command file, -options_from_file @cindex Process, read command file, -options_from_file
Read quoted input from fileaddress and execute it like dialog lines. Read quoted input from fileaddress and execute it like dialog lines.
Empty lines and lines which begin by # are ignored. Normally one line Empty lines and lines which begin by # are ignored. Normally one line
should hold one xorriso command and all its arguments. Nevertheless lines should hold one @command{xorriso} command and all its arguments. Nevertheless lines
may be concatenated by a trailing backslash. may be concatenated by a trailing backslash.
@* @*
See also section "Command processing", paragraph "Quoted input". See also section "Command processing", paragraph "Quoted input".
@ -4533,7 +4534,7 @@ Copy textline into libreadline history.
@item -status mode|filter @item -status mode|filter
@kindex -status shows current settings @kindex -status shows current settings
@cindex Program, show current settings, -status @cindex Program, show current settings, -status
Print the current settings of xorriso. Print the current settings of @command{xorriso}.
Modes: Modes:
@* @*
short... print only important or altered settings short... print only important or altered settings
@ -4672,12 +4673,12 @@ The first three items are single words, the rest of the line is the volume id.
@kindex -scsi_log reports SCSI commands @kindex -scsi_log reports SCSI commands
@cindex Drive, report SCSI commands, -scsi_log @cindex Drive, report SCSI commands, -scsi_log
Mode "on" enables very verbous logging of SCSI commands and drive replies. Mode "on" enables very verbous logging of SCSI commands and drive replies.
Logging messages get printed to stderr, not to any of the xorriso output Logging messages get printed to stderr, not to any of the @command{xorriso} output
channels. channels.
@* @*
A special property of this option is that the first -scsi_log setting A special property of this option is that the first -scsi_log setting
among the start arguments is in effect already when the first operations among the start arguments is in effect already when the first operations
of xorriso begin. Only "-scsi_log" with dash "-" is recognized that way. of @command{xorriso} begin. Only "-scsi_log" with dash "-" is recognized that way.
@c man .TP @c man .TP
@item -end @item -end
@kindex -end writes pending session and ends program @kindex -end writes pending session and ends program
@ -4735,8 +4736,8 @@ channels, "I" for info messages, "R" for result lines, "M" for -mark texts.
@item -mark text @item -mark text
@kindex -mark sets synchronizing message @kindex -mark sets synchronizing message
@cindex Process, set synchronizing message, -mark @cindex Process, set synchronizing message, -mark
If text is not empty it will get put out on "M" channel each time xorriso If text is not empty it will get put out on "M" channel each time @command{xorriso}
is ready for the next dialog line or before xorriso performs a command that is ready for the next dialog line or before @command{xorriso} performs a command that
was entered to the pager prompt. was entered to the pager prompt.
@c man .TP @c man .TP
@item -prog text @item -prog text
@ -4798,7 +4799,7 @@ Use text as name of this program and perform -help.
* ExPseudo:: Operate on storage facilities other than optical drives * ExPseudo:: Operate on storage facilities other than optical drives
* ExCdrecord:: Burn an existing ISO image file to media * ExCdrecord:: Burn an existing ISO image file to media
* ExMkisofs:: Perform multi-session runs as of cdrtools traditions * ExMkisofs:: Perform multi-session runs as of cdrtools traditions
* ExGrowisofs:: Let xorriso work underneath growisofs * ExGrowisofs:: Let @command{xorriso} work underneath growisofs
* ExException:: Adjust thresholds for verbosity, exit value and program abort * ExException:: Adjust thresholds for verbosity, exit value and program abort
* ExTime:: Examples of input timestrings * ExTime:: Examples of input timestrings
* ExIncBackup:: Incremental backup of a few directory trees * ExIncBackup:: Incremental backup of a few directory trees
@ -4810,8 +4811,8 @@ Use text as name of this program and perform -help.
@node ExDevices, ExCreate, Frontend, Examples @node ExDevices, ExCreate, Frontend, Examples
@section As superuser learn about available drives @section As superuser learn about available drives
On Linux or FreeBSD consider to give rw-permissions to those users or groups On Linux or FreeBSD consider to give rw-permissions to those users or groups
which shall be able to use the drives with xorriso. which shall be able to use the drives with @command{xorriso}.
On Solaris use pfexec. Consider to restrict privileges of xorriso to On Solaris use pfexec. Consider to restrict privileges of @command{xorriso} to
"base,sys_devices" and to give r-permission to user or group. "base,sys_devices" and to give r-permission to user or group.
@* @*
@sp 1 @sp 1
@ -5019,7 +5020,7 @@ $ xorriso -indev /dev/sr2 \
@section Bring a prepared ISOLINUX tree onto media and make it bootable @section Bring a prepared ISOLINUX tree onto media and make it bootable
The user has already created a suitable file tree on disk and copied the The user has already created a suitable file tree on disk and copied the
ISOLINUX files into subdirectory ./boot/isolinux of that tree. ISOLINUX files into subdirectory ./boot/isolinux of that tree.
Now xorriso can burn an El Torito bootable media: Now @command{xorriso} can burn an El Torito bootable media:
@* @*
@sp 1 @sp 1
$ xorriso -outdev /dev/sr0 -blank as_needed \ $ xorriso -outdev /dev/sr0 -blank as_needed \
@ -5062,9 +5063,9 @@ $ xorriso -dev stdio:/dev/sdb ...
@* @*
@sp 1 @sp 1
If /dev/sdb is to be used frequently and /dev/sda is the system disk, If /dev/sdb is to be used frequently and /dev/sda is the system disk,
then consider to place the following lines in a xorriso Startup File. then consider to place the following lines in a @command{xorriso} Startup File.
They allow to use /dev/sdb without prefix and protect disk /dev/sda They allow to use /dev/sdb without prefix and protect disk /dev/sda
from xorriso: from @command{xorriso}:
@* @*
@sp 1 @sp 1
-drive_class banned /dev/sda* -drive_class banned /dev/sda*
@ -5127,7 +5128,7 @@ of the changed content before it loads the media again.
In this case the previous session would not be loaded and the In this case the previous session would not be loaded and the
new session would contain only the newly added files. new session would contain only the newly added files.
@* @*
For the same reason do not let xorriso -as cdrecord load the media, For the same reason do not let @command{xorriso} -as cdrecord load the media,
but rather do this manually or by a program that reads from /dev/sr0. but rather do this manually or by a program that reads from /dev/sr0.
@* @*
@sp 1 @sp 1
@ -5138,9 +5139,9 @@ in order to enable multi-session emulation on overwriteable media.
@c man .SS @c man .SS
@c man .B Let xorriso work underneath growisofs @c man .B Let xorriso work underneath growisofs
@node ExGrowisofs, ExException, ExMkisofs, Examples @node ExGrowisofs, ExException, ExMkisofs, Examples
@section Let xorriso work underneath growisofs @section Let @command{xorriso} work underneath growisofs
growisofs expects an ISO formatter program which understands options -C and growisofs expects an ISO formatter program which understands options -C and
-M. If xorriso gets started by name "xorrisofs" then it is suitable for that. -M. If @command{xorriso} gets started by name "xorrisofs" then it is suitable for that.
@* @*
@sp 1 @sp 1
$ export MKISOFS="xorrisofs" $ export MKISOFS="xorrisofs"
@ -5151,7 +5152,7 @@ $ growisofs -M /dev/dvd /more/files
@* @*
@sp 1 @sp 1
If no "xorrisofs" is available on your system, then you will have to create If no "xorrisofs" is available on your system, then you will have to create
a link pointing to the xorriso binary and tell growisofs to use it. E.g. by: a link pointing to the @command{xorriso} binary and tell growisofs to use it. E.g. by:
@* @*
@sp 1 @sp 1
$ ln -s $(which xorriso) "$HOME/xorrisofs" $ ln -s $(which xorriso) "$HOME/xorrisofs"
@ -5160,7 +5161,7 @@ $ export MKISOFS="$HOME/xorrisofs"
@* @*
@sp 1 @sp 1
One may quit mkisofs emulation by argument "@minus{}@minus{}" and make One may quit mkisofs emulation by argument "@minus{}@minus{}" and make
use of all xorriso commands. growisofs dislikes options which use of all @command{xorriso} commands. growisofs dislikes options which
start with "-o" but -outdev must be set to "-". start with "-o" but -outdev must be set to "-".
So use "outdev" instead: So use "outdev" instead:
@* @*
@ -5308,8 +5309,8 @@ it is possible to access the session trees which represent the older backup
versions. With CD media, GNU/Linux mount accepts session numbers directly by versions. With CD media, GNU/Linux mount accepts session numbers directly by
its option "session=". its option "session=".
@* @*
Multi-session media and most overwriteable media written by xorriso can tell Multi-session media and most overwriteable media written by @command{xorriso} can tell
the sbsectors of their sessions by xorriso option -toc. the sbsectors of their sessions by @command{xorriso} option -toc.
Used after -commit the following option prints the matching mount command for Used after -commit the following option prints the matching mount command for
the newly written session (here for mount point /mnt): the newly written session (here for mount point /mnt):
@* @*
@ -5415,13 +5416,13 @@ resp. -s.
@c man .B Program alias names: @c man .B Program alias names:
@* @*
@section Program Alias Names @section Program Alias Names
Normal installation of xorriso creates three links or copies which by their Normal installation of @command{xorriso} creates three links or copies which by their
program name pre-select certain settings: program name pre-select certain settings:
@* @*
@sp 1 @sp 1
@strong{xorrisofs} starts xorriso with -as mkisofs emulation. @strong{xorrisofs} starts @command{xorriso} with -as mkisofs emulation.
@* @*
@strong{xorrecord} starts xorriso with -as cdrecord emulation. @strong{xorrecord} starts @command{xorriso} with -as cdrecord emulation.
@* @*
@strong{osirrox} starts with -osirrox "on:o_excl_off" which allows @strong{osirrox} 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 option -mount to
@ -5430,7 +5431,7 @@ one or more of the existing ISO sessions.
@c man .B Startup files: @c man .B Startup files:
@section Startup Files @section Startup Files
@* @*
If not -no_rc is given as the first argument then xorriso attempts on startup If not -no_rc is given as the first argument then @command{xorriso} attempts on startup
to read and execute lines from the following files: to read and execute lines from the following files:
@* @*
@sp 1 @sp 1
@ -5491,9 +5492,9 @@ The default setting of -check_media abort_file= is:
@node Seealso, Legal, Files, Top @node Seealso, Legal, Files, Top
@chapter See also @chapter See also
@table @asis @table @asis
@item For the mkisofs emulation of xorriso @item For the mkisofs emulation of @command{xorriso}
xorrisofs(1) xorrisofs(1)
@item For mounting xorriso generated ISO 9660 images (-t iso9660) @item For mounting @command{xorriso} generated ISO 9660 images (-t iso9660)
mount(8) mount(8)
@item Libreadline, a comfortable input line facility @item Libreadline, a comfortable input line facility
readline(3) readline(3)
@ -5526,12 +5527,12 @@ for libburnia-project.org
Copyright (c) 2007 - 2011 Thomas Schmitt Copyright (c) 2007 - 2011 Thomas Schmitt
@* @*
Permission is granted to distribute this text freely. It shall only be Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of xorriso. If you make use modified in sync with the technical properties of @command{xorriso}. If you make use
of the license to derive modified versions of xorriso then you are entitled of the license to derive modified versions of @command{xorriso} then you are entitled
to modify this text under that same license. to modify this text under that same license.
@c man .SH CREDITS @c man .SH CREDITS
@section Credits @section Credits
xorriso is in part based on work by Vreixo Formoso who provides libisofs @command{xorriso} is in part based on work by Vreixo Formoso who provides libisofs
together with Mario Danic who also leads the libburnia team. together with Mario Danic who also leads the libburnia team.
Thanks to Andy Polyakov who invented emulated growing, Thanks to Andy Polyakov who invented emulated growing,
to Derek Foreman and Ben Jansens who once founded libburn. to Derek Foreman and Ben Jansens who once founded libburn.