Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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 core-
     utils  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
     -q (--quiet)
	    hides all messages

     -d (--debug)
	    shows all warning/error messages

     -w (--wait)
	    estimate I/O throughput and estimated remaining  time  (slower  dis-
	    play)

     -W (--wait-delay secs)
	    wait 'secs' seconds for I/O estimation (implies -w)

     -m (--monitor)
	    loop while monitored processes are still running

     -M (--monitor-continuously)
	    like monitor but never stop (similar to watch progress)

     -c (--command cmd)
	    monitor  only  this  command  name (ex: firefox). This option can be
	    used multiple times on the command line.

     -a (--additional-command cmd)
	    add this command to the default list. This option can be used multi-
	    ple times on the command line.

     -p (--pid id)
	    monitor only this numeric process ID (ex: `pidof firefox`). This op-
	    tion can be used multiple times on the command line.

     -i (--ignore-file file)
	    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.

     -o (--open-mode {r|w})
	    report only files opened for read or write by the process. This  op-
	    tion  is useful when you want to monitor only output files (or input
	    ones) of a process.

     -v (--version)
	    show program version and exit

     -h (--help)
	    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  com-
     mands

	    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).

progress			January 22, 2016		     PROGRESS(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=progress&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help