Adjusted line lengths to less than 80 chars in source of xorriso manual
This commit is contained in:
@ -122,10 +122,12 @@ session-wise manipulation of such filesystems. It can load the management
|
||||
information of existing ISO images and it writes the session results to
|
||||
optical media or to filesystem objects.
|
||||
@*
|
||||
Vice versa @command{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
|
||||
@sp 1
|
||||
A special property of @command{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
|
||||
incorporates the libraries of libburnia-project.org .
|
||||
@c man .SS
|
||||
@ -236,11 +238,12 @@ one and the modifications.
|
||||
See paragraph Creating, Growing, Modifying, Blind Growing below.
|
||||
@c man .PP
|
||||
@sp 1
|
||||
@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
|
||||
the new image to the target media.
|
||||
@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 the new image to the target media.
|
||||
@c man .br
|
||||
The first session of a @command{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.
|
||||
The session ends by command -commit which triggers writing. A -commit is
|
||||
done automatically when the program ends regularly.
|
||||
@ -381,8 +384,8 @@ to the given block address. This is the usage model of
|
||||
mkisofs -M $indev -C $msc1,$msc2 -o $outdev
|
||||
@*
|
||||
which gives much room for wrong parameter combinations and should thus only be
|
||||
employed if a strict distinction between ISO formatter @command{xorriso} and the burn
|
||||
program is desired. -C $msc1,$msc2 is equivalent to:
|
||||
employed if a strict distinction between ISO formatter @command{xorriso}
|
||||
and the burn program is desired. -C $msc1,$msc2 is equivalent to:
|
||||
@*
|
||||
-load sbsector $msc1 -grow_blindly $msc2
|
||||
@c man .SS
|
||||
@ -400,7 +403,8 @@ 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
|
||||
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 @command{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.
|
||||
@c man .PP
|
||||
@sp 1
|
||||
@ -494,12 +498,13 @@ is the name of a set of additional information which enhance
|
||||
an ISO 9660 filesystem so that it can represent a POSIX compliant filesystem
|
||||
with ownership, access permissions, symbolic links, and other attributes.
|
||||
@*
|
||||
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 @command{xorriso}
|
||||
image.
|
||||
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
|
||||
@command{xorriso} image.
|
||||
@c man .PP
|
||||
@sp 1
|
||||
@command{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
|
||||
demands a file name length of up to 255 characters and paths of up to 1024
|
||||
characters. Rock Ridge fulfills this demand.
|
||||
@ -512,8 +517,8 @@ 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.
|
||||
@*
|
||||
Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images.
|
||||
@command{xorriso} is able to create or maintain an El Torito object which makes such
|
||||
an image bootable. For details see option -boot_image.
|
||||
@command{xorriso} is able to create or maintain an El Torito object which
|
||||
makes such an image bootable. For details see option -boot_image.
|
||||
@*
|
||||
@cindex MBR, _definiton
|
||||
It is possible to make ISO images bootable from USB stick or other
|
||||
@ -543,29 +548,31 @@ It uses this extension if enabled by option
|
||||
@*
|
||||
AAIP enhanced images are supposed to be mountable normally, but one cannot
|
||||
expect that the mounted filesystem will show and respect the eventual ACLs.
|
||||
For now, only @command{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
|
||||
print them in a format suitable for tool setfacl.
|
||||
@*
|
||||
Files with ACL show as group permissions the setting of entry "mask::" if
|
||||
that entry exists. Nevertheless the non-listed group members get handled
|
||||
according to entry "group::". @command{xorriso} brings "group::" into effect before
|
||||
eventually removing the ACL from a file.
|
||||
according to entry "group::". @command{xorriso} brings "group::" into effect
|
||||
before eventually removing the ACL from a file.
|
||||
@c man .PP
|
||||
@sp 1
|
||||
@cindex xattr, _definiton
|
||||
@strong{xattr} (aka EA)
|
||||
are pairs of name and value which can be attached to file objects. AAIP is
|
||||
able to represent them and @command{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.",
|
||||
like "user.x" or "user.whatever". Name has to be a 0 terminated string.
|
||||
Value may be any array of bytes which does not exceed the size of 4095 bytes.
|
||||
xattr processing happens only if it is enabled by option
|
||||
@strong{-xattr}.
|
||||
@*
|
||||
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
|
||||
them.
|
||||
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 them.
|
||||
@c man .SS
|
||||
@node Processing, Dialog, Extras, top
|
||||
@chapter Command processing
|
||||
@ -618,8 +625,8 @@ similar to the quotation rules of a shell parser.
|
||||
@*
|
||||
@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 "*"
|
||||
differs from the usual shell parsers. In @command{xorriso}, a quotation mark does not
|
||||
make a pattern symbol literal.
|
||||
differs from the usual shell parsers. In @command{xorriso}, a quotation mark
|
||||
does not make a pattern symbol literal.
|
||||
@c man .PP
|
||||
@sp 1
|
||||
@cindex Quoted input, _definiton
|
||||
@ -662,8 +669,10 @@ to make dialog more comfortable.
|
||||
@c man .PP
|
||||
@sp 1
|
||||
Readline is an enhancement for the input line. You may know it already from
|
||||
the bash shell. Whether it is available in @command{xorriso} depends on the availability
|
||||
of package readline-dev at the time when @command{xorriso} was built from its sourcecode.
|
||||
the bash shell. Whether it is available in @command{xorriso} depends on the
|
||||
availability
|
||||
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
|
||||
Leftward and the Rightward arrow key.
|
||||
@ -873,8 +882,8 @@ accepted. If it is not a MMC device then the prefix "stdio:" will be prepended
|
||||
automatically. This list is empty by default.
|
||||
@*
|
||||
Else if the path matches the "banned" list then the drive will not be
|
||||
accepted by @command{xorriso} but rather lead to a FAILURE event. This list is empty by
|
||||
default.
|
||||
accepted by @command{xorriso} but rather lead to a FAILURE event.
|
||||
This list is empty by default.
|
||||
@*
|
||||
Else if the path matches the "caution" list and if it is not a MMC device,
|
||||
then its address must have the prefix "stdio:" or it will be rejected.
|
||||
@ -928,7 +937,8 @@ an eventual recorded character set name gets used as input character set
|
||||
when reading an image.
|
||||
@*
|
||||
Note that the default output charset is the local character set of the
|
||||
terminal where @command{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
|
||||
all intended filenames, especially exotic national characters.
|
||||
@c man .TP
|
||||
@ -957,7 +967,8 @@ e.g. if you need to apply filters to all updated files.
|
||||
Mode "without_update" avoids hardlink processing during update commands.
|
||||
Use this if your filesystem situation does not allow -disk_dev_ino "on".
|
||||
@*
|
||||
@command{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
|
||||
image load to image load. One may give up the accumulated hard link addresses
|
||||
by -hardlinks "discard_extract".
|
||||
@ -1013,8 +1024,8 @@ 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.
|
||||
This is necessary if growisofs was used as burn program, because it does
|
||||
not overwrite the superblock checksum tag of the first session.
|
||||
Therefore load_check_off is in effect when @command{xorriso} -as mkisofs option -M
|
||||
is performed.
|
||||
Therefore load_check_off is in effect when @command{xorriso} -as mkisofs
|
||||
option -M is performed.
|
||||
@*
|
||||
The test can be re-enabled by mode "load_check_on".
|
||||
@*
|
||||
@ -1380,7 +1391,8 @@ arguments.
|
||||
@cindex Insert, limit data file size, -file_size_limit
|
||||
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
|
||||
size is not limited by @command{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{}
|
||||
@*
|
||||
@ -1526,7 +1538,8 @@ an intentional sequence of link hops.
|
||||
@item -pathspecs "on"|"off"
|
||||
@kindex -pathspecs sets meaning of = with -add
|
||||
@cindex Insert, meaning of = with -add, -pathspecs
|
||||
Control parameter interpretation with @command{xorriso} actions -add and -path_list.
|
||||
Control parameter interpretation with @command{xorriso}
|
||||
actions -add and -path_list.
|
||||
@*
|
||||
@cindex Pathspec, _definition
|
||||
"on" enables pathspecs of the form
|
||||
@ -1995,7 +2008,8 @@ If -else is missing and would be hit, then the result is a non-match.
|
||||
|
||||
Default action is @strong{echo},
|
||||
i.e. to print the address of the found file. Other actions are certain
|
||||
@command{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.
|
||||
@c man .br
|
||||
@table @asis
|
||||
@ -2245,7 +2259,8 @@ is not applied to any file in the ISO image.
|
||||
Irrevocably ban commands -external_filter and -unregister_filter,
|
||||
but not -set_filter. Use this to prevent external filtering in general or
|
||||
when all intended filters are registered.
|
||||
External filters may also be banned totally at compile time of @command{xorriso}.
|
||||
External filters may also be banned totally at compile time of
|
||||
@command{xorriso}.
|
||||
By default they are banned if @command{xorriso} runs under setuid permission.
|
||||
@c man .TP
|
||||
@item -set_filter name iso_rr_path [***]
|
||||
@ -2600,7 +2615,8 @@ identify the specification of how the data are recorded.
|
||||
Permissible are up to 128 characters. This setting gets overridden by
|
||||
image loading.
|
||||
@*
|
||||
The special text "@@xorriso@@" gets converted to the id string of @command{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
|
||||
the program id as -application_id.
|
||||
@c man .TP
|
||||
@ -2674,12 +2690,12 @@ image loading.
|
||||
@cindex Image, set preparer id, -preparer_id
|
||||
Set the preparer id string to be written with the next -commit. This may
|
||||
identify the person or other entity which controls the preparation of the data
|
||||
which shall be recorded. Normally this should be the id of @command{xorriso} and not
|
||||
of the person or program which operates @command{xorriso}. Please avoid to change it.
|
||||
Permissible are up to 128 characters.
|
||||
which shall be recorded. Normally this should be the id of @command{xorriso}
|
||||
and not of the person or program which operates @command{xorriso}.
|
||||
Please avoid to change it. Permissible are up to 128 characters.
|
||||
@*
|
||||
The special text "@@xorriso@@" gets converted to the id string of @command{xorriso}
|
||||
which is default at program startup.
|
||||
The special text "@@xorriso@@" gets converted to the id string of
|
||||
@command{xorriso} which is default at program startup.
|
||||
@*
|
||||
Unlike other id strings, this setting is not influenced by image loading.
|
||||
@c man .TP
|
||||
@ -2805,7 +2821,8 @@ Append the given number of extra bytes to the image stream.
|
||||
This is a traditional remedy for a traditional bug in block
|
||||
device read drivers. Needed only for CD recordings in TAO mode.
|
||||
Since one can hardly predict on what media an image might end up,
|
||||
@command{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 .
|
||||
@*
|
||||
@ -3098,8 +3115,8 @@ Partitions may be appended with boot block type MBR and with SUN Disk Label.
|
||||
With MBR:
|
||||
@*
|
||||
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 @command{xorriso} MBR
|
||||
features, number 2 would be the most natural choice.
|
||||
the unclaimed space before partition 1. So together with most @command{xorriso}
|
||||
MBR features, number 2 would be the most natural choice.
|
||||
@*
|
||||
The type_code may be "FAT12", "FAT16", "Linux",
|
||||
or a hexadecimal number between 0x00 and 0xff. Not all those numbers will
|
||||
@ -3152,7 +3169,8 @@ After eventual To=From mapping, the file address gets written into the .jigdo
|
||||
file. Jigdo restore tools will convert these addresses into really
|
||||
reachable data source addresses from which they can read.
|
||||
@*
|
||||
If the list of jigdo parameters is not empty, then @command{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
|
||||
eventual padding will be counted as part of the ISO image.
|
||||
@*
|
||||
@ -3241,8 +3259,8 @@ names. Shell command iconv -l lists them.
|
||||
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
|
||||
of the media use the same character set.
|
||||
Outside these constraints it may be necessary to let @command{xorriso} convert byte
|
||||
codes.
|
||||
Outside these constraints it may be necessary to let @command{xorriso}
|
||||
convert byte codes.
|
||||
@*
|
||||
There is an input conversion from input character set to the local character
|
||||
set which applies when an ISO image gets loaded. A conversion from local
|
||||
@ -3251,13 +3269,15 @@ 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.
|
||||
@*
|
||||
If conversions are desired then @command{xorriso} needs to know the name of the
|
||||
local character set. @command{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
|
||||
variables LC_ALL, LC_CTYPE, or LANG and should match the expectations of
|
||||
the terminal.
|
||||
@*
|
||||
The default output charset is the local character set of the terminal where
|
||||
@command{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
|
||||
reader has to riddle what character set was used.
|
||||
@*
|
||||
@ -3293,7 +3313,8 @@ If this appears necessary, one should consider to set -backslash_codes to
|
||||
@node Exception, DialogCtl, Charset, Options
|
||||
@section Exception processing
|
||||
@c man .PP
|
||||
Since the tasks of @command{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 @command{xorriso} to report and handle problem events.
|
||||
@*
|
||||
Those events get classified when they are detected by one of the software
|
||||
@ -3340,20 +3361,20 @@ be ignorable.
|
||||
@*
|
||||
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
|
||||
start arguments is in effect already when the first operations of @command{xorriso}
|
||||
begin. Only "-abort_on" with dash "-" is recognized that way.
|
||||
start arguments is in effect already when the first operations of
|
||||
@command{xorriso} begin. Only "-abort_on" with dash "-" is recognized that way.
|
||||
@c man .TP
|
||||
@item -return_with severity exit_value
|
||||
@kindex -return_with controls exit value
|
||||
@cindex Process, control exit value, -return_with
|
||||
Set the threshold and exit_value to be returned at program end if no abort
|
||||
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.
|
||||
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.
|
||||
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)
|
||||
or a number between 32 and 63. Some other exit_values are used by @command{xorriso} if
|
||||
it decides to abort the program run:
|
||||
or a number between 32 and 63. Some other exit_values are used by
|
||||
@command{xorriso} if it decides to abort the program run:
|
||||
@*
|
||||
1=abort due to external signal
|
||||
@*
|
||||
@ -3383,7 +3404,8 @@ Info messages which belong to no event get attributed severity "NOTE".
|
||||
@*
|
||||
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
|
||||
of @command{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
|
||||
@item -signal_handling mode
|
||||
@kindex -signal_handling controls handling of system signals
|
||||
@ -3397,8 +3419,8 @@ ugly messages but puts much effort in releasing eventually used optical drives
|
||||
before @command{xorriso} ends.
|
||||
@*
|
||||
Mode "off" as first -signal_handling among the start arguments prevents all
|
||||
own signal precautions of @command{xorriso}. Eventually inherited signal handler settings
|
||||
stay as they are.
|
||||
own signal precautions of @command{xorriso}. Eventually inherited signal
|
||||
handler settings stay as they are.
|
||||
@*
|
||||
It works like "sig_dfl" if given after other signal handling was already
|
||||
established at program start.
|
||||
@ -3408,14 +3430,16 @@ normally a sudden abort of the program. To prevent stuck drives, the
|
||||
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
|
||||
the risk that @command{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
|
||||
needs poweroff to be reset. So during burning, blanking, and formatting
|
||||
wait for at least their normal run time before killing externally.
|
||||
@*
|
||||
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
|
||||
of @command{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
|
||||
@item -error_behavior occasion behavior
|
||||
@kindex -error_behavior controls error workarounds
|
||||
@ -3902,7 +3926,8 @@ 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
|
||||
correction will fail and the drive is supposed to indicate error.
|
||||
@*
|
||||
@command{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
|
||||
blocks for further tries on the same media.
|
||||
@*
|
||||
@ -4134,8 +4159,8 @@ handled like any other ISO image directory.
|
||||
@*
|
||||
Option "auto_chmod_off" is default. If "auto_chmod_on" is set then access
|
||||
restrictions for disk directories get circumvented if those directories
|
||||
are owned by the effective user who runs @command{xorriso}. This happens by temporarily
|
||||
granting rwx permission to the owner.
|
||||
are owned by the effective user who runs @command{xorriso}. This happens
|
||||
by temporarily granting rwx permission to the owner.
|
||||
@*
|
||||
Option "sort_lba_on" may improve read performance with optical drives. It
|
||||
allows to restore large numbers of hard links without exhausting
|
||||
@ -4290,11 +4315,13 @@ of mkisofs emulation in the context of a @command{xorriso} run.
|
||||
Other than with the "cdrecord" personality there is no automatic -commit at
|
||||
the end of a "mkisofs" option list. Verbosity settings -v (= "UPDATE") and
|
||||
-quiet (= "SORRY") persist. The output file, eventually chosen with -o,
|
||||
persists until things happen like -commit, -rollback, -dev, or end of @command{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.
|
||||
@*
|
||||
-graft-points is equivalent to -pathspecs on. Note that pathspecs without "="
|
||||
are interpreted differently than with @command{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
|
||||
into that root directory.
|
||||
@*
|
||||
@ -4302,8 +4329,8 @@ If pathspecs are given and if no output file was chosen before or during the
|
||||
"mkisofs" option list, then standard output (-outdev "-") will get into effect.
|
||||
If -o points to a regular file, then it will be truncated to 0 bytes
|
||||
when finally writing begins. This truncation does not happen if the drive
|
||||
is chosen by @command{xorriso} options before -as mkisofs or after its list delimiter.
|
||||
Directories and symbolic links are no valid -o targets.
|
||||
is chosen by @command{xorriso} options before -as mkisofs or after its
|
||||
list delimiter. Directories and symbolic links are no valid -o targets.
|
||||
@*
|
||||
Writing to stdout is possible only if -as "mkisofs" was among the start
|
||||
arguments or if other start arguments pointed the output drive to
|
||||
@ -4376,15 +4403,16 @@ Option @minus{}append_partition is supported.
|
||||
@minus{}@minus{}old-empty is -compliance old_empty.
|
||||
@*
|
||||
The options of genisoimage Jigdo Template Extraction are recognized and
|
||||
performed via @command{xorriso} option -jigdo. See the "Alias:" names there for the
|
||||
meaning of the genisoimage options.
|
||||
performed via @command{xorriso} option -jigdo. See the "Alias:" names there
|
||||
for the meaning of the genisoimage options.
|
||||
@*
|
||||
@sp 1
|
||||
|
||||
Personalities "@strong{xorrisofs}", "@strong{genisoimage}",
|
||||
and "@strong{genisofs}" are aliases for "mkisofs".
|
||||
@*
|
||||
If @command{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
|
||||
-as "genisofs" to the command line arguments.
|
||||
I.e. all arguments will be interpreted mkisofs style until "@minus{}@minus{}"
|
||||
@ -4417,8 +4445,8 @@ closing is applicable and not option -multi is present.
|
||||
An eventually acquired input drive is given up.
|
||||
This is only allowed if no image changes are pending.
|
||||
@*
|
||||
dev= must be given as @command{xorriso} device address. Addresses like 0,0,0 or ATA:1,1,0
|
||||
are not supported.
|
||||
dev= must be given as @command{xorriso} device address. Addresses like 0,0,0
|
||||
or ATA:1,1,0 are not supported.
|
||||
@*
|
||||
If a track source is given, then an automatic -commit happens at the end of
|
||||
the "cdrecord" option list.
|
||||
@ -4434,14 +4462,15 @@ A much more elaborate libburn based cdrecord emulator is the program cdrskin.
|
||||
Personalites "@strong{xorrecord}", "@strong{wodim}", and "@strong{cdrskin}"
|
||||
are aliases for "cdrecord".
|
||||
@*
|
||||
If @command{xorriso} is started with one of the leafnames "xorrecord", "cdrskin",
|
||||
"cdrecord", or "wodim", then it automatically prepends -as "cdrskin"
|
||||
If @command{xorriso} is started with one of the leafnames "xorrecord",
|
||||
"cdrskin", "cdrecord", or "wodim", then it automatically prepends -as "cdrskin"
|
||||
to the command line arguments. I.e. all arguments will be interpreted cdrecord
|
||||
style until "@minus{}@minus{}" is encountered and an eventual commit happens.
|
||||
From then on, options are interpreted as @command{xorriso} options.
|
||||
@*
|
||||
@minus{}@minus{}no_rc as first argument of such a program start
|
||||
prevents interpretation of @command{xorriso} startup files. See section FILES below.
|
||||
prevents interpretation of @command{xorriso} startup files.
|
||||
See section FILES below.
|
||||
@c man .TP
|
||||
@item -read_mkisofsrc
|
||||
@kindex -read_mkisofsrc searches and reads .mkisofsrc file
|
||||
@ -4510,8 +4539,8 @@ files. See section FILES below.
|
||||
@cindex Process, read command file, -options_from_file
|
||||
Read quoted input from fileaddress and execute it like dialog lines.
|
||||
Empty lines and lines which begin by # are ignored. Normally one line
|
||||
should hold one @command{xorriso} command and all its arguments. Nevertheless lines
|
||||
may be concatenated by a trailing backslash.
|
||||
should hold one @command{xorriso} command and all its arguments.
|
||||
Nevertheless lines may be concatenated by a trailing backslash.
|
||||
@*
|
||||
See also section "Command processing", paragraph "Quoted input".
|
||||
@c man .TP
|
||||
@ -4673,12 +4702,13 @@ The first three items are single words, the rest of the line is the volume id.
|
||||
@kindex -scsi_log reports SCSI commands
|
||||
@cindex Drive, report SCSI commands, -scsi_log
|
||||
Mode "on" enables very verbous logging of SCSI commands and drive replies.
|
||||
Logging messages get printed to stderr, not to any of the @command{xorriso} output
|
||||
channels.
|
||||
Logging messages get printed to stderr, not to any of the @command{xorriso}
|
||||
output channels.
|
||||
@*
|
||||
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
|
||||
of @command{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
|
||||
@item -end
|
||||
@kindex -end writes pending session and ends program
|
||||
@ -4736,9 +4766,9 @@ channels, "I" for info messages, "R" for result lines, "M" for -mark texts.
|
||||
@item -mark text
|
||||
@kindex -mark sets synchronizing message
|
||||
@cindex Process, set synchronizing message, -mark
|
||||
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 @command{xorriso} performs a command that
|
||||
was entered to the pager prompt.
|
||||
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
|
||||
@command{xorriso} performs a command that was entered to the pager prompt.
|
||||
@c man .TP
|
||||
@item -prog text
|
||||
@kindex -prog sets program name
|
||||
@ -5141,7 +5171,8 @@ in order to enable multi-session emulation on overwriteable media.
|
||||
@node ExGrowisofs, ExException, ExMkisofs, Examples
|
||||
@section Let @command{xorriso} work underneath growisofs
|
||||
growisofs expects an ISO formatter program which understands options -C and
|
||||
-M. If @command{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
|
||||
$ export MKISOFS="xorrisofs"
|
||||
@ -5152,7 +5183,8 @@ $ growisofs -M /dev/dvd /more/files
|
||||
@*
|
||||
@sp 1
|
||||
If no "xorrisofs" is available on your system, then you will have to create
|
||||
a link pointing to the @command{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
|
||||
$ ln -s $(which xorriso) "$HOME/xorrisofs"
|
||||
@ -5309,8 +5341,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
|
||||
its option "session=".
|
||||
@*
|
||||
Multi-session media and most overwriteable media written by @command{xorriso} can tell
|
||||
the sbsectors of their sessions by @command{xorriso} option -toc.
|
||||
Multi-session media and most overwriteable media written by @command{xorriso}
|
||||
can tell the sbsectors of their sessions by @command{xorriso} option -toc.
|
||||
Used after -commit the following option prints the matching mount command for
|
||||
the newly written session (here for mount point /mnt):
|
||||
@*
|
||||
@ -5527,13 +5559,14 @@ for libburnia-project.org
|
||||
Copyright (c) 2007 - 2011 Thomas Schmitt
|
||||
@*
|
||||
Permission is granted to distribute this text freely. It shall only be
|
||||
modified in sync with the technical properties of @command{xorriso}. If you make use
|
||||
of the license to derive modified versions of @command{xorriso} then you are entitled
|
||||
to modify this text under that same license.
|
||||
modified in sync with the technical properties of @command{xorriso}.
|
||||
If you make use of the license to derive modified versions of
|
||||
@command{xorriso} then you are entitled to modify this text under that
|
||||
same license.
|
||||
@c man .SH CREDITS
|
||||
@section Credits
|
||||
@command{xorriso} is in part based on work by Vreixo Formoso who provides libisofs
|
||||
together with Mario Danic who also leads the libburnia team.
|
||||
@command{xorriso} is in part based on work by Vreixo Formoso who provides
|
||||
libisofs together with Mario Danic who also leads the libburnia team.
|
||||
Thanks to Andy Polyakov who invented emulated growing,
|
||||
to Derek Foreman and Ben Jansens who once founded libburn.
|
||||
@*
|
||||
|
||||
Reference in New Issue
Block a user