You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jmeter.apache.org by fs...@apache.org on 2020/03/07 14:51:06 UTC
[jmeter] branch master updated: Markup changes and a few minor typos
This is an automated email from the ASF dual-hosted git repository.
fschumacher pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/jmeter.git
The following commit(s) were added to refs/heads/master by this push:
new a335e25 Markup changes and a few minor typos
a335e25 is described below
commit a335e251b19c203efa86aea467c915b34856c8c9
Author: Felix Schumacher <fe...@internetallee.de>
AuthorDate: Sat Mar 7 15:50:42 2020 +0100
Markup changes and a few minor typos
---
xdocs/usermanual/curl.xml | 158 ++++++++++++++++++++++++++++++----------------
1 file changed, 103 insertions(+), 55 deletions(-)
diff --git a/xdocs/usermanual/curl.xml b/xdocs/usermanual/curl.xml
index 21a6ada..7ea228e 100644
--- a/xdocs/usermanual/curl.xml
+++ b/xdocs/usermanual/curl.xml
@@ -54,66 +54,114 @@ Create a Test Plan From a cURL Command
<subsection name="§-num;.2 Curl options supported" anchor="curl_options">
-<p><b>-H, --header<header></b>:Extra header to use when getting a web page.</p>
-<p><b>-X, --request <command></b>:Specifies a custom request method to use when communicating with the HTTP server.</p>
-<p><b>--compressed</b>:Request a compressed response using one of the algorithms curl supports, and return the uncompressed document.</p>
-<p><b>-A, --user-agent <agent string ></b>:Specify the User-Agent string to send to the HTTP server.</p>
-<p><b>-b, --cookie <name=data></b>:Pass the data to the HTTP server as a cookie.</p>
+<dl>
+ <dt><code>-H</code>, <code>--header <header></code></dt>
+ <dd>Extra header to use when getting a web page.</dd>
+ <dt><code>-X</code>, <code>--request <command></code></dt>
+ <dd>Specifies a custom request method to use when communicating with the HTTP server.</dd>
+ <dt><code>--compressed</code></dt>
+ <dd>Request a compressed response using one of the algorithms curl supports, and return the uncompressed document.</dd>
+ <dt><code>-A</code>, <code>--user-agent <agent string></code></dt>
+ <dd>Specify the User-Agent string to send to the HTTP server.</dd>
+ <dt><code>-b</code>, <code>--cookie <name=data></code></dt>
+ <dd>Pass the data to the HTTP server as a cookie.</dd>
+ <dt><code>-d</code> and friends</dt>
+ <dd><p>Sending data via POST request</p>
+ <p>Sends the specified data in a POST request to the HTTP server. If this option is used more than
+ once on the same command line, the data pieces specified will be merged together with a
+ separating '<code>&</code>' character. Thus, using '<code>-d name=daniel -d skill=lousy</code>' would generate a POST
+ chunk that looks like '<code>name=daniel&skill=lousy</code>'.</p>
+ <dl>
+ <dt><code>-d</code>, <code>--data <data></code>, <code>--data-ascii <data></code></dt>
+ <dd>use <code>@</code> to upload a file</dd>
+ <dt><code>--data-raw <data></code>gt;</dt>
+ <dd></dd>
+ <dt><code>--data-raw <data></code></dt>
+ <dd>This posts data exactly as specified with no extra processing whatsoever.
+ If you start the data with the character <code>@,</code> the rest should be a filename.</dd>
+ <dt><code>--data-raw <data></code>ta></dt>
+ <dd>This posts data, similar to the other <code>--data</code> options with the exception that this performs
+ URL-encoding.</dd>
+ <dt><code>--data-raw <data></code></dt>
+ <dd>This posts data similarly to <code>--data</code> but without the special interpretation
+ of the <code>@</code> character.</dd>
+ </dl>
+ </dd>
+ <dt><code>-F</code> and friends</dt>
+ <dd>
+ <p>This lets curl emulate a filled-in form in which a user has pressed the submit button.</p>
+ <dl>
+ <dt><code>-F</code>, <code>--form <name=content></code></dt>
+ <dd>use <code>@</code> to upload a file</dd>
+ <dt><code>--form-string <name=content></code></dt>
+ <dd></dd>
+ </dl>
+ </dd>
+ <dt><code>-u</code>, --user <user:password ></dt>
+ <dd>Specify user and password to use for server authentication.</dd>
+ <dt><code>--basic</code>, <code>--digest</code></dt>
+ <dd>Tells curl to use HTTP authentication.</dd>
+ <dt><code>--cacert</code> and friends</dt>
+ <dd>
+ <p>Tells curl to use the specified client certificate file when getting a file with HTTPS</p>
+ <dl>
+ <dt><code>--cacert <CA certificate></code></dt>
+ <dt><code>--capath <CA certificate directory></code></dt>
+ <dt><code>--ciphers <list of ciphers></code></dt>
+ <dt><code>--cert-status</code></dt>
+ <dt><code>--cert-type <type></code></dt>
+ </dl>
+ </dd>
+ <dt><code>-G</code>, <code>--get</code></dt>
+ <dd>put the post data in the URL and use get to replace post.</dd>
+ <dt><code>--no-keepalive</code></dt>
+ <dd>Disables the use of keepalive messages on the TCP connection.</dd>
+ <dt><code>-e</code>, <code>--referer <URL></code></dt>
+ <dd>Sends the <em>Referer Page</em> information to the HTTP server.</dd>
+ <dt><code>-L</code>, <code>--location</code></dt>
+ <dd>If the server reports that the requested page has moved to a different location
+ this option will make curl redo the request on the new place.</dd>
+ <dt><code>-i</code>, <code>--include</code></dt>
+ <dd>Include the HTTP-header in the output.</dd>
+ <dt><code>--connect-timeout <seconds></code></dt>
+ <dd>Maximum time in seconds that the connection to the server may take.</dd>
+ <dt><code>--keepalive-time <seconds></code></dt>
+ <dd>This option sets the time a connection needs to remain idle before sending keepalive probes
+ and the time between individual keepalive probes.</dd>
+ <dt><code>-m</code>, <code>--max-time <seconds></code></dt>
+ <dd>Maximum time in seconds that you allow the whole operation to take.</dd>
+ <dt><code>-x</code>, <code>--proxy <[protocol://][user:password@]proxyhost[:port]></code></dt>
+ <dd>Use the specified HTTP proxy. If the port number is not specified,
+ it is assumed at port <code>1080</code>.</dd>
+ <dt><code>-U</code>, <code>--proxy-user <user:password></code></dt>
+ <dd>Specify user and password to use for proxy authentication.</dd>
+ <dt><code>-k</code>, <code>--insecure</code></dt>
+ <dd>This option explicitly allows curl to perform <em>insecure</em> SSL connections and transfers.</dd>
+ <dt><code>--raw</code></dt>
+ <dd>When used, it disables all internal HTTP decoding of content or transfer encodings and instead makes them passed on unaltered,raw.</dd>
+ <dt><code>-I</code>, <code>--head</code></dt>
+ <dd>Fetch the HTTP-header only. HTTP-servers feature the method <code>HEAD</code> which this uses to get nothing but the header of a document.</dd>
+ <dt><code>--interface <name></code></dt>
+ <dd>Perform an operation using a specified interface. You can enter interface name, IP address or host name.</dd>
+ <dt><code>--proxy-ntlm</code>/<code>--proxy-negotiate</code></dt>
+ <dd>Tells curl to use HTTP BASIC/NTLM/Digest authentication when communicating with the given proxy.</dd>
+ <dt><code>--dns-servers <addresses></code></dt>
+ <dd>Resolve host name over DOH.</dd>
+ <dt><code>--resolve <host:port:address></code></dt>
+ <dd>Provide a custom address for a specific host and port pair.</dd>
+ <dt><code>--limit-rate <speed></code></dt>
+ <dd>Specify the maximum transfer rate you want curl to use.</dd>
+ <dt><code>--max-redirs <num></code></dt>
+ <dd>Set maximum number of redirections which may be followed.</dd>
+ <dt><code>--noproxy <no-proxy-list></code></dt>
+ <dd>Comma-separated list of hosts which do not use a proxy, if one is specified.</dd>
+</dl>
-<b>Sends the specified data in a POST request to the HTTP server. If this option is used more than
- once on the same command line, the data pieces specified will be merged together with a
-separating "&" character. Thus, using '-d name=daniel -d skill=lousy' would generate a POST
- chunk that looks like 'name=daniel&skill=lousy'.</b>
-<ul><li>-d,--data <data> --data-ascii <data> :use @ to upload the file</li>
-<li> --data-binary <data> </li><li>--data-raw <data> : This posts data exactly as specified with no extra processing whatsoever.
-If you start the data with the character @, the rest should be a filename. </li>
-<li> --data-urlencode <data> :This posts data, similar to the other --data options with the exception that this performs
- URL-encoding.</li>
- <li> --data-raw <data> :This posts data similarly to --data but without the special interpretation
-of the @ character. </li>
-</ul>
-
-<b>This lets curl emulate a filled-in form in which a user has pressed the submit button.</b>
-<ul><li>-F, --form <name=content> :use @ to upload the file</li>
-<li>--form-string <name=content></li>
-</ul>
-<p><b>-u, --user <user:password ></b>:Specify user and password to use for server authentication.</p>
-<p><b>--basic,--digest</b>:Tells curl to use HTTP authentication.</p>
-
-<b>Tells curl to use the specified client certificate file when getting a file with HTTPS</b>
-<ul>
-<li>--cacert <CA certificate></li>
-<li>--capath <CA certificate directory></li>
-<li>--ciphers <list of ciphers> </li>
-<li>--cert-status</li>
-<li>--cert-type <type></li>
-</ul>
-<p><b>-G, --get</b>:put the post data in the url and use get to replace post.</p>
-<p><b>--no-keepalive</b>:Disables the use of keepalive messages on the TCP connection.</p>
-<p><b>-e, --referer <URL></b>:Sends the "Referer Page" information to the HTTP server.</p>
-<p><b>-L, --location</b>:If the server reports that the requested page has moved to a different location
-this option will make curl redo the request on the new place.</p>
-<p><b>-i, --include</b>:Include the HTTP-header in the output.</p>
-<p><b>--connect-timeout <seconds></b>:Maximum time in seconds that the connection to the server may take.</p>
-<p><b>--keepalive-time <seconds></b>:This option sets the time a connection needs to remain idle before sending keepalive probes and the time between individual keepalive probes.</p>
-<p><b>-m, --max-time <seconds></b>:Maximum time in seconds that you allow the whole operation to take.</p>
-<p><b>-x, --proxy <[protocol://] [user:password@] proxyhost[:port]> </b>:Use the specified HTTP proxy. If the port number is not specified, it is assumed at port 1080. </p>
-<p><b>-U, --proxy-user <user:password></b>:Specify user and password to use for proxy authentication. </p>
-<p><b>-k, --insecure</b>:This option explicitly allows curl to perform "insecure" SSL connections and transfers.</p>
-<p><b>--raw</b>:When used, it disables all internal HTTP decoding of content or transfer encodings and instead makes them passed on unaltered,raw.</p>
-<p><b>-I, --head</b>:Fetch the HTTP-header only. HTTP-servers feature the command HEAD which this uses to get nothing but the header of a document.</p>
-<p><b>--interface <name></b>:Perform an operation using a specified interface. You can enter interface name, IP address or host name.</p>
-<p><b>--proxy-ntlm/--proxy-negotiate</b>:Tells curl to use HTTP basic/ntlm/Digest authentication when communicating with the given proxy.</p>
-<p><b>--dns-servers <addresses></b>:Resolve host name over DOH.</p>
-<p><b>--resolve <host:port:address></b>:Provide a custom address for a specific host and port pair.</p>
-<p><b>--limit-rate <speed></b>:Specify the maximum transfer rate you want curl to use.</p>
-<p><b>--max-redirs <num></b>:Set maximum number of redirections which may be followed.</p>
-<p><b>--noproxy <no-proxy-list></b>:Comma-separated list of hosts which do not use a proxy, if one is specified.</p>
</subsection>
<subsection name="§-num;.3 Warning" anchor="warning">
<p>
-When the command you entered is ignored or contains warning content, we will display warning in the comment section of Http Request.
+When the command you entered is ignored or contains warning content, we will display warning in the comment section of HTTP Request.
</p>
<figure width="768" height="339" image="curl/http_request_warning.png">Figure 1 -Warning</figure>