X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/2df20057e34db58c8caa37def9321e33acfa56fd..8b7a752024f34a220ef340d9b466ec871e6cbc0a:/support/mapfrom

diff --git a/support/mapfrom b/support/mapfrom
old mode 100644
new mode 100755
index 4e0b71d6..ca3b8173
--- a/support/mapfrom
+++ b/support/mapfrom
@@ -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 FROM the backup area as follows and get the differing ID values
+# mapped just like a remote transfer FROM the backed-up machine would do:
+#
+# rsync -av --usermap=`mapfrom /mnt/backup/etc/passwd` \
+#           --groupmap=`mapfrom /mnt/backup/etc/group` \
+#           /mnt/backup/some/src/ /some/dest/
+
 while (<>) {
     push @_, "$2:$1" if /^(\w+):[^:]+:(\d+)/;
 }