Bug fix: -not_leaf and -not_paths were not applied to -extract and alike
This commit is contained in:
@ -9,7 +9,7 @@
|
||||
.\" First parameter, NAME, should be all caps
|
||||
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
||||
.\" other parameters are allowed: see man(7), man(1)
|
||||
.TH XORRISO 1 "Version 1.5.5, Sep 12, 2021"
|
||||
.TH XORRISO 1 "Version 1.5.5, Sep 13, 2021"
|
||||
.\" Please adjust this date whenever revising the manpage.
|
||||
.\"
|
||||
.\" Some roff macros, for reference:
|
||||
@ -1494,10 +1494,13 @@ the target filesystem of an \-extract must be able to take the file size.
|
||||
\fB\-not_mgt\fR code[:code[...]]
|
||||
Control the behavior of the exclusion lists.
|
||||
.br
|
||||
Exclusion processing happens before disk_paths get mapped to the ISO image
|
||||
and before disk files get compared with image files.
|
||||
The absolute disk path of the source is matched against the \-not_paths list.
|
||||
The leafname of the disk path is matched against the patterns in the \-not_leaf
|
||||
Exclusion processing happens before disk_paths get mapped to the ISO image,
|
||||
before disk files get compared with image files, and before image files get
|
||||
extracted to disk files.
|
||||
.br
|
||||
The absolute disk paths involved in such an action are matched against the
|
||||
\-not_paths list.
|
||||
The leafnames of disk paths are matched against the patterns in the \-not_leaf
|
||||
list. If a match is detected then the disk path will not be regarded as an
|
||||
existing file and not be added to the ISO image.
|
||||
.br
|
||||
@ -1538,6 +1541,13 @@ path is relative, then the current \-cdx is prepended to form an absolute path.
|
||||
Pattern matching, if enabled, happens at definition time and not when exclusion
|
||||
checks are made.
|
||||
.br
|
||||
Keep in mind that there may be alternative paths to the same disk file. The
|
||||
exclusion tests are done literally, so that they do not keep files from getting
|
||||
into the ISO filesystem by other paths. Accordingly an exclusion does not
|
||||
prevent a disk file from being overwritten by file extraction via an
|
||||
alternative not excluded path. So the exlusions need to be coordinated with
|
||||
the actual disk_path parameters given with commands.
|
||||
.br
|
||||
(Do not forget to end the list of disk_paths by "\-\-")
|
||||
.TP
|
||||
\fB\-not_leaf\fR pattern
|
||||
@ -4983,6 +4993,15 @@ 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.
|
||||
The exclusion tests are made with the paths and names for the disk files.
|
||||
If exclusion of paths or names in the ISO image is desired, then use image
|
||||
manipulation commands like \-rm or \-find ... \-exec rm before extraction,
|
||||
and end the program by \-rollback_end .
|
||||
.br
|
||||
Excluded disk_path parameters of extraction commands cause SORRY events.
|
||||
Implicitely given paths in trees under disk_path parameters are excluded
|
||||
silently.
|
||||
.br
|
||||
If disk file objects already exist then the settings of \-overwrite and
|
||||
\-reassure apply. But \-overwrite "on" only triggers the behavior
|
||||
of \-overwrite "nondir". I.e. directories cannot be deleted.
|
||||
|
Reference in New Issue
Block a user