<html><head><title>Bidirectional pipe for unix shells</title><style type="text/css"><!--
TABLE.toc {border:0px}
TD.toc {font-size:80%; font-family:Tahoma; text-align:left}
H1 {font-size:250%; font-weight:bold} .level1 {text-align:center}
H2 {font-size:200%; font-weight:bold} .level2 {margin-left:1%}
H3 {font-size:160%; font-weight:bold} .level3 {margin-left:2%}
H4 {font-size:145%; font-weight:bold} .level4 {margin-left:3%}
H5 {font-size:130%; font-weight:bold} .level5 {margin-left:4%}
H6 {font-size:110%; font-weight:bold} .level5 {margin-left:5%}
BODY {font-family:Arial,Verdana,Helvetica }
--></style></head><body><h1>Bidirectional pipe for unix shells</h1><h2 class=level2> 0. Contents </h2>This is the documentation of twinpipe-1.0.5.<table width="100%" cellspacing=0 cellpadding=0 class=toc><tr><td width="50%" valign=middle align=left nowrap class=toc> 1. <a href="h0">Purpose</a><br> 2. <a href="h1">Copying</a><br></td> <td width="50%" valign=middle align=left nowrap class=toc> 3. <a href="h2">Installation</a><br> 4. <a href="download">Downloading</a><br></td> </tr></table><H2 class="level2"><a name="h0">1. Purpose</a></H2><div class="level2">
Use twinpipe to start two processes from the unix shell,
so that the processes talk to each other via stdout and stdin.
<p>
For example, you could use it to start two ppp processes
which need to talk to each others (for VPN solutions).
<p>
Twinpipe starts the two processes (shell commands) and
makes sure that one's stdout is another's stdin.
<p>
Two versions are included: A C-language version and shellscript-version.
<br>
The shellscript-version uses a named pipe (fifo) to do the trick, and
the C-language version just creates two pipes and executes the programs.<br>
Example of usage: <code>twinpipe 'echo a;head -n 1 >&2' 'echo b;echo c'</code>
<p>
The package, when compiled, also builds a usleep shell utility, which
takes only one argument: microsecondcount, and expectedly sleeps the
wanted duration. Example: <code>usleep 200000</code> (sleeps 0.2s).
</div><H2 class="level2"><a name="h1">2. Copying</a></H2><div class="level2">
twinpipe (the shellscript version and the C version) have been written by Joel Yliluoma, a.k.a. <a href="http://bisqwit.iki.fi/">Bisqwit</a>,<br> and is distributed under the following terms: <blockquote><code> * No warranty. You are free to modify this source and to<br> * distribute the modified sources, as long as you keep the<br> * existing copyright messages intact and as long as you<br> * remember to add your own copyright markings.<br> * You are not allowed to distribute the program or modified versions<br> * of the program without including the source code (or a reference to<br> * the publicly available source) and this notice with it.</code></blockquote>
</div><H2 class="level2"><a name="h2">3. Installation</a></H2><div class="level2">
<pre class=smallerpre
>$ make
$ su
# make install</pre>
</div><H2 class="level2"><a name="download">4. Downloading</a></H2><div class="level2">The official home page of twinpipe is at <a href="http://oktober.stc.cx/source/twinpipe.html">http://oktober.stc.cx/source/twinpipe.html</a>; .<br>Check there for new versions.</div><p align=right><small>Generated from <code>progdesc.php</code> (last updated: Tue, 14 May 2002 17:52:11 +0300)<br>with <code>docmaker.php</code> (last updated: Tue, 14 May 2002 17:41:54 +0300)<br>at Tue, 14 May 2002 17:52:11 +0300</small></p></body></html>