xref: /aosp_15_r20/external/curl/docs/cmdline-opts/_PROGRESS.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker<!-- Copyright (C) Daniel Stenberg, <[email protected]>, et al. -->
2*6236dae4SAndroid Build Coastguard Worker<!-- SPDX-License-Identifier: curl -->
3*6236dae4SAndroid Build Coastguard Worker# PROGRESS METER
4*6236dae4SAndroid Build Coastguard Worker
5*6236dae4SAndroid Build Coastguard Workercurl normally displays a progress meter during operations, indicating the
6*6236dae4SAndroid Build Coastguard Workeramount of transferred data, transfer speeds and estimated time left, etc. The
7*6236dae4SAndroid Build Coastguard Workerprogress meter displays the transfer rate in bytes per second. The suffixes
8*6236dae4SAndroid Build Coastguard Worker(k, M, G, T, P) are 1024 based. For example 1k is 1024 bytes. 1M is 1048576
9*6236dae4SAndroid Build Coastguard Workerbytes.
10*6236dae4SAndroid Build Coastguard Worker
11*6236dae4SAndroid Build Coastguard Workercurl displays this data to the terminal by default, so if you invoke curl to
12*6236dae4SAndroid Build Coastguard Workerdo an operation and it is about to write data to the terminal, it *disables*
13*6236dae4SAndroid Build Coastguard Workerthe progress meter as otherwise it would mess up the output mixing progress
14*6236dae4SAndroid Build Coastguard Workermeter and response data.
15*6236dae4SAndroid Build Coastguard Worker
16*6236dae4SAndroid Build Coastguard WorkerIf you want a progress meter for HTTP POST or PUT requests, you need to
17*6236dae4SAndroid Build Coastguard Workerredirect the response output to a file, using shell redirect (\>), --output
18*6236dae4SAndroid Build Coastguard Workeror similar.
19*6236dae4SAndroid Build Coastguard Worker
20*6236dae4SAndroid Build Coastguard WorkerThis does not apply to FTP upload as that operation does not spit out any
21*6236dae4SAndroid Build Coastguard Workerresponse data to the terminal.
22*6236dae4SAndroid Build Coastguard Worker
23*6236dae4SAndroid Build Coastguard WorkerIf you prefer a progress bar instead of the regular meter, --progress-bar is
24*6236dae4SAndroid Build Coastguard Workeryour friend. You can also disable the progress meter completely with the
25*6236dae4SAndroid Build Coastguard Worker--silent option.
26