html/man_file_stall.1.html

   1 <!-- manual page source format generated by PolyglotMan v3.0.7, -->
   2 <!-- available via anonymous ftp from ftp.cs.berkeley.edu:/ucb/people/phelps/tcltk/rman.tar.Z -->
   3
   4 <HTML>
   5 <HEAD>
   6 <TITLE>Man page for file_stall.1</TITLE>
   7 </HEAD>
   8 <BODY bgcolor=white>
   9 <A HREF="#toc">Table of Contents</A><P>
  10
  11 <H2><A NAME="sect0" HREF="#toc0">Name</A></H2>
  12
  13 <P>
  14 file_stall - wait for a file to appear
  15
  16 <H2><A NAME="sect1" HREF="#toc1"><B>Synopsis</B></A></H2>
  17
  18 <P>
  19 <B>file_stall</B> { <I>flag</I> } * <I>filename</I>
  20
  21 <H2><A NAME="sect2" HREF="#toc2"><B>Description</B></A></H2>
  22
  23 <P>
  24 This little utility is used by the SUIF makefile system to
  25 synchronize multiple nightly recompile runs using the same
  26 $SUIFHOME/src tree.
  27 <P>
  28 If <I>filename</I> already exists, there is no effect and
  29 <B>file_stall</B> exits immediately. Otherwise, it waits until
  30 <I>filename</I> appears and then exits. Either way, it returns a
  31 successful return code. It also prints a line to standard
  32 output reporting its results -- whether or not it had to
  33 wait and if it did wait, how long it did so.
  34
  35 <H2><A NAME="sect3" HREF="#toc3"><B>Options</B></A></H2>
  36
  37 <P>
  38 <B>-name</B> <I>name</I><BR>
  39
  40 This says to use <I>name</I> in the output message. By
  41 default, the output message refers to <I>filename.</I>
  42
  43 <DL>
  44
  45 <DT><B>-silent</B></DT></DT>
  46 <DD>
  47 This option causes the output message to be suppressed
  48 is there is no stall. If there is a wait,
  49 the output message is printed as usual.
  50 </DD>
  51
  52 <DT><B>--</B> </DT></DT>
  53 <DD>    This flag means ``end of options'' so subsequent
  54 arguments are not taken as flags, even if they
  55 begin with ``-''.
  56 </DD>
  57 </DL>
  58
  59 <H2><A NAME="sect4" HREF="#toc4"><B>History</B></A></H2>
  60
  61 <P>
  62 This program was written by Chris Wilson.
  63 <P>
  64
  65 <HR><P>
  66 <A NAME="toc"><B>Table of Contents</B></A><P>
  67 <UL>
  68 <LI><A NAME="toc0" HREF="#sect0">Name</A></LI>
  69 <LI><A NAME="toc1" HREF="#sect1">Synopsis</A></LI>
  70 <LI><A NAME="toc2" HREF="#sect2">Description</A></LI>
  71 <LI><A NAME="toc3" HREF="#sect3">Options</A></LI>
  72 <LI><A NAME="toc4" HREF="#sect4">History</A></LI>
  73 </UL>
  74 </BODY></HTML>