Commit 83fd337d authored by J.W. Schultz's avatar J.W. Schultz

Modified the (in|ex)clude [from] option descriptions to

better highlight the non-equivalence with client-side
--exclude.
parent 707c1a30
...@@ -176,15 +176,17 @@ was run as root. This complements the "uid" option. The default is gid -2, ...@@ -176,15 +176,17 @@ was run as root. This complements the "uid" option. The default is gid -2,
which is normally the group "nobody". which is normally the group "nobody".
dit(bf(exclude)) The "exclude" option allows you to specify a space dit(bf(exclude)) The "exclude" option allows you to specify a space
separated list of patterns to add to the exclude list. This is equivalent separated list of patterns to add to the exclude list.
to the client specifying these patterns with the --exclude option, except This is only superficially equivalent
that the exclude list is not passed to the client and thus only applies on to the client specifying these patterns with the --exclude option.
Only one "exclude" option may be specified, but
you can use "-" and "+" before patterns to specify exclude/include.
Because this exclude list is not passed to the client it only applies on
the server: that is, it excludes files received by a client when receiving the server: that is, it excludes files received by a client when receiving
from a server and files deleted on a server when sending to a server, but from a server and files deleted on a server when sending to a server, but
it doesn't exclude files sent from a client when sending to a server or it doesn't exclude files sent from a client when sending to a server or
files deleted on a client when receiving from a server. files deleted on a client when receiving from a server.
Only one "exclude" option may be specified, but
you can use "-" and "+" before patterns to specify exclude/include.
Note that this option is not designed with strong security in Note that this option is not designed with strong security in
mind, it is quite possible that a client may find a way to bypass this mind, it is quite possible that a client may find a way to bypass this
...@@ -193,24 +195,25 @@ cannot be accessed then use the uid/gid options in combination with ...@@ -193,24 +195,25 @@ cannot be accessed then use the uid/gid options in combination with
file permissions. file permissions.
dit(bf(exclude from)) The "exclude from" option specifies a filename dit(bf(exclude from)) The "exclude from" option specifies a filename
on the server that contains exclude patterns, one per line. This is on the server that contains exclude patterns, one per line.
equivalent to the client specifying the --exclude-from option with a This is only superficially equivalent
equivalent file except that it applies only on the server. See also to the client specifying the --exclude-from option with an equivalent file.
the "exclude" option above. See the "exclude" option above.
dit(bf(include)) The "include" option allows you to specify a space dit(bf(include)) The "include" option allows you to specify a space
separated list of patterns which rsync should not exclude. This is separated list of patterns which rsync should not exclude. This is
equivalent to the client specifying these patterns with the --include only superficially equivalent to the client specifying these patterns
option except that it applies only on the server. This is useful as it with the --include option because it applies only on the server.
This is useful as it
allows you to build up quite complex exclude/include rules. Only one allows you to build up quite complex exclude/include rules. Only one
"include" option may be specified, but you can use "+" and "-" before "include" option may be specified, but you can use "+" and "-" before
patterns to switch include/exclude. See also the "exclude" option above. patterns to switch include/exclude. See the "exclude" option above.
dit(bf(include from)) The "include from" option specifies a filename dit(bf(include from)) The "include from" option specifies a filename
on the server that contains include patterns, one per line. This is on the server that contains include patterns, one per line. This is
equivalent to the client specifying the --include-from option with a only superficially equivalent to the client specifying the
equivalent file except that it applies only on the server. See also --include-from option with a equivalent file.
the "exclude" option above. See the "exclude" option above.
dit(bf(auth users)) The "auth users" option specifies a comma and dit(bf(auth users)) The "auth users" option specifies a comma and
space separated list of usernames that will be allowed to connect to space separated list of usernames that will be allowed to connect to
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment