A simply retry tool in plain POSIX sh.
Simply call
retry $cmd
to execute $cmd and on failure retry multiple times with some waiting time
between calls. Multiple command line parameters exist to tweak execution.
It is possible to specify no waiting time if desired:
retry -s 0 $cmd
If it is necessary to specify command line parameters to $cmd separate the
arguments with -- like this:
retry -- $cmd --my-argument -X 3
Often it is desired to command the execution with a timeout. This can be done
with the timeout command from GNU
coreutils already present on many
systems. Either use with a global timeout:
timeout 10 retry $cmd
to execute $cmd with retrying but only wait up to 10s in total. Or with a
timeout per execution:
retry -- timeout 10 $cmd
Another tool provided is "count-fail-ratio" which can count fails, the fail ratio, the failure probability and timing information from repeated command calls. Simply call
count-fail-ratio $cmd
to execute $cmd automatically multiple times collecting the mentioned
statistics.
Further options to count-fail-ratio can be specified by runtime variables. For example to change the number of runs from the default of 20 set the variable "runs" while disabling computing timing information:
runs=100 timing=0 count-fail-ratio $cmd
For the complete list of variables take a look into the script file count-fail-ratio itself.
This project lives in https://github.com/okurz/retry
Feel free to add issues in github or send pull requests.
- For git commit messages use the rules stated on How to Write a Git Commit Message as a reference
If this is too much hassle for you feel free to provide incomplete pull requests for consideration or create an issue with a code change proposal.
This is done with the Test::More bash library. It will be automatically cloned.
To execute tests call
make test
make checkstyle
- https://github.com/minfrin/retry - an older C implementation which is also available in Debian and Ubuntu.
This project is licensed under the MIT license, see LICENSE file for details.