Lines 55-69
Create a Test Plan From a cURL Command
Link Here
|
55 |
<subsection name="§-num;.2 Curl options supported" anchor="curl_options"> |
55 |
<subsection name="§-num;.2 Curl options supported" anchor="curl_options"> |
56 |
|
56 |
|
57 |
<dl> |
57 |
<dl> |
58 |
<dt><code>-H</code>, <code>--header <header></code></dt> |
58 |
<dt><code>-H</code>, <code>--header <placeholder>header</placeholder></code></dt> |
59 |
<dd>Extra header to use when getting a web page.</dd> |
59 |
<dd>Extra header to use when getting a web page.</dd> |
60 |
<dt><code>-X</code>, <code>--request <command></code></dt> |
60 |
<dt><code>-X</code>, <code>--request <placeholder>command</placeholder></code></dt> |
61 |
<dd>Specifies a custom request method to use when communicating with the HTTP server.</dd> |
61 |
<dd>Specifies a custom request method to use when communicating with the HTTP server.</dd> |
62 |
<dt><code>--compressed</code></dt> |
62 |
<dt><code>--compressed</code></dt> |
63 |
<dd>Request a compressed response using one of the algorithms curl supports, and return the uncompressed document.</dd> |
63 |
<dd>Request a compressed response using one of the algorithms curl supports, and return the uncompressed document.</dd> |
64 |
<dt><code>-A</code>, <code>--user-agent <agent string></code></dt> |
64 |
<dt><code>-A</code>, <code>--user-agent <placeholder>agent string</placeholder></code></dt> |
65 |
<dd>Specify the User-Agent string to send to the HTTP server.</dd> |
65 |
<dd>Specify the User-Agent string to send to the HTTP server.</dd> |
66 |
<dt><code>-b</code>, <code>--cookie <name=data></code></dt> |
66 |
<dt><code>-b</code>, <code>--cookie <placeholder>name=data</placeholder></code></dt> |
67 |
<dd>Pass the data to the HTTP server as a cookie.</dd> |
67 |
<dd>Pass the data to the HTTP server as a cookie.</dd> |
68 |
<dt><code>-d</code> and friends</dt> |
68 |
<dt><code>-d</code> and friends</dt> |
69 |
<dd><p>Sending data via POST request</p> |
69 |
<dd><p>Sending data via POST request</p> |
Lines 72-88
Create a Test Plan From a cURL Command
Link Here
|
72 |
separating '<code>&</code>' character. Thus, using '<code>-d name=daniel -d skill=lousy</code>' would generate a POST |
72 |
separating '<code>&</code>' character. Thus, using '<code>-d name=daniel -d skill=lousy</code>' would generate a POST |
73 |
chunk that looks like '<code>name=daniel&skill=lousy</code>'.</p> |
73 |
chunk that looks like '<code>name=daniel&skill=lousy</code>'.</p> |
74 |
<dl> |
74 |
<dl> |
75 |
<dt><code>-d</code>, <code>--data <data></code>, <code>--data-ascii <data></code></dt> |
75 |
<dt><code>-d</code>, <code>--data <placeholder>data</placeholder></code>, <code>--data-ascii <placeholder>data</placeholder></code></dt> |
76 |
<dd>use <code>@</code> to upload a file</dd> |
76 |
<dd>use <code>@</code> to upload a file</dd> |
77 |
<dt><code>--data-raw <data></code>gt;</dt> |
77 |
<dt><code>--data-raw <placeholder>data</placeholder></code></dt> |
78 |
<dd></dd> |
78 |
<dd></dd> |
79 |
<dt><code>--data-raw <data></code></dt> |
79 |
<dt><code>--data-raw <placeholder>data</placeholder></code></dt> |
80 |
<dd>This posts data exactly as specified with no extra processing whatsoever. |
80 |
<dd>This posts data exactly as specified with no extra processing whatsoever. |
81 |
If you start the data with the character <code>@,</code> the rest should be a filename.</dd> |
81 |
If you start the data with the character <code>@,</code> the rest should be a filename.</dd> |
82 |
<dt><code>--data-raw <data></code>ta></dt> |
82 |
<dt><code>--data-raw <placeholder>data</placeholder></code></dt> |
83 |
<dd>This posts data, similar to the other <code>--data</code> options with the exception that this performs |
83 |
<dd>This posts data, similar to the other <code>--data</code> options with the exception that this performs |
84 |
URL-encoding.</dd> |
84 |
URL-encoding.</dd> |
85 |
<dt><code>--data-raw <data></code></dt> |
85 |
<dt><code>--data-raw <placeholder>data</placeholder></code></dt> |
86 |
<dd>This posts data similarly to <code>--data</code> but without the special interpretation |
86 |
<dd>This posts data similarly to <code>--data</code> but without the special interpretation |
87 |
of the <code>@</code> character.</dd> |
87 |
of the <code>@</code> character.</dd> |
88 |
</dl> |
88 |
</dl> |
Lines 91-103
Create a Test Plan From a cURL Command
Link Here
|
91 |
<dd> |
91 |
<dd> |
92 |
<p>This lets curl emulate a filled-in form in which a user has pressed the submit button.</p> |
92 |
<p>This lets curl emulate a filled-in form in which a user has pressed the submit button.</p> |
93 |
<dl> |
93 |
<dl> |
94 |
<dt><code>-F</code>, <code>--form <name=content></code></dt> |
94 |
<dt><code>-F</code>, <code>--form <placeholder>name=content</placeholder></code></dt> |
95 |
<dd>use <code>@</code> to upload a file</dd> |
95 |
<dd>use <code>@</code> to upload a file</dd> |
96 |
<dt><code>--form-string <name=content></code></dt> |
96 |
<dt><code>--form-string <placeholder>name=content</placeholder></code></dt> |
97 |
<dd></dd> |
97 |
<dd></dd> |
98 |
</dl> |
98 |
</dl> |
99 |
</dd> |
99 |
</dd> |
100 |
<dt><code>-u</code>, --user <user:password ></dt> |
100 |
<dt><code>-u</code>, --user <placeholder>user:password </placeholder></dt> |
101 |
<dd>Specify user and password to use for server authentication.</dd> |
101 |
<dd>Specify user and password to use for server authentication.</dd> |
102 |
<dt><code>--basic</code>, <code>--digest</code></dt> |
102 |
<dt><code>--basic</code>, <code>--digest</code></dt> |
103 |
<dd>Tells curl to use HTTP authentication.</dd> |
103 |
<dd>Tells curl to use HTTP authentication.</dd> |
Lines 105-139
Create a Test Plan From a cURL Command
Link Here
|
105 |
<dd> |
105 |
<dd> |
106 |
<p>Tells curl to use the specified client certificate file when getting a file with HTTPS</p> |
106 |
<p>Tells curl to use the specified client certificate file when getting a file with HTTPS</p> |
107 |
<dl> |
107 |
<dl> |
108 |
<dt><code>--cacert <CA certificate></code></dt> |
108 |
<dt><code>--cacert <placeholder>CA certificate</placeholder></code></dt> |
109 |
<dt><code>--capath <CA certificate directory></code></dt> |
109 |
<dt><code>--capath <placeholder>CA certificate directory</placeholder></code></dt> |
110 |
<dt><code>--ciphers <list of ciphers></code></dt> |
110 |
<dt><code>--ciphers <placeholder>list of ciphers</placeholder></code></dt> |
111 |
<dt><code>--cert-status</code></dt> |
111 |
<dt><code>--cert-status</code></dt> |
112 |
<dt><code>--cert-type <type></code></dt> |
112 |
<dt><code>--cert-type <placeholder>type</placeholder></code></dt> |
113 |
</dl> |
113 |
</dl> |
114 |
</dd> |
114 |
</dd> |
115 |
<dt><code>-G</code>, <code>--get</code></dt> |
115 |
<dt><code>-G</code>, <code>--get</code></dt> |
116 |
<dd>put the post data in the URL and use get to replace post.</dd> |
116 |
<dd>put the post data in the URL and use get to replace post.</dd> |
117 |
<dt><code>--no-keepalive</code></dt> |
117 |
<dt><code>--no-keepalive</code></dt> |
118 |
<dd>Disables the use of keepalive messages on the TCP connection.</dd> |
118 |
<dd>Disables the use of keepalive messages on the TCP connection.</dd> |
119 |
<dt><code>-e</code>, <code>--referer <URL></code></dt> |
119 |
<dt><code>-e</code>, <code>--referer <placeholder>URL</placeholder></code></dt> |
120 |
<dd>Sends the <em>Referer Page</em> information to the HTTP server.</dd> |
120 |
<dd>Sends the <em>Referer Page</em> information to the HTTP server.</dd> |
121 |
<dt><code>-L</code>, <code>--location</code></dt> |
121 |
<dt><code>-L</code>, <code>--location</code></dt> |
122 |
<dd>If the server reports that the requested page has moved to a different location |
122 |
<dd>If the server reports that the requested page has moved to a different location |
123 |
this option will make curl redo the request on the new place.</dd> |
123 |
this option will make curl redo the request on the new place.</dd> |
124 |
<dt><code>-i</code>, <code>--include</code></dt> |
124 |
<dt><code>-i</code>, <code>--include</code></dt> |
125 |
<dd>Include the HTTP-header in the output.</dd> |
125 |
<dd>Include the HTTP-header in the output.</dd> |
126 |
<dt><code>--connect-timeout <seconds></code></dt> |
126 |
<dt><code>--connect-timeout <placeholder>seconds</placeholder></code></dt> |
127 |
<dd>Maximum time in seconds that the connection to the server may take.</dd> |
127 |
<dd>Maximum time in seconds that the connection to the server may take.</dd> |
128 |
<dt><code>--keepalive-time <seconds></code></dt> |
128 |
<dt><code>--keepalive-time <placeholder>seconds</placeholder></code></dt> |
129 |
<dd>This option sets the time a connection needs to remain idle before sending keepalive probes |
129 |
<dd>This option sets the time a connection needs to remain idle before sending keepalive probes |
130 |
and the time between individual keepalive probes.</dd> |
130 |
and the time between individual keepalive probes.</dd> |
131 |
<dt><code>-m</code>, <code>--max-time <seconds></code></dt> |
131 |
<dt><code>-m</code>, <code>--max-time <placeholder>seconds</placeholder></code></dt> |
132 |
<dd>Maximum time in seconds that you allow the whole operation to take.</dd> |
132 |
<dd>Maximum time in seconds that you allow the whole operation to take.</dd> |
133 |
<dt><code>-x</code>, <code>--proxy <[protocol://][user:password@]proxyhost[:port]></code></dt> |
133 |
<dt><code>-x</code>, <code>--proxy <placeholder>[protocol://][user:password@]proxyhost[:port]</placeholder></code></dt> |
134 |
<dd>Use the specified HTTP proxy. If the port number is not specified, |
134 |
<dd>Use the specified HTTP proxy. If the port number is not specified, |
135 |
it is assumed at port <code>1080</code>.</dd> |
135 |
it is assumed at port <code>1080</code>.</dd> |
136 |
<dt><code>-U</code>, <code>--proxy-user <user:password></code></dt> |
136 |
<dt><code>-U</code>, <code>--proxy-user <placeholder>user:password</placeholder></code></dt> |
137 |
<dd>Specify user and password to use for proxy authentication.</dd> |
137 |
<dd>Specify user and password to use for proxy authentication.</dd> |
138 |
<dt><code>-k</code>, <code>--insecure</code></dt> |
138 |
<dt><code>-k</code>, <code>--insecure</code></dt> |
139 |
<dd>This option explicitly allows curl to perform <em>insecure</em> SSL connections and transfers.</dd> |
139 |
<dd>This option explicitly allows curl to perform <em>insecure</em> SSL connections and transfers.</dd> |
Lines 141-159
Create a Test Plan From a cURL Command
Link Here
|
141 |
<dd>When used, it disables all internal HTTP decoding of content or transfer encodings and instead makes them passed on unaltered,raw.</dd> |
141 |
<dd>When used, it disables all internal HTTP decoding of content or transfer encodings and instead makes them passed on unaltered,raw.</dd> |
142 |
<dt><code>-I</code>, <code>--head</code></dt> |
142 |
<dt><code>-I</code>, <code>--head</code></dt> |
143 |
<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> |
143 |
<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> |
144 |
<dt><code>--interface <name></code></dt> |
144 |
<dt><code>--interface <placeholder>name</placeholder></code></dt> |
145 |
<dd>Perform an operation using a specified interface. You can enter interface name, IP address or host name.</dd> |
145 |
<dd>Perform an operation using a specified interface. You can enter interface name, IP address or host name.</dd> |
146 |
<dt><code>--proxy-ntlm</code>/<code>--proxy-negotiate</code></dt> |
146 |
<dt><code>--proxy-ntlm</code>/<code>--proxy-negotiate</code></dt> |
147 |
<dd>Tells curl to use HTTP BASIC/NTLM/Digest authentication when communicating with the given proxy.</dd> |
147 |
<dd>Tells curl to use HTTP BASIC/NTLM/Digest authentication when communicating with the given proxy.</dd> |
148 |
<dt><code>--dns-servers <addresses></code></dt> |
148 |
<dt><code>--dns-servers <placeholder>addresses</placeholder></code></dt> |
149 |
<dd>Resolve host name over DOH.</dd> |
149 |
<dd>Resolve host name over DOH.</dd> |
150 |
<dt><code>--resolve <host:port:address></code></dt> |
150 |
<dt><code>--resolve <placeholder>host:port:address</placeholder></code></dt> |
151 |
<dd>Provide a custom address for a specific host and port pair.</dd> |
151 |
<dd>Provide a custom address for a specific host and port pair.</dd> |
152 |
<dt><code>--limit-rate <speed></code></dt> |
152 |
<dt><code>--limit-rate <placeholder>speed</placeholder></code></dt> |
153 |
<dd>Specify the maximum transfer rate you want curl to use.</dd> |
153 |
<dd>Specify the maximum transfer rate you want curl to use.</dd> |
154 |
<dt><code>--max-redirs <num></code></dt> |
154 |
<dt><code>--max-redirs <placeholder>num</placeholder></code></dt> |
155 |
<dd>Set maximum number of redirections which may be followed.</dd> |
155 |
<dd>Set maximum number of redirections which may be followed.</dd> |
156 |
<dt><code>--noproxy <no-proxy-list></code></dt> |
156 |
<dt><code>--noproxy <placeholder>no-proxy-list</placeholder></code></dt> |
157 |
<dd>Comma-separated list of hosts which do not use a proxy, if one is specified.</dd> |
157 |
<dd>Comma-separated list of hosts which do not use a proxy, if one is specified.</dd> |
158 |
</dl> |
158 |
</dl> |
159 |
|
159 |
|