1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
.TH PROGRESS 1 "January 22, 2016" "progress"
.SH NAME
progress \- Coreutils Progress Viewer
.SH SYNOPSIS
.B progress
[
.B \-qdwmM
] [
.B \-W
.I secs
] [
.B \-c
.I command
] [
.B \-a
.I command
] [
.B \-p
.I pid
]
.br
.B progress -v
|
.B \-\-version
.br
.B progress \-h
|
.B \-\-help
.br
.SH DESCRIPTION
This manual page briefly documents the \fBprogress\fP command.
.PP
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
.BR \-w ).
.SH OPTIONS
.TP
.B \-q (\-\-quiet)
hides all messages
.TP
.B \-d (\-\-debug)
shows all warning/error messages
.TP
.B \-w (\-\-wait)
estimate I/O throughput and estimated remaining time (slower display)
.TP
.B \-W (\-\-wait\-delay secs)
wait 'secs' seconds for I/O estimation (implies
.BR \-w )
.TP
.B \-m (\-\-monitor)
loop while monitored processes are still running
.TP
.B \-M (\-\-monitor\-continuously)
like monitor but never stop (similar to
.BR "watch progress" )
.TP
.B \-c (\-\-command cmd)
monitor only this command name (ex: firefox). This option can be used multiple
times on the command line.
.TP
.B \-a (\-\-additional-command cmd)
add this command to the default list. This option can be used multiple
times on the command line.
.TP
.B \-p (\-\-pid id)
monitor only this numeric process ID (ex: \`pidof firefox\`). This option can
be used multiple times on the command line.
.TP
.B \-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.
.TP
.B \-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.
.TP
.B \-v (\-\-version)
show program version and exit
.TP
.B \-h (\-\-help)
display help message and exit
.SH ENVIRONMENT
It's possible to give permanent options using PROGRESS_ARGS environment variable.
See example below. Command line arguments take precedence over environment.
.SH EXAMPLES
Continuously monitor all current and upcoming instances of coreutils commands
.RS
.B watch progress \-q
.RE
See how your download is progressing
.RS
.B watch progress \-wc firefox
.RE
Look at your Web server activity
.RS
.B progress \-c httpd
.RE
Launch and monitor any heavy command using $!
.RS
.B cp bigfile newfile & progress \-mp $!
.RE
Use environment variable to set permanent (multiple) arguments
.RS
.B export PROGRESS_ARGS='-M \-\-ignore-file ~/.xsession-errors'
.RE
.SH BUGS
Please report bugs at: http://github.com/Xfennec/progress/issues
.SH HOMEPAGE
http://github.com/Xfennec/progress
.SH AUTHOR
This manual page was written by Thomas Zimmermann <bugs@vdm-design.de>,
for the openSUSE project (and may be used by others).
|
