curl(1)                          Curl Manual                          curl(1)

NAME
       curl - transfer a URL

SYNOPSIS
       curl [options / URLs]

DESCRIPTION
       curl is a tool for transferring data from or to a server using URLs. It
       supports these protocols: DICT, FILE, FTP, FTPS, GOPHER, HTTP, HTTPS,
       IMAP and many more.

       curl offers a busload of useful tricks like proxy support, user
       authentication, FTP upload, HTTP post, SSL connections, cookies, file
       transfer resume and more.

OPTIONS
       Options start with one or two dashes. Many of the options require an
       additional value next to them.

       -d, --data <data>
              (HTTP MQTT) Sends the specified data in a POST request to the
              HTTP server, in the same way that a browser does when a user has
              filled in an HTML form and presses the submit button. This will
              cause curl to pass the data to the server using the content-type
              application/x-www-form-urlencoded.

              If any of these options is used more than once on the same
              command line, the data pieces specified will be merged with a
              separating &-symbol.

       -f, --fail
              (HTTP) Fail fast with no output at all on server errors. This is
              useful to enable scripts to better deal with failed attempts.

       -o, --output <file>
              Write output to <file> instead of stdout. If you are using {} or
              [] to fetch multiple documents, you should quote the URL.

       --retry <num>
              If a transient error is returned when curl tries to perform a
              transfer, it retries this number of times before giving up.
              Setting the number to 0 makes curl do no retries. Default is 0.

       -s, --silent
              Silent or quiet mode. Do not show progress meter or error
              messages. Makes curl mute. It still outputs the data you ask
              for, potentially even to the terminal/stdout unless you redirect
              it.

       -v, --verbose
              Makes curl verbose during the operation. Useful for debugging
              and seeing what's going on under the hood. Consider using -sS to
              turn off progress meter but keep error messages.

EXAMPLES
       Get the main page from a web server:

              curl https://www.example.com/

SEE ALSO
       ftp(1), wget(1), scp(1)

AUTHORS
       Daniel Stenberg and many contributors.
