| 1 |
File-Rsync - A wrapper module for rsync(1) http://rsync.samba.org/rsync/ |
| 2 |
|
| 3 |
******************************************************************************* |
| 4 |
Copyright (C) 2000-2016 Lee Eakin. All rights reserved. |
| 5 |
This program is free software; you can redistribute it and/or modify |
| 6 |
it under the same terms as Perl itself. |
| 7 |
******************************************************************************* |
| 8 |
|
| 9 |
Arg order is now preserved! Hopefully this provides better funtionality and |
| 10 |
more flexibility, and doesn't break anyone's code. Passing a hash reference is |
| 11 |
now deprecated, but forcing options to be a hash reference should restore old |
| 12 |
behavior if needed (option order not preserved, but source and dest are always |
| 13 |
the last 2 args). |
| 14 |
|
| 15 |
Windows is also now supported! See Changelog for details and credits. |
| 16 |
|
| 17 |
Updated to use $PATH environment variable to find rsync instead of hard-coding |
| 18 |
in the module since prompting breaks automatic builds and most modren systems |
| 19 |
should have rsync installed by now. It can be overridden using path-to-rsync |
| 20 |
at run time. |
| 21 |
|
| 22 |
Although I am the original author and maintainer, many of the bug fixes and |
| 23 |
improvements have come as either suggestions or patches from the perl |
| 24 |
community. The contributors names can be found near the end of the POD doc, |
| 25 |
and full credits can be found in the Changelog file. |
| 26 |
There have been many helpful people making this a much better module than |
| 27 |
I could ever write on my own. |
| 28 |
|
| 29 |
QUICK START GUIDE: |
| 30 |
|
| 31 |
Install rsync if you haven't already. |
| 32 |
|
| 33 |
Build/test/install File::Rsync |
| 34 |
|
| 35 |
perl Makefile.PL |
| 36 |
make |
| 37 |
make test |
| 38 |
make install |
| 39 |
|
| 40 |
Once installed you can use 'perldoc File::Rsync' to get the rest of the |
| 41 |
documentation. Or if you'd prefer to examine the docs before installation |
| 42 |
try 'perldoc -F Rsync.pm'. |
| 43 |
|
| 44 |
This module is an attempt to efficiently handle the possibly numerous arguments |
| 45 |
to the rsync command, and it's error conditions and messages. |