NAME
rsync-retry - Rsync wrapper to retry on transfer errors
VERSION
This document describes version 0.007 of rsync-retry (from Perl distribution App-rsync-retry), released on 2020-07-10.
SYNOPSIS
Use like you would use rsync:
% rsync-retry -Pavz [other options...] <source> <target>DESCRIPTION
This wrapper runs rsync then checks its exit code. If exit code indicates transfer errors (e.g. I/O error, socket error, partial transfers, timeout) it will re-run the rsync. The number of retries to perform is set by the "--retry-times" option, while the number of seconds to wait before each retry is set by the "--retry-delay" option.
OPTIONS
--help
Shortcuts: -h, -?.
--version
--retry-times=i
Default: -1 (unlimited).
--retry-delay=i
In seconds. Default: 30.
--retry-on=s
Specify comma-separated list of exit codes to trigger retry. Default: 10,11,12,22,23,24,30,35.
--retry-on-all
Specify that rsync-retry should retry on all non-zero exit codes.
ENVIRONMENT
RSYNC_RETRY_RSYNC_CMD
String. Rsync command to use. Defaults to rsynccolor (if available) or rsync otherwise. Can be used to chain several wrappers together.
RSYNC_RETRY_ON
String. Used to set default for --retry-on.
RSYNC_RETRY_ON_ALL
Bool. Used to set default for --retry-on-all.
HOMEPAGE
Please visit the project's homepage at https://metacpan.org/release/App-rsync-retry.
SOURCE
Source repository is at https://github.com/perlancar/perl-App-rsync-retry.
BUGS
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=App-rsync-retry
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
SEE ALSO
rsync.
Some other wrappers for rsync: rsync-new2old, rsynccolor.
AUTHOR
perlancar <perlancar@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2020, 2019 by perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.