keepalive-time.md (1103B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Long: keepalive-time 5 Arg: <seconds> 6 Help: Interval time for keepalive probes 7 Added: 7.18.0 8 Category: connection timeout 9 Multi: single 10 See-also: 11 - no-keepalive 12 - keepalive-cnt 13 - max-time 14 Example: 15 - --keepalive-time 20 $URL 16 --- 17 18 # `--keepalive-time` 19 20 Set the time a connection needs to remain idle before sending keepalive probes 21 and the time between individual keepalive probes. It is currently effective on 22 operating systems offering the `TCP_KEEPIDLE` and `TCP_KEEPINTVL` socket 23 options (meaning Linux, *BSD/macOS, Windows, Solaris, and recent AIX, HP-UX and more). 24 Keepalive is used by the TCP stack to detect broken networks on idle connections. 25 The number of missed keepalive probes before declaring the connection down is OS 26 dependent and is commonly 8 (*BSD/macOS/AIX), 9 (Linux/AIX) or 5/10 (Windows), and 27 this number can be changed by specifying the curl option `keepalive-cnt`. 28 Note that this option has no effect if --no-keepalive is used. 29 30 If unspecified, the option defaults to 60 seconds.