retry(1)                    General Commands Manual                   retry(1)




<?><?><?> (NAME)
       retry - <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       retry [-v] [-h] [-u until] [-w while] command ...


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?> <?><?><?><?><?> command <?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> (until) <?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?>.

       <?><?><?><?><?> retry <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> command <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (stdin) <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> command<?> <?><?><?> stdin
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> retry <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> (pipelines) <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?><?> retry <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       (stdout) <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> command
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> stdout <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       (while) <?><?> <?><?><?><?> <?><?><?><?><?> command<?> <?><?><?><?><?>
       stdout <?><?> <?><?><?> <?><?> <?><?> stderr <?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?> <?><?><?>
       <?><?><?><?><?><?> <?><?> stdout <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -d seconds, --delay=seconds
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?> <?><?> <?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?>.

       -j seconds, --jitter=seconds
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> (<?><?>
              <?><?><?><?><?>) <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?>. <?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>.

       -m message, --message=message
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> command <?><?><?>.

       -t times, --times=times
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> command. <?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       -u criteria, --until=criteria
              <?><?><?><?><?> command <?><?> <?><?><?><?><?> <?><?> (until)
              <?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?> <?><?><?>.
              <?><?><?><?><?><?><?><?> <?><?><?><?> 'success'<?> 'true'<?>
              'fail'<?> 'false'<?> <?><?> <?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?>. <?><?><?><?><?><?><?> 'success' <?><?><?>.

       -w criteria, --while=criteria
              <?><?><?><?><?> command <?><?><?><?><?><?> <?><?> (while) <?><?>
              <?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.
              <?><?><?><?><?><?><?><?> <?><?><?><?> 'success'<?> 'true'<?>
              'fail'<?> 'false'<?> <?><?> <?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?>.

       -h, --help
              <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       -v, --version
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       <?><?><?><?><?> retry <?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       command <?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?> command <?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>.

       <?><?><?> command <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> command <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

               ~$ retry --until=success -- false
               retry: 'false' returned 1, backing off for 10 seconds and trying again...
               retry: 'false' returned 1, backing off for 10 seconds and trying again...
               retry: 'false' returned 1, backing off for 10 seconds and trying again...

   ^C
       <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> curl <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?> (until)<?> <?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> stdout <?><?><?><?> <?> <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

               ~$ retry -- curl --fail http://localhost/entities | \
               jq ... | \
               retry -- curl --fail -X POST http://localhost/resource | \
               logger -t resource-init

       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> (until)<?> <?> <?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

               ~$ retry --until=success --delay "1,2,4,8,16,32,64" -- false
               retry: false returned 1, backing off for 1 second and trying again...
               retry: false returned 1, backing off for 2 seconds and trying again...
               retry: false returned 1, backing off for 4 seconds and trying again...
               retry: false returned 1, backing off for 8 seconds and trying again...
               retry: false returned 1, backing off for 16 seconds and trying again...
               retry: false returned 1, backing off for 32 seconds and trying again...
               retry: false returned 1, backing off for 64 seconds and trying again...
               retry: false returned 1, backing off for 64 seconds and trying again...
               retry: false returned 1, backing off for 64 seconds and trying again...

   ^C
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

               ~$ retry --times=3 -- false
               retry: false returned 1, backing off for 10 seconds and trying again...
               retry: false returned 1, backing off for 10 seconds and trying again...
               retry: false returned 1, giving up.


<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Graham Leggett <minfrin@sharp.fm>

                                  retry-1.0.6                         retry(1)