xref: /aosp_15_r20/external/curl/docs/cmdline-opts/http3-only.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: http3-only
5*6236dae4SAndroid Build Coastguard WorkerTags: Versions
6*6236dae4SAndroid Build Coastguard WorkerProtocols: HTTP
7*6236dae4SAndroid Build Coastguard WorkerAdded: 7.88.0
8*6236dae4SAndroid Build Coastguard WorkerMutexed: http1.1 http1.0 http2 http2-prior-knowledge http3
9*6236dae4SAndroid Build Coastguard WorkerRequires: HTTP/3
10*6236dae4SAndroid Build Coastguard WorkerHelp: Use HTTP v3 only
11*6236dae4SAndroid Build Coastguard WorkerCategory: http
12*6236dae4SAndroid Build Coastguard WorkerMulti: mutex
13*6236dae4SAndroid Build Coastguard WorkerSee-also:
14*6236dae4SAndroid Build Coastguard Worker  - http1.1
15*6236dae4SAndroid Build Coastguard Worker  - http2
16*6236dae4SAndroid Build Coastguard Worker  - http3
17*6236dae4SAndroid Build Coastguard WorkerExample:
18*6236dae4SAndroid Build Coastguard Worker  - --http3-only $URL
19*6236dae4SAndroid Build Coastguard Worker---
20*6236dae4SAndroid Build Coastguard Worker
21*6236dae4SAndroid Build Coastguard Worker# `--http3-only`
22*6236dae4SAndroid Build Coastguard Worker
23*6236dae4SAndroid Build Coastguard WorkerInstructs curl to use HTTP/3 to the host in the URL, with no fallback to
24*6236dae4SAndroid Build Coastguard Workerearlier HTTP versions. HTTP/3 can only be used for HTTPS and not for HTTP
25*6236dae4SAndroid Build Coastguard WorkerURLs. For HTTP, this option triggers an error.
26*6236dae4SAndroid Build Coastguard Worker
27*6236dae4SAndroid Build Coastguard WorkerThis option allows a user to avoid using the Alt-Svc method of upgrading to
28*6236dae4SAndroid Build Coastguard WorkerHTTP/3 when you know that the target speaks HTTP/3 on the given host and port.
29*6236dae4SAndroid Build Coastguard Worker
30*6236dae4SAndroid Build Coastguard WorkerThis option makes curl fail if a QUIC connection cannot be established, it
31*6236dae4SAndroid Build Coastguard Workerdoes not attempt any other HTTP versions on its own. Use --http3 for similar
32*6236dae4SAndroid Build Coastguard Workerfunctionality *with* a fallback.
33