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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_TCP_NODELAY(3)	   curl_easy_setopt options	CURLOPT_TCP_NODELAY(3)

NAME
       CURLOPT_TCP_NODELAY - set the TCP_NODELAY option

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	curl_easy_setopt(CURL *handle, CURLOPT_TCP_NODELAY, long node-
       lay);

DESCRIPTION
       Pass a long specifying whether the TCP_NODELAY option is	to be  set  or
       cleared	(1L = set, 0 = clear). The option is set by default. This will
       have no effect after the	connection has been established.

       Setting this option to 1L will disable TCP's Nagle  algorithm  on  this
       connection.  The	 purpose  of  this algorithm is	to try to minimize the
       number of small packets on the network (where "small packets" means TCP
       segments	less than the Maximum Segment Size (MSS) for the network).

       Maximizing  the	amount of data sent per	TCP segment is good because it
       amortizes the overhead of the send. However, in some cases  small  seg-
       ments  may  need	 to be sent without delay. This	is less	efficient than
       sending larger amounts of data at a time, and can contribute to conges-
       tion on the network if overdone.

DEFAULT
       1

PROTOCOLS
       All

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl)	{
	 curl_easy_setopt(curl,	CURLOPT_URL, "http://example.com");
	 /* disable Nagle */
	 curl_easy_setopt(curl,	CURLOPT_TCP_NODELAY, 0);
	 curl_easy_perform(curl);
       }

AVAILABILITY
       Always. The default was changed to 1 from 0 in 7.50.2.

RETURN VALUE
       Returns CURLE_OK

SEE ALSO
       CURLOPT_SOCKOPTFUNCTION(3), CURLOPT_TCP_KEEPALIVE(3),

libcurl	7.72.0			March 23, 2020		CURLOPT_TCP_NODELAY(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_TCP_NODELAY&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help