retry.md (1108B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Long: retry 5 Arg: <num> 6 Added: 7.12.3 7 Help: Retry request if transient problems occur 8 Category: curl 9 Multi: single 10 See-also: 11 - retry-max-time 12 Example: 13 - --retry 7 $URL 14 --- 15 16 # `--retry` 17 18 If a transient error is returned when curl tries to perform a transfer, it 19 retries this number of times before giving up. Setting the number to 0 20 makes curl do no retries (which is the default). Transient error means either: 21 a timeout, an FTP 4xx response code or an HTTP 408, 429, 500, 502, 503 or 504 22 response code. 23 24 When curl is about to retry a transfer, it first waits one second and then for 25 all forthcoming retries it doubles the waiting time until it reaches 10 26 minutes, which then remains the set fixed delay time between the rest of the 27 retries. By using --retry-delay you disable this exponential backoff algorithm. 28 See also --retry-max-time to limit the total time allowed for retries. 29 30 curl complies with the Retry-After: response header if one was present to know 31 when to issue the next retry (added in 7.66.0).