home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / SREFV12J / SREFAST.HT0 < prev    next >
Text File  |  1997-06-03  |  9KB  |  234 lines
  1. <td>
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Configure SREFAST</TITLE>
  5. </HEAD>
  6.  
  7. <BODY>
  8. <h1> The SREFAST configurator </H1>
  9.  
  10. <b>Select an option: </b>
  11. <ol>
  12. <LI> <A HREF="#addone">Add an entry to</A>
  13.  the SREFAST configuration index-file
  14. <LI><A HREF="/srefast3?removeone=1"> Remove an entry from</A>
  15.  the SREFAST configuration index-file
  16. <LI><A HREF="/srefast3?viewconfig0=1"> View entries in  the  configuration file</A>.
  17.  
  18. <LI><A HREF="/srefast3?viewconfig=1"> View SREFAST usage statistics, and view entries in  the <i>working </i> configuration file</A>.
  19. <LI><A HREF="/srefast3?refresh=1"> Refresh the <i>working </i> configuration file</A>.
  20.  
  21.  <li> <A HREF="#descriptions">Descriptions of SREFAST configuration options </A>
  22.  
  23. </ol>
  24.  
  25.  <a href="/samples/srefast.doc"> Need more help?</a>
  26. <pre>
  27.  
  28.  
  29.  
  30.  
  31.  
  32. </pre>
  33.  
  34. <!-- ============= ADDONE =============================== -->
  35. <A NAME="addone"><HR></a>
  36. <h2> Add an entry to the SREFAST configuration file </h2>
  37.  
  38. <FORM ACTION="srefast3" METHOD="POST">
  39.  
  40. <input type="hidden" name="addone" value=1>
  41. <table border=1>
  42. <td><STRONG>Selector and directory</STRONG></td>
  43. <td>
  44.     <table border=2>
  45.       <td> <INPUT TYPE="CHECKBOX" NAME="nodo" VALUE="1" > NODO?</td>
  46.       <td>   SEL: <INPUT TYPE="text" NAME="sel"  SIZE=32 MAXLENGTH=80>
  47.            <br>
  48.             DIR: <INPUT TYPE="text" NAME="dir"  SIZE=32 MAXLENGTH=80>
  49.       </td>
  50.    </table>
  51. <td>
  52. <tr>
  53. <td>
  54. <STRONG>Access controls</STRONG></td>
  55.  
  56. <td>
  57.    SERVER: <INPUT TYPE="text" NAME="server"  SIZE=32 MAXLENGTH=80><BR>
  58.  
  59.    HOST: <INPUT TYPE="text" NAME="HOST"  SIZE=32 MAXLENGTH=80>
  60.  
  61.    <br>
  62.    <table>
  63.      <td> USERS:<TEXTAREA NAME="users" ROWS=2 COLS=15></TEXTAREA></td>
  64.      <td> PWDS:<TEXTAREA NAME="pwds" ROWS=2 COLS=15></TEXTAREA></td>
  65.  
  66.    </table>
  67.  
  68. </td>
  69. <tr>
  70. <td>
  71. <P><STRONG>Other options</STRONG><BR> </td>
  72.  
  73. <td>
  74. <table> <td>MIME:</td>
  75. <td>
  76. <menu><li>
  77.   <INPUT TYPE="radio" NAME="MIME" VALUE="text/html" >text/html ||
  78.   <INPUT TYPE="radio" NAME="MIME" VALUE="text/plain" >text/plain ||
  79.   <INPUT TYPE="radio" NAME="MIME" VALUE="image/gif" >image/gif ||
  80.   <INPUT TYPE="radio" NAME="MIME" VALUE="image/jpg" >image/jpg ||
  81.   <INPUT TYPE="radio" NAME="MIME" VALUE="application/octet-stream" > generic <br>
  82. <li><INPUT TYPE="radio" NAME="MIME" VALUE="other" ><u>OTHER</u>:
  83. <INPUT TYPE="text" NAME="MIME2"  SIZE=30 MAXLENGTH=80><BR>
  84. </menu>
  85. </td>
  86. </table>
  87.  
  88. <br><INPUT TYPE="CHECKBOX" NAME="nocache" VALUE="1" >NOCACHE ||
  89. <INPUT TYPE="CHECKBOX" NAME="norecord" VALUE="1" >NORECORD ||
  90. <INPUT TYPE="CHECKBOX" NAME="ssi" VALUE="1" >SSI  ||
  91. <INPUT TYPE="CHECKBOX" NAME="DIR_NAMEONLY" VALUE="1" >DIR_NAMEONLY
  92. <BR> TRIGGER <INPUT TYPE="text" NAME="TRIGGER"  SIZE=30 MAXLENGTH=80><BR>
  93.  
  94. </table>
  95.  
  96. <p>
  97. Place at entry # (leave blank to put at the end)
  98. <INPUT TYPE="text" NAME="entrynum"  SIZE=5 MAXLENGTH=5>
  99.  
  100. <INPUT TYPE="submit" VALUE="Add entry"></table>
  101.  
  102. </FORM>
  103. <P><A HREF="#main">Return to Top </A>
  104. <pre>
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111. </pre>
  112.  
  113. <!-- =================DESCRIPTIONS =========================== -->
  114. <A NAME="descriptions"> <hr></A>
  115. <H3> Short description of SREFAST options </h3>
  116. <pre>
  117. <STRONG>SEL  </STRONG>   <U>Required. </U> The target "selector".
  118.         The selector requested by the client will be compared against SEL.
  119.         * You can include * (wildcard) characters in SEL.
  120.  
  121. <strong>NODO  </strong>    <i>Optional</i>.  If selected, then requests that
  122.         match SEL (and SERVER) are <b>not</b> processed by SREFAST (the
  123.         main SRE-Filter will immediately be called).
  124.  
  125. <STRONG>DIR     </STRONG> <I>Optional.  </I>The directory containing the requested file.
  126.         * If not specified, the GoServe default data directory is used.
  127.         * If  DIR starts with a url (that MUST begin with http://),
  128.           then requests that match this entry will be redirected to this URL.
  129.         * When redirecting, you can include an * at the end of DIR to
  130.           "append the selector" (or the file portion of the selector) to the
  131.           target URL.
  132.  
  133. <STRONG>DIR_NAMEONLY</STRONG> <I>Optional.  </I> Modifies the DIR option.
  134.          When mapping requests to files, SREFAST can use the value of the DIR
  135.          option in two ways:
  136.               i) It can append the selector
  137.              ii) It can append <u>just the file name</u> portion of the selector
  138.          DIR_NAMEONLY controls which method to use; if DIRNAME_ONLY is
  139.          selected, then method ii is used.
  140.              <i>Example: </i> assuming DOIT.1.!DIR='D:\PERSONAL' and the
  141.                 selector is /STUF/FOO.BAR, then the following are returned:
  142.                 <tt>DIR_NAMEONLY <b>not</b> selected: D:\PERSONAL\STUF\FOO.BAR
  143.                 <tt>DIR_NAMEONLY  selected: D:\PERSONAL\FOO.BAR
  144.         * If DIR is not specified, DIR_NAMEONLY is ignored.
  145.  
  146.  
  147. <STRONG>SERVER  </STRONG> <I>Optional. </I>The numeric IP address, or Host alias, this
  148.         entry is valid for.
  149.                <em>If you are <b>not</b>  serving multiple hosts,
  150.                you should <b>not</b> specify a SERVER variable</em>.
  151.         * If SERVER is not specified, the entry is valid for all requests.
  152.         * Otherwise, it's value will be compared against the numeric
  153.           IP address of the target server (as provided by GoServe), and
  154.           the HOST: request header (if one exists).
  155.         * If SERVER is specified, and neither the numeric IP address
  156.           or the HOST: request header match the value of SERVER,
  157.           this entry will be ignored.
  158.  
  159. <strong>HOST</strong>   <i>Optional</i>.  The <b>host nickname</b> of the SERVER.
  160.                       <em>If you are <b>not</b> serving multiple hosts,
  161.                       you should <b>not</b> specify a SERVER variable.</em>
  162.         * HOST is only used to resolve REPLACE variables in
  163.           server side includes. If you specify a SERVER but
  164.           not a HOST, the "generic host" variables will be used.
  165.         * We highly recommend coordinating the values assigned to
  166.           SERVER, HOST, and DIR with the HOSTS. entries (in INITFILT.80)
  167.  
  168. <STRONG>USERS   </STRONG> <I>Optional.  </I> A space delimited list of allowed users.
  169.         * If the client did not provide a username, an authorization
  170.           request is sent back to the client.
  171.         * If this username is not in USERS, an authorization
  172.           request is sent back to the client.
  173.         * If this username is in USERS., then PWDS is also checked.
  174.  
  175. <STRONG>PWDS  </STRONG> <I>Optional. </I> A list of allowed passwords, with each word in the list
  176.        paired with the corresponding word in USERS.
  177.        * Given that USERS is satfisfied,the appropriate word in PWDS is
  178.          compared against the password provided by the client.
  179.        * If this word does not match the password, then an
  180.          authorization request is sent back to the client.
  181.        * A value of * means "any password will do".
  182.  
  183.  
  184. <STRONG>SSI    </STRONG> <I>Optional.</I> If checked, then this entry contains server side includes.
  185.         * SREFAST uses "pre-compiled" cache files to handle most
  186.           server side includes.
  187.         * If SSI=1, then the SEL must NOT contain wildcards. That is,
  188.           SSI=1 entries must be specific to a single file.
  189.  
  190. <STRONG>MIME   </STRONG> <I>Optional.</I>  The Mime type of this request.
  191.          You can:
  192.          * Select one of the commonly used ones.
  193.            Note that <tt>generic</tt> is  actually <tt>application/octet-stream</tt>.
  194.          * Let SRE-Filter determine it (choose <u>OTHER</u>, and leave the text field blank),
  195.          * Specify your own (choose <u>OTHER</u>, and fill in the text field).
  196.  
  197. <STRONG>NOCACHE  </STRONG><EM>Optional</EM>.  If checked, then this entry will NOT be cached by GoServe.
  198.  
  199. <STRONG>NORECORD  </STRONG><I>Optional</I>.  If checked, then this entry will not be recorded.
  200.          That is, no POST-Filter action will occur: no recording in
  201.          the RECORD_ALL file, no recording in the .LOG files, etc.
  202.          Otherwise, the entry WILL be recorded (using the standard
  203.          SRE-Filter mechanisms).
  204.  
  205. <STRONG>TRIGGER  </STRONG> <EM>Optional</em>.  If filled in, this should contain
  206.          the <b>fully qualified name</b> of a <u>trigger file</u>.  When SREFAST
  207.          checks it's SSI cache, it always checks the file-stamp of the "own file";
  208.          and will not use the cache entry if the file stamp has changed.  However, if
  209.          an INCLUDEd file has changed, SREFAST will <b>not</b> detect the change;
  210.          and will instead use the out-of-date cache entry.  By using a
  211.          trigger file, you can specify one additional file-stamp to check (i.e.;
  212.          an INCLUDEd file).
  213.          
  214. </pre>
  215.  
  216. Note that when examining INITFAST (the configuration file), SREFAST will  use the first
  217. matching entry (starting from entry #1). Thus,
  218. using a low number when <tt>adding an entry</tt> will give the entry
  219. higher priority.<p>
  220. <A HREF="#main">Return to Top </A>
  221. <pre>
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229. </pre>
  230. <hr>
  231. <!-- Replace servername -->
  232. </body>
  233. </html>
  234.