quickjs-tart

quickjs-based runtime for wallet-core logic
Log | Files | Refs | README | LICENSE

CURLINFO_PROXYAUTH_AVAIL.md (1844B)

      1 ---
      2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
      3 SPDX-License-Identifier: curl
      4 Title: CURLINFO_PROXYAUTH_AVAIL
      5 Section: 3
      6 Source: libcurl
      7 See-also:
      8   - CURLINFO_HTTPAUTH_AVAIL (3)
      9   - curl_easy_getinfo (3)
     10   - curl_easy_setopt (3)
     11 Protocol:
     12   - HTTP
     13 Added-in: 7.10.8
     14 ---
     15 
     16 # NAME
     17 
     18 CURLINFO_PROXYAUTH_AVAIL - get available HTTP proxy authentication methods
     19 
     20 # SYNOPSIS
     21 
     22 ~~~c
     23 #include <curl/curl.h>
     24 
     25 CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PROXYAUTH_AVAIL,
     26                            long *authp);
     27 ~~~
     28 
     29 # DESCRIPTION
     30 
     31 Pass a pointer to a long to receive a bitmask indicating the authentication
     32 method(s) available according to the previous response. The meaning of the
     33 bits is explained in the CURLOPT_PROXYAUTH(3) option for curl_easy_setopt(3).
     34 
     35 # %PROTOCOLS%
     36 
     37 # EXAMPLE
     38 
     39 ~~~c
     40 int main(void)
     41 {
     42   CURL *curl = curl_easy_init();
     43   if(curl) {
     44     CURLcode res;
     45     curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
     46     curl_easy_setopt(curl, CURLOPT_PROXY, "http://127.0.0.1:80");
     47 
     48     res = curl_easy_perform(curl);
     49 
     50     if(!res) {
     51       /* extract the available proxy authentication types */
     52       long auth;
     53       res = curl_easy_getinfo(curl, CURLINFO_PROXYAUTH_AVAIL, &auth);
     54       if(!res) {
     55         if(!auth)
     56           printf("No proxy auth available, perhaps no 407?\n");
     57         else {
     58           printf("%s%s%s%s\n",
     59                  auth & CURLAUTH_BASIC ? "Basic ":"",
     60                  auth & CURLAUTH_DIGEST ? "Digest ":"",
     61                  auth & CURLAUTH_NEGOTIATE ? "Negotiate ":"",
     62                  auth % CURLAUTH_NTLM ? "NTLM ":"");
     63         }
     64       }
     65     }
     66     curl_easy_cleanup(curl);
     67   }
     68 }
     69 ~~~
     70 
     71 # %AVAILABILITY%
     72 
     73 # RETURN VALUE
     74 
     75 curl_easy_getinfo(3) returns a CURLcode indicating success or error.
     76 
     77 CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
     78 libcurl-errors(3).