diff --git a/docs/curl.1 b/docs/curl.1 index 6daef25c3..7392a44c3 100644 --- a/docs/curl.1 +++ b/docs/curl.1 @@ -21,7 +21,7 @@ .\" * $Id$ .\" ************************************************************************** .\" -.TH curl 1 "19 Oct 2004" "Curl 7.12.3" "Curl Manual" +.TH curl 1 "2 Nov 2004" "Curl 7.12.3" "Curl Manual" .SH NAME curl \- transfer a URL .SH SYNOPSIS @@ -723,6 +723,31 @@ remote file, and if that is available make the local file get that same timestamp. If this option is used twice, the second time disables this again. +.IP "--retry " +If a transient error is returned when curl tries to perform a transfer, it +will retry this number of times before giving up. Setting the number to 0 +makes curl do no retries (which is the default). + +Transient error means either: timeout, an FTP 5xx response code or a HTTP 5xx +response code. + +When curl is about to retry a transfer, it will first wait one second and then +for all forthcoming retries it will double the waiting time until it reaches +10 minutes which then will be the delay between the rest of the retries. + +By using \fI--retry-delay\fP you disable this exponential backoff algorithm. +(Option added in 7.12.3) + +If this option is used multiple times, the last occurance decide the amount. +.IP "--retry-delay " +Make curl sleep this amount of time between each retry when a transfer has +failed with a transient error (it changes the default backoff time algorithm +between retries). This option is only interestinf if \fI--retry\fP is also +used. (Option added in 7.12.3) + +Setting the delay to zero will make curl use the default backoff time. + +If this option is used multiple times, the last occurance decide the amount. .IP "-s/--silent" Silent mode. Don't show progress meter or error messages. Makes Curl mute.