Scroll to navigation

PROGRESS(1) General Commands Manual PROGRESS(1)

NAME

progress - Coreutils Progress Viewer

SYNOPSIS

progress [ -qdwmM ] [ -W secs ] [ -c command ] [ -a command ] [ -p pid ]
progress -v | --version
progress -h | --help

DESCRIPTION

This manual page briefly documents the progress command.

This tool can be described as a Tiny, Dirty, C command that looks for coreutils basic commands (cp, mv, dd, tar, gzip/gunzip, cat, etc.) currently running on your system and displays the percentage of copied data.

It can now also estimate throughput (using flag -w).

OPTIONS

hides all messages
shows all warning/error messages
estimate I/O throughput and estimated remaining time (slower display)
wait 'secs' seconds for I/O estimation (implies -w)
loop while monitored processes are still running
like monitor but never stop (similar to watch progress)
monitor only this command name (ex: firefox). This option can be used multiple times on the command line.
add this command to the default list. This option can be used multiple times on the command line.
monitor only this numeric process ID (ex: `pidof firefox`). This option can be used multiple times on the command line.
do not report a process for 'file'. If the file does not exist yet, you must give a full and clean absolute path. This option can be used multiple times on the command line.
report only files opened for read or write by the process. This option is useful when you want to monitor only output files (or input ones) of a process.
show program version and exit
display help message and exit

ENVIRONMENT

It's possible to give permanent options using PROGRESS_ARGS environment variable. See example below. Command line arguments take precedence over environment.

EXAMPLES

Continuously monitor all current and upcoming instances of coreutils commands

watch progress -q

See how your download is progressing

watch progress -wc firefox

Look at your Web server activity

progress -c httpd

Launch and monitor any heavy command using $!

cp bigfile newfile & progress -mp $!

Use environment variable to set permanent (multiple) arguments

export PROGRESS_ARGS='-M --ignore-file ~/.xsession-errors'

BUGS

Please report bugs at: http://github.com/Xfennec/progress/issues

HOMEPAGE

http://github.com/Xfennec/progress

AUTHOR

This manual page was written by Thomas Zimmermann <bugs@vdm-design.de>, for the openSUSE project (and may be used by others).

January 22, 2016 progress