home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume22 / tpipe / README < prev    next >
Text File  |  1990-06-07  |  2KB  |  47 lines
  1. -------------------------------------------------------------
  2. tpipe --  replicate standard output to an additional pipeline
  3.               version 1.02    6 Mar. 1990
  4. -------------------------------------------------------------
  5.  
  6. tpipe is a simple utility program that can be used to split a unix
  7. pipeline into two pipelines. That is, the output of one pipeline can
  8. be replicated and supplied as the input to two other pipelines
  9. executing simultaneously.
  10.  
  11. Like tee(1), tpipe transcribes its standard input to its standard
  12. output. But where tee(1) writes an additional copy of its input to a
  13. file, tpipe writes the additional copy to the input of another
  14. pipeline, which is specified as the argument to tpipe. In a typical
  15. use, this pipeline will eventually write to a file. The standard
  16. output of tpipe is typically piped into another pipeline, whose output
  17. (if any) may go to the user's terminal or anywhere at all.
  18.  
  19. I wrote tpipe because I was processing image files (using pbmplus),
  20. and I wanted to apply more than one pipeline to the same input file,
  21. but the early parts of the pipeline were the same. I did not want to
  22. have to execute the early parts multiple times. I did not have enough
  23. disk space to write what would have been a huge intermediate file.
  24. Frankly, I did not know about teeing to named pipes, but anyway it's
  25. nice not to have to bother with them or worry about name conflicts,
  26. especially if you have more than one job wanting to do this at the
  27. same time...
  28.  
  29. See the manual page for tpipe(1) for information about its use,
  30. including an artificial example. 
  31.  
  32. This distribution contains four files:
  33.   Readme (this is it)
  34.   Makefile (it is trivial)
  35.   tpipe.1  (the manual page)
  36.   tpipe.c  (the code!)
  37.  
  38. To read the manual page, just `nroff -man tpipe.1'.
  39.  
  40. To compile tpipe, just `make'. Put tpipe.1 in the man1/ directory in
  41. your MANPATH or the system man path.
  42.  
  43. --
  44. David B Rosen, Cognitive & Neural Systems                  rosen@bucasb.bu.edu
  45. Center for Adaptive Systems                 rosen%bucasb@{buacca,bu-it}.bu.edu
  46. Boston University              {mit-eddie,harvard,uunet}!bu.edu!thalamus!rosen
  47.