table of contents
- bookworm 7.88.1-10+deb12u7
- bookworm-backports 8.10.1-1~bpo12+1
- testing 8.10.1-2
- unstable 8.10.1-2
CURLOPT_DISALLOW_USERNAME_IN_URL(3) | Library Functions Manual | CURLOPT_DISALLOW_USERNAME_IN_URL(3) |
NAME¶
CURLOPT_DISALLOW_USERNAME_IN_URL - disallow specifying username in the URL
SYNOPSIS¶
#include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DISALLOW_USERNAME_IN_URL,
long disallow);
DESCRIPTION¶
A long parameter set to 1 tells the library to not allow URLs that include a username.
This is the equivalent to the CURLU_DISALLOW_USER flag for the curl_url_set(3) function.
DEFAULT¶
0 (disabled) - usernames are allowed by default.
PROTOCOLS¶
All
EXAMPLE¶
int main(void) {
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_DISALLOW_USERNAME_IN_URL, 1L);
curl_easy_perform(curl);
} }
AVAILABILITY¶
Added in 7.61.0
RETURN VALUE¶
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
curl_easy_perform(3) returns CURLE_LOGIN_DENIED if this option is enabled and a URL containing a username is specified.
SEE ALSO¶
CURLOPT_PROTOCOLS(3), CURLOPT_URL(3), curl_url_set(3), libcurl-security(3)
2024-06-09 | libcurl |