|
|
|
|
@ -50,7 +50,7 @@
|
|
|
|
|
@c man .\" First parameter, NAME, should be all caps
|
|
|
|
|
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
|
|
|
|
@c man .\" other parameters are allowed: see man(7), man(1)
|
|
|
|
|
@c man .TH XORRISO 1 "Version 1.4.1, Mai 17, 2015"
|
|
|
|
|
@c man .TH XORRISO 1 "Version 1.4.1, Jul 30, 2015"
|
|
|
|
|
@c man .\" Please adjust this date whenever revising the manpage.
|
|
|
|
|
@c man .\"
|
|
|
|
|
@c man .\" Some roff macros, for reference:
|
|
|
|
|
@ -330,7 +330,7 @@ for @command{xorriso}.
|
|
|
|
|
@*
|
|
|
|
|
Closed is the state of DVD-ROM media and of multi-session media which were
|
|
|
|
|
written with command -close on. If the drive is read-only hardware then it will
|
|
|
|
|
probably show any media as closed CD-ROM resp. DVD-ROM.
|
|
|
|
|
probably show any media as closed CD-ROM or DVD-ROM.
|
|
|
|
|
@*
|
|
|
|
|
Overwriteable media assume this state in such read-only drives or if they
|
|
|
|
|
contain unrecognizable data in the first 32 data blocks.
|
|
|
|
|
@ -1003,7 +1003,7 @@ If an ISO image was written onto a partition with offset of 640000 blocks of
|
|
|
|
|
512 bytes, then it can be loaded from the base device by -displacement 160000.
|
|
|
|
|
@*
|
|
|
|
|
In both cases, the ISO sessions should be self contained, i.e. not add-on
|
|
|
|
|
sessions to an ISO image outside their track resp. partition.
|
|
|
|
|
sessions to an ISO image outside their track or partition.
|
|
|
|
|
@c man .TP
|
|
|
|
|
@item -drive_class "harmless"|"banned"|"caution"|"clear_list" disk_pattern
|
|
|
|
|
@kindex -drive_class controls drive accessability
|
|
|
|
|
@ -1240,7 +1240,8 @@ for substantial time after they have been used for reading. This reduces
|
|
|
|
|
the startup time for the next drive operation but can be loud and waste
|
|
|
|
|
energy if no i/o with the drive is expected to happen soon.
|
|
|
|
|
@*
|
|
|
|
|
Modes "in", "out", "all" immediately calm down -indev, -outdev, resp. both.
|
|
|
|
|
Modes "in", "out", "all" immediately calm down -indev, -outdev, or both,
|
|
|
|
|
respectively.
|
|
|
|
|
Mode "revoke" immediately alerts both.
|
|
|
|
|
Mode "on" causes -calm_drive to be performed automatically after each -dev,
|
|
|
|
|
-indev, and -outdev. Mode "off" disables this.
|
|
|
|
|
@ -1394,7 +1395,7 @@ as files to add, if they are not parameters to appropriate commands.
|
|
|
|
|
@cindex Insert, paths from disk file, -path_list
|
|
|
|
|
Like -add but read the parameter words from file disk_path
|
|
|
|
|
or standard input if disk_path is "-".
|
|
|
|
|
The list must contain exactly one pathspec resp. disk_path pattern per line.
|
|
|
|
|
The list must contain exactly one pathspec or disk_path pattern per line.
|
|
|
|
|
@c man .TP
|
|
|
|
|
@item -quoted_path_list disk_path
|
|
|
|
|
@kindex -quoted_path_list inserts paths from disk file
|
|
|
|
|
@ -1547,7 +1548,7 @@ In case of collision merge directories with existing ones, but do not overwrite
|
|
|
|
|
existing ISO file objects.
|
|
|
|
|
@*
|
|
|
|
|
The rules for generating the copy addresses are the same as with
|
|
|
|
|
command -cpr (see above) resp. shell command cp -r. Other than with -cpr,
|
|
|
|
|
command -cpr (see above) or shell command cp -r. Other than with -cpr,
|
|
|
|
|
relative iso_rr_path_original will get prepended the -cd path and not
|
|
|
|
|
the -cdx path. Consider to -mkdir iso_rr_path_dest before -cp_clone
|
|
|
|
|
so the copy address does not depend on the number of iso_rr_path_original
|
|
|
|
|
@ -1648,7 +1649,7 @@ if they contain a / character, or as -not_leaf pattern.
|
|
|
|
|
@kindex -quoted_not_list sets exclusions
|
|
|
|
|
@cindex Insert, file exclusion, -quoted_not_list
|
|
|
|
|
Like -not_list but with quoted input reading rules. Each word is
|
|
|
|
|
handled as one parameter for -not_paths resp. -not_leaf.
|
|
|
|
|
handled as one parameter for -not_paths or -not_leaf.
|
|
|
|
|
@c man .TP
|
|
|
|
|
@item -follow occasion[:occasion[...]]
|
|
|
|
|
@kindex -follow softlinks and mount points
|
|
|
|
|
@ -1751,7 +1752,7 @@ Set the threshold for automatic splitting of regular files. Such splitting
|
|
|
|
|
maps a large disk file onto a ISO directory with several part files in it.
|
|
|
|
|
This is necessary if the size of the disk file exceeds -file_size_limit.
|
|
|
|
|
Older operating systems can handle files in mounted ISO 9660 filesystems
|
|
|
|
|
only if they are smaller than 2 GiB resp. 4 GiB.
|
|
|
|
|
only if they are smaller than 2 GiB or in other cases 4 GiB.
|
|
|
|
|
@*
|
|
|
|
|
Default is 0 which will exclude files larger than -file_size_limit by a
|
|
|
|
|
FAILURE event.
|
|
|
|
|
@ -1915,8 +1916,8 @@ ACL entries are separated by comma or newline. If an entry is empty text or
|
|
|
|
|
begins with "#" then it will be ignored. A valid entry has to begin
|
|
|
|
|
by a letter out of @{ugom@} for "user", "group", "other", "mask". It has to
|
|
|
|
|
contain two colons ":". A non-empty text between those ":" gives a user id
|
|
|
|
|
resp. group id. After the second ":" there may be letters out of @{rwx- #@}.
|
|
|
|
|
The first three give read, write resp. execute permission.
|
|
|
|
|
or group id. After the second ":" there may be letters out of @{rwx- #@}.
|
|
|
|
|
The first three give read, write, or execute permission.
|
|
|
|
|
Letters "-", " " and TAB are ignored. "#" causes the rest of the entry to
|
|
|
|
|
be ignored. Letter "X" or any other letters are not supported. Examples:
|
|
|
|
|
@*
|
|
|
|
|
@ -2193,7 +2194,7 @@ All applicable -compliance rules are taken into respect.
|
|
|
|
|
Rule "omit_version" is always enabled, because else
|
|
|
|
|
namespaces "joliet" and "ecma119" would cause changes with every
|
|
|
|
|
non-directory name.
|
|
|
|
|
Consider to also enable rules "no_force_dots" resp. "no_j_force_dots".
|
|
|
|
|
Consider to also enable rules "no_force_dots" and "no_j_force_dots".
|
|
|
|
|
@*
|
|
|
|
|
The namespaces use different character sets and apply further restrictions
|
|
|
|
|
to name length, permissible characters, and mandatory name components.
|
|
|
|
|
@ -2223,7 +2224,7 @@ is performed if the decision is "yes" or "true". See operator -if.
|
|
|
|
|
@c man \fB\-true\fR and \fB\-false\fR :
|
|
|
|
|
@c man-ignore-lines 1
|
|
|
|
|
@item -true and -false :
|
|
|
|
|
Always match resp. match not. Evaluation goes on.
|
|
|
|
|
Always match or match not, respectively. Evaluation goes on.
|
|
|
|
|
@*
|
|
|
|
|
@item -sort_lba :
|
|
|
|
|
Always match. This causes -find to perform its action in a sequence sorted by
|
|
|
|
|
@ -2718,7 +2719,7 @@ under SEE ALSO.
|
|
|
|
|
@item -eject "in"|"out"|"all"
|
|
|
|
|
@kindex -eject ejects drive tray
|
|
|
|
|
@cindex Drive, eject tray, -eject
|
|
|
|
|
Eject the medium in -indev, resp. -outdev, resp. both drives.
|
|
|
|
|
Eject the medium in -indev, -outdev, or both drives, respectively.
|
|
|
|
|
Note: It is not possible yet to effectively eject disk files.
|
|
|
|
|
@c man .TP
|
|
|
|
|
@item -commit_eject "in"|"out"|"all"|"none"
|
|
|
|
|
@ -2864,9 +2865,9 @@ Only if the drive reports contradicting speed information there will appear
|
|
|
|
|
-speed 0, if it deviates from "Write speed H".
|
|
|
|
|
@*
|
|
|
|
|
"Read speed L" and "Read speed H" tell the minimum and maximum read speeds,
|
|
|
|
|
as reported by the drive. They would be chosen by -read_speed "min" resp.
|
|
|
|
|
"max" if they undercut resp. surpass the built-in limits. These are "1x"
|
|
|
|
|
resp. "52xCD", "24xDVD", "20xBD".
|
|
|
|
|
as reported by the drive. They would be chosen by -read_speed "min" or
|
|
|
|
|
"max" if they undercut or surpass the built-in limits. These are "1x",
|
|
|
|
|
"52xCD", "24xDVD", "20xBD".
|
|
|
|
|
@c man .TP
|
|
|
|
|
@item -close_damaged "as_needed"|"force"
|
|
|
|
|
@kindex -close_damaged closes damaged track and session
|
|
|
|
|
@ -2889,7 +2890,8 @@ After closing was attempted, both drives are given up.
|
|
|
|
|
@item -list_profiles "in"|"out"|"all"
|
|
|
|
|
@kindex -list_profiles lists supported media
|
|
|
|
|
@cindex Drive, list supported media, -list_profiles
|
|
|
|
|
Put out a list of media types supported by -indev, resp. -outdev, resp. both.
|
|
|
|
|
Put out a list of media types supported by -indev, -outdev, or both,
|
|
|
|
|
respectively.
|
|
|
|
|
The currently recognized type is marked by text "(current)".
|
|
|
|
|
@end table
|
|
|
|
|
@c man .TP
|
|
|
|
|
@ -3335,6 +3337,46 @@ or BD media. A number of 64 KB may improve throughput with bus systems which
|
|
|
|
|
show latency problems. The default depends on media type, on command
|
|
|
|
|
-stream_recording , and on compile time options.
|
|
|
|
|
@c man .TP
|
|
|
|
|
@item -modesty_on_drive parameter[:parameters]
|
|
|
|
|
@kindex -modesty_on_drive keep drive buffer hungry
|
|
|
|
|
@cindex Write, drive buffer, -modesty_on_drive
|
|
|
|
|
Control whether the drive buffer shall be kept from getting completely filled.
|
|
|
|
|
Parameter "on" (or "1") keeps the program from trying to write to the burner
|
|
|
|
|
drive while its buffer is in danger to be filled over a given limit.
|
|
|
|
|
If this limit is exceeded then the program will wait until the filling
|
|
|
|
|
reaches a given low percentage value.
|
|
|
|
|
@*
|
|
|
|
|
This can ease the load on operating system and drive controller and thus help
|
|
|
|
|
with achieving better input bandwidth if disk and burner are not on independent
|
|
|
|
|
controllers (like hda and hdb). It may also help with simultaneous burns on
|
|
|
|
|
different burners with Linux kernels like 3.16. On the other hand it increases
|
|
|
|
|
the risk of buffer underflow and thus reduced write speed.
|
|
|
|
|
@*
|
|
|
|
|
Some burners are not suitable because they
|
|
|
|
|
report buffer fill with granularity too coarse in size or time,
|
|
|
|
|
or expect their buffer to be filled to the top before they go to full speed.
|
|
|
|
|
@*
|
|
|
|
|
Parameters "off" or "0" disable this feature.
|
|
|
|
|
@*
|
|
|
|
|
The threshhold for beginning to wait is given by parameter "max_percent=".
|
|
|
|
|
Parameter "min_percent=" defines the threshhold for resuming transmission.
|
|
|
|
|
Percentages are permissible in the range of 25 to 100. Numbers in this
|
|
|
|
|
range without a prepended name are interpreted as "on:min_percent=".
|
|
|
|
|
@*
|
|
|
|
|
E.g.: -modesty_on_drive 75
|
|
|
|
|
@*
|
|
|
|
|
The optimal values depend on the buffer behavior of the drive.
|
|
|
|
|
@*
|
|
|
|
|
There are also timing parameters "timeout_sec=", "min_usec=", "max_usec=".
|
|
|
|
|
Read the description of burn_drive_set_buffer_waiting() in libburn.h,
|
|
|
|
|
before setting them to non-default values.
|
|
|
|
|
@*
|
|
|
|
|
Parameters, which are not mentioned with a -modesty_on_drive command,
|
|
|
|
|
stay unchanged.
|
|
|
|
|
Default is:
|
|
|
|
|
@*
|
|
|
|
|
-modesty_on_drive off:min_percent=65:max_percent=95
|
|
|
|
|
@c man .TP
|
|
|
|
|
@item -stdio_sync "on"|"off"|"end"|number
|
|
|
|
|
@kindex -stdio_sync controls stdio buffer
|
|
|
|
|
@cindex Write, buffer syncing, -stdio_sync
|
|
|
|
|
@ -3845,8 +3887,8 @@ This is mutually exclusive with production of other boot blocks like MBR.
|
|
|
|
|
@*
|
|
|
|
|
@strong{mips_discard}, @strong{sparc_discard}, @strong{hppa_discard},
|
|
|
|
|
@strong{alpha_discard}
|
|
|
|
|
revoke any boot file declarations made for mips, mipsel, sparc, hppa,
|
|
|
|
|
resp. alpha.
|
|
|
|
|
revoke any boot file declarations made for mips/mipsel, sparc, hppa,
|
|
|
|
|
or alpha, respectively.
|
|
|
|
|
This removes the ban on production of other boot blocks.
|
|
|
|
|
@*
|
|
|
|
|
@cindex HFS+ serial number
|
|
|
|
|
@ -4322,7 +4364,7 @@ before ending the program.
|
|
|
|
|
With setting "tree" the reassuring prompt will appear for an eventual
|
|
|
|
|
directory only once and not for each file in its whole subtree.
|
|
|
|
|
@*
|
|
|
|
|
Setting "off" silently kills any kind of image file object resp. performs
|
|
|
|
|
Setting "off" silently kills any kind of image file object and performs
|
|
|
|
|
above irrevocable actions.
|
|
|
|
|
@*
|
|
|
|
|
To really produce user prompts, command -dialog needs to be set to "on".
|
|
|
|
|
@ -4455,7 +4497,7 @@ address.
|
|
|
|
|
"%sbsector%" will be substituted by the session start sector.
|
|
|
|
|
@*
|
|
|
|
|
"%track%", "%session%", "%volid%" will be substituted by track number,
|
|
|
|
|
session number, resp. volume id of the depicted session.
|
|
|
|
|
session number, or volume id of the depicted session.
|
|
|
|
|
@c man .TP
|
|
|
|
|
@item -print_size
|
|
|
|
|
@kindex -print_size predicts image size
|
|
|
|
|
@ -4607,8 +4649,8 @@ File type 'e' indicates the El Torito boot catalog.
|
|
|
|
|
@*
|
|
|
|
|
If the file has non-trivial ACL, then a '+' is appended to the permission info.
|
|
|
|
|
If the file is hidden, then 'I' for "iso_rr", 'J' for "joliet", 'A'
|
|
|
|
|
for "hfsplus", resp. 'H' for multiple hiding gets appended.
|
|
|
|
|
Together with ACL it is 'i', 'j', 'a', resp. 'h'.
|
|
|
|
|
for "hfsplus", 'H' for multiple hiding gets appended.
|
|
|
|
|
Together with ACL it is 'i', 'j', 'a', 'h'.
|
|
|
|
|
@c man .TP
|
|
|
|
|
@item -lsdl iso_rr_pattern [***]
|
|
|
|
|
@kindex -lsdl lists files in ISO image
|
|
|
|
|
@ -5320,7 +5362,7 @@ 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",
|
|
|
|
|
by default.
|
|
|
|
|
@minus{}disk_dev_ino can be set to "off" by @minus{}@minus{}old-root-no-ino
|
|
|
|
|
resp. to "on" by @minus{}@minus{}old-root-devno .
|
|
|
|
|
or to "on" by @minus{}@minus{}old-root-devno .
|
|
|
|
|
@minus{}md5 can be set to "off" by @minus{}@minus{}old-root-no-md5 .
|
|
|
|
|
@*
|
|
|
|
|
Not original mkisofs options are @minus{}@minus{}quoted_path_list ,
|
|
|
|
|
@ -5493,7 +5535,7 @@ character device.
|
|
|
|
|
If list_path is not empty then the record will also be appended to the
|
|
|
|
|
data file given by this path.
|
|
|
|
|
@*
|
|
|
|
|
Program scdbackup_verify will recognize and verify tag resp. record.
|
|
|
|
|
Program scdbackup_verify will recognize and verify tag and file record.
|
|
|
|
|
@end table
|
|
|
|
|
@c man .TP
|
|
|
|
|
@c man .B Scripting, dialog and program control features:
|
|
|
|
|
@ -5674,7 +5716,7 @@ result and info channel. An empty text will cause no output at all.
|
|
|
|
|
@cindex Program, prompt for enter key, -prompt
|
|
|
|
|
Show text at beginning of output line and
|
|
|
|
|
wait for the user to hit the Enter key
|
|
|
|
|
resp. to send a line via stdin.
|
|
|
|
|
or to send a line via stdin.
|
|
|
|
|
@c man .TP
|
|
|
|
|
@item -sleep seconds
|
|
|
|
|
@kindex -sleep waits for a given time span
|
|
|
|
|
@ -5711,7 +5753,7 @@ This transport becomes visible with -report_about "ALL".
|
|
|
|
|
If path is not empty it gives the address of a plain text file where
|
|
|
|
|
a log record gets appended after each session. This log can be used to
|
|
|
|
|
determine the start_lba of a session for mount options -o sbsector=
|
|
|
|
|
resp. -s from date or volume ID.
|
|
|
|
|
(on GNU/Linux) or -s (on FreeBSD) from date or volume ID.
|
|
|
|
|
@*
|
|
|
|
|
Record format is: timestamp start_lba size volume-id
|
|
|
|
|
@*
|
|
|
|
|
@ -5934,7 +5976,7 @@ or be "-" to leave the according standard i/o channel unreplaced.
|
|
|
|
|
@*
|
|
|
|
|
xorriso will open the stdin pipe, read and execute dialog lines from it
|
|
|
|
|
until the sender closes the pipe. The output pipes get opened depending on
|
|
|
|
|
mode "buffered" resp. "direct". After all lines are executed, xorriso will
|
|
|
|
|
mode "buffered" or "direct". After all lines are executed, xorriso will
|
|
|
|
|
close its side of the pipes and enter a new cycle of opening, reading and
|
|
|
|
|
executing.
|
|
|
|
|
@*
|
|
|
|
|
@ -6562,7 +6604,7 @@ sums against the current file content on hard disk. This is usually much faster
|
|
|
|
|
than the default which compares both contents directly.
|
|
|
|
|
@*
|
|
|
|
|
With @strong{mount} option @strong{-o "sbsector="} on GNU/Linux
|
|
|
|
|
resp. @strong{-s} on FreeBSD or NetBSD
|
|
|
|
|
or @strong{-s} on FreeBSD or NetBSD
|
|
|
|
|
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=".
|
|
|
|
|
@ -6666,7 +6708,7 @@ $ xorriso -abort_on NEVER -indev /dev/sr0 \
|
|
|
|
|
This can be repeated several times, if necessary with -eject or with other
|
|
|
|
|
-indev drives. See the human readable part of "$HOME"/dvd_copy.map for
|
|
|
|
|
addresses which can be used on "$HOME"/dvd_copy with mount option -o sbsector=
|
|
|
|
|
resp. -s.
|
|
|
|
|
or -s.
|
|
|
|
|
@c man .SH FILES
|
|
|
|
|
@node Files, Seealso, Examples, Top
|
|
|
|
|
@chapter Files
|
|
|
