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