OpenSuSE Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
x SuSE Linux 13.1-RELEASE x
x SuSE Linux 13.1-RELEASEx
CURLOPT_FRESH_CONNECT(3)            libcurl           CURLOPT_FRESH_CONNECT(3)

NAME
       CURLOPT_FRESH_CONNECT - force a new connection to be used

SYNOPSIS
       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FRESH_CONNECT, long fresh);

DESCRIPTION
       Pass  a long. Set to 1 to make the next transfer use a new (fresh) con-
       nection by force instead of trying  to  reuse  an  existing  one.  This
       option  should  be used with caution and only if you understand what it
       does as it may impact performance negatively.

       Related functionality is CURLOPT_FORBID_REUSE(3) which makes  sure  the
       connection is closed after use so that it cannot be reused.

       Set  fresh  to 0 to have libcurl attempt reusing an existing connection
       (default behavior).

DEFAULT
       0

PROTOCOLS
       Most

EXAMPLE
       {
         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
         curl_easy_setopt(curl, CURLOPT_FRESH_CONNECT, 1L);
         /* this transfer must use a new connection, not reuse an existing */
         curl_easy_perform(curl);
       }

AVAILABILITY
       Always

RETURN VALUE
       Returns CURLE_OK

SEE ALSO
       CURLOPT_FORBID_REUSE(3),    CURLOPT_MAXAGE_CONN(3),    CURLOPT_MAXLIFE-
       TIME_CONN(3)

ibcurl 8.4.0                  September 26, 2023      CURLOPT_FRESH_CONNECT(3)

Want to link to this manual page? Use this URL:
<
http://star2.abcm.com/cgi-bin/bsdi-man?query=CURLOPT_FRESH_CONNECT&sektion=3&manpath=>

home | help