diff options
author | Jens Finkhaeuser <jens@finkhaeuser.de> | 2019-09-19 15:54:53 +0200 |
---|---|---|
committer | Daniel Stenberg <daniel@haxx.se> | 2019-09-19 15:57:28 +0200 |
commit | 0a4ecbdf1c35de3a0a367db73edbf50fabc0fb0e (patch) | |
tree | 6683941b25029f617b35d5ca9787391680bdb3c9 /docs/libcurl/curl_url_set.3 | |
parent | 346188f6e455ab99f1d040e3ba474b80e9694bda (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.3 | 6 |
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. |