| 1 |
Thu Mar 10 07:52:24 CST 2016 ( leakin at japh dot net ) |
| 2 |
|
| 3 |
* version 0.49: fix infun, broken since 0.46 refactor |
| 4 |
|
| 5 |
Michal Krupicka ( Michal dot Krupicka at skoda-auto dot cz ) reported |
| 6 |
that I broke the the input function (it worked differently from 0.45 |
| 7 |
and the documentation) when I converted to using IPC::Run3. This restores |
| 8 |
compatability with 0.45. Thanks Michal. |
| 9 |
|
| 10 |
Mon Sep 21 15:58:35 CDT 2015 ( leakin at dfw dot nostrum dot com ) |
| 11 |
|
| 12 |
* version 0.48: fix list option parsing |
| 13 |
|
| 14 |
Bill Shunn ( proprietor at shunn dot net ) found a bug in list option |
| 15 |
parsing that broke filters (and probably others as well). |
| 16 |
|
| 17 |
Fri Sep 11 08:36:39 CDT 2015 ( leakin at dfw dot nostrum dot com ) |
| 18 |
|
| 19 |
* version 0.47: fixed hash ref parsing |
| 20 |
|
| 21 |
Andreas Koenig ( andk at cpan dot org ) pointed out a problem |
| 22 |
with the hash ref compatibility code, and then graciously provided |
| 23 |
a test case to help me track down the problem. Added another |
| 24 |
test to confirm. |
| 25 |
|
| 26 |
Wed Jul 29 09:32:05 CDT 2015 ( leakin at dfw dot nostrum dot com ) |
| 27 |
|
| 28 |
* version 0.46: added support for new options up to 3.1.1 |
| 29 |
|
| 30 |
Max Maischein ( corion at corion dot net ) provided code and |
| 31 |
insight on how to support Windows OS, as well as some improved |
| 32 |
tests. IPC::Open3 was replaced with IPC::Run3 as part of this |
| 33 |
effort, thanks to Max for showing me this module. It simplified |
| 34 |
a big chunk of code and I was able to take advantage of its |
| 35 |
features in a few places (see infun and files-from below). |
| 36 |
|
| 37 |
Gavin Carr ( gavin at openfusion dot com dot au ) enlightened me |
| 38 |
some time ago of the advantages of ordered args with rsync. |
| 39 |
Order of args is now preserved. This is a long overdue change. |
| 40 |
Rsync itself performs some things differently based on the order |
| 41 |
of some args, hopefully this is a big improvement in functionality |
| 42 |
and doesn't break anyone. Passing options as a hash ref is now |
| 43 |
deprecated. Thanks Gavin, sorry it took me so long to implement. |
| 44 |
|
| 45 |
Petya Kohts ( kohts at yandex-team dot ru ) suggested code |
| 46 |
for srchost that would properly handle the rsync:// prefix |
| 47 |
|
| 48 |
Neil Hooey ( nhooey at gmail dot com) provided a better |
| 49 |
algorithm for the status method. |
| 50 |
|
| 51 |
Erez Schatz ( moonbuzz at gmail dot com ) sent improved pod |
| 52 |
formatting that should work better with pod2html |
| 53 |
|
| 54 |
The module debug option has become moddebug so it does not conflict |
| 55 |
with the rsync debug option. |
| 56 |
|
| 57 |
infun can now be an array ref, contents are fed to stdin via IPC::Run3 |
| 58 |
|
| 59 |
files-from can also be an array ref, this is handled in the module |
| 60 |
by setting infun to the array ref and --files-from='-' |
| 61 |
|
| 62 |
Added several more tests. |
| 63 |
|
| 64 |
Fri Nov 7 08:45:42 CST 2014 ( leakin at dfw dot nostrum dot com ) |
| 65 |
|
| 66 |
* version 0.45: removed 'use File::Rsync::Config', oops |
| 67 |
|
| 68 |
Thu Nov 6 10:03:01 CST 2014 ( leakin at dfw dot nostrum dot com ) |
| 69 |
|
| 70 |
* version 0.44: long overdue fix for automated builds, removed |
| 71 |
prompt for rsync path to use PATH environment instead. |
| 72 |
|
| 73 |
Tue Aug 18 10:56:10 CDT 2009 ( leakin at dfw dot nostrum dot com ) |
| 74 |
|
| 75 |
* version 0.43: Gavin Carr ( gavin at openfusion dot com dot au ) |
| 76 |
sent a patch to make include-from and exclude-from allow multiple |
| 77 |
arguments. This oversight was a misunderstanding on my part as to |
| 78 |
how these actually work. Many thanks to Gavin for correcting my |
| 79 |
perception in the form of a very helpful patch. |
| 80 |
|
| 81 |
also added support for new options in 2.6.7 |
| 82 |
|
| 83 |
removed 1 second sleep based on Petya Kohts testing ( kohts at |
| 84 |
yandex-team dot ru ) as this is un-needed paranoia |
| 85 |
|
| 86 |
added test to check for rsync binary in configured location |
| 87 |
|
| 88 |
Fri Jun 24 21:11:04 CDT 2005 ( leakin at dfw dot nostrum dot com ) |
| 89 |
|
| 90 |
* version 0.42: added Scalar::Util as a required module since it was |
| 91 |
not part of core before perl 5.8 (sorry). Also changed build-name for |
| 92 |
the config file so it will not clobber perl's Config.pm for odd |
| 93 |
@INC orders. Thanks again to Simon Myers (Smylers at stripey dot com ) |
| 94 |
for pointing out the potential problem. |
| 95 |
|
| 96 |
Tue May 24 11:28:43 CDT 2005 ( leakin at dfw dot nostrum dot com ) |
| 97 |
|
| 98 |
* version 0.41: fixed 'use Scalar::Util' again (hopefully correct this |
| 99 |
time). Trying to do too many things at once, and need work on tests |
| 100 |
to catch my bonehead mistakes. Improved test.pl coming soon. |
| 101 |
|
| 102 |
Mon May 23 16:51:42 CDT 2005 ( leakin at dfw dot nostrum dot com ) |
| 103 |
|
| 104 |
* version 0.40: I missed one critical line in the patch from Smylers |
| 105 |
and broke more than I fixed. This update includes the 'use' statement. |
| 106 |
|
| 107 |
Sun May 22 17:13:16 CDT 2005 ( leakin at dfw dot nostrum dot com ) |
| 108 |
|
| 109 |
* version 0.39: Simon Myers ( Smylers at stripey dot com ) sent |
| 110 |
a patch to allow Path::Class objects as source paths. The previous |
| 111 |
error checking only allowed source to be a string or an array. |
| 112 |
This update bypasses the sanity-check if the source is a blessed |
| 113 |
object and now assumes the programmer knows what they are doing |
| 114 |
and that the object can be read as a string. |
| 115 |
|
| 116 |
Added support for the only-write-batch option in rsync-2.6.5-pre1 |
| 117 |
|
| 118 |
Wed Mar 30 22:06:04 CST 2005 ( leakin at dfw dot nostrum dot com ) |
| 119 |
|
| 120 |
* version 0.38: Harald Flaucher ( Harald dot Flaucher at |
| 121 |
mondial dot de ) requested support for the --acls option, which |
| 122 |
is not part of rsync, but an included patch that some use. His |
| 123 |
request inspired the idea for the 'literal' option in the module |
| 124 |
to allow passing arbitrary literal arguments to rsync so other |
| 125 |
patches or even newer versions of rsync can be used. Also added |
| 126 |
support for the protocol option that was previously undocumented. |
| 127 |
|
| 128 |
Sat Mar 5 19:59:01 CST 2005 ( leakin at dfw dot nostrum dot com ) |
| 129 |
|
| 130 |
* version 0.37: added support for new options in 2.6.4-pre1: |
| 131 |
del, delete-before, delete-during, delay-updates, dirs, filter, |
| 132 |
fuzzy, itemize-changes, list-only, omit-dir-times, remove-sent-files, |
| 133 |
and max-size. See the rsync manpage for full details on these options. |
| 134 |
|
| 135 |
Fixed a type-o that kept partial-dir from being handled properly. |
| 136 |
|
| 137 |
Bill Uhl ( buhl at web-services dot net ) provided a patch to |
| 138 |
split out the creation of the rsync command from the exec function. |
| 139 |
The new call (getcmd) returns a reference to an array of the command |
| 140 |
to be executed. Bill is working on a graphical interface to rsync |
| 141 |
using this module and wants an alternate exec wrapper. This version |
| 142 |
includes a variation on his patch. |
| 143 |
|
| 144 |
Tue Jan 18 17:05:00 CST 2005 ( leakin at dfw dot nostrum dot com ) |
| 145 |
|
| 146 |
* version 0.36: fix for "uninitialized value" warning submitted |
| 147 |
thru rt.cpan.org. Thanks go to the anonymous Debian user (HTH). |
| 148 |
|
| 149 |
Wed Dec 8 18:33:45 CST 2004 ( leakin at dfw dot nostrum dot com ) |
| 150 |
|
| 151 |
* version 0.35: test 4 was failing due to bad pattern match in the |
| 152 |
test code. no functional changes (error message changed for 2.6.3). |
| 153 |
|
| 154 |
Thu Aug 12 20:45:43 CDT 2004 ( leakin at dfw dot nostrum dot com ) |
| 155 |
|
| 156 |
* version 0.34: added support for new options in 2.6.3: partial-dir, |
| 157 |
checksum-seed, keep-dirlinks, inplace, ipv4, and ipv6. |
| 158 |
|
| 159 |
Tue Jun 1 12:59:36 CDT 2004 ( leakin at dfw dot nostrum dot com ) |
| 160 |
|
| 161 |
* version 0.33: Fixed a type-o in parsing of quote-dst tag. |
| 162 |
Peter teStrake (peter dot testrake at tradingscreen dot com) |
| 163 |
pointed out that the exec method did not protect itself from a |
| 164 |
user-defined SIGCHLD handler and could miss the exit of rsync and |
| 165 |
report a false error. A local reset of the handler should protect |
| 166 |
it and still leave the handler in place for the rest of the user |
| 167 |
code. |
| 168 |
|
| 169 |
Sun Dec 21 03:18:26 CST 2003 ( leakin at dfw dot nostrum dot com ) |
| 170 |
|
| 171 |
* version 0.32: Added support for new option in 2.6.0: --from0, |
| 172 |
--no-relative, --no-implied-dirs, and --files-from. A new |
| 173 |
infun option has been added so a user-supplied function can print the |
| 174 |
list to --files-from=-. See the rsync man page and the pod doc for |
| 175 |
more info. Also fixed a bug underscores were not recognized as the |
| 176 |
hyphen equivalent for quote_dst, quote_src and path_to_rsync. |
| 177 |
An anonymous user submitted a fix where parens were needed due to |
| 178 |
precedence problems when srchost is defined. The fix is included |
| 179 |
in this release. |
| 180 |
|
| 181 |
Tue Jul 29 22:13:50 CDT 2003 ( leakin at dfw dot nostrum dot com ) |
| 182 |
|
| 183 |
* version 0.31: Bill Uhl ( buhl at web-services dot net ) sent a |
| 184 |
patch to add the missing ignore-existing option and make write-batch |
| 185 |
a scalar option (both were oversights on my part). He also |
| 186 |
suggested quoting the source paths. Since this could break intended |
| 187 |
actions, There are now 2 options to do this if desired. The |
| 188 |
quote-src and quote-dst flags will add double-quotes around each |
| 189 |
path in the source or the destination when set. This should help |
| 190 |
avoid with pathnames containing spaces. James CE Johnson sent a |
| 191 |
patch to add the no-stdin flag since calling the module under |
| 192 |
mod_perl was having problems. Bill also reported problems on win32 |
| 193 |
and I found strange behavior myself during some tests, so I have |
| 194 |
backed-out the passing of stdin (from 0.27) entirely. |
| 195 |
|
| 196 |
Tue Jun 10 14:41:54 CDT 2003 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 197 |
|
| 198 |
* version 0.30: Paul Egan sent a patch that does a much better |
| 199 |
job of cleaning up the select loop. I was still not taking full |
| 200 |
advantage of the features of IO::Select or IO::Handle. Thanks |
| 201 |
go to Paul for a much simplified loop, and hopefully an end to |
| 202 |
the hangs (at least those due to the perl code). |
| 203 |
|
| 204 |
Mon Jun 9 17:39:42 CDT 2003 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 205 |
|
| 206 |
* version 0.29: Paul Egan had another suggestion I liked very much. |
| 207 |
I switched to using IO::Select rather than calling select directly. |
| 208 |
I've always hated the ugly vec code that must be added in order to use |
| 209 |
select. It clutters the program with lots of unrelated but essential |
| 210 |
cruft. The module keeps all that separate from what is going on in the |
| 211 |
rsync wrapper. Paul was still seeing a hang in certain cases, and |
| 212 |
Ronald J Kimball ( rjk at linguist dot thayer dot dartmouth dot edu ) |
| 213 |
was having similar problems. Both were seeing a hang on the eof tests, |
| 214 |
so I removed them (eof does not play well with sysread, but we need |
| 215 |
sysread to make sure we don't block). I have not been able to make it |
| 216 |
hang (at least not yet). |
| 217 |
|
| 218 |
Thu May 29 21:33:07 CDT 2003 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 219 |
|
| 220 |
* version 0.28: Paul Egan ( paulegan at mail dot com ) found one of the |
| 221 |
cases where the module could block, and provided a patch to fix it. The |
| 222 |
cost is a going thru select again after each block is read, but he was |
| 223 |
able to prove it stops the hang. Paul also suggested an improvement on |
| 224 |
the sysread. I am now using the block size of the file descriptor |
| 225 |
(defaulting back to 1024 if that fails for some reason). Many thanks to |
| 226 |
Paul for not only finding a way to reproduce the hang, but also finding |
| 227 |
a fix. |
| 228 |
|
| 229 |
Sat Feb 1 23:03:55 CST 2003 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 230 |
|
| 231 |
* version 0.27: got into too big a rush and forgot to test. |
| 232 |
The STDIN hack caused IPC::Open3 to spew, so I had to change |
| 233 |
it to glob to work properly. 0.26 was never released, but |
| 234 |
now I'm thinking seriously about breaking the link between |
| 235 |
the module version and RCS. I'll have to do this anyway |
| 236 |
if I move to Subversion for revision control, since it's versions |
| 237 |
are handled in a different manner. |
| 238 |
|
| 239 |
Mon Jan 13 11:25:42 CST 2003 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 240 |
|
| 241 |
* version 0.26: Added link-dest option (new in 2.5.6pre1). |
| 242 |
I previously closed stdin of the forked rsync command since rsync |
| 243 |
didn't really use it. Now the include-from and exclude-from options |
| 244 |
may be set to '-' and rsync will read the list from stdin. I've |
| 245 |
attempted to pass STDIN directly to rsync in case someone wants |
| 246 |
to use this option. In my simple tests the code works, but I have |
| 247 |
not done extensive tests, and do not know if you can pass other data |
| 248 |
such as passwords (not a good idea in terms of security). This |
| 249 |
may also have other side effects since STDIN could be a tty in some |
| 250 |
instances and not in others (may cause the underlying rsh, ssh, or |
| 251 |
other transport to behave differently during testing versus cron or |
| 252 |
other unattended execution). If this becomes a problem for anyone |
| 253 |
I'll figure out some way to make it optional. |
| 254 |
|
| 255 |
Tue Jan 7 13:46:56 CST 2003 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 256 |
|
| 257 |
* version 0.25: Tong Zhu ( tongzhu at thereinc dot com ) found an error |
| 258 |
where use of errfun and/or outfun exposed possible use of uninitialized |
| 259 |
variables (those used to break output into individual lines). Thanks |
| 260 |
for pointing out my error, and the useful 'diff' output making my coding |
| 261 |
error easy to track down and fix. |
| 262 |
|
| 263 |
Wed Dec 11 17:57:25 CST 2002 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 264 |
|
| 265 |
* version 0.24: Heiko Jansen ( heiko_jansen at web dot de ) found an |
| 266 |
error in the exec function where I was accessing the errfun and outfun |
| 267 |
functions from the main object, and ignoring them if they were passed to |
| 268 |
'exec'. Thanks for pointing out the error, hopefully this will work |
| 269 |
much better for you know. |
| 270 |
|
| 271 |
Wed Dec 4 22:38:14 CST 2002 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 272 |
|
| 273 |
* version 0.23: I got 3 separate reports of hangs, but cannot reproduce |
| 274 |
the error (yet). Added a trap and more eof tests to hopefully catch |
| 275 |
and exit properly. |
| 276 |
|
| 277 |
Thu Mar 14 23:19:35 CST 2002 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 278 |
|
| 279 |
* version 0.22: added options for rsync 2.5.4, no-blocking-io, no-detach, |
| 280 |
and no-whole-file. |
| 281 |
|
| 282 |
Thu Dec 20 13:52:33 CST 2001 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 283 |
|
| 284 |
* version 0.21: added rsync+ options from 2.4.7pre4/2.5.0, read-batch |
| 285 |
and write-batch. |
| 286 |
|
| 287 |
Thanks to Jonathan Pelletier ( jonathan dot pelletier at matrox dot com |
| 288 |
) for catching (and supply a fix for) an output message loss. This |
| 289 |
version contains a variation on his patch. Jonathan also suggested the |
| 290 |
new method 'lastcmd' to return the last 'rsync' command passed to the |
| 291 |
system for debugging and error messages. |
| 292 |
|
| 293 |
Fri Sep 7 15:18:58 CDT 2001 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 294 |
|
| 295 |
* version 0.20: made changes to test.pl so failed tests would |
| 296 |
return non-zero exit and actually fail the tests. Also corrected |
| 297 |
several type-os in the POD documentation (thanks to Joe Smith |
| 298 |
( Joe dot Smith at wcom dot com ) for pointing them out). |
| 299 |
|
| 300 |
Wed May 16 21:11:31 CDT 2001 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 301 |
|
| 302 |
* version 0.19: discovered the new makefile was installing |
| 303 |
into the wrong path. It should follow the proper naming convention |
| 304 |
now. |
| 305 |
|
| 306 |
Thu May 10 22:28:28 CDT 2001 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 307 |
|
| 308 |
* version 0.18: Many thanks to Andreas Koenig ( andreas dot koenig at |
| 309 |
dubravka dot kbx dot de ) for setting me straight on the architecture |
| 310 |
specific versus the arch-independent directory usage, and for explaining |
| 311 |
why this wasn't showing up in the by-module listings. The tar file now |
| 312 |
has a recognizable .pm file in it for proper CPAN distribution. There |
| 313 |
is also a File::Rsync::Config.pm in the arch-specific dir where the |
| 314 |
build process stores the path to the rsync executable. |
| 315 |
|
| 316 |
Mon May 7 01:07:44 CDT 2001 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 317 |
|
| 318 |
* version 0.17: I decided it is better for the out and err methods |
| 319 |
to return any collected output regardless of whether or not an output |
| 320 |
function has been defined. This way you can process each line yourself |
| 321 |
and still print the entire output in bulk if desired. This also |
| 322 |
keeps me from having to work out what these methods should return |
| 323 |
if called when an output function has been defined. |
| 324 |
|
| 325 |
Thu Feb 15 21:25:23 CST 2001 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 326 |
|
| 327 |
* version 0.16: James Mello ( kingjamm at colltech dot com ) submitted a |
| 328 |
patch to add a 'list' function, and educated me on the interesting |
| 329 |
aspect of calling rsync without a destination in order to obtain an 'ls |
| 330 |
-l' or 'ls -lr' (with -r or -a) style output. Rather than duplicating |
| 331 |
the exec function I made modifications to it and built a wrapper to get |
| 332 |
the list functionality. This has all kinds of possibilities. Many |
| 333 |
thanks to James for the great idea and the education on an option I had |
| 334 |
never explored. |
| 335 |
|
| 336 |
use File::Rsync;$rs=File::Rsync->new(srchost => 'localhost:'); |
| 337 |
print $rs->list; will list available modules on the local daemon. |
| 338 |
|
| 339 |
Tue Nov 28 10:22:50 CST 2000 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 340 |
|
| 341 |
* version 0.15: After more thought and discussion with Boris we decided |
| 342 |
a second arg of either 'out' or 'err' should be passed to the functions |
| 343 |
so a single user-defined function could be used and it will be able to |
| 344 |
determine the source of the text in arg 1. Simple functions can ignore |
| 345 |
the second arg. The examples below would need to change to 'outfun => |
| 346 |
sub {print shift}' and 'errfun => sub {print shift}' to keep from |
| 347 |
printing the source string. (version 0.14 was not released to CPAN) |
| 348 |
|
| 349 |
Fri Nov 17 23:03:00 CST 2000 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 350 |
|
| 351 |
* version 0.14: Per suggestion from Boris Goldowsky ( boris at range dot |
| 352 |
infoplease dot com ), added 'outfun' and 'errfun' options. If you |
| 353 |
supply a function (CODE) reference to these the stderr and stdout from |
| 354 |
rsync is passed to these functions one output line at a time and is not |
| 355 |
collected internally for post examination. Providing a function like |
| 356 |
'outfun => sub {print @_}' will cause each line to be printed as they |
| 357 |
arrive. A function like 'outfun => sub {print "."}' will simply shows |
| 358 |
progress dots like cpio's -V option. Thanks to Boris for the |
| 359 |
suggestion. Sorry it took me so long to get it added. |
| 360 |
|
| 361 |
Sat Sep 16 23:32:59 CDT 2000 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 362 |
|
| 363 |
* version 0.13: added suport for new flags blocking-io and ignore-errors, |
| 364 |
as well as scalars bwlimit, max-delete, and modify-window. I also |
| 365 |
rearranged the options hashes into a vertical sort similar to 'ls'. |
| 366 |
This makes additions a bit more difficult, but makes reading and |
| 367 |
verifying the options much easier (at least for me). |
| 368 |
|
| 369 |
Tue Feb 29 17:41:14 CST 2000 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 370 |
|
| 371 |
* version 0.12: pervious version fixed blocking, but was not clean |
| 372 |
and caused the tests to fail in odd ways. This should be better. |
| 373 |
|
| 374 |
* also added code to treat underscore the same as hyphen in option keys |
| 375 |
similar to Tk. This allows the use of bareword keys in hashes without |
| 376 |
being mis-interpreted as subtraction. |
| 377 |
|
| 378 |
Fri Feb 18 17:45:13 CST 2000 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 379 |
|
| 380 |
* version 0.11: fixed a blocking problem in the exec function |
| 381 |
If one of the output pipes filled up it hung forever (oops). |
| 382 |
|
| 383 |
Mon Feb 7 14:05:37 CST 2000 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 384 |
|
| 385 |
* version 0.10: removed comments about rsync not considering some things |
| 386 |
to be errors. This appears to be a bug in 2.3.2 on Linux. It has been |
| 387 |
submitted to the rsync team. On Solaris rsync properly returns a non-zero |
| 388 |
exit status if the source path does not exist. The bug was fixed in the |
| 389 |
CVS tree, and in the release 2.4.1. |
| 390 |
|
| 391 |
* added support for --backup-dir and --existing options (new in 2.4.1) |
| 392 |
|
| 393 |
* Since I've not heard from anyone about keeping the command-line style |
| 394 |
options, I've dropped them. The hash-style affords more flexibility |
| 395 |
anyway. I also removed some duplicate code in parseopts since I can now |
| 396 |
treat all args as a hash. |
| 397 |
|
| 398 |
* After some discussion on the rsync mailing list I was told about a |
| 399 |
method of passing multiple source arguments for a remote server. I've |
| 400 |
added a new hash key 'srchost' to be used in combination with the 'source' |
| 401 |
array to make it easier to use this capability. If the source host is |
| 402 |
remote, and you have multiple source paths, you can put the source |
| 403 |
hostname in 'srchost', and the paths in the 'source' array. The module |
| 404 |
will assemble them as a single argument to rsync. If 'srchost' is null |
| 405 |
then the 'source' array is passed to exec as separate arguments. |
| 406 |
|
| 407 |
Wed Dec 1 21:55:44 CST 1999 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 408 |
|
| 409 |
* version 0.09: removed bareword keys in hashes (5.00404 doesn't like |
| 410 |
my use of 'scalar' as a key) |
| 411 |
|
| 412 |
* version 0.08: changed test 5 in test.pl to account for different |
| 413 |
return status between Solaris and Linux. I'll need to look into why |
| 414 |
one detects the error and the other doesn't (rsync itself, not perl). |
| 415 |
|
| 416 |
Tue Nov 30 20:46:00 CST 1999 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 417 |
|
| 418 |
* version 0.07: |
| 419 |
|
| 420 |
* removed global $pkgname, now uses 'my $pkgname=ref $self' instead. |
| 421 |
I also had to bless $self earlier in 'new' so defopts, and parseopts can |
| 422 |
use 'ref $self' to determine the package name. It was not too bright |
| 423 |
to hardcode the package name (vacations can have odd effects on the brain) |
| 424 |
|
| 425 |
* changed saveopts and parseopts to begin with underscore since they |
| 426 |
are for internal use only. |
| 427 |
|
| 428 |
Sun Nov 28 19:41:31 CST 1999 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 429 |
|
| 430 |
* version 0.06: |
| 431 |
|
| 432 |
* added $pkgname for 'carp' messages to make it clearer where they came |
| 433 |
from. |
| 434 |
|
| 435 |
* added missing check for 'include' in exec method |
| 436 |
|
| 437 |
* other misc cleanup and clarification of code and documentation |
| 438 |
|
| 439 |
Sun Nov 28 02:47:34 CST 1999 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 440 |
|
| 441 |
* version 0.05: major re-organization and re-writing of internal |
| 442 |
functions to add the ability to pass a hash reference for perl-style |
| 443 |
options handling. (Thanks to Greg Ward for the suggestion) This gives |
| 444 |
increased flexibility including the ability to turn off boolean flags, |
| 445 |
and to build your own include or exclude list as an array and pass a |
| 446 |
reference to the array to the module. The same can be done for source |
| 447 |
paths. |
| 448 |
|
| 449 |
* removed leading double-dashes from the option keys. It is easier to |
| 450 |
add them in the parser for command-line style than to remove them for |
| 451 |
perl-style hashes. |
| 452 |
|
| 453 |
* changed 'err' and 'out' methods to return an empty string or an empty |
| 454 |
list if no output was generated. If there was output they return it as |
| 455 |
an array or a reference to an array as before. This should make testing |
| 456 |
for the existence of output more efficient. Before you had to call them |
| 457 |
in a scalar context and dereference the return in order to check. Now |
| 458 |
you can use a simple truth test. Also added a note about conditions |
| 459 |
where rsync itself can return a true (0) exit but the programmer may |
| 460 |
consider it an error. In these situations you need to check stderr for |
| 461 |
error messages (such as 'no such file or directory'). See 'exec' method |
| 462 |
in the manpage. |
| 463 |
|
| 464 |
* removed newlines from carp messages so the 'at <prog> line ##' is on |
| 465 |
the same line as the rest of the error message (bad habit from die). |
| 466 |
|
| 467 |
* changed all return values except 'new' to zero instead of undef so |
| 468 |
-w won't complain about use of un-initialized values. If anyone has |
| 469 |
a good reason to put this back (like good/standard coding practices) let |
| 470 |
me know. |
| 471 |
|
| 472 |
* added test.pl script for 'make test'. |
| 473 |
|
| 474 |
Sun Nov 21 02:18:56 CST 1999 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 475 |
|
| 476 |
* version 0.04: added missing 'next' that would cause a parsing |
| 477 |
error if -P was used. |
| 478 |
|
| 479 |
* Renamed module to File::Rsync (Thanks to Tim Bunce for the suggestion) |
| 480 |
It really fits better here than in Net::, but once I thought of it |
| 481 |
as a network-based program I had a mental block when considering other |
| 482 |
groups. |
| 483 |
|
| 484 |
Fri Nov 19 13:25:18 CST 1999 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 485 |
|
| 486 |
* version 0.03: --address should be a scalar, not a flag (the |
| 487 |
rsync man page is unclear on this). |
| 488 |
|
| 489 |
Wed Nov 17 21:20:16 CST 1999 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 490 |
|
| 491 |
* version 0.02: |
| 492 |
|
| 493 |
* wrote first draft of Makefile.PL and makepm.PL to wrap it all up |
| 494 |
as a real perl module. |
| 495 |
|
| 496 |
* added new options for rsync 2.3.2 (-P, --delete-after, and |
| 497 |
--address) |
| 498 |
-P is short for --partial and --progress. --address is only |
| 499 |
used in server mode. I don't know what good these are inside |
| 500 |
this module, but you should still be able to pass them if you |
| 501 |
want. |
| 502 |
--delete-after allows the user to delay any --delete actions |
| 503 |
until after all other files are synced. The default is to |
| 504 |
perform any deletes before in order help insure sufficient disk |
| 505 |
space is available. See the rsync (1) man page for more |
| 506 |
details. |
| 507 |
|
| 508 |
* remove any chance of clobbering $_ (mostly paranoia I hope) |
| 509 |
|
| 510 |
Tue Jun 15 15:27:20 CDT 1999 Lee Eakin ( leakin at dfw dot nostrum dot com ) |
| 511 |
|
| 512 |
* version 0.01: (initial) based on rsync 2.3.1 |