aboutsummaryrefslogtreecommitdiff
path: root/docs/libcurl/curl_url_set.3
diff options
context:
space:
mode:
authorJens Finkhaeuser <jens@finkhaeuser.de>2019-09-19 15:54:53 +0200
committerDaniel Stenberg <daniel@haxx.se>2019-09-19 15:57:28 +0200
commit0a4ecbdf1c35de3a0a367db73edbf50fabc0fb0e (patch)
tree6683941b25029f617b35d5ca9787391680bdb3c9 /docs/libcurl/curl_url_set.3
parent346188f6e455ab99f1d040e3ba474b80e9694bda (diff)
urlapi: CURLU_NO_AUTHORITY allows empty authority/host part
CURLU_NO_AUTHORITY is intended for use with unknown schemes (i.e. not "file:///") to override cURL's default demand that an authority exists. Closes #4349
Diffstat (limited to 'docs/libcurl/curl_url_set.3')
-rw-r--r--docs/libcurl/curl_url_set.36
1 files changed, 6 insertions, 0 deletions
diff --git a/docs/libcurl/curl_url_set.3 b/docs/libcurl/curl_url_set.3
index 43d741220..e2e2c1887 100644
--- a/docs/libcurl/curl_url_set.3
+++ b/docs/libcurl/curl_url_set.3
@@ -111,6 +111,12 @@ instead "guesses" which scheme that was intended based on the host name. If
the outermost sub-domain name matches DICT, FTP, IMAP, LDAP, POP3 or SMTP then
that scheme will be used, otherwise it picks HTTP. Conflicts with the
\fICURLU_DEFAULT_SCHEME\fP option which takes precedence if both are set.
+.IP CURLU_NO_AUTHORITY
+If set, skips authority checks. The RFC allows individual schemes to omit the
+host part (normally the only mandatory part of the authority), but libcurl
+cannot know whether this is permitted for custom schemes. Specifying the flag
+permits empty authority sections, similar to how file scheme is handled.
+
.SH RETURN VALUE
Returns a CURLUcode error value, which is CURLUE_OK (0) if everything went
fine.