From defe2287aa7e4fedc3c5589d142cfad7b740dacd Mon Sep 17 00:00:00 2001 From: Wayne Davison Date: Sun, 19 Jun 2022 16:43:38 -0700 Subject: Improve the filter intro. --- rsync.1.md | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) diff --git a/rsync.1.md b/rsync.1.md index 038dbdc0..9c149b31 100644 --- a/rsync.1.md +++ b/rsync.1.md @@ -3739,11 +3739,19 @@ The options allowed when starting an rsync daemon are as follows: ## FILTER RULES -The filter rules allow for flexible selection of which files to transfer -(include) and which files to skip (exclude). The rules either directly specify -include/exclude patterns or they specify a way to acquire more include/exclude -patterns (e.g. to read them from a file). Some rules even exclude/include xattr -attributes. +The filter rules allow for custom control of several aspects of how files are +handled: + +- Control which files the sending side puts into the file list that describes + the transfer hierarchy +- Control which files the receiving side protects from deletion when the file + is not in the sender's file list +- Control which extended attribute names are skipped when copying xattrs + +The rules are either directly specified via option arguments or they can be +read in from one or more files. The filter-rule files can even be a part of +the hierarchy of files being copied, affecting different parts of the tree in +different ways. ### SIMPLE INCLUDE/EXCLUDE RULES -- cgit v1.2.1