xref: /aosp_15_r20/external/curl/docs/cmdline-opts/connect-timeout.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker---
2*6236dae4SAndroid Build Coastguard Workerc: Copyright (C) Daniel Stenberg, <[email protected]>, et al.
3*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl
4*6236dae4SAndroid Build Coastguard WorkerLong: connect-timeout
5*6236dae4SAndroid Build Coastguard WorkerArg: <seconds>
6*6236dae4SAndroid Build Coastguard WorkerHelp: Maximum time allowed to connect
7*6236dae4SAndroid Build Coastguard WorkerCategory: connection timeout
8*6236dae4SAndroid Build Coastguard WorkerAdded: 7.7
9*6236dae4SAndroid Build Coastguard WorkerMulti: single
10*6236dae4SAndroid Build Coastguard WorkerSee-also:
11*6236dae4SAndroid Build Coastguard Worker  - max-time
12*6236dae4SAndroid Build Coastguard WorkerExample:
13*6236dae4SAndroid Build Coastguard Worker  - --connect-timeout 20 $URL
14*6236dae4SAndroid Build Coastguard Worker  - --connect-timeout 3.14 $URL
15*6236dae4SAndroid Build Coastguard Worker---
16*6236dae4SAndroid Build Coastguard Worker
17*6236dae4SAndroid Build Coastguard Worker# `--connect-timeout`
18*6236dae4SAndroid Build Coastguard Worker
19*6236dae4SAndroid Build Coastguard WorkerMaximum time in seconds that you allow curl's connection to take. This only
20*6236dae4SAndroid Build Coastguard Workerlimits the connection phase, so if curl connects within the given period it
21*6236dae4SAndroid Build Coastguard Workercontinues - if not it exits.
22*6236dae4SAndroid Build Coastguard Worker
23*6236dae4SAndroid Build Coastguard WorkerThis option accepts decimal values (added in 7.32.0). The decimal value needs
24*6236dae4SAndroid Build Coastguard Workerto be provided using a dot (.) as decimal separator - not the local version
25*6236dae4SAndroid Build Coastguard Workereven if it might be using another separator.
26*6236dae4SAndroid Build Coastguard Worker
27*6236dae4SAndroid Build Coastguard WorkerThe connection phase is considered complete when the DNS lookup and requested
28*6236dae4SAndroid Build Coastguard WorkerTCP, TLS or QUIC handshakes are done.
29