CURLOPT_NOPROXY(3)

CURLOPT_NOPROXY(3)  curl_easy_setopt options   CURLOPT_NOPROXY(3)

NAME

     CURLOPT_NOPROXY - disable proxy use for specific hosts

SYNOPSIS

     #include <curl/curl.h>

     CURLcode  curl_easy_setopt(CURL  *handle,   CURLOPT_NOPROXY,
     char *noproxy);

DESCRIPTION

     Pass a pointer to a zero terminated string. The string  con-
     sists  of  a  comma separated list of host names that do not
     require a proxy to get reached, even if  one  is  specified.
     The  only  wildcard available is a single * character, which
     matches all hosts, and effectively disables the proxy.  Each
     name  in  this list is matched as either a domain which con-
     tains the hostname, or the  hostname  itself.  For  example,
     example.com  would  match  example.com,  example.com:80, and
     www.example.com,    but    not    www.notanexample.com    or
     example.com.othertld.

     If the name in the noproxy list has a leading period, it  is
     a  domain  match  against  the  provided host name. This way
     ".example.com"  will  switch  off   proxy   use   for   both
     "www.example.com" as well as for "foo.example.com".

     Setting the noproxy string to  ""  (an  empty  string)  will
     explicitly  enable  the  proxy  for  all host names, even if
     there is an environment variable set for it.

     The application does not have  to  keep  the  string  around
     after setting this option.

Environment variables

     See CURLOPT_PROXY(3)

DEFAULT

     NULL

PROTOCOLS

     Most

EXAMPLE

     CURL *curl = curl_easy_init();
     if(curl) {
       /* accept various URLs */
       curl_easy_setopt(curl, CURLOPT_URL, input);
       /* use this proxy */
       curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:80");
       /* ... but make sure this host name is not proxied */
       curl_easy_setopt(curl, CURLOPT_NOPROXY, "www.example.com");
       curl_easy_perform(curl);

libcurl 7.58.0   Last change: September 24, 2017                1

CURLOPT_NOPROXY(3)  curl_easy_setopt options   CURLOPT_NOPROXY(3)

     }

AVAILABILITY

     Added in 7.19.4

RETURN VALUE

     Returns   CURLE_OK   if    the    option    is    supported,
     CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there
     was insufficient heap space.

SEE ALSO

     CURLOPT_PROXY(3), CURLOPT_PROXYAUTH(3),

libcurl 7.58.0   Last change: September 24, 2017                2