Mention the mapfrom/mapto scripts and how they work.

[rsync/rsync.git] / support / mapto

diff --git a/support/mapto b/support/mapto
old mode 100644 (file)
new mode 100755 (executable)
index 8bafa10..a1dbe3c
--- a/support/mapto
+++ b/support/mapto
@@ -1,4 +1,14 @@
 #!/usr/bin/perl
+# This helper script makes it easy to use a passwd or group file to map
+# values in a LOCAL transfer.  For instance, if you mount a backup that
+# does not have the same passwd setup as the local machine, you can do
+# a copy TO the backup area as follows and get the differing ID values
+# mapped just like a remote transfer TO the backed-up machine would do:
+#
+# rsync -av --usermap=`mapto /mnt/backup/etc/passwd` \
+#           --groupmap=`mapto /mnt/backup/etc/group` \
+#           /some/src/ /mnt/backup/some/dest/
+
 while (<>) {
     push @_, "$1:$2" if /^(\w+):[^:]+:(\d+)/;
 }