TULSOFT / Proc-Async-0.2.0 / docs / extester.html 
<html><head><title></title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" >

<style type="text/css">
 <!--/*--><![CDATA[/*><!--*/
BODY {
  background: white;
  color: black;
  font-family: arial,sans-serif;
  margin: 0;
  padding: 1ex;
}

A:link, A:visited {
  background: transparent;
  color: #006699;
}

A[href="#POD_ERRORS"] {
  background: transparent;
  color: #FF0000;
}

DIV {
  border-width: 0;
}

DT {
  margin-top: 1em;
  margin-left: 1em;
}

.pod { margin-right: 20ex; }

.pod PRE     {
  background: #eeeeee;
  border: 1px solid #888888;
  color: black;
  padding: 1em;
  white-space: pre;
}

.pod H1      {
  background: transparent;
  color: #006699;
  font-size: large;
}

.pod H1 A { text-decoration: none; }
.pod H2 A { text-decoration: none; }
.pod H3 A { text-decoration: none; }
.pod H4 A { text-decoration: none; }

.pod H2      {
  background: transparent;
  color: #006699;
  font-size: medium;
}

.pod H3      {
  background: transparent;
  color: #006699;
  font-size: medium;
  font-style: italic;
}

.pod H4      {
  background: transparent;
  color: #006699;
  font-size: medium;
  font-weight: normal;
}

.pod IMG     {
  vertical-align: top;
}

.pod .toc A  {
  text-decoration: none;
}

.pod .toc LI {
  line-height: 1.2em;
  list-style-type: none;
}

  /*]]>*/-->
</style>


</head>
<body class='pod'>
<!--
  generated by Pod::Simple::HTML v3.16,
  using Pod::Simple::PullParser v3.16,
  under Perl v5.014002 at Wed May 29 07:27:42 2013 GMT.

 If you want to change this HTML document, you probably shouldn't do that
   by changing it directly.  Instead, see about changing the calling options
   to Pod::Simple::HTML, and/or subclassing Pod::Simple::HTML,
   then reconverting this document from the Pod source.
   When in doubt, email the author of Pod::Simple::HTML for advice.
   See 'perldoc Pod::Simple::HTML' for more info.

-->

<!-- start doc -->
<a name='___top' class='dummyTopAnchor' ></a>

<div class='indexgroup'>
<ul   class='indexList indexList1'>
  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
  <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
  <li class='indexItem indexItem1'><a href='#OPTIONS'>OPTIONS</a>
  <ul   class='indexList indexList2'>
    <li class='indexItem indexItem2'><a href='#General_options'>General options</a>
  </ul>
</ul>
</div>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="SYNOPSIS"
>SYNOPSIS</a></h1>

<pre>   extester [-stdout &#60;text&#62;]  [-stderr &#60;text&#62;] [-pipe]    \
            [-exit &#60;integer&#62;] [-signal &#60;integer&#62;]         \
            [-sleep &#60;seconds&#62; [-progress &#60;seconds&#62;] ]     \
            [-create &#60;file&#62;=&#60;number&#62; [&#60;file&#62;=&#60;number&#62;...]

   extester -help
   extester -version</pre>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="DESCRIPTION"
>DESCRIPTION</a></h1>

<p>A simple script that does nothing except that:</p>

<ul>
<li>it may print a given text to its standard output</li>

<li>it may print a given text to its standard error</li>

<li>it may exit with a given exit code</li>

<li>it may send to itself a given signal (which may cause exiting)</li>

<li>it may sleep for a given time period before exiting (or signaling)</li>

<li>it may print a short progress report on its standard error every given interval</li>

<li>it may read its standard input and pipes it to its standard output</li>

<li>it may create one or more output files (whose names may iclude subdirectorie that will also be created) and fill them with the given number of lines
<p>For example:</p>

<pre>   extester -create a.tmp=1 dir/dor/b.tmp=5 empty.dir/=0</pre>

<p>creates:</p>

<pre>   ./a.tmp          size:  2
   ./dir/dor/b.tmp  size: 15
   ./empty.dir      an empty directory</pre>
</li>
</ul>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="OPTIONS"
>OPTIONS</a></h1>

<h2><a class='u' href='#___top' title='click to go to top of document'
name="General_options"
>General options</a></h2>

<dl>
<dt><a name="-help"
><b>-help</b></a></dt>

<dd>
<p>Print documentation and exits.</p>

<dt><a name="-version"
><b>-version</b></a></dt>

<dd>
<p>Print the version and exits.</p>
</dd>
</dl>

<!-- end doc -->

</body></html>