pv-for-cygwin Files

==
pv
==

Pipe Viewer - is 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.

Additional support is available for multiple instances working in 
tandem, to given a visual indicator of relative throughput in a 
complex pipeline

See the man pages for a full list of features.
	man pv

Source homepage:    http://www.ivarch.com/programs/pv.shtml
Source download:    http://www.ivarch.com/programs/sources/pv-1.3.4.tar.bz2
Author:             Andrew Wood <andrew.wood@ivarch.com>
Cygwin packager:  	dragomerlin at sourceforge.net
License:            Artistic License 2.0; see COPYING for details.

--------------- Quick install ---------------------
 pv.exe to c:\cygwin\bin\
 pv.1.gz to c:\cygwin\usr\share\man\man1\

---- Complete install (the same with docs) --------
 Install from cygwin terminal:
	wget http://sourceforge.net/projects/pvforcygwin/files/pv-1.3.4-1/pv-1.3.4-1.tar.bz2 -O - | tar -jxv -C /
 Uninstall (empty folders will remain)
	wget http://sourceforge.net/projects/pvforcygwin/files/pv-1.3.4-1/pv-1.3.4-1.tar.bz2 -O - | tar -jtf - | grep -v /$ | sed "s|^|\/|" | xargs rm -v

---------- Compile with cygport -------------------
	cd /usr/src
	wget http://sourceforge.net/projects/pvforcygwin/files/pv-1.3.4-1/pv-1.3.4-1-src.tar.bz2
	tar -jxvf pv-1.3.4-1-src.tar.bz2
	cygport pv-1.3.4-1.cygport all
 This will create the following packages:
	/usr/src/pv-1.3.4-1.tar.bz2
	/usr/src/pv-1.3.4-1-src.tar.bz2
	/usr/src/pv-debuginfo-1.3.4-1.tar.bz2

--- Manual compiling (from author's source code) ---
 Extract, configure and build:
	cd /usr/src
	wget http://www.ivarch.com/programs/sources/pv-1.3.4.tar.bz2
	tar -jxvf pv-1.3.4.tar.bz2
	cd pv-1.3.4
	./configure
	make
	
 Install:  
	make install
	
 Uninstall:
	make uninstall

 Clean the sources:
	make clean

 When compiling from source doc folder is not installed.
 
-------------- Package creation --------------------
Based on http://cygwin.com/setup.html

How to create
- pv-1.3.4-1.tar.bz2
- pv-1.3.4-1-src.tar.bz2
- pv-debuginfo-1.3.4-1.tar.bz2

 Install build and build script requirements (see below)
 
 Switch to working dir
	cd /usr/src
	
 Download original source code
	wget http://www.ivarch.com/programs/sources/pv-1.3.4.tar.bz2
	
 Create two source directories for comparison
	mkdir origsrc src
	
 Extract the original source code to both of them
	tar -jxvf pv-1.3.4.tar.bz2 -C origsrc
	tar -jxvf pv-1.3.4.tar.bz2 -C src
	
 Create the patches directory
	mkdir -p ./src/pv-1.3.4/CYGWIN-PATCHES/
	
 Create a setup.hint in text unix format under CYGWIN-PATCHES
	wget http://sourceforge.net/projects/pvforcygwin/files/pv-1.3.4-1/setup.hint -O ./src/pv-1.3.4/CYGWIN-PATCHES/setup.hint
	
 Create a cygport configuration file in text unix format
	wget http://sourceforge.net/projects/pvforcygwin/files/pv-1.3.4-1/pv-1.3.4-1.cygport
	
 Create a README text file in unix format containing cygwin related information under CYGWIN-PATCHES
 and put it in under src/pv-1.3.4/CYGWIN-PATCHES/README
	wget http://sourceforge.net/projects/pvforcygwin/files/pv-1.3.4-1/README -O ./src/pv-1.3.4/CYGWIN-PATCHES/README
	
 Make any other change that you consider necessary to src folder contents
 
 Create a patch to compare origsrc and src folders
	diff -Nrup origsrc src > pv-1.3.4-1.cygwin.patch
	
 Check that you have included the necessary dependencies in setup.hint, modify and run diff again
	cygport pv-1.3.4-1.cygport almostall
	cygport pv-1.3.4-1.cygport deps
 
 Compile and create the packages with cygport
	cygport pv-1.3.4-1.cygport all

----------- Install as a package with official setup.exe installer -----------------
 Create a mirror on your local system and get into it
	cd /cygdrive/c
	mkdir -p cygwin-mirror/release
	cd cygwin-mirror

 Create a folder for each program you have inside release, in this case only pv
	mkdir release/pv
	
 Copy into the program folder the binary tar, src tar and setup.hint
	wget http://sourceforge.net/projects/pvforcygwin/files/pv-1.3.4-1/pv-1.3.4-1.tar.bz2 -O release/pv/pv-1.3.4-1.tar.bz2
	wget http://sourceforge.net/projects/pvforcygwin/files/pv-1.3.4-1/pv-1.3.4-1-src.tar.bz2 -O release/pv/pv-1.3.4-1-src.tar.bz2
	wget http://sourceforge.net/projects/pvforcygwin/files/pv-1.3.4-1/setup.hint -O release/pv/setup.hint
	
 Download latest revision of genini to make setup.bz2 and setup.ini from the existing release
 from http://cygwin.com/cgi-bin/cvsweb.cgi/genini/genini?cvsroot=cygwin-apps OR from
	wget http://sourceforge.net/projects/pvforcygwin/files/genini
		
 Generate setup.bz2 and setup.ini with genini perl script
	perl genini --output=setup --recursive --okmissing=source release
	cp setup setup.ini
	bzip2 setup
	
 Download the official setup.exe installer
	wget http://cygwin.com/setup.exe
	
 Install from local directory and skip setup.ini signature verification
	./setup.exe -X -L -l c:\\cygwin-mirror

 There you can see the software you already installed with official installer plus the one existing in the mirror.
 To add more official software to your custom mirror download them to the release folder and generate
 again the setup.ini and setup.bz2 files. List of mirrors: http://cygwin.com/mirrors.html
 Examples with rsync and lftp:
	rsync -vaz rsync://mirrors.syringanetworks.net/cygwin/release/ release 
	lftp -e "mirror -c release release;quit" cygwin.mirrorcatalogs.com/cygwin/

-------------------------------------------------------------------------

Runtime requirements:
	cygwin
	libintl8

Build requirements:
	binutils
	gcc4
	gettext-devel
	libiconv
	make
	readline
	
Build script additional requirements:
	coreutils
	findutils
	cygport

To generate setup and get official packages
	perl
	rsync
	lftp

-------------------------------------------------------------------------
Examples:

 To simulate typing
	echo "You can simulate on-screen typing just like in the movies" | pv -qL 10
	
 To view pipe transfer rate and size
	wget -qO - http://www.kernel.org/pub/linux/kernel/v1.0/linux-1.0.tar.gz | pv | gzip -d | pv  > /dev/null
	
 Limit transfer rate over a pipe
	pv /dev/zero -L 1m > /dev/null
	
 Limit transfer rate and total size over a pipe
	cat /dev/zero | pv -L 3m | dd bs=1M count=5 iflag=fullblock > /dev/null
 
 More useful commands (URL)
	http://www.commandlinefu.com/commands/matching/pv/cHY=/sort-by-votes

-------------------------------------------------------------------------
Known issues:
- Locking the terminal under mintty is problematic
 pv: failed to lock terminal: Invalid argument
	See http://code.google.com/p/pipeviewer/issues/detail?id=4
	
 To circumvent the issue you can run executables from Windows Command Prompt (don't use mintty)
	c:\cygwin\bin\pv -cN source access.log | c:\cygwin\bin\gzip | c:\cygwin\bin\pv -cN c:\cygwin\bin\gzip > access.log.gz
	c:\cygwin\bin\dd if=/dev/sda bs=1M count=90 | c:\cygwin\bin\pv -cN source | c:\cygwin\bin\gzip | c:\cygwin\bin\pv -cN gz > data.gz

-------------------------------------------------------------------------
Cygwin version history:  (For a list of changes in upstream releases,
see http://www.ivarch.com/programs/pv.shtml)

1.3.4-1:
- pv version 1.3.4