OLD | NEW |
(Empty) | |
| 1 git-retry(1) |
| 2 ============= |
| 3 |
| 4 NAME |
| 5 ---- |
| 6 git-retry - |
| 7 include::_git-retry_desc.helper.txt[] |
| 8 |
| 9 SYNOPSIS |
| 10 -------- |
| 11 [verse] |
| 12 'git retry' [-v] [-c COUNT] [-d DELAY] [-e] -- _<git_subcommand>_ |
| 13 |
| 14 DESCRIPTION |
| 15 ----------- |
| 16 |
| 17 `git retry` is a bootstrap that wraps a standard `git` command execution in |
| 18 a fault-tolerant retry wrapper. |
| 19 |
| 20 If a retry succeeds, the return code of the successful attempt is returned. |
| 21 Otherwise, the return code of the last failed attempt is returned. |
| 22 |
| 23 The wrapper is aware of `git`-specific failure conditions and will only consider |
| 24 retrying if a given failure can be linked to such a condition. |
| 25 |
| 26 |
| 27 OPTIONS |
| 28 ------- |
| 29 |
| 30 <git_subcommand>:: |
| 31 The `git` command to retry. This should omit the actual `git` command (e.g., |
| 32 to retry `git clone`, use `git retry clone`). |
| 33 |
| 34 -v, --verbose:: |
| 35 Increases logging verbosity. By default, no additional logging is generated |
| 36 by the `git retry` command. This can be specified multiple times. |
| 37 |
| 38 -c, --retry-count _count_:: |
| 39 Specify the number of retries that should be performed before giving up. The |
| 40 default retry count is *5*. |
| 41 |
| 42 -d, --delay _seconds_:: |
| 43 Floating-point value that specifies the amount of time (in seconds) to wait |
| 44 after a failure. This can be zero to specify no delay. The default delay is |
| 45 *3 seconds*. |
| 46 |
| 47 -D, --delay-factor:: |
| 48 The exponential factor to apply to the delay. By default this is *2*. |
| 49 For a given retry round *n*, the delay for that round will be |
| 50 *(<delay-factor>^(n-1) * delay)*. If no delay is specified, this will have |
| 51 no effect. |
| 52 If the delay factor is *0*, the delay will increase linearly (for a given |
| 53 retry round *n*, the delay will be *(n * delay)*). |
| 54 |
| 55 (Note that a delay factor of *1* will result in a constant delay.) |
| 56 |
| 57 |
| 58 EXIT STATUS |
| 59 ----------- |
| 60 |
| 61 Upon success, `git retry` will exit with the successful exit code of *0*. On |
| 62 failure, it will exit with the exit code of the last failed attempt. |
| 63 |
| 64 |
| 65 include::_footer.txt[] |
| 66 |
| 67 // vim: ft=asciidoc: |
OLD | NEW |