docs: expanded on some CURLU details

This commit is contained in:
Daniel Stenberg 2018-11-11 00:10:56 +01:00
parent c05d77ee7d
commit f7fa04d7f3
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2
2 changed files with 14 additions and 3 deletions

View File

@ -29,8 +29,16 @@ CURLOPT_CURLU \- set URL with CURLU *
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CURLU, void *pointer); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CURLU, void *pointer);
.SH DESCRIPTION .SH DESCRIPTION
Pass in a pointer to the \fIURL\fP to work with. The parameter should be a Pass in a pointer to the \fIURL\fP to work with. The parameter should be a
CURLU *. Setting \fICURLOPT_CURLU(3)\fP will explicitly override \fICURLOPT_URL(3)\fP. CURLU *. Setting \fICURLOPT_CURLU(3)\fP will explicitly override
\fICURLOPT_URL(3)\fP.
\fICURLOPT_URL(3)\fP or \fICURLOPT_CURLU(3)\fP \fBmust\fP be set before a
transfer is started.
libcurl will use this handle and its contents read-only and will not change
its contents. An application can very well update the contents of the URL
handle after a transfer is done and if the same handle is then used in a
subsequest request the updated contents will then be used.
.SH DEFAULT .SH DEFAULT
The default value of this parameter is NULL. The default value of this parameter is NULL.
.SH PROTOCOLS .SH PROTOCOLS

View File

@ -58,7 +58,10 @@ use for this transfer, independent of what libcurl has been compiled to
support. That may be useful if you accept the URL from an external source and support. That may be useful if you accept the URL from an external source and
want to limit the accessibility. want to limit the accessibility.
\fICURLOPT_URL(3)\fP is the only option that \fBmust\fP be set before a The \fICURLOPT_URL(3)\fP string will be ignored if \fICURLOPT_CURLU(3)\fP is
set.
\fICURLOPT_URL(3)\fP or \fICURLOPT_CURLU(3)\fP \fBmust\fP be set before a
transfer is started. transfer is started.
The host part of the URL contains the address of the server that you want to The host part of the URL contains the address of the server that you want to
@ -350,4 +353,4 @@ similar is called.
.BR CURLOPT_VERBOSE "(3), " CURLOPT_PROTOCOLS "(3), " .BR CURLOPT_VERBOSE "(3), " CURLOPT_PROTOCOLS "(3), "
.BR CURLOPT_FORBID_REUSE "(3), " CURLOPT_FRESH_CONNECT "(3), " .BR CURLOPT_FORBID_REUSE "(3), " CURLOPT_FRESH_CONNECT "(3), "
.BR curl_easy_perform "(3), " .BR curl_easy_perform "(3), "
.BR CURLINFO_REDIRECT_URL "(3), " CURLOPT_PATH_AS_IS "(3), " .BR CURLINFO_REDIRECT_URL "(3), " CURLOPT_PATH_AS_IS "(3), " CURLOPT_CURLU "(3), "