DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CURLOPT_FORBID_REUSE(3)





CURLOPT_FORBID_REUSE(3curl_easy_setopt optionCURLOPT_FORBID_REUSE(3)



NAME

     CURLOPT_FORBID_REUSE - make connection get  closed  at  once
     after use


SYNOPSIS

     #include <curl/curl.h>

     CURLcode           curl_easy_setopt(CURL            *handle,
     CURLOPT_FORBID_REUSE, long close);


DESCRIPTION

     Pass a long. Set close to 1 to make libcurl explicitly close
     the  connection  when done with the transfer. Normally, lib-
     curl keeps all connections alive when done with one transfer
     in case a succeeding one follows that can re-use them.  This
     option should be used with caution and only  if  you  under-
     stand what it does as it can seriously impact performance.

     Set to 0 to have libcurl keep the connection open for possi-
     ble later re-use (default behavior).


DEFAULT

     0


PROTOCOLS

     Most


EXAMPLE

     {
       curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
       curl_easy_setopt(curl, CURLOPT_FORBID_REUSE, 1L);
       curl_easy_perform(curl);

       /* this second transfer may not reuse the same connection */
       curl_easy_perform(curl);
     }


AVAILABILITY

     Always


RETURN VALUE

     Returns CURLE_OK


SEE ALSO

     CURLOPT_FRESH_CONNECT(3), CURLOPT_MAXCONNECTS(3),

libcurl 7.58.0      Last change: May 31, 2017                   1


Man(1) output converted with man2html