curl.1: list the -w variables sorted alphabetically

This commit is contained in:
Daniel Stenberg 2012-08-28 10:43:12 +02:00
parent 4eec66e479
commit d4af0bb8f6

View File

@ -1499,12 +1499,11 @@ space with \\t.
The %-symbol is a special symbol in the win32-environment, where all The %-symbol is a special symbol in the win32-environment, where all
occurrences of % must be doubled when using this option. occurrences of % must be doubled when using this option.
The variables available at this point are: The variables available are:
.RS .RS
.TP 15 .TP 15
.B url_effective .B content_type
The URL that was fetched last. This is most meaningful if you've told curl The Content-Type of the requested document, if there was any.
to follow location: headers.
.TP .TP
.B filename_effective .B filename_effective
The ultimate filename that curl writes out to. This is only meaningful if curl The ultimate filename that curl writes out to. This is only meaningful if curl
@ -1512,6 +1511,10 @@ is told to write to a file with the \fI--remote-name\fP or \fI--output\fP
option. It's most useful in combination with the \fI--remote-header-name\fP option. It's most useful in combination with the \fI--remote-header-name\fP
option. (Added in 7.25.1) option. (Added in 7.25.1)
.TP .TP
.B ftp_entry_path
The initial path curl ended up in when logging on to the remote FTP
server. (Added in 7.15.4)
.TP
.B http_code .B http_code
The numerical response code that was found in the last retrieved HTTP(S) or The numerical response code that was found in the last retrieved HTTP(S) or
FTP(s) transfer. In 7.18.2 the alias \fBresponse_code\fP was added to show the FTP(s) transfer. In 7.18.2 the alias \fBresponse_code\fP was added to show the
@ -1521,21 +1524,51 @@ same info.
The numerical code that was found in the last response (from a proxy) to a The numerical code that was found in the last response (from a proxy) to a
curl CONNECT request. (Added in 7.12.4) curl CONNECT request. (Added in 7.12.4)
.TP .TP
.B time_total .B num_connects
The total time, in seconds, that the full operation lasted. The time will be Number of new connects made in the recent transfer. (Added in 7.12.3)
displayed with millisecond resolution.
.TP .TP
.B time_namelookup .B num_redirects
The time, in seconds, it took from the start until the name resolving was Number of redirects that were followed in the request. (Added in 7.12.3)
completed. .TP
.B redirect_url
When an HTTP request was made without -L to follow redirects, this variable
will show the actual URL a redirect \fIwould\fP take you to. (Added in 7.18.2)
.TP
.B size_download
The total amount of bytes that were downloaded.
.TP
.B size_header
The total amount of bytes of the downloaded headers.
.TP
.B size_request
The total amount of bytes that were sent in the HTTP request.
.TP
.B size_upload
The total amount of bytes that were uploaded.
.TP
.B speed_download
The average download speed that curl measured for the complete download. Bytes
per second.
.TP
.B speed_upload
The average upload speed that curl measured for the complete upload. Bytes per
second.
.TP
.B ssl_verify_result
The result of the SSL peer certificate verification that was requested. 0
means the verification was successful. (Added in 7.19.0)
.TP
.B time_appconnect
The time, in seconds, it took from the start until the SSL/SSH/etc
connect/handshake to the remote host was completed. (Added in 7.19.0)
.TP .TP
.B time_connect .B time_connect
The time, in seconds, it took from the start until the TCP connect to the The time, in seconds, it took from the start until the TCP connect to the
remote host (or proxy) was completed. remote host (or proxy) was completed.
.TP .TP
.B time_appconnect .B time_namelookup
The time, in seconds, it took from the start until the SSL/SSH/etc The time, in seconds, it took from the start until the name resolving was
connect/handshake to the remote host was completed. (Added in 7.19.0) completed.
.TP .TP
.B time_pretransfer .B time_pretransfer
The time, in seconds, it took from the start until the file transfer was just The time, in seconds, it took from the start until the file transfer was just
@ -1553,46 +1586,13 @@ The time, in seconds, it took from the start until the first byte was just
about to be transferred. This includes time_pretransfer and also the time the about to be transferred. This includes time_pretransfer and also the time the
server needed to calculate the result. server needed to calculate the result.
.TP .TP
.B size_download .B time_total
The total amount of bytes that were downloaded. The total time, in seconds, that the full operation lasted. The time will be
displayed with millisecond resolution.
.TP .TP
.B size_upload .B url_effective
The total amount of bytes that were uploaded. The URL that was fetched last. This is most meaningful if you've told curl
.TP to follow location: headers.
.B size_header
The total amount of bytes of the downloaded headers.
.TP
.B size_request
The total amount of bytes that were sent in the HTTP request.
.TP
.B speed_download
The average download speed that curl measured for the complete download. Bytes
per second.
.TP
.B speed_upload
The average upload speed that curl measured for the complete upload. Bytes per
second.
.TP
.B content_type
The Content-Type of the requested document, if there was any.
.TP
.B num_connects
Number of new connects made in the recent transfer. (Added in 7.12.3)
.TP
.B num_redirects
Number of redirects that were followed in the request. (Added in 7.12.3)
.TP
.B redirect_url
When an HTTP request was made without -L to follow redirects, this variable
will show the actual URL a redirect \fIwould\fP take you to. (Added in 7.18.2)
.TP
.B ftp_entry_path
The initial path curl ended up in when logging on to the remote FTP
server. (Added in 7.15.4)
.TP
.B ssl_verify_result
The result of the SSL peer certificate verification that was requested. 0
means the verification was successful. (Added in 7.19.0)
.RE .RE
If this option is used several times, the last one will be used. If this option is used several times, the last one will be used.