Debian Codegraph @

Changelog

raw
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