|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| autoconf/ | H | 12-Sep-2021 | - | 1,408 | 1,018 |
| doc/ | H | 03-May-2022 | - | 2,240 | 1,861 |
| src/ | H | 30-Jun-2017 | - | 9,158 | 6,334 |
| tests/ | H | 30-Jun-2017 | - | 513 | 191 |
| README | H A D | 08-Sep-2021 | 8 KiB | 268 | 179 |
| configure | H A D | 12-Sep-2021 | 191 KiB | 6,889 | 5,842 |
README
1Introduction
2************
3
4This is the README for `pv' ("Pipe Viewer"), a terminal-based tool for
5monitoring the progress of data through a pipeline. It can be inserted into
6any normal pipeline between two processes to give a visual indication of how
7quickly data is passing through, how long it has taken, how near to
8completion it is, and an estimate of how long it will be until completion.
9
10
11Documentation
12*************
13
14A manual page is included in this distribution. See `man ./doc/quickref.1',
15or `man pv' after installation.
16
17
18Compilation
19***********
20
21If this is not a packaged release, first run "./generate.sh".
22
23To compile the package, type "sh ./configure", which should generate a
24Makefile for your system. You may then type "make" to build everything.
25Note that GNU `make' is required; this may be installed as `gmake' on some
26systems, so if typing "make" gives an error, try "gmake" instead.
27
28See the file `doc/INSTALL' for more about the `configure' script.
29
30Developers note that you can do "./configure --enable-debugging" to cause
31debugging support to be built in, and "--enable-profiling" builds in
32profiling support (see "man gprof"). Also note that doing "make index" will
33generate an HTML code index (using "ctags" and "cproto"); this index lists
34all files used, all functions defined, and all TODOs marked in the code.
35
36
37Author and acknowledgements
38***************************
39
40This package is copyright 2021 Andrew Wood, and is being distributed under
41the terms of the Artistic License 2.0. For more details of this license,
42see the file `doc/COPYING'.
43
44Report bugs in `pv' using the contact form linked from the home page.
45
46The `pv' home page is at:
47
48 http://www.ivarch.com/programs/pv.shtml
49
50The latest version can always be found here.
51
52Credit is also due to:
53
54 Jakub Hrozek <jhrozek@redhat.com>
55 - Fedora package maintainer
56
57 Antoine Beaupré <anarcat@debian.org>
58 - Debian package maintainer
59
60 Kevin Coyner <kcoyner@debian.org>
61 Cédric Delfosse <cedric@debian.org>
62 - previous Debian package maintainers
63
64 Eduardo Aguiar <eduardo.oliveira@sondabrasil.com.br>
65 - provided Portuguese (Brazilian) translation
66
67 Stéphane Lacasse <stephane@gorfou.ca>
68 - provided French translation
69
70 Marcos Kreinacke <public@kreinacke.com>
71 - provided German translation
72
73 Bartosz Fe�ski <fenio@o2.pl> <http://skawina.eu.org/>
74 - provided Polish translation along with Krystian Zubel
75
76 Joshua Jensen
77 - reported RPM installation bug
78
79 Boris Folgmann <http://www.folgmann.com/en/>
80 - reported cursor handling bug
81
82 Mathias Gumz
83 - reported NLS bug
84
85 Daniel Roethlisberger
86 - submitted patch to use lockfiles for -c if terminal locking fails
87
88 Adam Buchbinder
89 - lots of help with a Cygwin port of -c
90
91 Mark Tomich <http://metuchen.dyndns.org>
92 - suggested -B option
93
94 Gert Menke
95 - reported bug when piping to dd with a large input buffer size
96
97 Ville Herva <Ville.Herva@iki.fi>
98 - informative bug report about rate limiting performance
99
100 Elias Pipping
101 - patch to compile properly on Darwin 9; potential NULL deref report
102
103 Patrick Collison
104 - similar patch for OS X
105
106 Boris Lohner
107 - reported problem that "-L" does not complain if given non-numeric value
108
109 Sebastian Kayser
110 - supplied testing for SIGPIPE, demonstrated internationalisation problem
111
112 Laszlo Ersek <http://phptest11.atw.hu/>
113 - reported shared memory leak on SIGINT with -c
114
115 Phil Rutschman <http://bandgap.rsnsoft.com/>
116 - provided a patch for fully restoring terminal state on exit
117
118 Henry Precheur <http://henry.precheur.org/>
119 - reporting and suggestions for --rate-limit bug when rate is under 10
120
121 E. Rosten <http://mi.eng.cam.ac.uk/~er258/>
122 - supplied patch for block buffering in line mode
123
124 Kjetil Torgrim Homme
125 - reported compilation error with default CFLAGS on non-GCC compilers
126
127 Alexandre de Verteuil
128 - reported bug in OS X build and supplied test environment to fix in
129
130 Martin Baum
131 - supplied patch to return nonzero exit status if terminated by signal
132
133 Sam Nelson <http://www.siliconfuture.net/>
134 - supplied patch to fix trailing slash on DESTDIR
135
136 Daniel Pape
137 - reported Cygwin installation problem due to DESTDIR
138
139 Philipp Beckers
140 - ported to the Syabas PopcornHour A-100 series
141
142 Henry Gebhard <hsggebhardt@googlemail.com>
143 - supplied patches to improve SI prefixes and add --average-rate
144
145 Vladimir Kokarev, Alexander Leo
146 - reported that exit status did not reflect file errors
147
148 Thomas Rachel
149 - submitted patches for IEEE1541 (MiB suffixes), 1+e03 bug
150
151 Guillaume Marcais
152 - submitted speedup patch for line mode
153
154 Moritz Barsnick
155 - submitted patch for compile warning in size calculation
156
157 Pawel Piatek
158 - submitted RPM and patches for AIX
159
160 Sami Liedes
161 - submitted patch for --timer and --bytes with --numeric
162
163 Steven Willis
164 - reported problem with "-R" killing non-PV remote processes
165
166 Vladimir Pal, Vladimir Ermakov
167 - submitted patch which led to development of --format option
168
169 Peter Samuelson <peter@p12n.org>
170 - submitted patch to calculate size if stdout is a block device
171
172 Miguel Diaz
173 - much Cygwin help (and packaging), found narrow-terminal bug
174
175 Jim Salter <http://ubuntuwiki.net>
176 - commissioned work on the --skip-errors option
177
178 Wouter Pronk
179 - reported build problem on SCO
180
181 Bryan Dongray <http://www.dongrays.com>
182 - provided patches for test scripts failing on older Red Hats
183
184 Zev Weiss <www.bewilderbeest.net>
185 - provided patch to fix splice() not using stdin
186
187 Zing Shishak
188 - provided patch for --null / -0 (count null terminated lines)
189
190 Jacek Wielemborek <http://deetah.jogger.pl/kategorie/english>
191 - implemented fdwatch in Python, suggested PV port
192 - reported bug with "-l" and ETA / size
193 - suggested common switches
194
195 Kim Krecht
196 - suggested buffer fill status and last bytes output display options
197
198 Cristian Ciupitu <http://ciupicri.github.io>, Josh Stone
199 - pointed out file descriptor leak with helpful suggestions
200 (Josh Stone initially noticed the missing close)
201
202 Jan Seda
203 - found issue with splice() and SPLICE_F_NONBLOCK causing slowdown
204
205 André Stapf
206 - pointed out formatting problem e.g. 13GB -> 13.1GB which should be
207 shown 13.0GB -> 13.1GB; highlighted on-startup row swapping in -c
208
209 Damon Harper <http://www.usrbin.ca/>
210 - suggested "-D" / "--delay-start" option
211
212 Ganaël Laplanche <http://www.martymac.org>
213 - provided patch for lstat64 on systems that do not support it
214
215 Peter Korsgaard <http://www.buildroot.net/>
216 - provided similar patch for lstat64, specifically for uClibc support
217 - provided AIX cross-compilation patch to fix bug in -lc128 check
218
219 Ralf Ramsauer <https://blog.ramses-pyramidenbau.de/>
220 - reported bug which dropped transfer rate on terminal resize
221
222 Michiel Van Herwegen
223 - reported and discussed bug with "-l" and ETA / size
224
225 Erkki Seppälä <http://www.inside.org/~flux/>
226 - provided patch implementing "-I"
227
228 Eric A. Borisch
229 - provided details of compatibility fix for "%Lu" in watchpid code
230
231 Jan Venekamp
232 - reported MacOS buffer size interactions with pipes
233
234 Matt <https://github.com/lemonsqueeze/pv>
235 - provided "rate-window" patches for rate calculation
236
237 Filippo Valsorda
238 - provided patch for stat64 issue on Apple Silicon
239
240 Matt Koscica, William Dillon
241 - also reported stat64 issue on Apple Silicon
242
243 Norman Rasmussen
244 - suggested -c with -d PID:FD, reject -N with -d PID
245
246 Andriy Gapon, Jonathan Elchison
247 - reported bug where "pv /dev/zero >/dev/null &" stops immediately
248
249 Marcelo Chiesa
250 - reported unused-result warnings when compiling PV 1.6.6
251
252 Jered Floyd
253 - provided patches to improve --rate-limit
254
255 Christoph Biedl
256 - provided ETA and dynamic interval patches
257
258 Richard Fonfara
259 - provided German translations for "pv --help"
260
261 Johannes Gerer <http://johannesgerer.com>
262 - suggested that "-B" should enable "-C"
263
264 Sam James
265 - provided fix for number.c build issue caused by missing stddef.h
266
267-----------------------------------------------------------------------------
268