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_TCP_NODELAY(3)              libcurl             CURLOPT_TCP_NODELAY(3)

NAME
       CURLOPT_TCP_NODELAY - the TCP_NODELAY option

SYNOPSIS
       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TCP_NODELAY, long nodelay);

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  has
       no effect after the connection has been established.

       Setting this option to 1L disables TCP's Nagle algorithm on connections
       created using this handle. The purpose of this algorithm is to  try  to
       minimize the number of small packets on the network (where "small pack-
       ets" means TCP segments less than the Maximum Segment Size for the net-
       work).

       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, "https://example.com");
         /* leave Nagle enabled */
         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_BUFFERSIZE(3),         CURLOPT_SOCKOPTFUNCTION(3),         CUR-
       LOPT_TCP_KEEPALIVE(3)

ibcurl 8.4.0                  September 26, 2023        CURLOPT_TCP_NODELAY(3)

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

home | help