Commit 8a66584d authored by Daniel Stenberg's avatar Daniel Stenberg
Browse files

documented the current --retry options

parent 186f433e
Loading
Loading
Loading
Loading
+26 −1
Original line number Original line Diff line number Diff line
@@ -21,7 +21,7 @@
.\" * $Id$
.\" * $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
.SH NAME
curl \- transfer a URL
curl \- transfer a URL
.SH SYNOPSIS
.SH SYNOPSIS
@@ -723,6 +723,31 @@ remote file, and if that is available make the local file get that same
timestamp.
timestamp.


If this option is used twice, the second time disables this again.
If this option is used twice, the second time disables this again.
.IP "--retry <num>"
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 <seconds>"
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"
.IP "-s/--silent"
Silent mode. Don't show progress meter or error messages.  Makes
Silent mode. Don't show progress meter or error messages.  Makes
Curl mute.
Curl mute.