You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by sl...@apache.org on 2002/03/29 20:05:55 UTC

cvs commit: httpd-docs-1.3/htdocs/manual readme-tpf.html install-tpf.html

slive       02/03/29 11:05:55

  Modified:    htdocs/manual readme-tpf.html install-tpf.html
  Log:
  This patch updates the readme and install files for TPF.
  Minor updates to the latest version of the TPF operating system are now
  reflected in the documents.
  Also, changes to the documents were made so that they now pass W3C
  validation for xhtml 1.0 transitional.
  
  Submitted by:	David McCreedy
  
  Revision  Changes    Path
  1.12      +3 -3      httpd-docs-1.3/htdocs/manual/readme-tpf.html
  
  Index: readme-tpf.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/readme-tpf.html,v
  retrieving revision 1.11
  retrieving revision 1.12
  diff -u -d -b -u -r1.11 -r1.12
  --- readme-tpf.html	2 Oct 2001 11:02:58 -0000	1.11
  +++ readme-tpf.html	29 Mar 2002 19:05:54 -0000	1.12
  @@ -3,7 +3,7 @@
   
   <html xmlns="http://www.w3.org/1999/xhtml">
     <head>
  -    <meta name="generator" content="HTML Tidy, see www.w3.org" />
  +    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
   
       <title>The Apache TPF Port</title>
     </head>
  @@ -12,7 +12,7 @@
       <a id="top" name="top"></a> 
   
       <center>
  -      <h1>Overview of the Apache TPF Port</h1>
  +      <h2>Overview of the Apache TPF Port</h2>
       </center>
       <hr />
   
  @@ -205,7 +205,7 @@
   
         <li>rfc1413.c&nbsp;</li>
   
  -      <li>rotatelogs.c <em>(requires PUT10)&nbsp;</em></li>
  +      <li>rotatelogs.c <em>(requires PUT10; if PJ27214 implemented be sure to apply PJ28367)&nbsp;</em></li>
   
         <li>util.c&nbsp;</li>
   
  
  
  
  1.16      +54 -49    httpd-docs-1.3/htdocs/manual/install-tpf.html
  
  Index: install-tpf.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/install-tpf.html,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -d -b -u -r1.15 -r1.16
  --- install-tpf.html	17 Jan 2002 00:58:45 -0000	1.15
  +++ install-tpf.html	29 Mar 2002 19:05:54 -0000	1.16
  @@ -2,16 +2,18 @@
       "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   
   <html xmlns="http://www.w3.org/1999/xhtml">
  +
  +
     <head>
  -    <meta name="generator" content="HTML Tidy, see www.w3.org" />
  +    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
   
       <title>Installing Apache on TPF</title>
     </head>
   
     <body>
       <center>
  -      <h1><a id="top" name="top"></a>Installing the Apache 1.3 HTTP
  -      Server on TPF</h1>
  +      <h2><a id="top" name="top"></a>Installing the Apache 1.3 HTTP
  +      Server on TPF</h2>
       </center>
       <hr />
   
  @@ -81,9 +83,8 @@
         </li>
   
         <li>FTP the tarball to your OS/390 UNIX machine using binary
  -      mode:&nbsp;</li>
  +      mode:&nbsp;
   
  -      <li style="list-style: none">
           <ul>
             <li>activate FTP in an MSDOS window:
             <b><tt>ftp&nbsp;<i>your.os390.unix.machine.com</i></tt></b>&nbsp;</li>
  @@ -108,22 +109,18 @@
         </li>
   
         <li>Decompress and extract the archived files necessary for compiling
  -      Apache:
  +      Apache:<br />
         <b><tt>pax&nbsp;-rvzkf&nbsp;<i>os390_unix_filename</i>.tar.Z&nbsp;-o&nbsp;from=ISO8859-1,to=IBM-1047&nbsp;"*/src"</tt></b><br />
          &nbsp;</li>
   
         <li>
           Remove unnecessary subdirectories: 
  -
           <ul>
             <li>
             <b><tt>cd&nbsp;apache_1.3.<em>xx</em>/src/os</tt></b></li>
   
             <li>
             <b><tt>rm&nbsp;-r&nbsp;bs2000&nbsp;cygwin&nbsp;mpeix&nbsp;netware&nbsp;os2&nbsp;os390&nbsp;win32</tt></b></li>
  -
  -          <li style="list-style: none"><b><tt><br />
  -          </tt></b></li>
           </ul>
           &nbsp;
         </li>
  @@ -174,26 +171,24 @@
         <li>Edit src/Configuration. It contains the list and settings
         of various "Rules" and an additional section at the bottom
         that determines which modules to compile:<br />
  -       &nbsp;</li>
  +       &nbsp;
   
  -      <li style="list-style: none">
           <ul>
  -          <li>Adjust the Rules and
  +          <li>adjust the rules and
             <tt>EXTRA_CFLAGS|LIBS|LDFLAGS|INCLUDES</tt> if you feel
  -          so inclined.<br />
  +          so inclined
              &nbsp;</li>
   
  -          <li>Comment out (by preceding the line with a "#") lines
  +          <li>comment out (by preceding the line with a "#") lines
             corresponding to those modules you DO NOT wish to
  -          include.<br />
  +          include
              &nbsp;</li>
   
  -          <li>Uncomment (by removing the initial "#", if present)
  +          <li>uncomment (by removing the initial "#", if present)
             lines corresponding to those modules you wish to include
             or add new lines corresponding to any custom modules you
  -          have written. The <a
  -          href="readme-tpf.html">readme-tpf.html</a> document lists
  -          the modules that have been tested on TPF.&nbsp;</li>
  +          have written (the <a href="readme-tpf.html">readme-tpf.html</a> document lists
  +          the modules that have been tested on TPF)&nbsp;</li>
           </ul>
   
           <p>The modules placed in the Apache distribution are the
  @@ -230,8 +225,6 @@
             <tt>_C89_OPTIONS</tt> export in src/os/tpf/TPFExport</li>
           </ul>
           <br />
  -        <br />
  -         
   
           <p>Otherwise:<br />
           </p>
  @@ -245,8 +238,6 @@
             <tt>_C89_OPTIONS</tt> export in src/os/tpf/TPFExport</li>
           </ul>
           <br />
  -        <br />
  -         
   
           <p>Without <tt>non_socket_select</tt> CGI output is
           buffered and only sent to the browser when the CGI program
  @@ -276,8 +267,6 @@
             <tt>_C89_OPTIONS</tt> export in src/os/tpf/TPFExport</li>
           </ul>
           <br />
  -        <br />
  -         
   
           <p>Otherwise:<br />
           </p>
  @@ -290,17 +279,37 @@
             <tt>_C89_OPTIONS</tt> export in src/os/tpf/TPFExport</li>
           </ul>
           <br />
  -        <br />
  -         
   
           <p>The use of <tt>tpf_sawnc</tt> allows for a cleaner
           shutdown of Apache.</p>
         </li>
   
  -      <li style="list-style: none"><a id="export"
  -      name="export"></a></li>
  +      <li>
  +        Indicate if you would like to use the TCP/IP network services database.
  +        (This only applies if you are using TCP/IP native stack.)
   
  -      <li>Set the TPF environment variables:
  +        <p>If you are on a PUT16 or higher system, or have PJ28195 installed,
  +           you can use the TCP/IP network services database.
  +           To do so, you must do <em>one</em> of the following:<br />
  +        </p>
  +
  +        <ul>
  +          <li>add "<tt>#define&nbsp;TPF_HAVE_NSD</tt>" to
  +          <tt>src/os/tpf/os.h</tt>&nbsp;&nbsp;&nbsp;<em>or</em></li>
  +
  +          <li>add "<tt>-DTPF_HAVE_NSD</tt>" to the
  +          <tt>_C89_OPTIONS</tt> export in src/os/tpf/TPFExport</li>
  +
  +        </ul>
  +        <br />
  +
  +        <p>See <em>TPF Transmission Control Protocol/Internet Protocol</em> for more information
  +           about the TCP/IP network services database:
  +           <a href="http://www.ibm.com/tpf/pubs/tpfpubs.htm">http://www.ibm.com/tpf/pubs/tpfpubs.htm</a>.</p>
  +      </li>
  +
  +      <li><a id="export" name="export"></a>
  +      Set the TPF environment variables:
         <b><tt>.&nbsp;os/tpf/TPFExport</tt></b>&nbsp;<br />
         <br />
          <font color="#FF0000"><font size="+1">TIP:</font></font> The
  @@ -427,11 +436,10 @@
               <br />
                
   
  -            <div style="margin-left: 2em">
                 util_uri.c:&nbsp;&nbsp;&nbsp;<tt>Function argument
                 assignment between types "unsigned char*" and "const
                 unsigned char*" is not allowed.</tt>
  -            </div>
  +            <br />
               <br />
             </li>
   
  @@ -494,10 +502,10 @@
   
         <li>Ensure that the program name you are using for Apache has
         <tt>RESTRICT</tt> and <tt>KEY0</tt> authorization.
  -      <b><tt>zdpat&nbsp;<i>chta</i>&nbsp;</tt> &nbsp;(</b>c-c) will
  +      <b><tt>zdpat&nbsp;<i>chta</i>&nbsp;</tt>&nbsp;(</b>c-c) will
         display allocation information. You can use
         <b><tt>zapat&nbsp;<i>chta</i>&nbsp;restrict&nbsp;key0&nbsp;</tt></b>
  -      &nbsp;<tt>(<b>c-c</b>)</tt> to alter the authorization. Note
  +      <tt>(<b>c-c</b>)</tt> to alter the authorization. Note
         that if the program name is unallocated, you must have the
         loadset for it activated or you will receive <tt>INVALID
         PROGRAM NAME</tt> from the <tt>zdpat/zapat</tt>
  @@ -518,23 +526,20 @@
           example "<tt>/usr/local/apache</tt>")</p>
         </li>
   
  -      <li style="list-style: none">
  +      <li>
           <p>General documentation for Apache is located at <a
           href="http://httpd.apache.org/docs/">http://httpd.apache.org/docs/</a>
           and in the HTML pages included with the distribution
  -        (tarball) under the /htdocs/manual directory.&nbsp;
  +        (tarball) under the <tt>/htdocs/manual</tt> directory.&nbsp;
           &nbsp;</p>
         </li>
   
         <li>
  -        On TPF activate ZCLAW 
  +        On TPF activate your TCP/IP Offload (ZCLAW) or Native Stack communications device.
   
  -        <p>Refer to the TCP/IP Offload Support section of the
  -        <em>TPF TCP/IP</em> publication for more information: <a
  +        <p>Refer to the <em>TPF TCP/IP</em> publication for more information: <a
           href="http://www.ibm.com/tpf/pubs/tpfpubs.htm">http://www.ibm.com/tpf/pubs/tpfpubs.htm</a>.</p>
   
  -        <p>Note: Apache does not currently work with Native
  -        Stack.</p>
         </li>
   
         <li>
  @@ -583,10 +588,10 @@
   
           <ul>
             <li>For PUT11 and later use the DAEMON model for
  -          Apache:<tt><b>ZINET&nbsp;ADD&nbsp;S-APACHE&nbsp;PGM-<em>chta</em>&nbsp;MODEL-DAEMON&nbsp;USER-root</b></tt></li>
  +          Apache: <tt><b>ZINET&nbsp;ADD&nbsp;S-APACHE&nbsp;PGM-<em>chta</em>&nbsp;MODEL-DAEMON&nbsp;USER-root</b></tt></li>
   
             <li>On pre-PUT11 systems use the NOLISTEN model
  -          instead:<tt><b>ZINET&nbsp;ADD&nbsp;S-APACHE&nbsp;PGM-<em>chta</em>&nbsp;MODEL-NOLISTEN</b></tt></li>
  +          instead: <tt><b>ZINET&nbsp;ADD&nbsp;S-APACHE&nbsp;PGM-<em>chta</em>&nbsp;MODEL-NOLISTEN</b></tt></li>
           </ul>
           <br />
            <font color="red" size="4">TIP:</font> Logic changes
  @@ -630,23 +635,23 @@
       <ul>
         <li><i>"DEFINE - Define preprocessor macro name(s)"</i> must
         include <b><tt>TPF, CHARSET_EBCDIC, _POSIX_SOURCE,</tt></b>
  -      and <b><tt>USE_HSREGEX</tt></b><br />
  +      and <b><tt>USE_HSREGEX</tt></b>
          &nbsp;</li>
   
         <li><i>"LSEARCH - Path for user include files"</i> must
         include <b><tt>../src/include</tt></b> and
  -      <b><tt>../src/os/tpf</tt></b><br />
  +      <b><tt>../src/os/tpf</tt></b>
          &nbsp;</li>
   
  -      <li><i>"DLL - Generate DLL code"</i> must be checked<br />
  +      <li><i>"DLL - Generate DLL code"</i> must be checked
          &nbsp;</li>
   
         <li><i>"LONGNAME - Support long names"</i> must be
  -      checked<br />
  +      checked
          &nbsp;</li>
       </ul>
  -    <hr />
   
  +    <hr />
       <center>
         [ <a href="#top">top</a>&nbsp; | <a
         href="#download">Download</a>&nbsp; | <a