xref: /aosp_15_r20/external/curl/docs/cmdline-opts/parallel.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 WorkerShort: Z
5*6236dae4SAndroid Build Coastguard WorkerLong: parallel
6*6236dae4SAndroid Build Coastguard WorkerHelp: Perform transfers in parallel
7*6236dae4SAndroid Build Coastguard WorkerAdded: 7.66.0
8*6236dae4SAndroid Build Coastguard WorkerCategory: connection curl global
9*6236dae4SAndroid Build Coastguard WorkerMulti: boolean
10*6236dae4SAndroid Build Coastguard WorkerScope: global
11*6236dae4SAndroid Build Coastguard WorkerSee-also:
12*6236dae4SAndroid Build Coastguard Worker  - next
13*6236dae4SAndroid Build Coastguard Worker  - verbose
14*6236dae4SAndroid Build Coastguard Worker  - parallel-max
15*6236dae4SAndroid Build Coastguard Worker  - parallel-immediate
16*6236dae4SAndroid Build Coastguard WorkerExample:
17*6236dae4SAndroid Build Coastguard Worker  - --parallel $URL -o file1 $URL -o file2
18*6236dae4SAndroid Build Coastguard Worker---
19*6236dae4SAndroid Build Coastguard Worker
20*6236dae4SAndroid Build Coastguard Worker# `--parallel`
21*6236dae4SAndroid Build Coastguard Worker
22*6236dae4SAndroid Build Coastguard WorkerMakes curl perform all transfers in parallel as compared to the regular serial
23*6236dae4SAndroid Build Coastguard Workermanner. Parallel transfer means that curl runs up to N concurrent transfers
24*6236dae4SAndroid Build Coastguard Workersimultaneously and if there are more than N transfers to handle, it starts new
25*6236dae4SAndroid Build Coastguard Workerones when earlier transfers finish.
26*6236dae4SAndroid Build Coastguard Worker
27*6236dae4SAndroid Build Coastguard WorkerWith parallel transfers, the progress meter output is different than when
28*6236dae4SAndroid Build Coastguard Workerdoing serial transfers, as it then displays the transfer status for multiple
29*6236dae4SAndroid Build Coastguard Workertransfers in a single line.
30*6236dae4SAndroid Build Coastguard Worker
31*6236dae4SAndroid Build Coastguard WorkerThe maximum amount of concurrent transfers is set with --parallel-max and it
32*6236dae4SAndroid Build Coastguard Workerdefaults to 50.
33