Pipecut - Readme


(1) Information
(2) Use
(3) Bugs
(4) Why?
(5) History

1. Information

	Pipecut takes piped, or redirected, input. And splits it out to
	files of any name you chose, of *any size you chose.

	The smallest input accepted is 1KB(1024 bytes).

	The largest file pipecut will write is 2GB minus either 1KB, or 1MB.
	If -b uses a k, then it's minus 1KB. If -b uses a m, then it's minus 1MB.

	Pipecut was written with linux in mind, but it does work in Win.
	The Win version was compiled with Cygwin(MingW32).

	* File size is a multiple of 1KB, or 1MB.


2. Use

	pipecut -o bar_ -b 5k < foo
	or
	cat | pipecut -o bar -b 5k

	Which writes the file foo, into 5K sized files named bar_001, bar_002...


	Switches(case sensitive, all numbers must be integers)
	-b size(k|m)	Output file size, the k denotes kilobyte increments,
			whereas m is megabytes. Note: The last file is the remainder
			of the input, so it most likely won't be equal to the others.

	-o file name	Output file name prefix (001-999 is appended)

	-s 1-999	Skips writing data to this many files. Thus "-s 5", would
			skip writing the first five files.

	-f 1-999	Write this many files. So "-f 5", writes only the
			first five files.

	-m 1-999	Writes only this numbered file(supersedes -s, -f).
			"-m 5" would be the same as "-s 4 -f 1".


	Ranges can be accomplished by using -s and -f together. Such as:

	pipecut -o bar_ -b 5k -s 5 -f 3 < foo

	Which skips the first five files, then writes only three files.


3. Bugs

	Hopefully none.

	If there are any others, report them to duneboy79@yahoo.com


4. Why?

	Because the gnu split utility, wasn't as flexible as I would like.


5. History

	0.2-2	Added GNU message to help screen.
	0.2	First released version.
	Added the -f switch.
	Fixed a no input bug.

	Earlier versions where internal betas.