curl_url_set.3: clarify by default using known schemes only

Closes #8994
This commit is contained in:
Daniel Stenberg 2022-06-12 12:53:54 +02:00
parent 18a01e3229
commit 965119855d
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2

View File

@ -18,6 +18,8 @@
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY .\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied. .\" * KIND, either express or implied.
.\" * .\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" ************************************************************************** .\" **************************************************************************
.TH curl_url_set 3 "6 Aug 2018" "libcurl" "libcurl Manual" .TH curl_url_set 3 "6 Aug 2018" "libcurl" "libcurl Manual"
.SH NAME .SH NAME
@ -46,6 +48,12 @@ call.
Setting a part to a NULL pointer will effectively remove that part's contents Setting a part to a NULL pointer will effectively remove that part's contents
from the CURLU handle. from the CURLU handle.
By default, this API only accepts URLs using schemes for protocols that are
supported built-in. To make libcurl parse URLs generically even for schemes it
does not know about, the \fBCURLU_NON_SUPPORT_SCHEME\fP flags bit must be
set. Otherwise, this function returns \fICURLUE_UNSUPPORTED_SCHEME\fP on URL
schemes it does not recognize.
The \fIflags\fP argument is a bitmask with independent features. The \fIflags\fP argument is a bitmask with independent features.
.SH PARTS .SH PARTS
.IP CURLUPART_URL .IP CURLUPART_URL