# ====================[ .curlrc                            ]====================
# cURL configuration, optimized for failure-tolerant file download over FTP,
# HTTP, SCP, and like protocols. Such downloads will automatically resume and
# retry as needed.
#
# --------------------( EXAMPLES                           )--------------------
# Fetch a 100MB archive file over HTTP:
#   curl "http://dlsvr04.asus.com/pub/ASUS/lan/P5GD1-VM_LAN.zip"

# ....................{ INTERFACE                          }....................
# Show cURL, FTP, and HTTP error messages on failure.
show-error

# Show cURL transfer progress as a "progress bar" rather than numerical numbers.
#progress-bar

# ....................{ CONNECTION                         }....................
# Request compressed HTTP responses, which cURL then automatically uncompresses. 
compressed

# Timeout connection attempts longer than this many seconds.
connect-timeout = 32

# Prevent connections from dying by sending so-called "keepalive" probes every
# this many seconds.
keepalive-time = 64

# Follow redirected, relocated, or otherwise moved pages by reposting the prior
# request to the new page location.
location

# Follow redirections at most this many times.
max-redirs = 8

# Send this "Referer-Page" HTTP header string. When ";auto", cURL automatically
# substitutes this for the most recent URL cURL accessed.
referer = ";auto"

# Send this "User-Agent" HTTP header string.
user-agent = "Mozilla/4.0"

# ....................{ CONNECTION =ftp                    }....................
# Connect to FTP servers passively, rather than actively.
ftp-pasv

# ....................{ AUTHENTICATION                     }....................
# Authenticate SSH connections via this public key file.
pubkey = ~/.ssh/id_rsa.pub

# ....................{ COOKIES                            }....................
# cURL supplies a site-specific "cookie-jar" option for persisting all cookies
# for that site in some on-disk file. Sadly, cURL does not supply some cookie
# jar of "cookie-jar" options, for automatically persisting all cookies for all
# sites in some collection of on-disk files. For the moment, therefore, we
# resist specifying any specific "cookie-jar" options in this config file.

# ....................{ TRANSFERS                          }....................
# Automatically resume partially downloaded and uploaded files.
continue-at = -

# Automatically create local directories as needed, when downloading.
create-dirs

# Limit cURL-consumed bandwidth to this many bytes per second, where a suffix of
# 'k' or 'K' is kilobytes, 'm' or 'M' is megabytes, and 'g' or 'g' is gigabytes. 
limit-rate = 8K

# Name downloaded files according to their remote filename.
remote-name-all

# Timestamp downloaded files according to their remote file's timestamp.
remote-time

# Retry failed transfers at most this many times.
retry = 8

# ....................{ TRANSFERS =ftp                     }....................
# Automatically create remote FTP directories as needed, when uploading.
ftp-create-dirs

# Access remote FTP paths in a (somewhat) more standards compliant way than
# with the 'nocwd' option but without the full penalty of the 'multicwd' option.
ftp-method = singlecwd

# Attempt to encrypt both FTP login and connection; if this fails, fall back to
# plaintext FTP login and connection.
ftp-ssl

# Enable FTP Clear Command Channel (CCC), if available. This disables SSL/TLS
# encryption for the connection following the initially encrypted login.
ftp-ssl-ccc