From 0a4ecbdf1c35de3a0a367db73edbf50fabc0fb0e Mon Sep 17 00:00:00 2001 From: Jens Finkhaeuser Date: Thu, 19 Sep 2019 15:54:53 +0200 Subject: 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 --- docs/libcurl/curl_url_set.3 | 6 ++++++ docs/libcurl/symbols-in-versions | 1 + 2 files changed, 7 insertions(+) (limited to 'docs/libcurl') 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. diff --git a/docs/libcurl/symbols-in-versions b/docs/libcurl/symbols-in-versions index 9daad949f..ff0dfb238 100644 --- a/docs/libcurl/symbols-in-versions +++ b/docs/libcurl/symbols-in-versions @@ -779,6 +779,7 @@ CURLU_DISALLOW_USER 7.62.0 CURLU_GUESS_SCHEME 7.62.0 CURLU_NON_SUPPORT_SCHEME 7.62.0 CURLU_NO_DEFAULT_PORT 7.62.0 +CURLU_NO_AUTHORITY 7.67.0 CURLU_PATH_AS_IS 7.62.0 CURLU_URLDECODE 7.62.0 CURLU_URLENCODE 7.62.0 -- cgit v1.2.3