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-retry-on-all.

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.