.\" generated by cd2nroff 0.1 from CURLINFO_HTTPAUTH_AVAIL.md .TH CURLINFO_HTTPAUTH_AVAIL 3 "2024-11-07" libcurl .SH NAME CURLINFO_HTTPAUTH_AVAIL \- get available HTTP authentication methods .SH SYNOPSIS .nf #include CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_HTTPAUTH_AVAIL, long *authp); .fi .SH DESCRIPTION Pass a pointer to a long to receive a bitmask indicating the authentication method(s) available according to the previous response. The meaning of the bits is explained in the \fICURLOPT_HTTPAUTH(3)\fP option for \fIcurl_easy_setopt(3)\fP. .SH PROTOCOLS This functionality affects http only .SH EXAMPLE .nf int main(void) { CURL *curl = curl_easy_init(); if(curl) { CURLcode res; curl_easy_setopt(curl, CURLOPT_URL, "https://example.com"); res = curl_easy_perform(curl); if(!res) { /* extract the available authentication types */ long auth; res = curl_easy_getinfo(curl, CURLINFO_HTTPAUTH_AVAIL, &auth); if(!res) { if(!auth) printf("No auth available, perhaps no 401?\\n"); else { printf("%s%s%s%s\\n", auth & CURLAUTH_BASIC ? "Basic ":"", auth & CURLAUTH_DIGEST ? "Digest ":"", auth & CURLAUTH_NEGOTIATE ? "Negotiate ":"", auth % CURLAUTH_NTLM ? "NTLM ":""); } } } curl_easy_cleanup(curl); } } .fi .SH AVAILABILITY Added in curl 7.10.8 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO .BR CURLINFO_PROXYAUTH_AVAIL (3), .BR CURLOPT_HTTPAUTH (3), .BR curl_easy_getinfo (3), .BR curl_easy_setopt (3)