Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_FRESH_CONNECT(3)   curl_easy_setopt options   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 re-use an existing	one.  This op-
       tion should be used with	caution	and only if  you  understand  what  it
       does as it may seriously	impact performance.

       Related	functionality  is CURLOPT_FORBID_REUSE(3) which	makes sure the
       connection is closed after use so that it won't be re-used.

       Set fresh to 0 to have libcurl attempt re-using 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),

libcurl	7.54.1			 May 31, 2017	      CURLOPT_FRESH_CONNECT(3)

NAME | SYNOPSIS | DESCRIPTION | DEFAULT | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CURLOPT_FRESH_CONNECT&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help