xf.li | 6c8fc1e | 2023-08-12 00:11:09 -0700 | [diff] [blame] | 1 | c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al. |
| 2 | SPDX-License-Identifier: curl |
| 3 | Long: keepalive-time |
| 4 | Arg: <seconds> |
| 5 | Help: Interval time for keepalive probes |
| 6 | Added: 7.18.0 |
| 7 | Category: connection |
| 8 | Example: --keepalive-time 20 $URL |
| 9 | See-also: no-keepalive max-time |
| 10 | Multi: single |
| 11 | --- |
| 12 | This option sets the time a connection needs to remain idle before sending |
| 13 | keepalive probes and the time between individual keepalive probes. It is |
| 14 | currently effective on operating systems offering the TCP_KEEPIDLE and |
| 15 | TCP_KEEPINTVL socket options (meaning Linux, recent AIX, HP-UX and more). |
| 16 | Keepalives are used by the TCP stack to detect broken networks on idle |
| 17 | connections. The number of missed keepalive probes before declaring the |
| 18 | connection down is OS dependent and is commonly 9 or 10. This option has no |
| 19 | effect if --no-keepalive is used. |
| 20 | |
| 21 | If unspecified, the option defaults to 60 seconds. |