4 Help: Use output FORMAT after completion
6 Make curl display information on stdout after a completed transfer. The format
7 is a string that may contain plain text mixed with any number of
8 variables. The format can be specified as a literal "string", or you can have
9 curl read the format from a file with "@filename" and to tell curl to read the
10 format from stdin you write "@-".
12 The variables present in the output format will be substituted by the value or
13 text that curl thinks fit, as described below. All variables are specified as
14 %{variable_name} and to output a normal % you just write them as %%. You can
15 output a newline by using \\n, a carriage return with \\r and a tab space with
19 The %-symbol is a special symbol in the win32-environment, where all
20 occurrences of % must be doubled when using this option.
22 The variables available are:
26 The Content-Type of the requested document, if there was any.
29 The ultimate filename that curl writes out to. This is only meaningful if curl
30 is told to write to a file with the --remote-name or --output
31 option. It's most useful in combination with the --remote-header-name
32 option. (Added in 7.26.0)
35 The initial path curl ended up in when logging on to the remote FTP
36 server. (Added in 7.15.4)
39 The numerical response code that was found in the last retrieved HTTP(S) or
40 FTP(s) transfer. In 7.18.2 the alias \fBresponse_code\fP was added to show the
44 The numerical code that was found in the last response (from a proxy) to a
45 curl CONNECT request. (Added in 7.12.4)
48 The http version that was effectively used. (Added in 7.50.0)
51 The IP address of the local end of the most recently done connection - can be
52 either IPv4 or IPv6 (Added in 7.29.0)
55 The local port number of the most recently done connection (Added in 7.29.0)
58 Number of new connects made in the recent transfer. (Added in 7.12.3)
61 Number of redirects that were followed in the request. (Added in 7.12.3)
63 .B proxy_ssl_verify_result
64 The result of the HTTPS proxy's SSL peer certificate verification that was
65 requested. 0 means the verification was successful. (Added in 7.52.0)
68 When an HTTP request was made without -L to follow redirects, this variable
69 will show the actual URL a redirect \fIwould\fP take you to. (Added in 7.18.2)
72 The remote IP address of the most recently done connection - can be either
73 IPv4 or IPv6 (Added in 7.29.0)
76 The remote port number of the most recently done connection (Added in 7.29.0)
79 The URL scheme (sometimes called protocol) that was effectively used (Added in 7.52.0)
82 The total amount of bytes that were downloaded.
85 The total amount of bytes of the downloaded headers.
88 The total amount of bytes that were sent in the HTTP request.
91 The total amount of bytes that were uploaded.
94 The average download speed that curl measured for the complete download. Bytes
98 The average upload speed that curl measured for the complete upload. Bytes per
102 The result of the SSL peer certificate verification that was requested. 0
103 means the verification was successful. (Added in 7.19.0)
106 The time, in seconds, it took from the start until the SSL/SSH/etc
107 connect/handshake to the remote host was completed. (Added in 7.19.0)
110 The time, in seconds, it took from the start until the TCP connect to the
111 remote host (or proxy) was completed.
114 The time, in seconds, it took from the start until the name resolving was
118 The time, in seconds, it took from the start until the file transfer was just
119 about to begin. This includes all pre-transfer commands and negotiations that
120 are specific to the particular protocol(s) involved.
123 The time, in seconds, it took for all redirection steps include name lookup,
124 connect, pretransfer and transfer before the final transaction was
125 started. time_redirect shows the complete execution time for multiple
126 redirections. (Added in 7.12.3)
128 .B time_starttransfer
129 The time, in seconds, it took from the start until the first byte was just
130 about to be transferred. This includes time_pretransfer and also the time the
131 server needed to calculate the result.
134 The total time, in seconds, that the full operation lasted.
137 The URL that was fetched last. This is most meaningful if you've told curl
138 to follow location: headers.
141 If this option is used several times, the last one will be used.