xref: /curl/docs/cmdline-opts/connect-timeout.md (revision 2abfc759)
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: connect-timeout
5Arg: <seconds>
6Help: Maximum time allowed to connect
7Category: connection timeout
8Added: 7.7
9Multi: single
10See-also:
11  - max-time
12Example:
13  - --connect-timeout 20 $URL
14  - --connect-timeout 3.14 $URL
15---
16
17# `--connect-timeout`
18
19Maximum time in seconds that you allow curl's connection to take. This only
20limits the connection phase, so if curl connects within the given period it
21continues - if not it exits.
22
23This option accepts decimal values (added in 7.32.0). The decimal value needs
24to be provided using a dot (.) as decimal separator - not the local version
25even if it might be using another separator.
26
27The connection phase is considered complete when the DNS lookup and requested
28TCP, TLS or QUIC handshakes are done.
29