New options -cpax, -cp_rx, cp_rax to restore files and trees from ISO to disk
This commit is contained in:
@ -2,7 +2,7 @@
|
||||
.\" First parameter, NAME, should be all caps
|
||||
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
||||
.\" other parameters are allowed: see man(7), man(1)
|
||||
.TH XORRISO 1 "Jun, 02, 2008"
|
||||
.TH XORRISO 1 "Jun, 5, 2008"
|
||||
.\" Please adjust this date whenever revising the manpage.
|
||||
.\"
|
||||
.\" Some roff macros, for reference:
|
||||
@ -146,7 +146,7 @@ There are two families of media in the MMC standard:
|
||||
unformatted DVD-RW. These media provide a table of content which
|
||||
describes their existing sessions. See option \fB-toc\fR.
|
||||
.br
|
||||
\fBOverwriteable\fR media are DVD-RAM, DVD+RW, and formatted DVD-RW.
|
||||
\fBOverwriteable\fR media are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW.
|
||||
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
|
||||
first session was written by xorriso, then a table of content can
|
||||
@ -181,7 +181,7 @@ Appendable is the state after writing a session with option -close off.
|
||||
for xorriso.
|
||||
.br
|
||||
Closed is the state of DVD-ROM media and of multi-session media which were
|
||||
written with option -close on. If the drive is incapable of writing it will
|
||||
written with option -close on. If the drive is read-only hardware then it will
|
||||
probably show any media as closed CD-ROM resp. DVD-ROM.
|
||||
.br
|
||||
Overwriteable media assume this state in such read-only drives or if they
|
||||
@ -1140,6 +1140,9 @@ With setting "nondir", only directories are protected by such events, other
|
||||
existing file types get treated with -rm before the new file gets added.
|
||||
Setting "on" allows automatic -rm_r. I.e. a non-directory can replace an
|
||||
existing directory and all its subordinates.
|
||||
.br
|
||||
If restoring of files is enabled, then the overwrite rule applies to the
|
||||
target file objects on disk as well.
|
||||
.TP
|
||||
\fB\-split_size\fR number["k"|"m"]
|
||||
Set the threshold for automatic splitting of regular files. Such splitting
|
||||
@ -1385,6 +1388,8 @@ If "on" then ask the user for "y" or "n":
|
||||
.br
|
||||
before deleting or overwriting any file in the ISO image,
|
||||
.br
|
||||
before overwriting any disk file during restore operations,
|
||||
.br
|
||||
before rolling back pending image changes,
|
||||
.br
|
||||
before committing image changes to media,
|
||||
@ -1602,12 +1607,19 @@ Normally xorriso only writes to disk files which were given as stdio:
|
||||
pseudo-drives or as log files.
|
||||
But its alter ego, osirrox, is able to extract file objects
|
||||
from ISO images and to create, overwrite, or delete file objects on disk.
|
||||
.br
|
||||
Disk file exclusions by -not_mgt, -not_leaf, -not_paths apply.
|
||||
If disk file objects already exist then the settings of -overwrite and
|
||||
-reassure apply.
|
||||
.TP
|
||||
\fB\-osirrox\fR "on"|"device_files"|"off"[:option:...]
|
||||
Setting "off" disables disk filesystem manipulations. This is the default
|
||||
unless the program was started with leafname "osirrox". Elsewise
|
||||
the capability to restore files can be enabled explicitly by -osirrox "on".
|
||||
.br
|
||||
Access permissions of files in the ISO image do not restrict restoring.
|
||||
The permissions on disk have to allow writing, of course.
|
||||
.br
|
||||
To enable restoring of special files by "device_files" is potentially
|
||||
dangerous.
|
||||
The meaning of the number st_rdev (see man 2 stat) depends much on the
|
||||
@ -1624,7 +1636,7 @@ directories as data files if the directory contains a complete collection
|
||||
of -cut_out part files.
|
||||
.br
|
||||
With option "concat_split_off" such directories are
|
||||
handled as any other ISO image directory.
|
||||
handled like any other ISO image directory.
|
||||
.TP
|
||||
\fB\-cpx\fR iso_rr_path [***] disk_path
|
||||
Extract single leaf file objects from the ISO image and store them under
|
||||
@ -1633,13 +1645,26 @@ disk_path must be a directory or non-existent. In the latter case it gets
|
||||
created. The extracted files get installed in it with the same leafnames.
|
||||
.br
|
||||
Missing directory components in disk_path will get created, if possible.
|
||||
Disk file exclusions are in effect. If this is undesired then perform
|
||||
-not_mgt "off" first.
|
||||
.br
|
||||
Directories are allowed as iso_rr_path only with -osirrox "concat_split_on"
|
||||
and only if they actually represent a complete collection of -cut_out split
|
||||
file parts.
|
||||
.TP
|
||||
\fB\-cpax\fR iso_rr_path [***] disk_path
|
||||
Like -cpx but restoring mtime, atime as in ISO image and trying to set
|
||||
ownership and group as in ISO image.
|
||||
.TP
|
||||
\fB\-cp_rx\fR iso_rr_path [***] disk_path
|
||||
Like -cpx but also extracting whole directory trees from the ISO image.
|
||||
If directories do already exist under disk_path then their content
|
||||
eventually gets merged with the content of restored directories
|
||||
of the same name. Disk files get removed only if they are to be replaced
|
||||
by file objects from the ISO image.
|
||||
.TP
|
||||
\fB\-cp_rax\fR iso_rr_path [***] disk_path
|
||||
Like -cp_rx but restoring mtime, atime as in ISO image and trying to set
|
||||
ownership and group as in ISO image.
|
||||
.TP
|
||||
.B Command compatibility emulations:
|
||||
.PP
|
||||
Writing of ISO 9660 on CD is traditionally done by program mkisofs
|
||||
|
||||
Reference in New Issue
Block a user