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
       coreutils basic commands	(cp, mv, dd, tar, gzip/gunzip, cat, etc.) cur-
       rently  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
	      display)

       -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
	      multiple times on	the command line.

       -p (--pid id)
	      monitor only this	numeric	process	ID (ex:	`pidof firefox`). This
	      option 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
	      option  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
       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).

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

home | help