mirror of
https://github.com/curl/curl.git
synced 2026-08-24 13:33:33 +03:00
cmdline-docs: use .IP consistently
Remove use of .TP and some .B. The idea is to reduce nroff syntax as much as possible and to use it consistently. Ultimately, we should be able to introduce our own easier-to-use-and-read syntax/formatting and convert on generation time. Closes #12535
This commit is contained in:
parent
1e9db6997a
commit
67211e9540
8 changed files with 110 additions and 212 deletions
|
|
@ -46,31 +46,24 @@ the % cannot be escaped and unintended expansion is possible.
|
|||
|
||||
The variables available are:
|
||||
.RS
|
||||
.TP 15
|
||||
**certs**
|
||||
.IP certs
|
||||
Output the certificate chain with details. Supported only by the OpenSSL,
|
||||
GnuTLS, Schannel and Secure Transport backends. (Added in 7.88.0)
|
||||
.TP
|
||||
**content_type**
|
||||
.IP content_type
|
||||
The Content-Type of the requested document, if there was any.
|
||||
.TP
|
||||
**errormsg**
|
||||
.IP errormsg
|
||||
The error message. (Added in 7.75.0)
|
||||
.TP
|
||||
**exitcode**
|
||||
.IP exitcode
|
||||
The numerical exit code of the transfer. (Added in 7.75.0)
|
||||
.TP
|
||||
**filename_effective**
|
||||
.IP filename_effective
|
||||
The ultimate filename that curl writes out to. This is only meaningful if curl
|
||||
is told to write to a file with the --remote-name or --output
|
||||
option. It's most useful in combination with the --remote-header-name
|
||||
option. (Added in 7.26.0)
|
||||
.TP
|
||||
**ftp_entry_path**
|
||||
.IP ftp_entry_path
|
||||
The initial path curl ended up in when logging on to the remote FTP
|
||||
server. (Added in 7.15.4)
|
||||
.TP
|
||||
**header_json**
|
||||
.IP header_json
|
||||
A JSON object with all HTTP response headers from the recent transfer. Values
|
||||
are provided as arrays, since in the case of multiple headers there can be
|
||||
multiple values. (Added in 7.83.0)
|
||||
|
|
@ -78,214 +71,156 @@ multiple values. (Added in 7.83.0)
|
|||
The header names provided in lowercase, listed in order of appearance over the
|
||||
wire. Except for duplicated headers. They are grouped on the first occurrence
|
||||
of that header, each value is presented in the JSON array.
|
||||
.TP
|
||||
**http_code**
|
||||
.IP http_code
|
||||
The numerical response code that was found in the last retrieved HTTP(S) or
|
||||
FTP(s) transfer.
|
||||
.TP
|
||||
**http_connect**
|
||||
.IP http_connect
|
||||
The numerical code that was found in the last response (from a proxy) to a
|
||||
curl CONNECT request. (Added in 7.12.4)
|
||||
.TP
|
||||
**http_version**
|
||||
.IP http_version
|
||||
The http version that was effectively used. (Added in 7.50.0)
|
||||
.TP
|
||||
**json**
|
||||
.IP json
|
||||
A JSON object with all available keys. (Added in 7.70.0)
|
||||
.TP
|
||||
**local_ip**
|
||||
.IP local_ip
|
||||
The IP address of the local end of the most recently done connection - can be
|
||||
either IPv4 or IPv6. (Added in 7.29.0)
|
||||
.TP
|
||||
**local_port**
|
||||
.IP local_port
|
||||
The local port number of the most recently done connection. (Added in 7.29.0)
|
||||
.TP
|
||||
**method**
|
||||
.IP method
|
||||
The http method used in the most recent HTTP request. (Added in 7.72.0)
|
||||
.TP
|
||||
**num_certs**
|
||||
.IP num_certs
|
||||
Number of server certificates received in the TLS handshake. Supported only by
|
||||
the OpenSSL, GnuTLS, Schannel and Secure Transport backends.
|
||||
(Added in 7.88.0)
|
||||
.TP
|
||||
**num_connects**
|
||||
.IP num_connects
|
||||
Number of new connects made in the recent transfer. (Added in 7.12.3)
|
||||
.TP
|
||||
**num_headers**
|
||||
.IP num_headers
|
||||
The number of response headers in the most recent request (restarted at each
|
||||
redirect). Note that the status line IS NOT a header. (Added in 7.73.0)
|
||||
.TP
|
||||
**num_redirects**
|
||||
.IP num_redirects
|
||||
Number of redirects that were followed in the request. (Added in 7.12.3)
|
||||
.TP
|
||||
**onerror**
|
||||
.IP onerror
|
||||
The rest of the output is only shown if the transfer returned a non-zero error.
|
||||
(Added in 7.75.0)
|
||||
.TP
|
||||
**proxy_ssl_verify_result**
|
||||
.IP "proxy_ssl_verify_result"
|
||||
The result of the HTTPS proxy's SSL peer certificate verification that was
|
||||
requested. 0 means the verification was successful. (Added in 7.52.0)
|
||||
.TP
|
||||
**redirect_url**
|
||||
.IP redirect_url
|
||||
When an HTTP request was made without --location to follow redirects (or when
|
||||
--max-redirs is met), this variable shows the actual URL a redirect
|
||||
*would* have gone to. (Added in 7.18.2)
|
||||
.TP
|
||||
**referer**
|
||||
.IP referer
|
||||
The Referer: header, if there was any. (Added in 7.76.0)
|
||||
.TP
|
||||
**remote_ip**
|
||||
.IP remote_ip
|
||||
The remote IP address of the most recently done connection - can be either
|
||||
IPv4 or IPv6. (Added in 7.29.0)
|
||||
.TP
|
||||
**remote_port**
|
||||
.IP remote_port
|
||||
The remote port number of the most recently done connection. (Added in 7.29.0)
|
||||
.TP
|
||||
**response_code**
|
||||
.IP response_code
|
||||
The numerical response code that was found in the last transfer (formerly
|
||||
known as "http_code"). (Added in 7.18.2)
|
||||
.TP
|
||||
**scheme**
|
||||
.IP scheme
|
||||
The URL scheme (sometimes called protocol) that was effectively used. (Added in 7.52.0)
|
||||
.TP
|
||||
**size_download**
|
||||
.IP size_download
|
||||
The total amount of bytes that were downloaded. This is the size of the
|
||||
body/data that was transferred, excluding headers.
|
||||
.TP
|
||||
**size_header**
|
||||
.IP size_header
|
||||
The total amount of bytes of the downloaded headers.
|
||||
.TP
|
||||
**size_request**
|
||||
.IP size_request
|
||||
The total amount of bytes that were sent in the HTTP request.
|
||||
.TP
|
||||
**size_upload**
|
||||
.IP size_upload
|
||||
The total amount of bytes that were uploaded. This is the size of the
|
||||
body/data that was transferred, excluding headers.
|
||||
.TP
|
||||
**speed_download**
|
||||
.IP speed_download
|
||||
The average download speed that curl measured for the complete download. Bytes
|
||||
per second.
|
||||
.TP
|
||||
**speed_upload**
|
||||
.IP speed_upload
|
||||
The average upload speed that curl measured for the complete upload. Bytes per
|
||||
second.
|
||||
.TP
|
||||
**ssl_verify_result**
|
||||
.IP 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
|
||||
**stderr**
|
||||
.IP stderr
|
||||
From this point on, the --write-out output is written to standard
|
||||
error. (Added in 7.63.0)
|
||||
.TP
|
||||
**stdout**
|
||||
.IP stdout
|
||||
From this point on, the --write-out output is written to standard output.
|
||||
This is the default, but can be used to switch back after switching to stderr.
|
||||
(Added in 7.63.0)
|
||||
.TP
|
||||
**time_appconnect**
|
||||
.IP 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
|
||||
**time_connect**
|
||||
.IP time_connect
|
||||
The time, in seconds, it took from the start until the TCP connect to the
|
||||
remote host (or proxy) was completed.
|
||||
.TP
|
||||
**time_namelookup**
|
||||
.IP time_namelookup
|
||||
The time, in seconds, it took from the start until the name resolving was
|
||||
completed.
|
||||
.TP
|
||||
**time_pretransfer**
|
||||
.IP time_pretransfer
|
||||
The time, in seconds, it took from the start until the file transfer was just
|
||||
about to begin. This includes all pre-transfer commands and negotiations that
|
||||
are specific to the particular protocol(s) involved.
|
||||
.TP
|
||||
**time_redirect**
|
||||
.IP time_redirect
|
||||
The time, in seconds, it took for all redirection steps including name lookup,
|
||||
connect, pretransfer and transfer before the final transaction was
|
||||
started. time_redirect shows the complete execution time for multiple
|
||||
redirections. (Added in 7.12.3)
|
||||
.TP
|
||||
**time_starttransfer**
|
||||
.IP time_starttransfer
|
||||
The time, in seconds, it took from the start until the first byte is received.
|
||||
This includes time_pretransfer and also the time the server needed to calculate
|
||||
the result.
|
||||
.TP
|
||||
**time_total**
|
||||
.IP time_total
|
||||
The total time, in seconds, that the full operation lasted.
|
||||
.TP
|
||||
**url**
|
||||
.IP url
|
||||
The URL that was fetched. (Added in 7.75.0)
|
||||
.TP
|
||||
**url.scheme**
|
||||
.IP url.scheme
|
||||
The scheme part of the URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**url.user**
|
||||
.IP url.user
|
||||
The user part of the URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**url.password**
|
||||
.IP url.password
|
||||
The password part of the URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**url.options**
|
||||
.IP url.options
|
||||
The options part of the URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**url.host**
|
||||
.IP url.host
|
||||
The host part of the URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**url.port**
|
||||
.IP url.port
|
||||
The port number of the URL that was fetched. If no port number was specified,
|
||||
but the URL scheme is known, that scheme's default port number is
|
||||
shown. (Added in 8.1.0)
|
||||
.TP
|
||||
**url.path**
|
||||
.IP url.path
|
||||
The path part of the URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**url.query**
|
||||
.IP url.query
|
||||
The query part of the URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**url.fragment**
|
||||
.IP url.fragment
|
||||
The fragment part of the URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**url.zoneid**
|
||||
.IP url.zoneid
|
||||
The zone id part of the URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**urle.scheme**
|
||||
.IP urle.scheme
|
||||
The scheme part of the effective (last) URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**urle.user**
|
||||
.IP urle.user
|
||||
The user part of the effective (last) URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**urle.password**
|
||||
.IP urle.password
|
||||
The password part of the effective (last) URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**urle.options**
|
||||
.IP urle.options
|
||||
The options part of the effective (last) URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**urle.host**
|
||||
.IP urle.host
|
||||
The host part of the effective (last) URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**urle.port**
|
||||
.IP urle.port
|
||||
The port number of the effective (last) URL that was fetched. If no port
|
||||
number was specified, but the URL scheme is known, that scheme's default port
|
||||
number is shown. (Added in 8.1.0)
|
||||
.TP
|
||||
**urle.path**
|
||||
.IP urle.path
|
||||
The path part of the effective (last) URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**urle.query**
|
||||
.IP urle.query
|
||||
The query part of the effective (last) URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**urle.fragment**
|
||||
.IP urle.fragment
|
||||
The fragment part of the effective (last) URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**urle.zoneid**
|
||||
.IP urle.zoneid
|
||||
The zone id part of the effective (last) URL that was fetched. (Added in 8.1.0)
|
||||
.TP
|
||||
**urlnum**
|
||||
.IP urlnum
|
||||
The URL index number of this transfer, 0-indexed. Unglobbed URLs share the
|
||||
same index number as the origin globbed URL. (Added in 7.75.0)
|
||||
.TP
|
||||
**url_effective**
|
||||
.IP url_effective
|
||||
The URL that was fetched last. This is most meaningful if you have told curl
|
||||
to follow location: headers.
|
||||
.RE
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue