788 +To make a file executable, rsync turns on each 'x' permission that |
790 +To make a file executable, rsync turns on each 'x' permission that |
789 +has a corresponding 'r' permission enabled. |
791 +has a corresponding 'r' permission enabled. |
790 .RE |
792 .RE |
791 |
793 |
792 .IP |
794 .IP |
793 @@ -1265,19 +1269,19 @@ |
795 @@ -1253,6 +1257,8 @@ |
|
796 The source and destination systems must have compatible ACL entries for this |
|
797 option to work properly. See the \fB\-\-fake\-super\fP option for a way to backup |
|
798 and restore ACLs that are not compatible. |
|
799 +.IP |
|
800 +Note, that rsync does not support NFSv4 ACLs. |
|
801 .IP |
|
802 .IP "\fB\-X, \-\-xattrs\fP" |
|
803 This option causes rsync to update the destination |
|
804 @@ -1265,19 +1271,19 @@ |
794 .IP |
805 .IP |
795 Note that this option does not copy rsyncs special xattr values (e.g. those |
806 Note that this option does not copy rsyncs special xattr values (e.g. those |
796 used by \fB\-\-fake\-super\fP) unless you repeat the option (e.g. \-XX). This |
807 used by \fB\-\-fake\-super\fP) unless you repeat the option (e.g. \-XX). This |
797 -\(dq\© all xattrs\(dq\& mode cannot be used with \fB\-\-fake\-super\fP. |
808 -\(dq\© all xattrs\(dq\& mode cannot be used with \fB\-\-fake\-super\fP. |
798 +"copy all xattrs" mode cannot be used with \fB\-\-fake\-super\fP. |
809 +"copy all xattrs" mode cannot be used with \fB\-\-fake\-super\fP. |
812 +prefixing it with a 'D', or specify an item that should only apply to a |
823 +prefixing it with a 'D', or specify an item that should only apply to a |
813 +file by prefixing it with a 'F'. For example, the following will ensure |
824 +file by prefixing it with a 'F'. For example, the following will ensure |
814 that all directories get marked set\-gid, that no files are other\-writable, |
825 that all directories get marked set\-gid, that no files are other\-writable, |
815 that both are user\-writable and group\-writable, and that both have |
826 that both are user\-writable and group\-writable, and that both have |
816 consistent executability across all bits: |
827 consistent executability across all bits: |
817 @@ -1344,8 +1348,8 @@ |
828 @@ -1344,8 +1350,8 @@ |
818 option is not used, the optimization that excludes files that have not been |
829 option is not used, the optimization that excludes files that have not been |
819 modified cannot be effective; in other words, a missing \fB\-t\fP or \fB\-a\fP will |
830 modified cannot be effective; in other words, a missing \fB\-t\fP or \fB\-a\fP will |
820 cause the next transfer to behave as if it used \fB\-I\fP, causing all files to be |
831 cause the next transfer to behave as if it used \fB\-I\fP, causing all files to be |
821 -updated (though rsync\(cq\&s delta\-transfer algorithm will make the update fairly efficient |
832 -updated (though rsync\(cq\&s delta\-transfer algorithm will make the update fairly efficient |
822 -if the files haven\(cq\&t actually changed, you\(cq\&re much better off using \fB\-t\fP). |
833 -if the files haven\(cq\&t actually changed, you\(cq\&re much better off using \fB\-t\fP). |
823 +updated (though rsync's delta\-transfer algorithm will make the update fairly efficient |
834 +updated (though rsync's delta\-transfer algorithm will make the update fairly efficient |
824 +if the files haven't actually changed, you're much better off using \fB\-t\fP). |
835 +if the files haven't actually changed, you're much better off using \fB\-t\fP). |
825 .IP |
836 .IP |
826 .IP "\fB\-O, \-\-omit\-dir\-times\fP" |
837 .IP "\fB\-O, \-\-omit\-dir\-times\fP" |
827 This tells rsync to omit directories when |
838 This tells rsync to omit directories when |
828 @@ -1360,7 +1364,7 @@ |
839 @@ -1360,7 +1366,7 @@ |
829 directory right away (without having to delay that until a bunch of recursive |
840 directory right away (without having to delay that until a bunch of recursive |
830 copying has finished). This early\-create idiom is not necessary if directory |
841 copying has finished). This early\-create idiom is not necessary if directory |
831 modify times are not being preserved, so it is skipped. Since early\-create |
842 modify times are not being preserved, so it is skipped. Since early\-create |
832 -directories don\(cq\&t have accurate mode, mtime, or ownership, the use of this |
843 -directories don\(cq\&t have accurate mode, mtime, or ownership, the use of this |
833 +directories don't have accurate mode, mtime, or ownership, the use of this |
844 +directories don't have accurate mode, mtime, or ownership, the use of this |
834 option can help when someone wants to avoid these partially\-finished |
845 option can help when someone wants to avoid these partially\-finished |
835 directories. |
846 directories. |
836 .IP |
847 .IP |
837 @@ -1370,12 +1374,12 @@ |
848 @@ -1370,12 +1376,12 @@ |
838 .IP |
849 .IP |
839 .IP "\fB\-\-super\fP" |
850 .IP "\fB\-\-super\fP" |
840 This tells the receiving side to attempt super\-user |
851 This tells the receiving side to attempt super\-user |
841 -activities even if the receiving rsync wasn\(cq\&t run by the super\-user. These |
852 -activities even if the receiving rsync wasn\(cq\&t run by the super\-user. These |
842 +activities even if the receiving rsync wasn't run by the super\-user. These |
853 +activities even if the receiving rsync wasn't run by the super\-user. These |
848 -also for ensuring that you will get errors if the receiving side isn\(cq\&t |
859 -also for ensuring that you will get errors if the receiving side isn\(cq\&t |
849 +also for ensuring that you will get errors if the receiving side isn't |
860 +also for ensuring that you will get errors if the receiving side isn't |
850 being run as the super\-user. To turn off super\-user activities, the |
861 being run as the super\-user. To turn off super\-user activities, the |
851 super\-user can use \fB\-\-no\-super\fP. |
862 super\-user can use \fB\-\-no\-super\fP. |
852 .IP |
863 .IP |
853 @@ -1383,10 +1387,10 @@ |
864 @@ -1383,10 +1389,10 @@ |
854 When this option is enabled, rsync simulates |
865 When this option is enabled, rsync simulates |
855 super\-user activities by saving/restoring the privileged attributes via |
866 super\-user activities by saving/restoring the privileged attributes via |
856 special extended attributes that are attached to each file (as needed). This |
867 special extended attributes that are attached to each file (as needed). This |
857 -includes the file\(cq\&s owner and group (if it is not the default), the file\(cq\&s |
868 -includes the file\(cq\&s owner and group (if it is not the default), the file\(cq\&s |
858 +includes the file's owner and group (if it is not the default), the file's |
869 +includes the file's owner and group (if it is not the default), the file's |
862 +any permission bits that we won't allow to be set on the real file (e.g. |
873 +any permission bits that we won't allow to be set on the real file (e.g. |
863 +the real file gets u\-s,g\-s,o\-t for safety) or that would limit the owner's |
874 +the real file gets u\-s,g\-s,o\-t for safety) or that would limit the owner's |
864 access (since the real super\-user can always access/change a file, the |
875 access (since the real super\-user can always access/change a file, the |
865 files we create can always be accessed/changed by the creating user). |
876 files we create can always be accessed/changed by the creating user). |
866 This option also handles ACLs (if \fB\-\-acls\fP was specified) and non\-user |
877 This option also handles ACLs (if \fB\-\-acls\fP was specified) and non\-user |
867 @@ -1412,18 +1416,18 @@ |
878 @@ -1412,18 +1418,18 @@ |
868 .IP |
879 .IP |
869 This option is overridden by both \fB\-\-super\fP and \fB\-\-no\-super\fP. |
880 This option is overridden by both \fB\-\-super\fP and \fB\-\-no\-super\fP. |
870 .IP |
881 .IP |
871 -See also the \(dq\&fake super\(dq\& setting in the daemon\(cq\&s rsyncd.conf file. |
882 -See also the \(dq\&fake super\(dq\& setting in the daemon\(cq\&s rsyncd.conf file. |
872 +See also the "fake super" setting in the daemon's rsyncd.conf file. |
883 +See also the "fake super" setting in the daemon's rsyncd.conf file. |
885 +the real filesystem\-level preallocation support provided by Linux's |
896 +the real filesystem\-level preallocation support provided by Linux's |
886 +\fBfallocate\fP(2) system call or Cygwin's \fBposix_fallocate\fP(3), not the slow |
897 +\fBfallocate\fP(2) system call or Cygwin's \fBposix_fallocate\fP(3), not the slow |
887 glibc implementation that writes a zero byte into each block. |
898 glibc implementation that writes a zero byte into each block. |
888 .IP |
899 .IP |
889 Without this option, larger files may not be entirely contiguous on the |
900 Without this option, larger files may not be entirely contiguous on the |
890 @@ -1432,7 +1436,7 @@ |
901 @@ -1432,7 +1438,7 @@ |
891 etc.), this option may have no positive effect at all. |
902 etc.), this option may have no positive effect at all. |
892 .IP |
903 .IP |
893 .IP "\fB\-n, \-\-dry\-run\fP" |
904 .IP "\fB\-n, \-\-dry\-run\fP" |
894 -This makes rsync perform a trial run that doesn\(cq\&t |
905 -This makes rsync perform a trial run that doesn\(cq\&t |
895 +This makes rsync perform a trial run that doesn't |
906 +This makes rsync perform a trial run that doesn't |
896 make any changes (and produces mostly the same output as a real run). It |
907 make any changes (and produces mostly the same output as a real run). It |
897 is most commonly used in combination with the \fB\-v, \-\-verbose\fP and/or |
908 is most commonly used in combination with the \fB\-v, \-\-verbose\fP and/or |
898 \fB\-i, \-\-itemize\-changes\fP options to see what an rsync command is going |
909 \fB\-i, \-\-itemize\-changes\fP options to see what an rsync command is going |
899 @@ -1440,29 +1444,29 @@ |
910 @@ -1440,29 +1446,29 @@ |
900 .IP |
911 .IP |
901 The output of \fB\-\-itemize\-changes\fP is supposed to be exactly the same on a |
912 The output of \fB\-\-itemize\-changes\fP is supposed to be exactly the same on a |
902 dry run and a subsequent real run (barring intentional trickery and system |
913 dry run and a subsequent real run (barring intentional trickery and system |
903 -call failures); if it isn\(cq\&t, that\(cq\&s a bug. Other output should be mostly |
914 -call failures); if it isn\(cq\&t, that\(cq\&s a bug. Other output should be mostly |
904 +call failures); if it isn't, that's a bug. Other output should be mostly |
915 +call failures); if it isn't, that's a bug. Other output should be mostly |
932 -in mind that rsync treats a \(dq\&bind\(dq\& mount to the same device as being on the |
943 -in mind that rsync treats a \(dq\&bind\(dq\& mount to the same device as being on the |
933 +in mind that rsync treats a "bind" mount to the same device as being on the |
944 +in mind that rsync treats a "bind" mount to the same device as being on the |
934 same filesystem. |
945 same filesystem. |
935 .IP |
946 .IP |
936 If this option is repeated, rsync omits all mount\-point directories from |
947 If this option is repeated, rsync omits all mount\-point directories from |
937 @@ -1482,8 +1486,8 @@ |
948 @@ -1482,8 +1488,8 @@ |
938 combined with the \fB\-\-ignore\-existing\fP option, no files will be updated |
949 combined with the \fB\-\-ignore\-existing\fP option, no files will be updated |
939 (which can be useful if all you want to do is delete extraneous files). |
950 (which can be useful if all you want to do is delete extraneous files). |
940 .IP |
951 .IP |
941 -This option is a transfer rule, not an exclude, so it doesn\(cq\&t affect the |
952 -This option is a transfer rule, not an exclude, so it doesn\(cq\&t affect the |
942 -data that goes into the file\-lists, and thus it doesn\(cq\&t affect deletions. |
953 -data that goes into the file\-lists, and thus it doesn\(cq\&t affect deletions. |
943 +This option is a transfer rule, not an exclude, so it doesn't affect the |
954 +This option is a transfer rule, not an exclude, so it doesn't affect the |
944 +data that goes into the file\-lists, and thus it doesn't affect deletions. |
955 +data that goes into the file\-lists, and thus it doesn't affect deletions. |
945 It just limits the files that the receiver requests to be transferred. |
956 It just limits the files that the receiver requests to be transferred. |
946 .IP |
957 .IP |
947 .IP "\fB\-\-ignore\-existing\fP" |
958 .IP "\fB\-\-ignore\-existing\fP" |
948 @@ -1491,15 +1495,15 @@ |
959 @@ -1491,15 +1497,15 @@ |
949 already exist on the destination (this does \fInot\fP ignore existing |
960 already exist on the destination (this does \fInot\fP ignore existing |
950 directories, or nothing would get done). See also \fB\-\-existing\fP. |
961 directories, or nothing would get done). See also \fB\-\-existing\fP. |
951 .IP |
962 .IP |
952 -This option is a transfer rule, not an exclude, so it doesn\(cq\&t affect the |
963 -This option is a transfer rule, not an exclude, so it doesn\(cq\&t affect the |
953 -data that goes into the file\-lists, and thus it doesn\(cq\&t affect deletions. |
964 -data that goes into the file\-lists, and thus it doesn\(cq\&t affect deletions. |
962 -already\-handled files don\(cq\&t get tweaked (which avoids a change in |
973 -already\-handled files don\(cq\&t get tweaked (which avoids a change in |
963 +already\-handled files don't get tweaked (which avoids a change in |
974 +already\-handled files don't get tweaked (which avoids a change in |
964 permissions on the hard\-linked files). This does mean that this option |
975 permissions on the hard\-linked files). This does mean that this option |
965 is only looking at the existing files in the destination hierarchy itself. |
976 is only looking at the existing files in the destination hierarchy itself. |
966 .IP |
977 .IP |
967 @@ -1511,24 +1515,24 @@ |
978 @@ -1511,24 +1517,24 @@ |
968 Note that you should only use this option on source files that are quiescent. |
979 Note that you should only use this option on source files that are quiescent. |
969 If you are using this to move files that show up in a particular directory over |
980 If you are using this to move files that show up in a particular directory over |
970 to another host, make sure that the finished files get renamed into the source |
981 to another host, make sure that the finished files get renamed into the source |
971 -directory, not directly written into it, so that rsync can\(cq\&t possibly transfer |
982 -directory, not directly written into it, so that rsync can\(cq\&t possibly transfer |
972 -a file that is not yet fully written. If you can\(cq\&t first write the files into |
983 -a file that is not yet fully written. If you can\(cq\&t first write the files into |
997 -the files\(cq\& parent directory. Files that are excluded from the transfer are |
1008 -the files\(cq\& parent directory. Files that are excluded from the transfer are |
998 +the files' parent directory. Files that are excluded from the transfer are |
1009 +the files' parent directory. Files that are excluded from the transfer are |
999 also excluded from being deleted unless you use the \fB\-\-delete\-excluded\fP |
1010 also excluded from being deleted unless you use the \fB\-\-delete\-excluded\fP |
1000 option or mark the rules as only matching on the sending side (see the |
1011 option or mark the rules as only matching on the sending side (see the |
1001 include/exclude modifiers in the FILTER RULES section). |
1012 include/exclude modifiers in the FILTER RULES section). |
1002 @@ -1585,7 +1589,7 @@ |
1013 @@ -1585,7 +1591,7 @@ |
1003 computes the deletions in a separate pass after all updates are done). |
1014 computes the deletions in a separate pass after all updates are done). |
1004 If the number of removed files overflows an internal buffer, a |
1015 If the number of removed files overflows an internal buffer, a |
1005 temporary file will be created on the receiving side to hold the names (it |
1016 temporary file will be created on the receiving side to hold the names (it |
1006 -is removed while open, so you shouldn\(cq\&t see it during the transfer). If |
1017 -is removed while open, so you shouldn\(cq\&t see it during the transfer). If |
1007 +is removed while open, so you shouldn't see it during the transfer). If |
1018 +is removed while open, so you shouldn't see it during the transfer). If |
1008 the creation of the temporary file fails, rsync will try to fall back to |
1019 the creation of the temporary file fails, rsync will try to fall back to |
1009 using \fB\-\-delete\-after\fP (which it cannot do if \fB\-\-recursive\fP is doing an |
1020 using \fB\-\-delete\-after\fP (which it cannot do if \fB\-\-recursive\fP is doing an |
1010 incremental scan). |
1021 incremental scan). |
1011 @@ -1627,7 +1631,7 @@ |
1022 @@ -1627,7 +1633,7 @@ |
1012 that, this option is independent of any other type of delete processing. |
1023 that, this option is independent of any other type of delete processing. |
1013 .IP |
1024 .IP |
1014 The missing source files are represented by special file\-list entries which |
1025 The missing source files are represented by special file\-list entries which |
1015 -display as a \(dq\&*missing\(dq\& entry in the \fB\-\-list\-only\fP output. |
1026 -display as a \(dq\&*missing\(dq\& entry in the \fB\-\-list\-only\fP output. |
1016 +display as a "*missing" entry in the \fB\-\-list\-only\fP output. |
1027 +display as a "*missing" entry in the \fB\-\-list\-only\fP output. |
1017 .IP |
1028 .IP |
1018 .IP "\fB\-\-ignore\-errors\fP" |
1029 .IP "\fB\-\-ignore\-errors\fP" |
1019 Tells \fB\-\-delete\fP to go ahead and delete files |
1030 Tells \fB\-\-delete\fP to go ahead and delete files |
1020 @@ -1651,27 +1655,27 @@ |
1031 @@ -1651,27 +1657,27 @@ |
1021 .IP |
1032 .IP |
1022 Beginning with version 3.0.0, you may specify \fB\-\-max\-delete=0\fP to be warned |
1033 Beginning with version 3.0.0, you may specify \fB\-\-max\-delete=0\fP to be warned |
1023 about any extraneous files in the destination without removing any of them. |
1034 about any extraneous files in the destination without removing any of them. |
1024 -Older clients interpreted this as \(dq\&unlimited\(dq\&, so if you don\(cq\&t know what |
1035 -Older clients interpreted this as \(dq\&unlimited\(dq\&, so if you don\(cq\&t know what |
1025 +Older clients interpreted this as "unlimited", so if you don't know what |
1036 +Older clients interpreted this as "unlimited", so if you don't know what |
1053 +"MB", or "GB". (Note: lower\-case is also accepted for all values.) |
1064 +"MB", or "GB". (Note: lower\-case is also accepted for all values.) |
1054 +Finally, if the suffix ends in either "+1" or "\-1", the value will |
1065 +Finally, if the suffix ends in either "+1" or "\-1", the value will |
1055 be offset by one byte in the indicated direction. |
1066 be offset by one byte in the indicated direction. |
1056 .IP |
1067 .IP |
1057 Examples: \-\-max\-size=1.5mb\-1 is 1499999 bytes, and \-\-max\-size=2g+1 is |
1068 Examples: \-\-max\-size=1.5mb\-1 is 1499999 bytes, and \-\-max\-size=2g+1 is |
1058 @@ -1689,7 +1693,7 @@ |
1069 @@ -1689,7 +1695,7 @@ |
1059 .IP |
1070 .IP |
1060 .IP "\fB\-B, \-\-block\-size=BLOCKSIZE\fP" |
1071 .IP "\fB\-B, \-\-block\-size=BLOCKSIZE\fP" |
1061 This forces the block size used in |
1072 This forces the block size used in |
1062 -rsync\(cq\&s delta\-transfer algorithm to a fixed value. It is normally selected based on |
1073 -rsync\(cq\&s delta\-transfer algorithm to a fixed value. It is normally selected based on |
1063 +rsync's delta\-transfer algorithm to a fixed value. It is normally selected based on |
1074 +rsync's delta\-transfer algorithm to a fixed value. It is normally selected based on |
1064 the size of each file being updated. See the technical report for details. |
1075 the size of each file being updated. See the technical report for details. |
1065 .IP |
1076 .IP |
1066 .IP "\fB\-e, \-\-rsh=COMMAND\fP" |
1077 .IP "\fB\-e, \-\-rsh=COMMAND\fP" |
1067 @@ -1702,8 +1706,8 @@ |
1078 @@ -1702,8 +1708,8 @@ |
1068 remote shell \fICOMMAND\fP will be used to run an rsync daemon on the |
1079 remote shell \fICOMMAND\fP will be used to run an rsync daemon on the |
1069 remote host, and all data will be transmitted through that remote |
1080 remote host, and all data will be transmitted through that remote |
1070 shell connection, rather than through a direct socket connection to a |
1081 shell connection, rather than through a direct socket connection to a |
1071 -running rsync daemon on the remote host. See the section \(dq\&USING |
1082 -running rsync daemon on the remote host. See the section \(dq\&USING |
1072 -RSYNC\-DAEMON FEATURES VIA A REMOTE\-SHELL CONNECTION\(dq\& above. |
1083 -RSYNC\-DAEMON FEATURES VIA A REMOTE\-SHELL CONNECTION\(dq\& above. |
1073 +running rsync daemon on the remote host. See the section "USING |
1084 +running rsync daemon on the remote host. See the section "USING |
1074 +RSYNC\-DAEMON FEATURES VIA A REMOTE\-SHELL CONNECTION" above. |
1085 +RSYNC\-DAEMON FEATURES VIA A REMOTE\-SHELL CONNECTION" above. |
1075 .IP |
1086 .IP |
1076 Command\-line arguments are permitted in COMMAND provided that COMMAND is |
1087 Command\-line arguments are permitted in COMMAND provided that COMMAND is |
1077 presented to rsync as a single argument. You must use spaces (not tabs |
1088 presented to rsync as a single argument. You must use spaces (not tabs |
1078 @@ -1715,9 +1719,9 @@ |
1089 @@ -1715,9 +1721,9 @@ |
1079 shell is parsing and which quotes rsync is parsing). Some examples: |
1090 shell is parsing and which quotes rsync is parsing). Some examples: |
1080 .IP |
1091 .IP |
1081 .RS |
1092 .RS |
1082 -\f(CW \-e '\&ssh \-p 2234'\&\fP |
1093 -\f(CW \-e '\&ssh \-p 2234'\&\fP |
1083 +\f(CW \-e 'ssh \-p 2234'\fP |
1094 +\f(CW \-e 'ssh \-p 2234'\fP |
1097 -program, script, or command sequence you\(cq\&d care to run, so long as it does |
1108 -program, script, or command sequence you\(cq\&d care to run, so long as it does |
1098 +program, script, or command sequence you'd care to run, so long as it does |
1109 +program, script, or command sequence you'd care to run, so long as it does |
1099 not corrupt the standard\-in & standard\-out that rsync is using to |
1110 not corrupt the standard\-in & standard\-out that rsync is using to |
1100 communicate. |
1111 communicate. |
1101 .IP |
1112 .IP |
1102 @@ -1743,7 +1747,7 @@ |
1113 @@ -1743,7 +1749,7 @@ |
1103 machine for use with the \fB\-\-relative\fP option. For instance: |
1114 machine for use with the \fB\-\-relative\fP option. For instance: |
1104 .IP |
1115 .IP |
1105 .RS |
1116 .RS |
1106 -\f(CW rsync \-avR \-\-rsync\-path=\(dq\&cd /a/b && rsync\(dq\& host:c/d /e/\fP |
1117 -\f(CW rsync \-avR \-\-rsync\-path=\(dq\&cd /a/b && rsync\(dq\& host:c/d /e/\fP |
1107 +\f(CW rsync \-avR \-\-rsync\-path="cd /a/b && rsync" host:c/d /e/\fP |
1118 +\f(CW rsync \-avR \-\-rsync\-path="cd /a/b && rsync" host:c/d /e/\fP |
1108 .RE |
1119 .RE |
1109 |
1120 |
1110 .IP |
1121 .IP |
1111 @@ -1776,8 +1780,8 @@ |
1122 @@ -1776,8 +1782,8 @@ |
1112 option. If that option is off, any spaces in your remote options will be split |
1123 option. If that option is off, any spaces in your remote options will be split |
1113 by the remote shell unless you take steps to protect them. |
1124 by the remote shell unless you take steps to protect them. |
1114 .IP |
1125 .IP |
1115 -When performing a local transfer, the \(dq\&local\(dq\& side is the sender and the |
1126 -When performing a local transfer, the \(dq\&local\(dq\& side is the sender and the |
1116 -\(dq\&remote\(dq\& side is the receiver. |
1127 -\(dq\&remote\(dq\& side is the receiver. |
1117 +When performing a local transfer, the "local" side is the sender and the |
1128 +When performing a local transfer, the "local" side is the sender and the |
1118 +"remote" side is the receiver. |
1129 +"remote" side is the receiver. |
1119 .IP |
1130 .IP |
1120 Note some versions of the popt option\-parsing library have a bug in them that |
1131 Note some versions of the popt option\-parsing library have a bug in them that |
1121 prevents you from using an adjacent arg with an equal in it next to a short |
1132 prevents you from using an adjacent arg with an equal in it next to a short |
1122 @@ -1786,7 +1790,7 @@ |
1133 @@ -1786,7 +1792,7 @@ |
1123 .IP |
1134 .IP |
1124 .IP "\fB\-C, \-\-cvs\-exclude\fP" |
1135 .IP "\fB\-C, \-\-cvs\-exclude\fP" |
1125 This is a useful shorthand for excluding a |
1136 This is a useful shorthand for excluding a |
1126 -broad range of files that you often don\(cq\&t want to transfer between |
1137 -broad range of files that you often don\(cq\&t want to transfer between |
1127 +broad range of files that you often don't want to transfer between |
1138 +broad range of files that you often don't want to transfer between |
1128 systems. It uses a similar algorithm to CVS to determine if |
1139 systems. It uses a similar algorithm to CVS to determine if |
1129 a file should be ignored. |
1140 a file should be ignored. |
1130 .IP |
1141 .IP |
1131 @@ -1808,17 +1812,17 @@ |
1142 @@ -1808,17 +1814,17 @@ |
1132 .IP |
1143 .IP |
1133 Finally, any file is ignored if it is in the same directory as a |
1144 Finally, any file is ignored if it is in the same directory as a |
1134 \&.cvsignore file and matches one of the patterns listed therein. Unlike |
1145 \&.cvsignore file and matches one of the patterns listed therein. Unlike |
1135 -rsync\(cq\&s filter/exclude files, these patterns are split on whitespace. |
1146 -rsync\(cq\&s filter/exclude files, these patterns are split on whitespace. |
1136 +rsync's filter/exclude files, these patterns are split on whitespace. |
1147 +rsync's filter/exclude files, these patterns are split on whitespace. |
1147 -putting the \(dq\&:C\(dq\& and \(dq\&\-C\(dq\& rules into a filter file with your other rules). |
1158 -putting the \(dq\&:C\(dq\& and \(dq\&\-C\(dq\& rules into a filter file with your other rules). |
1148 +putting the ":C" and "\-C" rules into a filter file with your other rules). |
1159 +putting the ":C" and "\-C" rules into a filter file with your other rules). |
1149 The first option turns on the per\-directory scanning for the .cvsignore |
1160 The first option turns on the per\-directory scanning for the .cvsignore |
1150 file. The second option does a one\-time import of the CVS excludes |
1161 file. The second option does a one\-time import of the CVS excludes |
1151 mentioned above. |
1162 mentioned above. |
1152 @@ -1841,7 +1845,7 @@ |
1163 @@ -1841,7 +1847,7 @@ |
1153 your command. The first time it is used is a shorthand for this rule: |
1164 your command. The first time it is used is a shorthand for this rule: |
1154 .IP |
1165 .IP |
1155 .RS |
1166 .RS |
1156 -\f(CW \-\-filter='\&dir\-merge /.rsync\-filter'\&\fP |
1167 -\f(CW \-\-filter='\&dir\-merge /.rsync\-filter'\&\fP |
1157 +\f(CW \-\-filter='dir\-merge /.rsync\-filter'\fP |
1168 +\f(CW \-\-filter='dir\-merge /.rsync\-filter'\fP |
1158 .RE |
1169 .RE |
1159 |
1170 |
1160 .IP |
1171 .IP |
1161 @@ -1851,7 +1855,7 @@ |
1172 @@ -1851,7 +1857,7 @@ |
1162 rule: |
1173 rule: |
1163 .IP |
1174 .IP |
1164 .RS |
1175 .RS |
1165 -\f(CW \-\-filter='\&exclude .rsync\-filter'\&\fP |
1176 -\f(CW \-\-filter='\&exclude .rsync\-filter'\&\fP |
1166 +\f(CW \-\-filter='exclude .rsync\-filter'\fP |
1177 +\f(CW \-\-filter='exclude .rsync\-filter'\fP |
1167 .RE |
1178 .RE |
1168 |
1179 |
1169 .IP |
1180 .IP |
1170 @@ -1870,7 +1874,7 @@ |
1181 @@ -1870,7 +1876,7 @@ |
1171 .IP "\fB\-\-exclude\-from=FILE\fP" |
1182 .IP "\fB\-\-exclude\-from=FILE\fP" |
1172 This option is related to the \fB\-\-exclude\fP |
1183 This option is related to the \fB\-\-exclude\fP |
1173 option, but it specifies a FILE that contains exclude patterns (one per line). |
1184 option, but it specifies a FILE that contains exclude patterns (one per line). |
1174 -Blank lines in the file and lines starting with \(cq\&;\(cq\& or \(cq\&#\(cq\& are ignored. |
1185 -Blank lines in the file and lines starting with \(cq\&;\(cq\& or \(cq\&#\(cq\& are ignored. |
1175 +Blank lines in the file and lines starting with ';' or '#' are ignored. |
1186 +Blank lines in the file and lines starting with ';' or '#' are ignored. |
1176 If \fIFILE\fP is \fB\-\fP, the list will be read from standard input. |
1187 If \fIFILE\fP is \fB\-\fP, the list will be read from standard input. |
1177 .IP |
1188 .IP |
1178 .IP "\fB\-\-include=PATTERN\fP" |
1189 .IP "\fB\-\-include=PATTERN\fP" |
1179 @@ -1883,7 +1887,7 @@ |
1190 @@ -1883,7 +1889,7 @@ |
1180 .IP "\fB\-\-include\-from=FILE\fP" |
1191 .IP "\fB\-\-include\-from=FILE\fP" |
1181 This option is related to the \fB\-\-include\fP |
1192 This option is related to the \fB\-\-include\fP |
1182 option, but it specifies a FILE that contains include patterns (one per line). |
1193 option, but it specifies a FILE that contains include patterns (one per line). |
1183 -Blank lines in the file and lines starting with \(cq\&;\(cq\& or \(cq\&#\(cq\& are ignored. |
1194 -Blank lines in the file and lines starting with \(cq\&;\(cq\& or \(cq\&#\(cq\& are ignored. |
1184 +Blank lines in the file and lines starting with ';' or '#' are ignored. |
1195 +Blank lines in the file and lines starting with ';' or '#' are ignored. |
1185 If \fIFILE\fP is \fB\-\fP, the list will be read from standard input. |
1196 If \fIFILE\fP is \fB\-\fP, the list will be read from standard input. |
1186 .IP |
1197 .IP |
1187 .IP "\fB\-\-files\-from=FILE\fP" |
1198 .IP "\fB\-\-files\-from=FILE\fP" |
1188 @@ -1902,7 +1906,7 @@ |
1199 @@ -1902,7 +1908,7 @@ |
1189 specified in the list on the destination rather than noisily skipping |
1200 specified in the list on the destination rather than noisily skipping |
1190 them (use \fB\-\-no\-dirs\fP or \fB\-\-no\-d\fP if you want to turn that off). |
1201 them (use \fB\-\-no\-dirs\fP or \fB\-\-no\-d\fP if you want to turn that off). |
1191 .IP o |
1202 .IP o |
1192 -The \fB\-\-archive\fP (\fB\-a\fP) option\(cq\&s behavior does not imply \fB\-\-recursive\fP |
1203 -The \fB\-\-archive\fP (\fB\-a\fP) option\(cq\&s behavior does not imply \fB\-\-recursive\fP |
1193 +The \fB\-\-archive\fP (\fB\-a\fP) option's behavior does not imply \fB\-\-recursive\fP |
1204 +The \fB\-\-archive\fP (\fB\-a\fP) option's behavior does not imply \fB\-\-recursive\fP |
1194 (\fB\-r\fP), so specify it explicitly, if you want it. |
1205 (\fB\-r\fP), so specify it explicitly, if you want it. |
1195 .IP o |
1206 .IP o |
1196 These side\-effects change the default state of rsync, so the position |
1207 These side\-effects change the default state of rsync, so the position |
1197 @@ -1913,7 +1917,7 @@ |
1208 @@ -1913,7 +1919,7 @@ |
1198 |
1209 |
1199 .IP |
1210 .IP |
1200 The filenames that are read from the FILE are all relative to the |
1211 The filenames that are read from the FILE are all relative to the |
1201 -source dir \-\- any leading slashes are removed and no \(dq\&..\(dq\& references are |
1212 -source dir \-\- any leading slashes are removed and no \(dq\&..\(dq\& references are |
1202 +source dir \-\- any leading slashes are removed and no ".." references are |
1213 +source dir \-\- any leading slashes are removed and no ".." references are |
1203 allowed to go higher than the source dir. For example, take this |
1214 allowed to go higher than the source dir. For example, take this |
1204 command: |
1215 command: |
1205 .IP |
1216 .IP |
1206 @@ -1922,12 +1926,12 @@ |
1217 @@ -1922,12 +1928,12 @@ |
1207 .RE |
1218 .RE |
1208 |
1219 |
1209 .IP |
1220 .IP |
1210 -If /tmp/foo contains the string \(dq\&bin\(dq\& (or even \(dq\&/bin\(dq\&), the /usr/bin |
1221 -If /tmp/foo contains the string \(dq\&bin\(dq\& (or even \(dq\&/bin\(dq\&), the /usr/bin |
1211 +If /tmp/foo contains the string "bin" (or even "/bin"), the /usr/bin |
1222 +If /tmp/foo contains the string "bin" (or even "/bin"), the /usr/bin |
1217 -if the \fB\-r\fP option was enabled, that dir\(cq\&s entire hierarchy would |
1228 -if the \fB\-r\fP option was enabled, that dir\(cq\&s entire hierarchy would |
1218 +if the \fB\-r\fP option was enabled, that dir's entire hierarchy would |
1229 +if the \fB\-r\fP option was enabled, that dir's entire hierarchy would |
1219 also be transferred (keep in mind that \fB\-r\fP needs to be specified |
1230 also be transferred (keep in mind that \fB\-r\fP needs to be specified |
1220 explicitly with \fB\-\-files\-from\fP, since it is not implied by \fB\-a\fP). |
1231 explicitly with \fB\-\-files\-from\fP, since it is not implied by \fB\-a\fP). |
1221 Also note |
1232 Also note |
1222 @@ -1936,10 +1940,10 @@ |
1233 @@ -1936,10 +1942,10 @@ |
1223 force the duplication of the source\-spec path (/usr in this case). |
1234 force the duplication of the source\-spec path (/usr in this case). |
1224 .IP |
1235 .IP |
1225 In addition, the \fB\-\-files\-from\fP file can be read from the remote host |
1236 In addition, the \fB\-\-files\-from\fP file can be read from the remote host |
1226 -instead of the local host if you specify a \(dq\&host:\(dq\& in front of the file |
1237 -instead of the local host if you specify a \(dq\&host:\(dq\& in front of the file |
1227 +instead of the local host if you specify a "host:" in front of the file |
1238 +instead of the local host if you specify a "host:" in front of the file |
1247 +filenames will be translated from the sending host's charset to the |
1258 +filenames will be translated from the sending host's charset to the |
1248 +receiving host's charset. |
1259 +receiving host's charset. |
1249 .IP |
1260 .IP |
1250 NOTE: sorting the list of files in the \-\-files\-from input helps rsync to be |
1261 NOTE: sorting the list of files in the \-\-files\-from input helps rsync to be |
1251 more efficient, as it will avoid re\-visiting the path elements that are shared |
1262 more efficient, as it will avoid re\-visiting the path elements that are shared |
1252 @@ -1962,7 +1966,7 @@ |
1263 @@ -1962,7 +1968,7 @@ |
1253 .IP |
1264 .IP |
1254 .IP "\fB\-0, \-\-from0\fP" |
1265 .IP "\fB\-0, \-\-from0\fP" |
1255 This tells rsync that the rules/filenames it reads from a |
1266 This tells rsync that the rules/filenames it reads from a |
1256 -file are terminated by a null (\(cq\&\e0\(cq\&) character, not a NL, CR, or CR+LF. |
1267 -file are terminated by a null (\(cq\&\e0\(cq\&) character, not a NL, CR, or CR+LF. |
1257 +file are terminated by a null ('\e0') character, not a NL, CR, or CR+LF. |
1268 +file are terminated by a null ('\e0') character, not a NL, CR, or CR+LF. |
1258 This affects \fB\-\-exclude\-from\fP, \fB\-\-include\-from\fP, \fB\-\-files\-from\fP, and any |
1269 This affects \fB\-\-exclude\-from\fP, \fB\-\-include\-from\fP, \fB\-\-files\-from\fP, and any |
1259 merged files specified in a \fB\-\-filter\fP rule. |
1270 merged files specified in a \fB\-\-filter\fP rule. |
1260 It does not affect \fB\-\-cvs\-exclude\fP (since all names read from a .cvsignore |
1271 It does not affect \fB\-\-cvs\-exclude\fP (since all names read from a .cvsignore |
1261 @@ -1985,7 +1989,7 @@ |
1272 @@ -1985,7 +1991,7 @@ |
1262 by default, otherwise it will be disabled by default. Either state is |
1273 by default, otherwise it will be disabled by default. Either state is |
1263 overridden by a manually specified positive or negative version of this option |
1274 overridden by a manually specified positive or negative version of this option |
1264 (note that \fB\-\-no\-s\fP and \fB\-\-no\-protect\-args\fP are the negative versions). |
1275 (note that \fB\-\-no\-s\fP and \fB\-\-no\-protect\-args\fP are the negative versions). |
1265 -Since this option was first introduced in 3.0.0, you\(cq\&ll need to make sure it\(cq\&s |
1276 -Since this option was first introduced in 3.0.0, you\(cq\&ll need to make sure it\(cq\&s |
1266 +Since this option was first introduced in 3.0.0, you'll need to make sure it's |
1277 +Since this option was first introduced in 3.0.0, you'll need to make sure it's |
1267 disabled if you ever need to interact with a remote rsync that is older than |
1278 disabled if you ever need to interact with a remote rsync that is older than |
1268 that. |
1279 that. |
1269 .IP |
1280 .IP |
1270 @@ -2020,9 +2024,9 @@ |
1281 @@ -2020,9 +2026,9 @@ |
1271 If you are using this option for reasons other than a shortage of disk |
1282 If you are using this option for reasons other than a shortage of disk |
1272 space, you may wish to combine it with the \fB\-\-delay\-updates\fP option, |
1283 space, you may wish to combine it with the \fB\-\-delay\-updates\fP option, |
1273 which will ensure that all copied files get put into subdirectories in the |
1284 which will ensure that all copied files get put into subdirectories in the |
1274 -destination hierarchy, awaiting the end of the transfer. If you don\(cq\&t |
1285 -destination hierarchy, awaiting the end of the transfer. If you don\(cq\&t |
1275 +destination hierarchy, awaiting the end of the transfer. If you don't |
1286 +destination hierarchy, awaiting the end of the transfer. If you don't |
1277 -partition, another way to tell rsync that you aren\(cq\&t overly concerned |
1288 -partition, another way to tell rsync that you aren\(cq\&t overly concerned |
1278 +partition, another way to tell rsync that you aren't overly concerned |
1289 +partition, another way to tell rsync that you aren't overly concerned |
1279 about disk space is to use the \fB\-\-partial\-dir\fP option with a relative |
1290 about disk space is to use the \fB\-\-partial\-dir\fP option with a relative |
1280 path; because this tells rsync that it is OK to stash off a copy of a |
1291 path; because this tells rsync that it is OK to stash off a copy of a |
1281 single file in a subdir in the destination hierarchy, rsync will use the |
1292 single file in a subdir in the destination hierarchy, rsync will use the |
1282 @@ -2050,7 +2054,7 @@ |
1293 @@ -2050,7 +2056,7 @@ |
1283 the destination machine as an additional hierarchy to compare destination |
1294 the destination machine as an additional hierarchy to compare destination |
1284 files against doing transfers (if the files are missing in the destination |
1295 files against doing transfers (if the files are missing in the destination |
1285 directory). If a file is found in \fIDIR\fP that is identical to the |
1296 directory). If a file is found in \fIDIR\fP that is identical to the |
1286 -sender\(cq\&s file, the file will NOT be transferred to the destination |
1297 -sender\(cq\&s file, the file will NOT be transferred to the destination |
1287 +sender's file, the file will NOT be transferred to the destination |
1298 +sender's file, the file will NOT be transferred to the destination |
1288 directory. This is useful for creating a sparse backup of just files that |
1299 directory. This is useful for creating a sparse backup of just files that |
1289 have changed from an earlier backup. |
1300 have changed from an earlier backup. |
1290 This option is typically used to copy into an empty (or newly created) |
1301 This option is typically used to copy into an empty (or newly created) |
1291 @@ -2099,10 +2103,10 @@ |
1302 @@ -2099,10 +2105,10 @@ |
1292 .RE |
1303 .RE |
1293 |
1304 |
1294 .IP |
1305 .IP |
1295 -If file\(cq\&s aren\(cq\&t linking, double\-check their attributes. Also check if some |
1306 -If file\(cq\&s aren\(cq\&t linking, double\-check their attributes. Also check if some |
1296 -attributes are getting forced outside of rsync\(cq\&s control, such a mount option |
1307 -attributes are getting forced outside of rsync\(cq\&s control, such a mount option |
1300 -ownership (such as OS X\(cq\&s \(dq\&Ignore ownership on this volume\(dq\& option). |
1311 -ownership (such as OS X\(cq\&s \(dq\&Ignore ownership on this volume\(dq\& option). |
1301 +ownership (such as OS X's "Ignore ownership on this volume" option). |
1312 +ownership (such as OS X's "Ignore ownership on this volume" option). |
1302 .IP |
1313 .IP |
1303 Beginning in version 2.6.4, multiple \fB\-\-link\-dest\fP directories may be |
1314 Beginning in version 2.6.4, multiple \fB\-\-link\-dest\fP directories may be |
1304 provided, which will cause rsync to search the list in the order specified |
1315 provided, which will cause rsync to search the list in the order specified |
1305 @@ -2172,11 +2176,11 @@ |
1316 @@ -2172,11 +2178,11 @@ |
1306 .IP |
1317 .IP |
1307 Simple character\-class matching is supported: each must consist of a list |
1318 Simple character\-class matching is supported: each must consist of a list |
1308 of letters inside the square brackets (e.g. no special classes, such as |
1319 of letters inside the square brackets (e.g. no special classes, such as |
1309 -\(dq\&[:alpha:]\(dq\&, are supported, and \(cq\&\-\(cq\& has no special meaning). |
1320 -\(dq\&[:alpha:]\(dq\&, are supported, and \(cq\&\-\(cq\& has no special meaning). |
1310 +"[:alpha:]", are supported, and '\-' has no special meaning). |
1321 +"[:alpha:]", are supported, and '\-' has no special meaning). |
1314 -Here\(cq\&s an example that specifies 6 suffixes to skip (since 1 of the 5 rules |
1325 -Here\(cq\&s an example that specifies 6 suffixes to skip (since 1 of the 5 rules |
1315 +Here's an example that specifies 6 suffixes to skip (since 1 of the 5 rules |
1326 +Here's an example that specifies 6 suffixes to skip (since 1 of the 5 rules |
1316 matches 2 suffixes): |
1327 matches 2 suffixes): |
1317 .IP |
1328 .IP |
1318 .nf |
1329 .nf |
1319 @@ -2234,8 +2238,8 @@ |
1330 @@ -2234,8 +2240,8 @@ |
1320 If a user or group has no name on the source system or it has no match |
1331 If a user or group has no name on the source system or it has no match |
1321 on the destination system, then the numeric ID |
1332 on the destination system, then the numeric ID |
1322 from the source system is used instead. See also the comments on the |
1333 from the source system is used instead. See also the comments on the |
1323 -\(dq\&use chroot\(dq\& setting in the rsyncd.conf manpage for information on how |
1334 -\(dq\&use chroot\(dq\& setting in the rsyncd.conf manpage for information on how |
1324 -the chroot setting affects rsync\(cq\&s ability to look up the names of the |
1335 -the chroot setting affects rsync\(cq\&s ability to look up the names of the |
1325 +"use chroot" setting in the rsyncd.conf manpage for information on how |
1336 +"use chroot" setting in the rsyncd.conf manpage for information on how |
1326 +the chroot setting affects rsync's ability to look up the names of the |
1337 +the chroot setting affects rsync's ability to look up the names of the |
1327 users and groups and what you can do about it. |
1338 users and groups and what you can do about it. |
1328 .IP |
1339 .IP |
1329 .IP "\fB\-\-usermap=STRING, \-\-groupmap=STRING\fP" |
1340 .IP "\fB\-\-usermap=STRING, \-\-groupmap=STRING\fP" |
1330 @@ -2245,9 +2249,9 @@ |
1341 @@ -2245,9 +2251,9 @@ |
1331 values separated by commas. Any matching \fBFROM\fP value from the sender is |
1342 values separated by commas. Any matching \fBFROM\fP value from the sender is |
1332 replaced with a \fBTO\fP value from the receiver. You may specify usernames |
1343 replaced with a \fBTO\fP value from the receiver. You may specify usernames |
1333 or user IDs for the \fBFROM\fP and \fBTO\fP values, and the \fBFROM\fP value may |
1344 or user IDs for the \fBFROM\fP and \fBTO\fP values, and the \fBFROM\fP value may |
1334 -also be a wild\-card string, which will be matched against the sender\(cq\&s |
1345 -also be a wild\-card string, which will be matched against the sender\(cq\&s |
1335 +also be a wild\-card string, which will be matched against the sender's |
1346 +also be a wild\-card string, which will be matched against the sender's |
1356 -a \(dq\&*\(dq\& or using an empty name. For instance: |
1367 -a \(dq\&*\(dq\& or using an empty name. For instance: |
1357 +a "*" or using an empty name. For instance: |
1368 +a "*" or using an empty name. For instance: |
1358 .IP |
1369 .IP |
1359 .nf |
1370 .nf |
1360 \-\-usermap=:nobody \-\-groupmap=*:nobody |
1371 \-\-usermap=:nobody \-\-groupmap=*:nobody |
1361 @@ -2294,8 +2298,8 @@ |
1372 @@ -2294,8 +2300,8 @@ |
1362 the omitted user/group will occur. If GROUP is empty, the trailing colon may |
1373 the omitted user/group will occur. If GROUP is empty, the trailing colon may |
1363 be omitted, but if USER is empty, a leading colon must be supplied. |
1374 be omitted, but if USER is empty, a leading colon must be supplied. |
1364 .IP |
1375 .IP |
1365 -If you specify \(dq\&\-\-chown=foo:bar, this is exactly the same as specifying |
1376 -If you specify \(dq\&\-\-chown=foo:bar, this is exactly the same as specifying |
1366 -\(dq\&\-\-usermap=*:foo \-\-groupmap=*:bar\(dq\&, only easier. |
1377 -\(dq\&\-\-usermap=*:foo \-\-groupmap=*:bar\(dq\&, only easier. |
1367 +If you specify "\-\-chown=foo:bar, this is exactly the same as specifying |
1378 +If you specify "\-\-chown=foo:bar, this is exactly the same as specifying |
1368 +"\-\-usermap=*:foo \-\-groupmap=*:bar", only easier. |
1379 +"\-\-usermap=*:foo \-\-groupmap=*:bar", only easier. |
1369 .IP |
1380 .IP |
1370 .IP "\fB\-\-timeout=TIMEOUT\fP" |
1381 .IP "\fB\-\-timeout=TIMEOUT\fP" |
1371 This option allows you to set a maximum I/O |
1382 This option allows you to set a maximum I/O |
1372 @@ -2345,18 +2349,18 @@ |
1383 @@ -2345,18 +2351,18 @@ |
1373 as a single letter for the mode, and use upper or lower case. |
1384 as a single letter for the mode, and use upper or lower case. |
1374 .IP |
1385 .IP |
1375 The main use of this option is to change Full buffering to Line buffering |
1386 The main use of this option is to change Full buffering to Line buffering |
1376 -when rsync\(cq\&s output is going to a file or pipe. |
1387 -when rsync\(cq\&s output is going to a file or pipe. |
1377 +when rsync's output is going to a file or pipe. |
1388 +when rsync's output is going to a file or pipe. |
1389 -The \(dq\&%i\(dq\& escape has a cryptic output that is 11 letters long. The general |
1400 -The \(dq\&%i\(dq\& escape has a cryptic output that is 11 letters long. The general |
1390 +The "%i" escape has a cryptic output that is 11 letters long. The general |
1401 +The "%i" escape has a cryptic output that is 11 letters long. The general |
1391 format is like the string \fBYXcstpoguax\fP, where \fBY\fP is replaced by the |
1402 format is like the string \fBYXcstpoguax\fP, where \fBY\fP is replaced by the |
1392 type of update being done, \fBX\fP is replaced by the file\-type, and the |
1403 type of update being done, \fBX\fP is replaced by the file\-type, and the |
1393 other letters represent attributes that may be output if they are being |
1404 other letters represent attributes that may be output if they are being |
1394 @@ -2382,7 +2386,7 @@ |
1405 @@ -2382,7 +2388,7 @@ |
1395 have attributes that are being modified). |
1406 have attributes that are being modified). |
1396 .IP o |
1407 .IP o |
1397 A \fB*\fP means that the rest of the itemized\-output area contains |
1408 A \fB*\fP means that the rest of the itemized\-output area contains |
1398 -a message (e.g. \(dq\&deleting\(dq\&). |
1409 -a message (e.g. \(dq\&deleting\(dq\&). |
1399 +a message (e.g. "deleting"). |
1410 +a message (e.g. "deleting"). |
1400 .RE |
1411 .RE |
1401 |
1412 |
1402 .IP |
1413 .IP |
1403 @@ -2392,10 +2396,10 @@ |
1414 @@ -2392,10 +2398,10 @@ |
1404 .IP |
1415 .IP |
1405 The other letters in the string above are the actual letters that |
1416 The other letters in the string above are the actual letters that |
1406 will be output if the associated attribute for the item is being updated or |
1417 will be output if the associated attribute for the item is being updated or |
1407 -a \(dq\&.\(dq\& for no change. Three exceptions to this are: (1) a newly created |
1418 -a \(dq\&.\(dq\& for no change. Three exceptions to this are: (1) a newly created |
1408 -item replaces each letter with a \(dq\&+\(dq\&, (2) an identical item replaces the |
1419 -item replaces each letter with a \(dq\&+\(dq\&, (2) an identical item replaces the |
1439 -sender\(cq\&s value (requires \fB\-\-group\fP and the authority to set the group). |
1450 -sender\(cq\&s value (requires \fB\-\-group\fP and the authority to set the group). |
1440 +sender's value (requires \fB\-\-group\fP and the authority to set the group). |
1451 +sender's value (requires \fB\-\-group\fP and the authority to set the group). |
1441 .IP o |
1452 .IP o |
1442 The \fBu\fP slot is reserved for future use. |
1453 The \fBu\fP slot is reserved for future use. |
1443 .IP o |
1454 .IP o |
1444 @@ -2435,8 +2439,8 @@ |
1455 @@ -2435,8 +2441,8 @@ |
1445 .RE |
1456 .RE |
1446 |
1457 |
1447 .IP |
1458 .IP |
1448 -One other output is possible: when deleting files, the \(dq\&%i\(dq\& will output |
1459 -One other output is possible: when deleting files, the \(dq\&%i\(dq\& will output |
1449 -the string \(dq\&*deleting\(dq\& for each item that is being removed (assuming that |
1460 -the string \(dq\&*deleting\(dq\& for each item that is being removed (assuming that |
1450 +One other output is possible: when deleting files, the "%i" will output |
1461 +One other output is possible: when deleting files, the "%i" will output |
1451 +the string "*deleting" for each item that is being removed (assuming that |
1462 +the string "*deleting" for each item that is being removed (assuming that |
1452 you are talking to a recent enough rsync that it logs deletions instead of |
1463 you are talking to a recent enough rsync that it logs deletions instead of |
1453 outputting them as a verbose message). |
1464 outputting them as a verbose message). |
1454 .IP |
1465 .IP |
1455 @@ -2444,10 +2448,10 @@ |
1466 @@ -2444,10 +2450,10 @@ |
1456 This allows you to specify exactly what the |
1467 This allows you to specify exactly what the |
1457 rsync client outputs to the user on a per\-update basis. The format is a |
1468 rsync client outputs to the user on a per\-update basis. The format is a |
1458 text string containing embedded single\-character escape sequences prefixed |
1469 text string containing embedded single\-character escape sequences prefixed |
1459 -with a percent (%) character. A default format of \(dq\&%n%L\(dq\& is assumed if |
1470 -with a percent (%) character. A default format of \(dq\&%n%L\(dq\& is assumed if |
1460 +with a percent (%) character. A default format of "%n%L" is assumed if |
1471 +with a percent (%) character. A default format of "%n%L" is assumed if |
1463 -of the possible escape characters, see the \(dq\&log format\(dq\& setting in the |
1474 -of the possible escape characters, see the \(dq\&log format\(dq\& setting in the |
1464 +of the possible escape characters, see the "log format" setting in the |
1475 +of the possible escape characters, see the "log format" setting in the |
1465 rsyncd.conf manpage. |
1476 rsyncd.conf manpage. |
1466 .IP |
1477 .IP |
1467 Specifying the \fB\-\-out\-format\fP option implies the \fB\-\-info=name\fP option, |
1478 Specifying the \fB\-\-out\-format\fP option implies the \fB\-\-info=name\fP option, |
1468 @@ -2457,11 +2461,11 @@ |
1479 @@ -2457,11 +2463,11 @@ |
1469 the string (e.g. if the \fB\-\-itemize\-changes\fP option was used), the logging |
1480 the string (e.g. if the \fB\-\-itemize\-changes\fP option was used), the logging |
1470 of names increases to mention any item that is changed in any way (as long |
1481 of names increases to mention any item that is changed in any way (as long |
1471 as the receiving side is at least 2.6.4). See the \fB\-\-itemize\-changes\fP |
1482 as the receiving side is at least 2.6.4). See the \fB\-\-itemize\-changes\fP |
1472 -option for a description of the output of \(dq\&%i\(dq\&. |
1483 -option for a description of the output of \(dq\&%i\(dq\&. |
1473 +option for a description of the output of "%i". |
1484 +option for a description of the output of "%i". |
1478 -logging is done at the end of the file\(cq\&s transfer. When this late logging |
1489 -logging is done at the end of the file\(cq\&s transfer. When this late logging |
1479 +logging is done at the end of the file's transfer. When this late logging |
1490 +logging is done at the end of the file's transfer. When this late logging |
1480 is in effect and \fB\-\-progress\fP is also specified, rsync will also output |
1491 is in effect and \fB\-\-progress\fP is also specified, rsync will also output |
1481 the name of the file being transferred prior to its progress information |
1492 the name of the file being transferred prior to its progress information |
1482 (followed, of course, by the out\-format output). |
1493 (followed, of course, by the out\-format output). |
1483 @@ -2471,10 +2475,10 @@ |
1494 @@ -2471,10 +2477,10 @@ |
1484 to a file. This is similar to the logging that a daemon does, but can be |
1495 to a file. This is similar to the logging that a daemon does, but can be |
1485 requested for the client side and/or the server side of a non\-daemon |
1496 requested for the client side and/or the server side of a non\-daemon |
1486 transfer. If specified as a client option, transfer logging will be |
1497 transfer. If specified as a client option, transfer logging will be |
1487 -enabled with a default format of \(dq\&%i %n%L\(dq\&. See the \fB\-\-log\-file\-format\fP |
1498 -enabled with a default format of \(dq\&%i %n%L\(dq\&. See the \fB\-\-log\-file\-format\fP |
1488 +enabled with a default format of "%i %n%L". See the \fB\-\-log\-file\-format\fP |
1499 +enabled with a default format of "%i %n%L". See the \fB\-\-log\-file\-format\fP |
1491 -Here\(cq\&s a example command that requests the remote side to log what is |
1502 -Here\(cq\&s a example command that requests the remote side to log what is |
1492 +Here's a example command that requests the remote side to log what is |
1503 +Here's a example command that requests the remote side to log what is |
1493 happening: |
1504 happening: |
1494 .IP |
1505 .IP |
1495 .nf |
1506 .nf |
1496 @@ -2490,15 +2494,15 @@ |
1507 @@ -2490,15 +2496,15 @@ |
1497 per\-update logging is put into the file specified by the \fB\-\-log\-file\fP option |
1508 per\-update logging is put into the file specified by the \fB\-\-log\-file\fP option |
1498 (which must also be specified for this option to have any effect). If you |
1509 (which must also be specified for this option to have any effect). If you |
1499 specify an empty string, updated files will not be mentioned in the log file. |
1510 specify an empty string, updated files will not be mentioned in the log file. |
1500 -For a list of the possible escape characters, see the \(dq\&log format\(dq\& setting |
1511 -For a list of the possible escape characters, see the \(dq\&log format\(dq\& setting |
1501 +For a list of the possible escape characters, see the "log format" setting |
1512 +For a list of the possible escape characters, see the "log format" setting |
1510 -on the file transfer, allowing you to tell how effective rsync\(cq\&s delta\-transfer |
1521 -on the file transfer, allowing you to tell how effective rsync\(cq\&s delta\-transfer |
1511 +on the file transfer, allowing you to tell how effective rsync's delta\-transfer |
1522 +on the file transfer, allowing you to tell how effective rsync's delta\-transfer |
1512 algorithm is for your data. This option is equivalent to \fB\-\-info=stats2\fP |
1523 algorithm is for your data. This option is equivalent to \fB\-\-info=stats2\fP |
1513 if combined with 0 or 1 \fB\-v\fP options, or \fB\-\-info=stats3\fP if combined |
1524 if combined with 0 or 1 \fB\-v\fP options, or \fB\-\-info=stats3\fP if combined |
1514 with 2 or more \fB\-v\fP options. |
1525 with 2 or more \fB\-v\fP options. |
1515 @@ -2506,27 +2510,27 @@ |
1526 @@ -2506,27 +2512,27 @@ |
1516 The current statistics are as follows: |
1527 The current statistics are as follows: |
1517 .RS |
1528 .RS |
1518 .IP o |
1529 .IP o |
1519 -\fBNumber of files\fP is the count of all \(dq\&files\(dq\& (in the generic |
1530 -\fBNumber of files\fP is the count of all \(dq\&files\(dq\& (in the generic |
1520 +\fBNumber of files\fP is the count of all "files" (in the generic |
1531 +\fBNumber of files\fP is the count of all "files" (in the generic |
1572 -would output as \(dq\&\e#012\(dq\&. A literal backslash that is in a filename is not |
1583 -would output as \(dq\&\e#012\(dq\&. A literal backslash that is in a filename is not |
1573 +would output as "\e#012". A literal backslash that is in a filename is not |
1584 +would output as "\e#012". A literal backslash that is in a filename is not |
1574 escaped unless it is followed by a hash and 3 digits (0\-9). |
1585 escaped unless it is followed by a hash and 3 digits (0\-9). |
1575 .IP |
1586 .IP |
1576 .IP "\fB\-h, \-\-human\-readable\fP" |
1587 .IP "\fB\-h, \-\-human\-readable\fP" |
1577 @@ -2594,7 +2598,7 @@ |
1588 @@ -2594,7 +2600,7 @@ |
1578 Backward compatibility note: versions of rsync prior to 3.1.0 do not support |
1589 Backward compatibility note: versions of rsync prior to 3.1.0 do not support |
1579 human\-readable level 1, and they default to level 0. Thus, specifying one or |
1590 human\-readable level 1, and they default to level 0. Thus, specifying one or |
1580 two \fB\-h\fP options will behave in a comparable manner in old and new versions |
1591 two \fB\-h\fP options will behave in a comparable manner in old and new versions |
1581 -as long as you didn\(cq\&t specify a \fB\-\-no\-h\fP option prior to one or more \fB\-h\fP |
1592 -as long as you didn\(cq\&t specify a \fB\-\-no\-h\fP option prior to one or more \fB\-h\fP |
1582 +as long as you didn't specify a \fB\-\-no\-h\fP option prior to one or more \fB\-h\fP |
1593 +as long as you didn't specify a \fB\-\-no\-h\fP option prior to one or more \fB\-h\fP |
1583 options. See the \fB\-\-list\-only\fP option for one difference. |
1594 options. See the \fB\-\-list\-only\fP option for one difference. |
1584 .IP |
1595 .IP |
1585 .IP "\fB\-\-partial\fP" |
1596 .IP "\fB\-\-partial\fP" |
1586 @@ -2615,12 +2619,12 @@ |
1597 @@ -2615,12 +2621,12 @@ |
1587 Note that if \fB\-\-whole\-file\fP is specified (or implied), any partial\-dir |
1598 Note that if \fB\-\-whole\-file\fP is specified (or implied), any partial\-dir |
1588 file that is found for a file that is being updated will simply be removed |
1599 file that is found for a file that is being updated will simply be removed |
1589 (since |
1600 (since |
1590 -rsync is sending files without using rsync\(cq\&s delta\-transfer algorithm). |
1601 -rsync is sending files without using rsync\(cq\&s delta\-transfer algorithm). |
1591 +rsync is sending files without using rsync's delta\-transfer algorithm). |
1602 +rsync is sending files without using rsync's delta\-transfer algorithm). |
1597 +"\fB\-\-partial\-dir=.rsync\-partial\fP") to have rsync create the |
1608 +"\fB\-\-partial\-dir=.rsync\-partial\fP") to have rsync create the |
1598 +partial\-directory in the destination file's directory when needed, and then |
1609 +partial\-directory in the destination file's directory when needed, and then |
1599 remove it again when the partial file is deleted. |
1610 remove it again when the partial file is deleted. |
1600 .IP |
1611 .IP |
1601 If the partial\-dir value is not an absolute path, rsync will add an exclude |
1612 If the partial\-dir value is not an absolute path, rsync will add an exclude |
1602 @@ -2628,21 +2632,21 @@ |
1613 @@ -2628,21 +2634,21 @@ |
1603 sending of any partial\-dir files that may exist on the sending side, and |
1614 sending of any partial\-dir files that may exist on the sending side, and |
1604 will also prevent the untimely deletion of partial\-dir items on the |
1615 will also prevent the untimely deletion of partial\-dir items on the |
1605 receiving side. An example: the above \fB\-\-partial\-dir\fP option would add |
1616 receiving side. An example: the above \fB\-\-partial\-dir\fP option would add |
1606 -the equivalent of \(dq\&\fB\-f '\&\-p .rsync\-partial/'\&\fP\(dq\& at the end of any other |
1617 -the equivalent of \(dq\&\fB\-f '\&\-p .rsync\-partial/'\&\fP\(dq\& at the end of any other |
1607 +the equivalent of "\fB\-f '\-p .rsync\-partial/'\fP" at the end of any other |
1618 +the equivalent of "\fB\-f '\-p .rsync\-partial/'\fP" at the end of any other |
1625 -is a security risk. E.g. AVOID \(dq\&/tmp\(dq\&. |
1636 -is a security risk. E.g. AVOID \(dq\&/tmp\(dq\&. |
1626 +is a security risk. E.g. AVOID "/tmp". |
1637 +is a security risk. E.g. AVOID "/tmp". |
1627 .IP |
1638 .IP |
1628 You can also set the partial\-dir value the RSYNC_PARTIAL_DIR environment |
1639 You can also set the partial\-dir value the RSYNC_PARTIAL_DIR environment |
1629 variable. Setting this in the environment does not force \fB\-\-partial\fP to be |
1640 variable. Setting this in the environment does not force \fB\-\-partial\fP to be |
1630 @@ -2655,7 +2659,7 @@ |
1641 @@ -2655,7 +2661,7 @@ |
1631 specified (since \fB\-\-inplace\fP conflicts with \fB\-\-partial\-dir\fP), and (2) when |
1642 specified (since \fB\-\-inplace\fP conflicts with \fB\-\-partial\-dir\fP), and (2) when |
1632 \fB\-\-delay\-updates\fP was specified (see below). |
1643 \fB\-\-delay\-updates\fP was specified (see below). |
1633 .IP |
1644 .IP |
1634 -For the purposes of the daemon\-config\(cq\&s \(dq\&refuse options\(dq\& setting, |
1645 -For the purposes of the daemon\-config\(cq\&s \(dq\&refuse options\(dq\& setting, |
1635 +For the purposes of the daemon\-config's "refuse options" setting, |
1646 +For the purposes of the daemon\-config's "refuse options" setting, |
1636 \fB\-\-partial\-dir\fP does \fInot\fP imply \fB\-\-partial\fP. This is so that a |
1647 \fB\-\-partial\-dir\fP does \fInot\fP imply \fB\-\-partial\fP. This is so that a |
1637 refusal of the \fB\-\-partial\fP option can be used to disallow the overwriting |
1648 refusal of the \fB\-\-partial\fP option can be used to disallow the overwriting |
1638 of destination files with a partial transfer, while still allowing the |
1649 of destination files with a partial transfer, while still allowing the |
1639 @@ -2666,12 +2670,12 @@ |
1650 @@ -2666,12 +2672,12 @@ |
1640 updated file into a holding directory until the end of the |
1651 updated file into a holding directory until the end of the |
1641 transfer, at which time all the files are renamed into place in rapid |
1652 transfer, at which time all the files are renamed into place in rapid |
1642 succession. This attempts to make the updating of the files a little more |
1653 succession. This attempts to make the updating of the files a little more |
1643 -atomic. By default the files are placed into a directory named \(dq\&.~tmp~\(dq\& in |
1654 -atomic. By default the files are placed into a directory named \(dq\&.~tmp~\(dq\& in |
1644 -each file\(cq\&s destination directory, but if you\(cq\&ve specified the |
1655 -each file\(cq\&s destination directory, but if you\(cq\&ve specified the |
1651 +".~tmp~" dir will be excluded from the transfer, and what you can do if |
1662 +".~tmp~" dir will be excluded from the transfer, and what you can do if |
1652 +you want rsync to cleanup old ".~tmp~" dirs that might be lying around. |
1663 +you want rsync to cleanup old ".~tmp~" dirs that might be lying around. |
1653 Conflicts with \fB\-\-inplace\fP and \fB\-\-append\fP. |
1664 Conflicts with \fB\-\-inplace\fP and \fB\-\-append\fP. |
1654 .IP |
1665 .IP |
1655 This option uses more memory on the receiving side (one bit per file |
1666 This option uses more memory on the receiving side (one bit per file |
1656 @@ -2683,9 +2687,9 @@ |
1667 @@ -2683,9 +2689,9 @@ |
1657 the updated files will be put into a single directory if the path is |
1668 the updated files will be put into a single directory if the path is |
1658 absolute) |
1669 absolute) |
1659 and (2) there are no mount points in the hierarchy (since the |
1670 and (2) there are no mount points in the hierarchy (since the |
1660 -delayed updates will fail if they can\(cq\&t be renamed into place). |
1671 -delayed updates will fail if they can\(cq\&t be renamed into place). |
1661 +delayed updates will fail if they can't be renamed into place). |
1672 +delayed updates will fail if they can't be renamed into place). |
1697 +If you didn't want to remove superfluous destination files, the more |
1708 +If you didn't want to remove superfluous destination files, the more |
1698 +time\-honored options of "\fB\-\-include='*/' \-\-exclude='*'\fP" would work fine |
1709 +time\-honored options of "\fB\-\-include='*/' \-\-exclude='*'\fP" would work fine |
1699 in place of the hide\-filter (if that is more natural to you). |
1710 in place of the hide\-filter (if that is more natural to you). |
1700 .IP |
1711 .IP |
1701 .IP "\fB\-\-progress\fP" |
1712 .IP "\fB\-\-progress\fP" |
1702 @@ -2737,7 +2741,7 @@ |
1713 @@ -2737,7 +2743,7 @@ |
1703 something to watch. |
1714 something to watch. |
1704 With a modern rsync this is the same as specifying |
1715 With a modern rsync this is the same as specifying |
1705 \fB\-\-info=flist2,name,progress\fP, but any user\-supplied settings for those |
1716 \fB\-\-info=flist2,name,progress\fP, but any user\-supplied settings for those |
1706 -info flags takes precedence (e.g. \(dq\&\-\-info=flist0 \-\-progress\(dq\&). |
1717 -info flags takes precedence (e.g. \(dq\&\-\-info=flist0 \-\-progress\(dq\&). |
1707 +info flags takes precedence (e.g. "\-\-info=flist0 \-\-progress"). |
1718 +info flags takes precedence (e.g. "\-\-info=flist0 \-\-progress"). |
1708 .IP |
1719 .IP |
1709 While rsync is transferring a regular file, it updates a progress line that |
1720 While rsync is transferring a regular file, it updates a progress line that |
1710 looks like this: |
1721 looks like this: |
1711 @@ -2748,12 +2752,12 @@ |
1722 @@ -2748,12 +2754,12 @@ |
1712 |
1723 |
1713 .IP |
1724 .IP |
1714 In this example, the receiver has reconstructed 782448 bytes or 63% of the |
1725 In this example, the receiver has reconstructed 782448 bytes or 63% of the |
1715 -sender\(cq\&s file, which is being reconstructed at a rate of 110.64 kilobytes |
1726 -sender\(cq\&s file, which is being reconstructed at a rate of 110.64 kilobytes |
1716 +sender's file, which is being reconstructed at a rate of 110.64 kilobytes |
1727 +sender's file, which is being reconstructed at a rate of 110.64 kilobytes |
1722 +These statistics can be misleading if rsync's delta\-transfer algorithm is |
1733 +These statistics can be misleading if rsync's delta\-transfer algorithm is |
1723 +in use. For example, if the sender's file consists of the basis file |
1734 +in use. For example, if the sender's file consists of the basis file |
1724 followed by additional data, the reported rate will probably drop |
1735 followed by additional data, the reported rate will probably drop |
1725 dramatically when the receiver gets to the literal data, and the transfer |
1736 dramatically when the receiver gets to the literal data, and the transfer |
1726 will probably take much longer to finish than the receiver estimated as it |
1737 will probably take much longer to finish than the receiver estimated as it |
1727 @@ -2774,12 +2778,12 @@ |
1738 @@ -2774,12 +2780,12 @@ |
1728 receiver to check (to see if they are up\-to\-date or not) remaining out of |
1739 receiver to check (to see if they are up\-to\-date or not) remaining out of |
1729 the 396 total files in the file\-list. |
1740 the 396 total files in the file\-list. |
1730 .IP |
1741 .IP |
1731 -In an incremental recursion scan, rsync won\(cq\&t know the total number of files |
1742 -In an incremental recursion scan, rsync won\(cq\&t know the total number of files |
1732 +In an incremental recursion scan, rsync won't know the total number of files |
1743 +In an incremental recursion scan, rsync won't know the total number of files |
1739 -\(dq\&to\-chk\(dq\&. Thus, seeing \(dq\&ir\-chk\(dq\& lets you know that the total count of files |
1750 -\(dq\&to\-chk\(dq\&. Thus, seeing \(dq\&ir\-chk\(dq\& lets you know that the total count of files |
1740 +"to\-chk". Thus, seeing "ir\-chk" lets you know that the total count of files |
1751 +"to\-chk". Thus, seeing "ir\-chk" lets you know that the total count of files |
1741 in the file list is still going to increase (and each time it does, the count |
1752 in the file list is still going to increase (and each time it does, the count |
1742 of files left to check will increase by the number of the files added to the |
1753 of files left to check will increase by the number of the files added to the |
1743 list). |
1754 list). |
1744 @@ -2793,7 +2797,7 @@ |
1755 @@ -2793,7 +2799,7 @@ |
1745 on the whole transfer, rather than individual files. Use this flag without |
1756 on the whole transfer, rather than individual files. Use this flag without |
1746 outputting a filename (e.g. avoid \fB\-v\fP or specify \fB\-\-info=name0\fP if you |
1757 outputting a filename (e.g. avoid \fB\-v\fP or specify \fB\-\-info=name0\fP if you |
1747 want to see how the transfer is doing without scrolling the screen with a |
1758 want to see how the transfer is doing without scrolling the screen with a |
1748 -lot of names. (You don\(cq\&t need to specify the \fB\-\-progress\fP option in |
1759 -lot of names. (You don\(cq\&t need to specify the \fB\-\-progress\fP option in |
1749 +lot of names. (You don't need to specify the \fB\-\-progress\fP option in |
1760 +lot of names. (You don't need to specify the \fB\-\-progress\fP option in |
1750 order to use \fB\-\-info=progress2\fP.) |
1761 order to use \fB\-\-info=progress2\fP.) |
1751 .IP |
1762 .IP |
1752 .IP "\fB\-\-password\-file=FILE\fP" |
1763 .IP "\fB\-\-password\-file=FILE\fP" |
1753 @@ -2804,10 +2808,10 @@ |
1764 @@ -2804,10 +2810,10 @@ |
1754 readable or if a root\-run rsync command finds a non\-root\-owned file. |
1765 readable or if a root\-run rsync command finds a non\-root\-owned file. |
1755 .IP |
1766 .IP |
1756 This option does not supply a password to a remote shell transport such as |
1767 This option does not supply a password to a remote shell transport such as |
1757 -ssh; to learn how to do that, consult the remote shell\(cq\&s documentation. |
1768 -ssh; to learn how to do that, consult the remote shell\(cq\&s documentation. |
1758 +ssh; to learn how to do that, consult the remote shell's documentation. |
1769 +ssh; to learn how to do that, consult the remote shell's documentation. |
1761 -authentication (i.e. if you have also specified a password in the daemon\(cq\&s |
1772 -authentication (i.e. if you have also specified a password in the daemon\(cq\&s |
1762 +authentication (i.e. if you have also specified a password in the daemon's |
1773 +authentication (i.e. if you have also specified a password in the daemon's |
1763 config file). |
1774 config file). |
1764 .IP |
1775 .IP |
1765 .IP "\fB\-\-list\-only\fP" |
1776 .IP "\fB\-\-list\-only\fP" |
1766 @@ -2837,17 +2841,17 @@ |
1777 @@ -2837,17 +2843,17 @@ |
1767 Compatibility note: when requesting a remote listing of files from an rsync |
1778 Compatibility note: when requesting a remote listing of files from an rsync |
1768 that is version 2.6.3 or older, you may encounter an error if you ask for a |
1779 that is version 2.6.3 or older, you may encounter an error if you ask for a |
1769 non\-recursive listing. This is because a file listing implies the \fB\-\-dirs\fP |
1780 non\-recursive listing. This is because a file listing implies the \fB\-\-dirs\fP |
1770 -option w/o \fB\-\-recursive\fP, and older rsyncs don\(cq\&t have that option. To |
1781 -option w/o \fB\-\-recursive\fP, and older rsyncs don\(cq\&t have that option. To |
1771 -avoid this problem, either specify the \fB\-\-no\-dirs\fP option (if you don\(cq\&t |
1782 -avoid this problem, either specify the \fB\-\-no\-dirs\fP option (if you don\(cq\&t |
1785 +be a fractional value (e.g. "\fB\-\-bwlimit=1.5m\fP"). If no suffix is specified, |
1796 +be a fractional value (e.g. "\fB\-\-bwlimit=1.5m\fP"). If no suffix is specified, |
1786 +the value will be assumed to be in units of 1024 bytes (as if "K" or "KiB" had |
1797 +the value will be assumed to be in units of 1024 bytes (as if "K" or "KiB" had |
1787 been appended). See the \fB\-\-max\-size\fP option for a description of all the |
1798 been appended). See the \fB\-\-max\-size\fP option for a description of all the |
1788 available suffixes. A value of zero specifies no limit. |
1799 available suffixes. A value of zero specifies no limit. |
1789 .IP |
1800 .IP |
1790 @@ -2856,7 +2860,7 @@ |
1801 @@ -2856,7 +2862,7 @@ |
1791 .IP |
1802 .IP |
1792 Rsync writes data over the socket in blocks, and this option both limits the |
1803 Rsync writes data over the socket in blocks, and this option both limits the |
1793 size of the blocks that rsync writes, and tries to keep the average transfer |
1804 size of the blocks that rsync writes, and tries to keep the average transfer |
1794 -rate at the requested limit. Some \(dq\&burstiness\(dq\& may be seen where rsync writes |
1805 -rate at the requested limit. Some \(dq\&burstiness\(dq\& may be seen where rsync writes |
1795 +rate at the requested limit. Some "burstiness" may be seen where rsync writes |
1806 +rate at the requested limit. Some "burstiness" may be seen where rsync writes |
1796 out a block of data and then sleeps to bring the average rate into compliance. |
1807 out a block of data and then sleeps to bring the average rate into compliance. |
1797 .IP |
1808 .IP |
1798 Due to the internal buffering of data, the \fB\-\-progress\fP option may not be an |
1809 Due to the internal buffering of data, the \fB\-\-progress\fP option may not be an |
1799 @@ -2867,7 +2871,7 @@ |
1810 @@ -2867,7 +2873,7 @@ |
1800 .IP |
1811 .IP |
1801 .IP "\fB\-\-write\-batch=FILE\fP" |
1812 .IP "\fB\-\-write\-batch=FILE\fP" |
1802 Record a file that can later be applied to |
1813 Record a file that can later be applied to |
1803 -another identical destination with \fB\-\-read\-batch\fP. See the \(dq\&BATCH MODE\(dq\& |
1814 -another identical destination with \fB\-\-read\-batch\fP. See the \(dq\&BATCH MODE\(dq\& |
1804 +another identical destination with \fB\-\-read\-batch\fP. See the "BATCH MODE" |
1815 +another identical destination with \fB\-\-read\-batch\fP. See the "BATCH MODE" |
1805 section for details, and also the \fB\-\-only\-write\-batch\fP option. |
1816 section for details, and also the \fB\-\-only\-write\-batch\fP option. |
1806 .IP |
1817 .IP |
1807 .IP "\fB\-\-only\-write\-batch=FILE\fP" |
1818 .IP "\fB\-\-only\-write\-batch=FILE\fP" |
1808 @@ -2879,58 +2883,58 @@ |
1819 @@ -2879,58 +2885,58 @@ |
1809 Note that you can feel free to write the batch directly to some portable |
1820 Note that you can feel free to write the batch directly to some portable |
1810 media: if this media fills to capacity before the end of the transfer, you |
1821 media: if this media fills to capacity before the end of the transfer, you |
1811 can just apply that partial transfer to the destination and repeat the |
1822 can just apply that partial transfer to the destination and repeat the |
1812 -whole process to get the rest of the changes (as long as you don\(cq\&t mind a |
1823 -whole process to get the rest of the changes (as long as you don\(cq\&t mind a |
1813 +whole process to get the rest of the changes (as long as you don't mind a |
1824 +whole process to get the rest of the changes (as long as you don't mind a |
1873 -daemon uses the charset specified in its \(dq\&charset\(dq\& configuration parameter |
1884 -daemon uses the charset specified in its \(dq\&charset\(dq\& configuration parameter |
1874 +daemon uses the charset specified in its "charset" configuration parameter |
1885 +daemon uses the charset specified in its "charset" configuration parameter |
1875 regardless of the remote charset you actually pass. Thus, you may feel free to |
1886 regardless of the remote charset you actually pass. Thus, you may feel free to |
1876 specify just the local charset for a daemon transfer (e.g. \fB\-\-iconv=utf8\fP). |
1887 specify just the local charset for a daemon transfer (e.g. \fB\-\-iconv=utf8\fP). |
1877 .IP |
1888 .IP |
1878 @@ -2947,10 +2951,10 @@ |
1889 @@ -2947,10 +2953,10 @@ |
1879 .IP "\fB\-\-checksum\-seed=NUM\fP" |
1890 .IP "\fB\-\-checksum\-seed=NUM\fP" |
1880 Set the checksum seed to the integer NUM. This 4 |
1891 Set the checksum seed to the integer NUM. This 4 |
1881 byte checksum seed is included in each block and MD4 file checksum calculation |
1892 byte checksum seed is included in each block and MD4 file checksum calculation |
1882 -(the more modern MD5 file checksums don\(cq\&t use a seed). By default the checksum |
1893 -(the more modern MD5 file checksums don\(cq\&t use a seed). By default the checksum |
1883 +(the more modern MD5 file checksums don't use a seed). By default the checksum |
1894 +(the more modern MD5 file checksums don't use a seed). By default the checksum |
1887 +\f(CWtime().\fP |
1898 +\f(CWtime().\fP |
1888 +This |
1899 +This |
1889 option is used to set a specific checksum seed, which is useful for |
1900 option is used to set a specific checksum seed, which is useful for |
1890 applications that want repeatable block checksums, or in the case where the |
1901 applications that want repeatable block checksums, or in the case where the |
1891 user wants a more random checksum seed. Setting NUM to 0 causes rsync to use |
1902 user wants a more random checksum seed. Setting NUM to 0 causes rsync to use |
1892 @@ -2980,7 +2984,7 @@ |
1903 @@ -2980,7 +2986,7 @@ |
1893 run as a daemon with the \fB\-\-daemon\fP option. The \fB\-\-address\fP option |
1904 run as a daemon with the \fB\-\-daemon\fP option. The \fB\-\-address\fP option |
1894 allows you to specify a specific IP address (or hostname) to bind to. This |
1905 allows you to specify a specific IP address (or hostname) to bind to. This |
1895 makes virtual hosting possible in conjunction with the \fB\-\-config\fP option. |
1906 makes virtual hosting possible in conjunction with the \fB\-\-config\fP option. |
1896 -See also the \(dq\&address\(dq\& global option in the rsyncd.conf manpage. |
1907 -See also the \(dq\&address\(dq\& global option in the rsyncd.conf manpage. |
1897 +See also the "address" global option in the rsyncd.conf manpage. |
1908 +See also the "address" global option in the rsyncd.conf manpage. |
1898 .IP |
1909 .IP |
1899 .IP "\fB\-\-bwlimit=RATE\fP" |
1910 .IP "\fB\-\-bwlimit=RATE\fP" |
1900 This option allows you to specify the maximum transfer |
1911 This option allows you to specify the maximum transfer |
1901 @@ -2998,7 +3002,7 @@ |
1912 @@ -2998,7 +3004,7 @@ |
1902 .IP "\fB\-M, \-\-dparam=OVERRIDE\fP" |
1913 .IP "\fB\-M, \-\-dparam=OVERRIDE\fP" |
1903 This option can be used to set a daemon\-config |
1914 This option can be used to set a daemon\-config |
1904 parameter when starting up rsync in daemon mode. It is equivalent to adding |
1915 parameter when starting up rsync in daemon mode. It is equivalent to adding |
1905 -the parameter at the end of the global settings prior to the first module\(cq\&s |
1916 -the parameter at the end of the global settings prior to the first module\(cq\&s |
1906 +the parameter at the end of the global settings prior to the first module's |
1917 +the parameter at the end of the global settings prior to the first module's |
1907 definition. The parameter names can be specified without spaces, if you so |
1918 definition. The parameter names can be specified without spaces, if you so |
1908 desire. For instance: |
1919 desire. For instance: |
1909 .IP |
1920 .IP |
1910 @@ -3012,25 +3016,25 @@ |
1921 @@ -3012,25 +3018,25 @@ |
1911 rsync to not detach itself and become a background process. This |
1922 rsync to not detach itself and become a background process. This |
1912 option is required when running as a service on Cygwin, and may also |
1923 option is required when running as a service on Cygwin, and may also |
1913 be useful when rsync is supervised by a program such as |
1924 be useful when rsync is supervised by a program such as |
1914 -\fBdaemontools\fP or AIX\(cq\&s \fBSystem Resource Controller\fP. |
1925 -\fBdaemontools\fP or AIX\(cq\&s \fBSystem Resource Controller\fP. |
1915 +\fBdaemontools\fP or AIX's \fBSystem Resource Controller\fP. |
1926 +\fBdaemontools\fP or AIX's \fBSystem Resource Controller\fP. |
1936 +given FORMAT string instead of using the "log format" setting in the config |
1947 +given FORMAT string instead of using the "log format" setting in the config |
1937 +file. It also enables "transfer logging" unless the string is empty, in which |
1948 +file. It also enables "transfer logging" unless the string is empty, in which |
1938 case transfer logging is turned off. |
1949 case transfer logging is turned off. |
1939 .IP |
1950 .IP |
1940 .IP "\fB\-\-sockopts\fP" |
1951 .IP "\fB\-\-sockopts\fP" |
1941 @@ -3040,15 +3044,15 @@ |
1952 @@ -3040,15 +3046,15 @@ |
1942 .IP "\fB\-v, \-\-verbose\fP" |
1953 .IP "\fB\-v, \-\-verbose\fP" |
1943 This option increases the amount of information the |
1954 This option increases the amount of information the |
1944 daemon logs during its startup phase. After the client connects, the |
1955 daemon logs during its startup phase. After the client connects, the |
1945 -daemon\(cq\&s verbosity level will be controlled by the options that the client |
1956 -daemon\(cq\&s verbosity level will be controlled by the options that the client |
1946 -used and the \(dq\&max verbosity\(dq\& setting in the module\(cq\&s config section. |
1957 -used and the \(dq\&max verbosity\(dq\& setting in the module\(cq\&s config section. |
1955 -an \(dq\&address already in use\(dq\& error when nothing else is using the port, |
1966 -an \(dq\&address already in use\(dq\& error when nothing else is using the port, |
1956 +an "address already in use" error when nothing else is using the port, |
1967 +an "address already in use" error when nothing else is using the port, |
1957 try specifying \fB\-\-ipv6\fP or \fB\-\-ipv4\fP when starting the daemon). |
1968 try specifying \fB\-\-ipv6\fP or \fB\-\-ipv4\fP when starting the daemon). |
1958 .IP |
1969 .IP |
1959 If rsync was complied without support for IPv6, the \fB\-\-ipv6\fP option |
1970 If rsync was complied without support for IPv6, the \fB\-\-ipv6\fP option |
1960 @@ -3087,7 +3091,7 @@ |
1971 @@ -3087,7 +3093,7 @@ |
1961 |
1972 |
1962 .PP |
1973 .PP |
1963 You have your choice of using either short or long RULE names, as described |
1974 You have your choice of using either short or long RULE names, as described |
1964 -below. If you use a short\-named rule, the \(cq\&,\(cq\& separating the RULE from the |
1975 -below. If you use a short\-named rule, the \(cq\&,\(cq\& separating the RULE from the |
1965 +below. If you use a short\-named rule, the ',' separating the RULE from the |
1976 +below. If you use a short\-named rule, the ',' separating the RULE from the |
1966 MODIFIERS is optional. The PATTERN or FILENAME that follows (when present) |
1977 MODIFIERS is optional. The PATTERN or FILENAME that follows (when present) |
1967 must come after either a single space or an underscore (_). |
1978 must come after either a single space or an underscore (_). |
1968 Here are the available rule prefixes: |
1979 Here are the available rule prefixes: |
1969 @@ -3115,15 +3119,15 @@ |
1980 @@ -3115,15 +3121,15 @@ |
1970 |
1981 |
1971 .PP |
1982 .PP |
1972 When rules are being read from a file, empty lines are ignored, as are |
1983 When rules are being read from a file, empty lines are ignored, as are |
1973 -comment lines that start with a \(dq\&#\(dq\&. |
1984 -comment lines that start with a \(dq\&#\(dq\&. |
1974 +comment lines that start with a "#". |
1985 +comment lines that start with a "#". |
1984 +does not begin with "\- " (dash, space) or "+ " (plus, space), then the |
1995 +does not begin with "\- " (dash, space) or "+ " (plus, space), then the |
1985 +rule will be interpreted as if "+ " (for an include option) or "\- " (for |
1996 +rule will be interpreted as if "+ " (for an include option) or "\- " (for |
1986 an exclude option) were prefixed to the string. A \fB\-\-filter\fP option, on |
1997 an exclude option) were prefixed to the string. A \fB\-\-filter\fP option, on |
1987 the other hand, must always contain either a short or long rule name at the |
1998 the other hand, must always contain either a short or long rule name at the |
1988 start of the rule. |
1999 start of the rule. |
1989 @@ -3136,8 +3140,8 @@ |
2000 @@ -3136,8 +3142,8 @@ |
1990 .SH "INCLUDE/EXCLUDE PATTERN RULES" |
2001 .SH "INCLUDE/EXCLUDE PATTERN RULES" |
1991 |
2002 |
1992 .PP |
2003 .PP |
1993 -You can include and exclude files by specifying patterns using the \(dq\&+\(dq\&, |
2004 -You can include and exclude files by specifying patterns using the \(dq\&+\(dq\&, |
1994 -\(dq\&\-\(dq\&, etc. filter rules (as introduced in the FILTER RULES section above). |
2005 -\(dq\&\-\(dq\&, etc. filter rules (as introduced in the FILTER RULES section above). |
1995 +You can include and exclude files by specifying patterns using the "+", |
2006 +You can include and exclude files by specifying patterns using the "+", |
1996 +"\-", etc. filter rules (as introduced in the FILTER RULES section above). |
2007 +"\-", etc. filter rules (as introduced in the FILTER RULES section above). |
1997 The include/exclude rules each specify a pattern that is matched against |
2008 The include/exclude rules each specify a pattern that is matched against |
1998 the names of the files that are going to be transferred. These patterns |
2009 the names of the files that are going to be transferred. These patterns |
1999 can take several forms: |
2010 can take several forms: |
2000 @@ -3147,15 +3151,15 @@ |
2011 @@ -3147,15 +3153,15 @@ |
2001 particular spot in the hierarchy of files, otherwise it is matched |
2012 particular spot in the hierarchy of files, otherwise it is matched |
2002 against the end of the pathname. This is similar to a leading ^ in |
2013 against the end of the pathname. This is similar to a leading ^ in |
2003 regular expressions. |
2014 regular expressions. |
2004 -Thus \(dq\&/foo\(dq\& would match a name of \(dq\&foo\(dq\& at either the \(dq\&root of the |
2015 -Thus \(dq\&/foo\(dq\& would match a name of \(dq\&foo\(dq\& at either the \(dq\&root of the |
2005 -transfer\(dq\& (for a global rule) or in the merge\-file\(cq\&s directory (for a |
2016 -transfer\(dq\& (for a global rule) or in the merge\-file\(cq\&s directory (for a |
2017 +any point in the hierarchy where a "foo" was found within a directory |
2028 +any point in the hierarchy where a "foo" was found within a directory |
2018 +named "sub". See the section on ANCHORING INCLUDE/EXCLUDE PATTERNS for |
2029 +named "sub". See the section on ANCHORING INCLUDE/EXCLUDE PATTERNS for |
2019 a full discussion of how to specify a pattern that matches at the root |
2030 a full discussion of how to specify a pattern that matches at the root |
2020 of the transfer. |
2031 of the transfer. |
2021 .IP o |
2032 .IP o |
2022 @@ -3164,48 +3168,48 @@ |
2033 @@ -3164,48 +3170,48 @@ |
2023 .IP o |
2034 .IP o |
2024 rsync chooses between doing a simple string match and wildcard |
2035 rsync chooses between doing a simple string match and wildcard |
2025 matching by checking if the pattern contains one of these three wildcard |
2036 matching by checking if the pattern contains one of these three wildcard |
2026 -characters: \(cq\&*\(cq\&, \(cq\&?\(cq\&, and \(cq\&[\(cq\& . |
2037 -characters: \(cq\&*\(cq\&, \(cq\&?\(cq\&, and \(cq\&[\(cq\& . |
2027 +characters: '*', '?', and '[' . |
2038 +characters: '*', '?', and '[' . |
2160 -should be inserted as excludes in place of the \(dq\&\-C\(dq\&. No arg should |
2171 -should be inserted as excludes in place of the \(dq\&\-C\(dq\&. No arg should |
2161 +should be inserted as excludes in place of the "\-C". No arg should |
2172 +should be inserted as excludes in place of the "\-C". No arg should |
2162 follow. |
2173 follow. |
2163 .IP o |
2174 .IP o |
2164 An \fBs\fP is used to indicate that the rule applies to the sending |
2175 An \fBs\fP is used to indicate that the rule applies to the sending |
2165 @@ -3298,7 +3302,7 @@ |
2176 @@ -3298,7 +3304,7 @@ |
2166 .IP o |
2177 .IP o |
2167 A \fBp\fP indicates that a rule is perishable, meaning that it is |
2178 A \fBp\fP indicates that a rule is perishable, meaning that it is |
2168 ignored in directories that are being deleted. For instance, the \fB\-C\fP |
2179 ignored in directories that are being deleted. For instance, the \fB\-C\fP |
2169 -option\(cq\&s default rules that exclude things like \(dq\&CVS\(dq\& and \(dq\&*.o\(dq\& are |
2180 -option\(cq\&s default rules that exclude things like \(dq\&CVS\(dq\& and \(dq\&*.o\(dq\& are |
2170 +option's default rules that exclude things like "CVS" and "*.o" are |
2181 +option's default rules that exclude things like "CVS" and "*.o" are |
2171 marked as perishable, and will not prevent a directory that was removed |
2182 marked as perishable, and will not prevent a directory that was removed |
2172 on the source from being deleted on the destination. |
2183 on the source from being deleted on the destination. |
2173 |
2184 |
2174 @@ -3310,16 +3314,16 @@ |
2185 @@ -3310,16 +3316,16 @@ |
2175 merge (.) or a dir\-merge (:) filter rule (as introduced in the FILTER RULES |
2186 merge (.) or a dir\-merge (:) filter rule (as introduced in the FILTER RULES |
2176 section above). |
2187 section above). |
2177 .PP |
2188 .PP |
2178 -There are two kinds of merged files \-\- single\-instance (\(cq\&.\(cq\&) and |
2189 -There are two kinds of merged files \-\- single\-instance (\(cq\&.\(cq\&) and |
2179 -per\-directory (\(cq\&:\(cq\&). A single\-instance merge file is read one time, and |
2190 -per\-directory (\(cq\&:\(cq\&). A single\-instance merge file is read one time, and |
2190 -affect what files don\(cq\&t get deleted (see PER\-DIRECTORY RULES AND DELETE |
2201 -affect what files don\(cq\&t get deleted (see PER\-DIRECTORY RULES AND DELETE |
2191 +affect what files don't get deleted (see PER\-DIRECTORY RULES AND DELETE |
2202 +affect what files don't get deleted (see PER\-DIRECTORY RULES AND DELETE |
2192 below). |
2203 below). |
2193 .PP |
2204 .PP |
2194 Some examples: |
2205 Some examples: |
2195 @@ -3348,27 +3352,27 @@ |
2206 @@ -3348,27 +3354,27 @@ |
2196 patterns, with no other rule\-parsing except for in\-file comments. |
2207 patterns, with no other rule\-parsing except for in\-file comments. |
2197 .IP o |
2208 .IP o |
2198 A \fBC\fP is a way to specify that the file should be read in a |
2209 A \fBC\fP is a way to specify that the file should be read in a |
2199 -CVS\-compatible manner. This turns on \(cq\&n\(cq\&, \(cq\&w\(cq\&, and \(cq\&\-\(cq\&, but also |
2210 -CVS\-compatible manner. This turns on \(cq\&n\(cq\&, \(cq\&w\(cq\&, and \(cq\&\-\(cq\&, but also |
2200 +CVS\-compatible manner. This turns on 'n', 'w', and '\-', but also |
2211 +CVS\-compatible manner. This turns on 'n', 'w', and '\-', but also |
2225 -while \(dq\&dir\-merge,s .filt\(dq\& and \(dq\&:sC\(dq\& would each make all their |
2236 -while \(dq\&dir\-merge,s .filt\(dq\& and \(dq\&:sC\(dq\& would each make all their |
2226 +while "dir\-merge,s .filt" and ":sC" would each make all their |
2237 +while "dir\-merge,s .filt" and ":sC" would each make all their |
2227 per\-directory rules apply only on the sending side. If the merge rule |
2238 per\-directory rules apply only on the sending side. If the merge rule |
2228 specifies sides to affect (via the \fBs\fP or \fBr\fP modifier or both), |
2239 specifies sides to affect (via the \fBs\fP or \fBr\fP modifier or both), |
2229 then the rules in the file must not specify sides (via a modifier or |
2240 then the rules in the file must not specify sides (via a modifier or |
2230 @@ -3376,22 +3380,22 @@ |
2241 @@ -3376,22 +3382,22 @@ |
2231 |
2242 |
2232 .PP |
2243 .PP |
2233 Per\-directory rules are inherited in all subdirectories of the directory |
2244 Per\-directory rules are inherited in all subdirectories of the directory |
2234 -where the merge\-file was found unless the \(cq\&n\(cq\& modifier was used. Each |
2245 -where the merge\-file was found unless the \(cq\&n\(cq\& modifier was used. Each |
2235 -subdirectory\(cq\&s rules are prefixed to the inherited per\-directory rules |
2246 -subdirectory\(cq\&s rules are prefixed to the inherited per\-directory rules |
2254 -Here\(cq\&s an example filter file which you\(cq\&d specify via \fB\-\-filter=\(dq\&. file\(dq\&:\fP |
2265 -Here\(cq\&s an example filter file which you\(cq\&d specify via \fB\-\-filter=\(dq\&. file\(dq\&:\fP |
2255 +Here's an example filter file which you'd specify via \fB\-\-filter=". file":\fP |
2266 +Here's an example filter file which you'd specify via \fB\-\-filter=". file":\fP |
2256 .PP |
2267 .PP |
2257 .RS |
2268 .RS |
2258 \f(CWmerge /home/user/.global\-filter\fP |
2269 \f(CWmerge /home/user/.global\-filter\fP |
2259 @@ -3408,7 +3412,7 @@ |
2270 @@ -3408,7 +3414,7 @@ |
2260 |
2271 |
2261 .PP |
2272 .PP |
2262 This will merge the contents of the /home/user/.global\-filter file at the |
2273 This will merge the contents of the /home/user/.global\-filter file at the |
2263 -start of the list and also turns the \(dq\&.rules\(dq\& filename into a per\-directory |
2274 -start of the list and also turns the \(dq\&.rules\(dq\& filename into a per\-directory |
2264 +start of the list and also turns the ".rules" filename into a per\-directory |
2275 +start of the list and also turns the ".rules" filename into a per\-directory |
2265 filter file. All rules read in prior to the start of the directory scan |
2276 filter file. All rules read in prior to the start of the directory scan |
2266 follow the global anchoring rules (i.e. a leading slash matches at the root |
2277 follow the global anchoring rules (i.e. a leading slash matches at the root |
2267 of the transfer). |
2278 of the transfer). |
2268 @@ -3419,7 +3423,7 @@ |
2279 @@ -3419,7 +3425,7 @@ |
2269 per\-directory file. For instance, here is a common filter (see \fB\-F\fP): |
2280 per\-directory file. For instance, here is a common filter (see \fB\-F\fP): |
2270 .PP |
2281 .PP |
2271 .RS |
2282 .RS |
2272 -\f(CW\-\-filter='\&: /.rsync\-filter'\&\fP |
2283 -\f(CW\-\-filter='\&: /.rsync\-filter'\&\fP |
2273 +\f(CW\-\-filter=': /.rsync\-filter'\fP |
2284 +\f(CW\-\-filter=': /.rsync\-filter'\fP |
2274 .RE |
2285 .RE |
2275 |
2286 |
2276 .PP |
2287 .PP |
2277 @@ -3427,38 +3431,38 @@ |
2288 @@ -3427,38 +3433,38 @@ |
2278 directories from the root down through the parent directory of the |
2289 directories from the root down through the parent directory of the |
2279 transfer prior to the start of the normal directory scan of the file in |
2290 transfer prior to the start of the normal directory scan of the file in |
2280 the directories that are sent as a part of the transfer. (Note: for an |
2291 the directories that are sent as a part of the transfer. (Note: for an |
2281 -rsync daemon, the root is always the same as the module\(cq\&s \(dq\&path\(dq\&.) |
2292 -rsync daemon, the root is always the same as the module\(cq\&s \(dq\&path\(dq\&.) |
2282 +rsync daemon, the root is always the same as the module's "path".) |
2293 +rsync daemon, the root is always the same as the module's "path".) |
2322 -\f(CWcat <<EOT | rsync \-avC \-\-filter='\&. \-'\& a/ b\fP |
2333 -\f(CWcat <<EOT | rsync \-avC \-\-filter='\&. \-'\& a/ b\fP |
2323 +\f(CWcat <<EOT | rsync \-avC \-\-filter='. \-' a/ b\fP |
2334 +\f(CWcat <<EOT | rsync \-avC \-\-filter='. \-' a/ b\fP |
2324 .br |
2335 .br |
2325 \f(CW+ foo.o\fP |
2336 \f(CW+ foo.o\fP |
2326 .br |
2337 .br |
2327 @@ -3468,7 +3472,7 @@ |
2338 @@ -3468,7 +3474,7 @@ |
2328 .br |
2339 .br |
2329 \f(CWEOT\fP |
2340 \f(CWEOT\fP |
2330 .br |
2341 .br |
2331 -\f(CWrsync \-avC \-\-include=foo.o \-f :C \-\-exclude='\&*.old'\& a/ b\fP |
2342 -\f(CWrsync \-avC \-\-include=foo.o \-f :C \-\-exclude='\&*.old'\& a/ b\fP |
2332 +\f(CWrsync \-avC \-\-include=foo.o \-f :C \-\-exclude='*.old' a/ b\fP |
2343 +\f(CWrsync \-avC \-\-include=foo.o \-f :C \-\-exclude='*.old' a/ b\fP |
2333 .br |
2344 .br |
2334 .RE |
2345 .RE |
2335 |
2346 |
2336 @@ -3479,25 +3483,25 @@ |
2347 @@ -3479,25 +3485,25 @@ |
2337 that follow the :C instead of being subservient to all your rules. To |
2348 that follow the :C instead of being subservient to all your rules. To |
2338 affect the other CVS exclude rules (i.e. the default list of exclusions, |
2349 affect the other CVS exclude rules (i.e. the default list of exclusions, |
2339 the contents of $HOME/.cvsignore, and the value of $CVSIGNORE) you should |
2350 the contents of $HOME/.cvsignore, and the value of $CVSIGNORE) you should |
2340 -omit the \fB\-C\fP command\-line option and instead insert a \(dq\&\-C\(dq\& rule into |
2351 -omit the \fB\-C\fP command\-line option and instead insert a \(dq\&\-C\(dq\& rule into |
2341 -your filter rules; e.g. \(dq\&\fB\-\-filter=\-C\fP\(dq\&. |
2352 -your filter rules; e.g. \(dq\&\fB\-\-filter=\-C\fP\(dq\&. |
2364 +"root of the transfer" (as opposed to per\-directory patterns, which are |
2375 +"root of the transfer" (as opposed to per\-directory patterns, which are |
2365 +anchored at the merge\-file's directory). If you think of the transfer as |
2376 +anchored at the merge\-file's directory). If you think of the transfer as |
2366 a subtree of names that are being sent from sender to receiver, the |
2377 a subtree of names that are being sent from sender to receiver, the |
2367 transfer\-root is where the tree starts to be duplicated in the destination |
2378 transfer\-root is where the tree starts to be duplicated in the destination |
2368 directory. This root governs where patterns that start with a / match. |
2379 directory. This root governs where patterns that start with a / match. |
2369 @@ -3508,8 +3512,8 @@ |
2380 @@ -3508,8 +3514,8 @@ |
2370 changing how much of the file tree is duplicated on the destination |
2381 changing how much of the file tree is duplicated on the destination |
2371 host). The following examples demonstrate this. |
2382 host). The following examples demonstrate this. |
2372 .PP |
2383 .PP |
2373 -Let\(cq\&s say that we want to match two source files, one with an absolute |
2384 -Let\(cq\&s say that we want to match two source files, one with an absolute |
2374 -path of \(dq\&/home/me/foo/bar\(dq\&, and one with a path of \(dq\&/home/you/bar/baz\(dq\&. |
2385 -path of \(dq\&/home/me/foo/bar\(dq\&, and one with a path of \(dq\&/home/you/bar/baz\(dq\&. |
2375 +Let's say that we want to match two source files, one with an absolute |
2386 +Let's say that we want to match two source files, one with an absolute |
2376 +path of "/home/me/foo/bar", and one with a path of "/home/you/bar/baz". |
2387 +path of "/home/me/foo/bar", and one with a path of "/home/you/bar/baz". |
2377 Here is how the various command choices differ for a 2\-source transfer: |
2388 Here is how the various command choices differ for a 2\-source transfer: |
2378 .PP |
2389 .PP |
2379 .RS |
2390 .RS |
2380 @@ -3529,9 +3533,9 @@ |
2391 @@ -3529,9 +3535,9 @@ |
2381 .RS |
2392 .RS |
2382 Example cmd: rsync \-a /home/me/ /home/you/ /dest |
2393 Example cmd: rsync \-a /home/me/ /home/you/ /dest |
2383 .br |
2394 .br |
2384 -+/\- pattern: /foo/bar (note missing \(dq\&me\(dq\&) |
2395 -+/\- pattern: /foo/bar (note missing \(dq\&me\(dq\&) |
2385 ++/\- pattern: /foo/bar (note missing "me") |
2396 ++/\- pattern: /foo/bar (note missing "me") |
2419 -files to be excluded from being deleted, you\(cq\&ll need to be sure that the |
2430 -files to be excluded from being deleted, you\(cq\&ll need to be sure that the |
2420 +files to be excluded from being deleted, you'll need to be sure that the |
2431 +files to be excluded from being deleted, you'll need to be sure that the |
2421 receiving side knows what files to exclude. The easiest way is to include |
2432 receiving side knows what files to exclude. The easiest way is to include |
2422 the per\-directory merge files in the transfer and use \fB\-\-delete\-after\fP, |
2433 the per\-directory merge files in the transfer and use \fB\-\-delete\-after\fP, |
2423 because this ensures that the receiving side gets all the same exclude |
2434 because this ensures that the receiving side gets all the same exclude |
2424 @@ -3600,14 +3604,14 @@ |
2435 @@ -3600,14 +3606,14 @@ |
2425 .RE |
2436 .RE |
2426 |
2437 |
2427 .PP |
2438 .PP |
2428 -However, if the merge files are not a part of the transfer, you\(cq\&ll need to |
2439 -However, if the merge files are not a part of the transfer, you\(cq\&ll need to |
2429 +However, if the merge files are not a part of the transfer, you'll need to |
2440 +However, if the merge files are not a part of the transfer, you'll need to |
2437 -rsync \-av \-\-filter=\(cq\&: .rules\(cq\& \-\-filter=\(cq\&. /my/extra.rules\(cq\& |
2448 -rsync \-av \-\-filter=\(cq\&: .rules\(cq\& \-\-filter=\(cq\&. /my/extra.rules\(cq\& |
2438 +rsync \-av \-\-filter=': .rules' \-\-filter='. /my/extra.rules' |
2449 +rsync \-av \-\-filter=': .rules' \-\-filter='. /my/extra.rules' |
2439 \-\-delete host:src/dir /dest |
2450 \-\-delete host:src/dir /dest |
2440 .fi |
2451 .fi |
2441 |
2452 |
2442 @@ -3620,12 +3624,12 @@ |
2453 @@ -3620,12 +3626,12 @@ |
2443 In one final example, the remote side is excluding the .rsync\-filter |
2454 In one final example, the remote side is excluding the .rsync\-filter |
2444 files from the transfer, but we want to use our own .rsync\-filter files |
2455 files from the transfer, but we want to use our own .rsync\-filter files |
2445 to control what gets deleted on the receiving side. To do this we must |
2456 to control what gets deleted on the receiving side. To do this we must |
2446 -specifically exclude the per\-directory merge files (so that they don\(cq\&t get |
2457 -specifically exclude the per\-directory merge files (so that they don\(cq\&t get |
2447 +specifically exclude the per\-directory merge files (so that they don't get |
2458 +specifically exclude the per\-directory merge files (so that they don't get |
2452 - rsync \-av \-\-filter='\&:e /.rsync\-filter'\& \-\-delete \e |
2463 - rsync \-av \-\-filter='\&:e /.rsync\-filter'\& \-\-delete \e |
2453 + rsync \-av \-\-filter=':e /.rsync\-filter' \-\-delete \e |
2464 + rsync \-av \-\-filter=':e /.rsync\-filter' \-\-delete \e |
2454 host:src/dir /dest |
2465 host:src/dir /dest |
2455 rsync \-avFF \-\-delete host:src/dir /dest |
2466 rsync \-avFF \-\-delete host:src/dir /dest |
2456 .fi |
2467 .fi |
2457 @@ -3641,7 +3645,7 @@ |
2468 @@ -3641,7 +3647,7 @@ |
2458 hosts. In order to do this using batch mode, rsync is run with the |
2469 hosts. In order to do this using batch mode, rsync is run with the |
2459 write\-batch option to apply the changes made to the source tree to one |
2470 write\-batch option to apply the changes made to the source tree to one |
2460 of the destination trees. The write\-batch option causes the rsync |
2471 of the destination trees. The write\-batch option causes the rsync |
2461 -client to store in a \(dq\&batch file\(dq\& all the information needed to repeat |
2472 -client to store in a \(dq\&batch file\(dq\& all the information needed to repeat |
2462 +client to store in a "batch file" all the information needed to repeat |
2473 +client to store in a "batch file" all the information needed to repeat |
2463 this operation against other, identical destination trees. |
2474 this operation against other, identical destination trees. |
2464 .PP |
2475 .PP |
2465 Generating the batch file once saves having to perform the file |
2476 Generating the batch file once saves having to perform the file |
2466 @@ -3656,7 +3660,7 @@ |
2477 @@ -3656,7 +3662,7 @@ |
2467 using the information stored in the batch file. |
2478 using the information stored in the batch file. |
2468 .PP |
2479 .PP |
2469 For your convenience, a script file is also created when the write\-batch |
2480 For your convenience, a script file is also created when the write\-batch |
2470 -option is used: it will be named the same as the batch file with \(dq\&.sh\(dq\& |
2481 -option is used: it will be named the same as the batch file with \(dq\&.sh\(dq\& |
2471 +option is used: it will be named the same as the batch file with ".sh" |
2482 +option is used: it will be named the same as the batch file with ".sh" |
2472 appended. This script file contains a command\-line suitable for updating a |
2483 appended. This script file contains a command\-line suitable for updating a |
2473 destination tree using the associated batch file. It can be executed using |
2484 destination tree using the associated batch file. It can be executed using |
2474 a Bourne (or Bourne\-like) shell, optionally passing in an alternate |
2485 a Bourne (or Bourne\-like) shell, optionally passing in an alternate |
2475 @@ -3685,25 +3689,25 @@ |
2486 @@ -3685,25 +3691,25 @@ |
2476 |
2487 |
2477 .PP |
2488 .PP |
2478 In these examples, rsync is used to update /adest/dir/ from /source/dir/ |
2489 In these examples, rsync is used to update /adest/dir/ from /source/dir/ |
2479 -and the information to repeat this operation is stored in \(dq\&foo\(dq\& and |
2490 -and the information to repeat this operation is stored in \(dq\&foo\(dq\& and |
2480 -\(dq\&foo.sh\(dq\&. The host \(dq\&remote\(dq\& is then updated with the batched data going |
2491 -\(dq\&foo.sh\(dq\&. The host \(dq\&remote\(dq\& is then updated with the batched data going |
2502 -standard input, such as the \(dq\&\fB\-\-exclude\-from=\-\fP\(dq\& option). |
2513 -standard input, such as the \(dq\&\fB\-\-exclude\-from=\-\fP\(dq\& option). |
2503 +standard input, such as the "\fB\-\-exclude\-from=\-\fP" option). |
2514 +standard input, such as the "\fB\-\-exclude\-from=\-\fP" option). |
2504 |
2515 |
2505 .PP |
2516 .PP |
2506 Caveats: |
2517 Caveats: |
2507 @@ -3716,7 +3720,7 @@ |
2518 @@ -3716,7 +3722,7 @@ |
2508 and then, if the file fails to verify, the update discarded with an |
2519 and then, if the file fails to verify, the update discarded with an |
2509 error. This means that it should be safe to re\-run a read\-batch operation |
2520 error. This means that it should be safe to re\-run a read\-batch operation |
2510 if the command got interrupted. If you wish to force the batched\-update to |
2521 if the command got interrupted. If you wish to force the batched\-update to |
2511 -always be attempted regardless of the file\(cq\&s size and date, use the \fB\-I\fP |
2522 -always be attempted regardless of the file\(cq\&s size and date, use the \fB\-I\fP |
2512 +always be attempted regardless of the file's size and date, use the \fB\-I\fP |
2523 +always be attempted regardless of the file's size and date, use the \fB\-I\fP |
2513 option (when reading the batch). |
2524 option (when reading the batch). |
2514 If an error occurs, the destination tree will probably be in a |
2525 If an error occurs, the destination tree will probably be in a |
2515 partially updated state. In that case, rsync can |
2526 partially updated state. In that case, rsync can |
2516 @@ -3732,7 +3736,7 @@ |
2527 @@ -3732,7 +3738,7 @@ |
2517 older than that with newer versions will not work.) |
2528 older than that with newer versions will not work.) |
2518 .PP |
2529 .PP |
2519 When reading a batch file, rsync will force the value of certain options |
2530 When reading a batch file, rsync will force the value of certain options |
2520 -to match the data in the batch file if you didn\(cq\&t set them to the same |
2531 -to match the data in the batch file if you didn\(cq\&t set them to the same |
2521 +to match the data in the batch file if you didn't set them to the same |
2532 +to match the data in the batch file if you didn't set them to the same |
2522 as the batch\-writing command. Other options can (and should) be changed. |
2533 as the batch\-writing command. Other options can (and should) be changed. |
2523 For instance \fB\-\-write\-batch\fP changes to \fB\-\-read\-batch\fP, |
2534 For instance \fB\-\-write\-batch\fP changes to \fB\-\-read\-batch\fP, |
2524 \fB\-\-files\-from\fP is dropped, and the |
2535 \fB\-\-files\-from\fP is dropped, and the |
2525 @@ -3740,13 +3744,13 @@ |
2536 @@ -3740,13 +3746,13 @@ |
2526 one of the \fB\-\-delete\fP options is specified. |
2537 one of the \fB\-\-delete\fP options is specified. |
2527 .PP |
2538 .PP |
2528 The code that creates the BATCH.sh file transforms any filter/include/exclude |
2539 The code that creates the BATCH.sh file transforms any filter/include/exclude |
2529 -options into a single list that is appended as a \(dq\&here\(dq\& document to the |
2540 -options into a single list that is appended as a \(dq\&here\(dq\& document to the |
2530 +options into a single list that is appended as a "here" document to the |
2541 +options into a single list that is appended as a "here" document to the |
2536 -The original batch mode in rsync was based on \(dq\&rsync+\(dq\&, but the latest |
2547 -The original batch mode in rsync was based on \(dq\&rsync+\(dq\&, but the latest |
2537 +The original batch mode in rsync was based on "rsync+", but the latest |
2548 +The original batch mode in rsync was based on "rsync+", but the latest |
2538 version uses a new implementation. |
2549 version uses a new implementation. |
2539 .PP |
2550 .PP |
2540 .SH "SYMBOLIC LINKS" |
2551 .SH "SYMBOLIC LINKS" |
2541 @@ -3756,16 +3760,16 @@ |
2552 @@ -3756,16 +3762,16 @@ |
2542 link in the source directory. |
2553 link in the source directory. |
2543 .PP |
2554 .PP |
2544 By default, symbolic links are not transferred at all. A message |
2555 By default, symbolic links are not transferred at all. A message |
2545 -\(dq\&skipping non\-regular\(dq\& file is emitted for any symlinks that exist. |
2556 -\(dq\&skipping non\-regular\(dq\& file is emitted for any symlinks that exist. |
2546 +"skipping non\-regular" file is emitted for any symlinks that exist. |
2557 +"skipping non\-regular" file is emitted for any symlinks that exist. |
2556 -Rsync can also distinguish \(dq\&safe\(dq\& and \(dq\&unsafe\(dq\& symbolic links. An |
2567 -Rsync can also distinguish \(dq\&safe\(dq\& and \(dq\&unsafe\(dq\& symbolic links. An |
2557 +Rsync can also distinguish "safe" and "unsafe" symbolic links. An |
2568 +Rsync can also distinguish "safe" and "unsafe" symbolic links. An |
2558 example where this might be used is a web site mirror that wishes to |
2569 example where this might be used is a web site mirror that wishes to |
2559 ensure that the rsync module that is copied does not include symbolic links to |
2570 ensure that the rsync module that is copied does not include symbolic links to |
2560 \fB/etc/passwd\fP in the public section of the site. Using |
2571 \fB/etc/passwd\fP in the public section of the site. Using |
2561 @@ -3775,11 +3779,11 @@ |
2572 @@ -3775,11 +3781,11 @@ |
2562 \fB\-\-links\fP for \fB\-\-safe\-links\fP to have any effect.) |
2573 \fB\-\-links\fP for \fB\-\-safe\-links\fP to have any effect.) |
2563 .PP |
2574 .PP |
2564 Symbolic links are considered unsafe if they are absolute symlinks |
2575 Symbolic links are considered unsafe if they are absolute symlinks |
2565 -(start with \fB/\fP), empty, or if they contain enough \(dq\&..\(dq\& |
2576 -(start with \fB/\fP), empty, or if they contain enough \(dq\&..\(dq\& |
2566 +(start with \fB/\fP), empty, or if they contain enough ".." |
2577 +(start with \fB/\fP), empty, or if they contain enough ".." |
2571 +Here's a summary of how the symlink options are interpreted. The list is |
2582 +Here's a summary of how the symlink options are interpreted. The list is |
2572 +in order of precedence, so if your combination of options isn't mentioned, |
2583 +in order of precedence, so if your combination of options isn't mentioned, |
2573 use the first line that is a complete subset of your options: |
2584 use the first line that is a complete subset of your options: |
2574 .PP |
2585 .PP |
2575 .IP "\fB\-\-copy\-links\fP" |
2586 .IP "\fB\-\-copy\-links\fP" |
2576 @@ -3805,8 +3809,8 @@ |
2587 @@ -3805,8 +3811,8 @@ |
2577 |
2588 |
2578 .PP |
2589 .PP |
2579 rsync occasionally produces error messages that may seem a little |
2590 rsync occasionally produces error messages that may seem a little |
2580 -cryptic. The one that seems to cause the most confusion is \(dq\&protocol |
2591 -cryptic. The one that seems to cause the most confusion is \(dq\&protocol |
2581 -version mismatch \-\- is your shell clean?\(dq\&. |
2592 -version mismatch \-\- is your shell clean?\(dq\&. |
2582 +cryptic. The one that seems to cause the most confusion is "protocol |
2593 +cryptic. The one that seems to cause the most confusion is "protocol |
2583 +version mismatch \-\- is your shell clean?". |
2594 +version mismatch \-\- is your shell clean?". |
2584 .PP |
2595 .PP |
2585 This message is usually caused by your startup scripts or remote shell |
2596 This message is usually caused by your startup scripts or remote shell |
2586 facility producing unwanted garbage on the stream that rsync is using |
2597 facility producing unwanted garbage on the stream that rsync is using |
2587 @@ -3906,13 +3910,13 @@ |
2598 @@ -3906,13 +3912,13 @@ |
2588 password allows you to run authenticated rsync connections to an rsync |
2599 password allows you to run authenticated rsync connections to an rsync |
2589 daemon without user intervention. Note that this does not supply a |
2600 daemon without user intervention. Note that this does not supply a |
2590 password to a remote shell transport such as ssh; to learn how to do that, |
2601 password to a remote shell transport such as ssh; to learn how to do that, |
2591 -consult the remote shell\(cq\&s documentation. |
2602 -consult the remote shell\(cq\&s documentation. |
2592 +consult the remote shell's documentation. |
2603 +consult the remote shell's documentation. |
2599 -The HOME environment variable is used to find the user\(cq\&s |
2610 -The HOME environment variable is used to find the user\(cq\&s |
2600 +The HOME environment variable is used to find the user's |
2611 +The HOME environment variable is used to find the user's |
2601 default .cvsignore file. |
2612 default .cvsignore file. |
2602 |
2613 |
2603 .PP |
2614 .PP |
2604 @@ -3987,7 +3991,7 @@ |
2615 @@ -3924,7 +3930,7 @@ |
|
2616 .SH "SEE ALSO" |
|
2617 |
|
2618 .PP |
|
2619 -\fBrsyncd.conf\fP(5) |
|
2620 +\fBrsyncd.conf\fP(5), \fBacl\fP(5) |
|
2621 .PP |
|
2622 .SH "BUGS" |
|
2623 |
|
2624 @@ -3987,7 +3993,7 @@ |
2605 gone\-but\-not\-forgotten compadre, J.W. Schultz. |
2625 gone\-but\-not\-forgotten compadre, J.W. Schultz. |
2606 .PP |
2626 .PP |
2607 Thanks also to Richard Brent, Brendan Mackay, Bill Waite, Stephen Rothwell |
2627 Thanks also to Richard Brent, Brendan Mackay, Bill Waite, Stephen Rothwell |
2608 -and David Bell. I\(cq\&ve probably missed some people, my apologies if I have. |
2628 -and David Bell. I\(cq\&ve probably missed some people, my apologies if I have. |
2609 +and David Bell. I've probably missed some people, my apologies if I have. |
2629 +and David Bell. I've probably missed some people, my apologies if I have. |