| 1 | NAME | 
| 2 | rsync-here.pl | 
| 3 |  | 
| 4 | SYNOPSIS | 
| 5 | Wrapper around rsync program to provide an easy calling syntax for | 
| 6 | rsyncing against a predefined target. | 
| 7 |  | 
| 8 | DESCRIPTION | 
| 9 | Before starting, your need to configure some specific variables in this | 
| 10 | file. Please see section CONFIGURATION. rsync-here.pl expects a single | 
| 11 | argument on the command line. Give it a full directory path and it will | 
| 12 | run the rsync program in the following style: (abstract) | 
| 13 |  | 
| 14 | cd /$root; \     # go to one level on top of the specified source path | 
| 15 | $rsync -azuv -R -e ssh --progress $source $target | 
| 16 |  | 
| 17 | CONFIGURATION | 
| 18 | Please edit "rsync-here.pl" to configure it, there is no ".ini"-style | 
| 19 | configuration file yet. | 
| 20 |  | 
| 21 | - $sh: /path/to/your/sh | 
| 22 | - $rsync: /path/to/your/rsync | 
| 23 | - $target_prefix: username@host.mydomain.org | 
| 24 | - $target_base: /path/to/your/backup-repository-base | 
| 25 | The hostname of your machine will be appended to "$target_base", on | 
| 26 | windows also the volumename. | 
| 27 |  | 
| 28 | PREREQUISITES | 
| 29 | * Perl | 
| 30 | * Rsync | 
| 31 | * SSH | 
| 32 | You also may find it convenient to setup ssh working with keys. (use | 
| 33 | ssh-keygen [-d]) | 
| 34 |  | 
| 35 | COPYRIGHT | 
| 36 | This program is free software. You may copy or redistribute it under the | 
| 37 | same terms as Perl itself. | 
| 38 |  | 
| 39 | TODO | 
| 40 | + windows compatibility | 
| 41 | + waiting for keypress on exit: better handling | 
| 42 | + write output to STDOUT while working! | 
| 43 | - ease ssh-key-setup for non-interactive use, include doc at min! | 
| 44 | - read "user - config" variables from %ENV | 
| 45 | - make it possible to sync single files |