New -follow occasion "concat"

This commit is contained in:
2014-04-21 16:56:44 +00:00
parent 642ec7ca89
commit 9ae473dac0
9 changed files with 121 additions and 94 deletions

View File

@ -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