New -follow occasion "concat"
This commit is contained in:
@ -1337,25 +1337,31 @@ handled as one parameter for \-not_paths resp. \-not_leaf.
|
||||
.TP
|
||||
\fB\-follow\fR occasion[:occasion[...]]
|
||||
Enable or disable resolution of symbolic links and mountpoints under
|
||||
disk_paths. This applies to actions \-add, \-du*x, \-ls*x, \-findx,
|
||||
disk_paths. This applies to actions \-add, \-du*x, \-ls*x, \-findx, \-concat,
|
||||
and to \-disk_pattern expansion.
|
||||
.br
|
||||
There are two kinds of follow decisison to be made:
|
||||
There are three kinds of follow decisison to be made:
|
||||
.br
|
||||
"link" is the hop from a symbolic link to its target file object.
|
||||
\fBlink\fR is the hop from a symbolic link to its target file object for the
|
||||
purpose of reading. I.e. not for command \-concat.
|
||||
If enabled then symbolic links are handled as their target file objects,
|
||||
else symbolic links are handled as themselves.
|
||||
.br
|
||||
"mount" is the hop from one filesystem to another subordinate filesystem.
|
||||
\fBmount\fR is the hop from one filesystem to another subordinate filesystem.
|
||||
If enabled then mountpoint directories are handled as any other directory,
|
||||
else mountpoints are handled as empty directories if they are encountered in
|
||||
directory tree traversals.
|
||||
.br
|
||||
\fBconcat\fR is the hop from a symbolic link to its target file object for
|
||||
the purpose of writing. I.e. for command \-concat. This is a security risk !
|
||||
.br
|
||||
Less general than above occasions:
|
||||
.br
|
||||
"pattern" is mount and link hopping, but only during \-disk_pattern expansion.
|
||||
\fBpattern\fR is mount and link hopping, but only during \-disk_pattern
|
||||
expansion.
|
||||
.br
|
||||
"param" is link hopping for parameter words (after eventual pattern expansion).
|
||||
\fBparam\fR is link hopping for parameter words (after eventual pattern
|
||||
expansion).
|
||||
If enabled then \-ls*x will show the link targets rather than the links
|
||||
themselves. \-du*x, \-findx, and \-add will process the link targets but not
|
||||
follow links in an eventual directory tree below the targets (unless "link"
|
||||
@ -1364,19 +1370,19 @@ is enabled).
|
||||
Occasions can be combined in a colon separated list. All occasions
|
||||
mentioned in the list will then lead to a positive follow decision.
|
||||
.br
|
||||
"off" prevents any positive follow decision. Use it if no other occasion
|
||||
\fBoff\fR prevents any positive follow decision. Use it if no other occasion
|
||||
applies.
|
||||
.br
|
||||
Shortcuts:
|
||||
.br
|
||||
"default" is equivalent to "pattern:mount:limit=100".
|
||||
\fBdefault\fR is equivalent to "pattern:mount:limit=100".
|
||||
.br
|
||||
"on" always decides positive. Equivalent to "link:mount".
|
||||
\fBon\fR always decides positive. Equivalent to "link:mount:concat".
|
||||
.br
|
||||
|
||||
Not an occasion but an optional setting is:
|
||||
.br
|
||||
"limit="<number> which sets the maximum number of link hops.
|
||||
\fBlimit=\fR<number> which sets the maximum number of link hops.
|
||||
A link hop consists of a sequence of symbolic links and a final target
|
||||
of different type. Nevertheless those hops can loop. Example:
|
||||
.br
|
||||
|
Reference in New Issue
Block a user