This repository has been archived by the owner on Feb 19, 2022. It is now read-only.
forked from icetee/pv
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
183 lines (122 loc) · 5.52 KB
/
INSTALL
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
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
Introduction
************
This is the README for `pv' ("Pipe Viewer"), a terminal-based tool for
monitoring the progress of data through a pipeline. It can be inserted into
any normal pipeline between two processes to give a visual indication of how
quickly data is passing through, how long it has taken, how near to
completion it is, and an estimate of how long it will be until completion.
Documentation
*************
A manual page is included in this distribution. See `man ./doc/quickref.1',
or `man pv' after installation.
Compilation
***********
If you have downloaded `pv' from Subversion, first run "./generate.sh".
To compile the package, type "sh ./configure", which should generate a
Makefile for your system. You may then type "make" to build everything.
Note that GNU `make' is required; this may be installed as `gmake' on some
systems, so if typing "make" gives an error, try "gmake" instead.
See the file `doc/INSTALL' for more about the `configure' script.
Developers note that you can do "./configure --enable-debugging" to cause
debugging support to be built in, and "--enable-profiling" builds in
profiling support (see "man gprof"). Also note that doing "make index" will
generate an HTML code index (using "ctags" and "cproto"); this index lists
all files used, all functions defined, and all TODOs marked in the code.
Developers also note that the /* RATS */ comments are used to tell the RATS
tool that a potential trouble spot has been checked so it doesn't need to
warn about it. (RATS: Rough Auditing Tool for Security - home page
http://www.fortifysoftware.com/security-resources/rats.jsp)
Author
******
This package is copyright (C) 2013 Andrew Wood, and is being distributed
under the terms of the Artistic License 2.0. For more details, see the
file `doc/COPYING'.
You can contact me by email at [email protected] or by using the
contact form on my web page at http://www.ivarch.com/.
The `pv' home page is at:
http://www.ivarch.com/programs/pv.shtml
The latest version can always be found here.
Credit is also due to:
Kevin Coyner <[email protected]>
- Debian package maintainer
Jakub Hrozek <[email protected]>
- Fedora package maintainer
Cédric Delfosse <[email protected]>
- previous Debian package maintainer
Eduardo Aguiar <[email protected]>
- provided Portuguese (Brazilian) translation
Stéphane Lacasse <[email protected]>
- provided French translation
Marcos Kreinacke <[email protected]>
- provided German translation
Bartosz Feñski <[email protected]> <http://skawina.eu.org/>
- provided Polish translation along with Krystian Zubel
Joshua Jensen
- reported RPM installation bug
Boris Folgmann <http://www.folgmann.com/en/>
- reported cursor handling bug
Mathias Gumz
- reported NLS bug
Daniel Roethlisberger
- submitted patch to use lockfiles for -c if terminal locking fails
Adam Buchbinder
- lots of help with a Cygwin port of -c
Mark Tomich <http://metuchen.dyndns.org>
- suggested -B option
Gert Menke
- reported bug when piping to dd with a large input buffer size
Ville Herva <[email protected]>
- informative bug report about rate limiting performance
Elias Pipping
- patch to compile properly on Darwin 9; potential NULL deref report
Patrick Collison
- similar patch for OS X
Boris Lohner
- reported problem that "-L" does not complain if given non-numeric value
Sebastian Kayser
- supplied testing for SIGPIPE, demonstrated internationalisation problem
Laszlo Ersek <http://phptest11.atw.hu/>
- reported shared memory leak on SIGINT with -c
Phil Rutschman <http://bandgap.rsnsoft.com/>
- provided a patch for fully restoring terminal state on exit
Henry Precheur <http://henry.precheur.org/>
- reporting and suggestions for --rate-limit bug when rate is under 10
E. Rosten <http://mi.eng.cam.ac.uk/~er258/>
- supplied patch for block buffering in line mode
Kjetil Torgrim Homme
- reported compilation error with default CFLAGS on non-GCC compilers
Alexandre de Verteuil
- reported bug in OS X build and supplied test environment to fix in
Martin Baum
- supplied patch to return nonzero exit status if terminated by signal
Sam Nelson <http://www.siliconfuture.net/>
- supplied patch to fix trailing slash on DESTDIR
Daniel Pape
- reported Cygwin installation problem due to DESTDIR
Philipp Beckers
- ported to the Syabas PopcornHour A-100 series
Henry Gebhard <[email protected]>
- supplied patches to improve SI prefixes and add --average-rate
Vladimir Kokarev, Alexander Leo
- reported that exit status did not reflect file errors
Thomas Rachel
- submitted patches for IEEE1541 (MiB suffixes), 1+e03 bug
Guillaume Marcais
- submitted speedup patch for line mode
Moritz Barsnick
- submitted patch for compile warning in size calculation
Pawel Piatek
- submitted RPM and patches for AIX
Sami Liedes
- submitted patch for --timer and --bytes with --numeric
Steven Willis
- reported problem with "-R" killing non-PV remote processes
Vladimir Pal, Vladimir Ermakov
- submitted patch which led to development of --format option
Peter Samuelson <[email protected]>
- submitted patch to calculate size if stdout is a block device
Miguel Diaz
- much Cygwin help (and packaging), found narrow-terminal bug
Jim Salter <http://ubuntuwiki.net>
- commissioned work on the --skip-errors option
-----------------------------------------------------------------------------