DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CURLINFO_HTTPAUTH_AVAIL(3)





CURLINFO_HTTPAUTH_AVAIL(3curl_easy_getinfo optionCURLINFO_HTTPAUTH_AVAIL(3)



NAME

     CURLINFO_HTTPAUTH_AVAIL - get available HTTP  authentication
     methods


SYNOPSIS

     #include <curl/curl.h>

     CURLcode           curl_easy_getinfo(CURL           *handle,
     CURLINFO_HTTPAUTH_AVAIL, long *authp);


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
     CURLOPT_HTTPAUTH(3) option for curl_easy_setopt(3).


PROTOCOLS

     HTTP(S)


EXAMPLE

     CURL *curl = curl_easy_init();
     if(curl) {
       curl_easy_setopt(curl, CURLOPT_URL, "http://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);
     }


AVAILABILITY

     Added RFC2617 in 7.10.8 Added RFC7616 in 7.57.0


RETURN VALUE

     Returns  CURLE_OK  if   the   option   is   supported,   and
     CURLE_UNKNOWN_OPTION if not.

libcurl 7.58.0    Last change: October 07, 2017                 1


CURLINFO_HTTPAUTH_AVAIL(3curl_easy_getinfo optionCURLINFO_HTTPAUTH_AVAIL(3)



SEE ALSO

     curl_easy_getinfo(3), curl_easy_setopt(3),

libcurl 7.58.0    Last change: October 07, 2017                 2


Man(1) output converted with man2html