CURLOPT_TCP_KEEPINTVL(3)

CURLOPT_TCP_KEEPINTVL(3curl_easy_setopt optionCURLOPT_TCP_KEEPINTVL(3)

NAME

     CURLOPT_TCP_KEEPINTVL - set TCP keep-alive interval

SYNOPSIS

     #include <curl/curl.h>

     CURLcode           curl_easy_setopt(CURL            *handle,
     CURLOPT_TCP_KEEPINTVL, long interval);

DESCRIPTION

     Pass a long. Sets the interval, in seconds, that the operat-
     ing  system  will wait between sending keepalive probes. Not
     all operating systems support this option. (Added in 7.25.0)

DEFAULT

     60

PROTOCOLS

     All

EXAMPLE

     CURL *curl = curl_easy_init();
     if(curl) {
       curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

       /* enable TCP keep-alive for this transfer */
       curl_easy_setopt(curl, CURLOPT_TCP_KEEPALIVE, 1L);

       /* set keep-alive idle time to 120 seconds */
       curl_easy_setopt(curl, CURLOPT_TCP_KEEPIDLE, 120L);

       /* interval time between keep-alive probes: 60 seconds */
       curl_easy_setopt(curl, CURLOPT_TCP_KEEPINTVL, 60L);

       curl_easy_perform(curl);
     }

AVAILABILITY

     Always

RETURN VALUE

     Returns  CURLE_OK  if   the   option   is   supported,   and
     CURLE_UNKNOWN_OPTION if not.

SEE ALSO

     CURLOPT_TCP_KEEPALIVE(3), CURLOPT_TCP_KEEPIDLE(3),

libcurl 7.58.0    Last change: January 02, 2017                 1