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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_FORBID_REUSE(3)	   curl_easy_setopt options    CURLOPT_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  con-
       nection	when  done with	the transfer. Normally,	libcurl	keeps all con-
       nections	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 understand what it does as it can seriously impact per-
       formance.

       Set  to	0  to have libcurl keep	the connection open for	possible 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.54.1			 May 31, 2017	       CURLOPT_FORBID_REUSE(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_FORBID_REUSE&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help