.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.6.
.TH RETRY "1" "January 2020" "retry 1.0.1" "User Commands"
.SH NAME
retry \- Repeat command until a criteria is met, usually success.
.SH SYNOPSIS
.B retry
[\fI\,-v\/\fR] [\fI\,-h\/\fR] [\fI\,-u until\/\fR] [\fI\,-w while\/\fR] \fI\,command \/\fR...
.SH DESCRIPTION
The tool repeats the given command until the command is successful,backing off with a configurable delay between each attempt.
.PP
Retry captures stdin into memory as the data is passed to the repeated
command, and this captured stdin is then replayed should the command
be repeated. This makes it possible to embed the retry tool into shell
pipelines.
.PP
Retry captures stdout into memory, and if the command was successful
stdout is passed on to stdout as normal, while if the command was
repeated stdout is passed to stderr instead. This ensures that output
is passed to stdout once and once only.
.TP
\fB\-d\fR seconds, \fB\-\-delay\fR=\fI\,seconds\/\fR
The number of seconds to back off
after each attempt.
.TP
\fB\-m\fR message, \fB\-\-message\fR=\fI\,message\/\fR A message to include in the notification
when repeat has backed off. Defaults to the
command name.
.TP
\fB\-t\fR times, \fB\-\-times\fR=\fI\,times\/\fR
The number of times to retry
the command. By default we try forever.
.TP
\fB\-u\fR criteria, \fB\-\-until\fR=\fI\,criteria\/\fR Keep repeating the command until any one
of the comma separated criteria is met.
Options include 'success', 'true', 'fail',
\&'false', an integer or a range of integers.
Default is 'success'.
.TP
\fB\-w\fR criteria, \fB\-\-while\fR=\fI\,criteria\/\fR Keep repeating the command while any one
of the comma separated criteria is met.
Options include 'success', 'true', 'fail',
\&'false', an integer or a range of integers.
.TP
\fB\-h\fR, \fB\-\-help\fR
Display this help message.
.TP
\fB\-v\fR, \fB\-\-version\fR
Display the version number.
.SH "SEE ALSO"
The full documentation for
.B retry
is maintained as a Texinfo manual.  If the
.B info
and
.B retry
programs are properly installed at your site, the command
.IP
.B info retry
.PP
should give you access to the complete manual.