]> granicus.if.org Git - apache/commitdiff
update transformation of recent changes
authorAndré Malo <nd@apache.org>
Mon, 30 Jun 2003 01:16:33 +0000 (01:16 +0000)
committerAndré Malo <nd@apache.org>
Mon, 30 Jun 2003 01:16:33 +0000 (01:16 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@100409 13f79535-47bb-0310-9956-ffa450edef68

13 files changed:
docs/manual/bind.html.en
docs/manual/cgi_path.html.en
docs/manual/custom-error.html.en
docs/manual/developer/API.html.en
docs/manual/env.html.en
docs/manual/filter.html.en
docs/manual/handler.html.en
docs/manual/logs.html.en
docs/manual/mod/core.html.en
docs/manual/mod/mod_include.html.en
docs/manual/mod/quickreference.html.de
docs/manual/mod/quickreference.html.en
docs/manual/suexec.html.en

index 9e49239f2caee2eccf9dc5e56a523bc787bef802..6fa040244a4788080f4045b9901a0b63d9a1a4d9 100644 (file)
 <div class="section">
 <h2><a name="overview" id="overview">Overview</a></h2>
     
-    
+
     <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mpm_common.html">mpm_common</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code></li></ul></td></tr></table>
-    
-    
+
+
     <p>When Apache starts, it binds to some port and address on
     the local machine and waits for incoming requests. By default,
     it listens to all addresses on the machine.  However, it needs to
index 2b65515f096e42f0e11e21012009f422b219fd52..c5e3a833590b3eef2a2428349afbcf0ef60d607f 100644 (file)
@@ -50,7 +50,7 @@
     <div class="example"><p><code>
       Alias /cgi-ralph /usr/local/httpd/cgi-bin/user.cgi/ralph
     </code></p></div>    
-    
+
     <p>In this case, <code>user.cgi</code> is the CGI script, the
     "/ralph" is information to be passed onto the CGI. If this
     configuration was in place, and a request came for
index 059ba07e5b1c7cd4f34af746cee6f0364e42d624..ea201eac3826e0bf271357e9cb2599392224412f 100644 (file)
 
     <p>Additional functionality allows webmasters to configure the response 
     of Apache to some error or problem.</p>
-    
+
     <p>Customizable responses can be defined to be activated in the event of 
     a server detected error or problem.</p>
-    
+
     <p>If a script crashes and produces a "500 Server Error" response, 
     then this response can be replaced with either some friendlier text or by 
     a redirection to another URL (local or external).</p>
 <div class="section">
 <h2><a name="behavior" id="behavior">Behavior</a></h2>
     
-    
+
     <h3>Old Behavior</h3>
       
-      
+
       <p>NCSA httpd 1.3 would return some boring old error/problem message 
       which would often be meaningless to the user, and would provide no 
       means of logging the symptoms which caused it.</p>
     
-    
+
     <h3>New Behavior</h3>
       
-      
+
       <p>The server can be asked to:</p>
-      
+
       <ol>
         <li>Display some other text, instead of the NCSA hard coded 
         messages, or</li>
-      
+
         <li>redirect to a local URL, or</li>
-      
+
         <li>redirect to an external URL.</li>
       </ol>
-      
+
       <p>Redirecting to another URL can be useful, but only if some 
       information can be passed which can then be used to explain and/or log 
       the error/problem more clearly.</p>
-      
+
       <p>To achieve this, Apache will define new CGI-like environment 
       variables:</p>
-      
+
       <div class="example"><p><code>
         REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/x-xbitmap, 
             image/jpeg<br />
@@ -85,9 +85,9 @@
         REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br />
         REDIRECT_URL=/cgi-bin/buggy.pl
       </code></p></div>
-      
+
       <p>Note the <code>REDIRECT_</code> prefix.</p>
-      
+
       <p>At least <code>REDIRECT_URL</code> and
       <code>REDIRECT_QUERY_STRING</code> will be passed to the
       new URL (assuming it's a cgi-script or a cgi-include). The
 <div class="section">
 <h2><a name="configuration" id="configuration">Configuration</a></h2>
     
-    
+
     <p>Use of <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> is enabled 
     for .htaccess files when the 
     <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> is set accordingly.</p>
-    
+
     <p>Here are some examples...</p>
-    
+
     <div class="example"><p><code>
       ErrorDocument 500 /cgi-bin/crash-recover <br />
       ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br />
       ErrorDocument 404 /Lame_excuses/not_found.html <br />
       ErrorDocument 401 /Subscription/how_to_subscribe.html
     </code></p></div>
-    
+
     <p>The syntax is,</p>
-    
+
     <div class="example"><p><code>
       ErrorDocument &lt;3-digit-code&gt; &lt;action&gt;
     </code></p></div>
-    
+
     <p>where the action can be,</p>
-    
+
     <ol>
       <li>Text to be displayed. Prefix the text with a quote
       ("). Whatever follows the quote is displayed. <em>Note:
       the (") prefix isn't displayed.</em></li>
-    
+
       <li>An external URL to redirect to.</li>
-    
+
       <li>A local URL to redirect to.</li>
     </ol>
   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="custom" id="custom">Custom Error Responses and Redirects</a></h2>
     
-    
+
     <p>Apache's behavior to redirected URLs has been modified so
     that additional environment variables are available to a
     script/server-include.</p>
-    
+
     <h3>Old behavior</h3>
       
-    
+
       <p>Standard CGI vars were made available to a script which
       has been redirected to. No indication of where the
       redirection came from was provided.</p>
     
-    
+
     <h3>New behavior</h3>
       
-    
+
       <p>A new batch of environment variables will be initialized
       for use by a script which has been redirected to. Each new
       variable will have the prefix <code>REDIRECT_</code>.
       and <code>REDIRECT_STATUS</code> to help the script trace its
       origin. Both the original URL and the URL being redirected to
       can be logged in the access log.</p>
-    
+
       <p>If the ErrorDocument specifies a local redirect to a CGI
       script, the script should include a "<code>Status:</code>"
       header field in its output in order to ensure the propagation
       all the way back to the client of the error condition that
       caused it to be invoked. For instance, a Perl ErrorDocument
       script might include the following:</p>
-    
+
       <div class="example"><p><code>
         ... <br />
         print  "Content-type: text/html\n"; <br />
         printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />
         ...
       </code></p></div>
-    
+
       <p>If the script is dedicated to handling a particular error
       condition, such as <code>404&nbsp;Not&nbsp;Found</code>, it can
       use the specific code and error text instead.</p>
index 3d1d2e2c5b2898d1d313b333f87cc2f6ae5202f6..5165ce56a8c7d8bff554dcaf326bfa27b955e36c 100644 (file)
@@ -355,8 +355,9 @@ struct stat finfo;    /* Set by server core;
 </code></p><pre>int header_only;     /* HEAD request, as opposed to GET */
 char *protocol;      /* Protocol, as given to us, or HTTP/0.9 */
 char *method;        /* GET, HEAD, POST, <em>etc.</em> */
-int method_number;   /* M_GET, M_POST, <em>etc.</em> */</pre><p><code>
-        <br />
+int method_number;   /* M_GET, M_POST, <em>etc.</em> */
+
+</pre><p><code>
         /* Info for logging */<br />
         <br />
         char *the_request;<br />
index 553524e3466359df0219e511cc1c1af655ae101e..8891345ba9597e5282fb18e1b2da01b294f60076 100644 (file)
@@ -30,7 +30,7 @@
     also used as a mechanism to communicate with external programs
     such as CGI scripts. This document discusses different ways to
     manipulate and use these variables.</p>
-        
+
     <p>Although these variables are referred to as <em>environment
     variables</em>, they are not the same as the environment
     variables controlled by the underlying operating system.
 <h2><a name="setting" id="setting">Setting Environment Variables</a></h2>
     
     <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_env.html">mod_env</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li><li><code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#unsetenv">UnsetEnv</a></code></li></ul></td></tr></table>
-    
+
     <h3><a name="basic-manipulation" id="basic-manipulation">Basic Environment Manipulation</a></h3>
         
-    
+
         <p>The most basic way to set an environment variable in Apache
         is using the unconditional <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> directive. Variables may also be passed from
         the environment of the shell which started the server using the
         <code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code> directive.</p>
-    
+
     
     <h3><a name="conditional" id="conditional">Conditional Per-Request Settings</a></h3>
         
-    
+
         <p>For additional flexibility, the directives provided by
         mod_setenvif allow environment variables to be set on a
         per-request basis, conditional on characteristics of particular
         a specific Referer [sic] header is found. Even more flexibility
         is available through the mod_rewrite's <code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> which uses the 
         <code>[E=...]</code> option to set environment variables.</p>
-    
+
     
     <h3><a name="unique-identifiers" id="unique-identifiers">Unique Identifiers</a></h3>
         
-    
+
         <p>Finally, mod_unique_id sets the environment variable
         <code>UNIQUE_ID</code> for each request to a value which is
         guaranteed to be unique across "all" requests under very
         specific conditions.</p>
-    
+
     
     <h3><a name="standard-cgi" id="standard-cgi">Standard CGI Variables</a></h3>
         
-    
+
         <p>In addition to all environment variables set within the
         Apache configuration and passed from the shell, CGI scripts and
         SSI pages are provided with a set of environment variables
         containing meta-information about the request as required by
         the <a href="http://cgi-spec.golux.com/">CGI
         specification</a>.</p>
-    
+
     
     <h3><a name="caveats" id="caveats">Some Caveats</a></h3>
         
-    
+
         <ul>
           <li>It is not possible to override or change the standard CGI
           variables using the environment manipulation directives.</li>
-    
+
           <li>When <a href="suexec.html">suexec</a> is used to launch
           CGI scripts, the environment will be cleaned down to a set of
           <em>safe</em> variables before CGI scripts are launched. The
           list of <em>safe</em> variables is defined at compile-time in
           <code>suexec.c</code>.</li>
-    
+
           <li>For portability reasons, the names of environment
           variables may contain only letters, numbers, and the
           underscore character. In addition, the first character may
 <div class="section">
 <h2><a name="using" id="using">Using Environment Variables</a></h2>
     
-    
+
     <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authz_host.html#allow">Allow</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_authz_host.html#deny">Deny</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li></ul></td></tr></table>
 
     <h3><a name="cgi-scripts" id="cgi-scripts">CGI Scripts</a></h3>
         
-    
+
         <p>One of the primary uses of environment variables is to
         communicate information to CGI scripts. As discussed above, the
         environment passed to CGI scripts includes standard
         meta-information about the request in addition to any variables
         set within the Apache configuration. For more details, see the
         <a href="howto/cgi.html">CGI tutorial</a>.</p>
-    
+
     
     <h3><a name="ssi-pages" id="ssi-pages">SSI Pages</a></h3>
         
-    
+
         <p>Server-parsed (SSI) documents processed by mod_include's
         <code>INCLUDES</code> filter can print environment variables
         using the <code>echo</code> element, and can use environment
         conditional on characteristics of a request. Apache also
         provides SSI pages with the standard CGI environment variables
         as discussed above. For more details, see the <a href="howto/ssi.html">SSI tutorial</a>.</p>
-    
+
     
     <h3><a name="access-control" id="access-control">Access Control</a></h3>
         
-    
+
         <p>Access to the server can be controlled based on the value of
         environment variables using the <code>allow from env=</code>
         and <code>deny from env=</code> directives. In combination with
         characteristics of the client. For example, you can use these 
         directives to deny access to a particular browser (User-Agent).
         </p>
-    
+
     
     <h3><a name="logging" id="logging">Conditional Logging</a></h3>
         
-    
+
         <p>Environment variables can be logged in the access log using
         the <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>
         option <code>%e</code>. In addition, the decision on whether
         requests for filenames ending in <code>gif</code>, or you can
         choose to only log requests from clients which are outside your
         subnet.</p>
-    
+
     
     <h3><a name="response-headers" id="response-headers">Conditional Response Headers</a></h3>
         
-    
+
         <p>The <code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code>
         directive can use the presence or
         absence of an environment variable to determine whether or not
         client. This allows, for example, a certain response header to
         be sent only if a corresponding header is received in the
         request from the client.</p>
-    
+
     
 
     <h3><a name="external-filter" id="external-filter">External Filter Activation</a></h3>
 
     <h3><a name="url-rewriting" id="url-rewriting">URL Rewriting</a></h3>
         
-    
+
         <p>The <code>%{ENV:...}</code> form of <em>TestString</em> in
         the <code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
         allows mod_rewrite's rewrite
 <div class="section">
 <h2><a name="special" id="special">Special Purpose Environment Variables</a></h2>
     
-    
+
         <p>Interoperability problems have led to the introduction of
         mechanisms to modify the way Apache behaves when talking to
         particular clients. To make these mechanisms as flexible as
         possible, they are invoked by defining environment variables,
         typically with <code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>, though <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> and  <code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code> could also be used, for example.</p>
-    
+
     <h3><a name="downgrade" id="downgrade">downgrade-1.0</a></h3>
         
-    
+
         <p>This forces the request to be treated as a HTTP/1.0 request
         even if it was in a later dialect.</p>
-    
+
     
     <h3><a name="force-no-vary" id="force-no-vary">force-no-vary</a></h3>
         
-    
+
         <p>This causes any <code>Vary</code> fields to be removed from
         the response header before it is sent back to the client. Some
         clients don't interpret this field correctly; setting this
     
     <h3><a name="force-response" id="force-response">force-response-1.0</a></h3>
         
-    
+
       <p>This forces an HTTP/1.0 response to clients making an HTTP/1.0
       request. It was originally
       implemented as a result of a problem with AOL's proxies. Some
 
     <h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3>
         
-    
+
         <p>This disables <code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code>
         when set.</p>
-    
+
     
 
     <h3><a name="prefer-language" id="prefer-language">prefer-language</a></h3>
-    
+
         <p>This influences <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>'s behaviour. If
         it contains a language tag (such as <code>en</code>, <code>ja</code>
         or <code>x-klingon</code>), <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> tries
         to deliver a variant with that language. If there's no such variant,
         the normal <a href="content-negotiation.html">negotiation</a> process
         applies.</p>
-    
+
     
 
     <h3><a name="redirect-carefully" id="redirect-carefully">redirect-carefully</a></h3>
         
-    
+
         <p>This forces the server to be more careful when sending a redirect
         to the client.  This is typically used when a client has a known
         problem handling redirects.  This was originally implemented as a
         result of a problem with Microsoft's WebFolders software which has
         a problem handling redirects on directory resources via DAV 
         methods.</p>
-    
+
     
 
    <h3><a name="suppress-error-charset" id="suppress-error-charset">suppress-error-charset</a></h3>
 <div class="section">
 <h2><a name="examples" id="examples">Examples</a></h2>
     
-    
+
     <h3><a name="misbehaving" id="misbehaving">Changing protocol behavior with misbehaving clients</a></h3>
         
-    
+
         <p>We recommend that the following lines be included in
         httpd.conf to deal with known client problems.</p>
 <div class="example"><pre>
@@ -354,7 +354,7 @@ BrowserMatch "JDK/1\.0" force-response-1.0</pre></div>
     
     <h3><a name="no-img-log" id="no-img-log">Do not log requests for images in the access log</a></h3>
         
-    
+
         <p>This example keeps requests for images from appearing in the
         access log. It can be easily modified to prevent logging of
         particular directories, or to prevent logging of requests
@@ -364,11 +364,11 @@ SetEnvIf Request_URI \.gif image-request
 SetEnvIf Request_URI \.jpg image-request
 SetEnvIf Request_URI \.png image-request
 CustomLog logs/access_log common env=!image-request</pre></div>
-    
+
     
     <h3><a name="image-theft" id="image-theft">Prevent "Image Theft"</a></h3>
         
-    
+
         <p>This example shows how to keep people not on your server
         from using images on your server as inline-images on their
         pages. This is not a recommended configuration, but it can work
@@ -383,7 +383,7 @@ SetEnvIf Referer "^$" local_referal
    Deny from all
    Allow from env=local_referal
 &lt;/Directory&gt;</pre></div>
-    
+
         <p>For more information about this technique, see the
         ApacheToday tutorial " <a href="http://apachetoday.com/news_story.php3?ltsn=2000-06-14-002-01-PS">
     Keeping Your Images from Adorning Other Sites</a>".</p>
index 846042d95361b679e0366f9044c86f4be4114251..57a0788d837fb0ab430f8e792b63a112eb508682 100644 (file)
@@ -30,7 +30,7 @@
 <h2><a name="filters" id="filters">Filters</a></h2>
     
     <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilteroptions">ExtFilterOptions</a></code></li><li><code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code></li><li><code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code></li></ul></td></tr></table>
-    
+
     <p>A <em>filter</em> is a process that is applied to data that
     is sent or received by the server. Data sent by clients to the
     server is processed by <em>input filters</em> while data sent
index 962c76102daa015057ccb122a60541067102dadf..a1eac4403ebec00249ed40fac1d6873f6c2c002b 100644 (file)
@@ -34,7 +34,7 @@
 <h2><a name="definition" id="definition">What is a Handler</a></h2>
     
     <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_actions.html">mod_actions</a></code></li><li><code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_imap.html">mod_imap</a></code></li><li><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></li><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li><li><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></li><li><code class="module"><a href="./mod/mod_status.html">mod_status</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removehandler">RemoveHandler</a></code></li><li><code class="directive"><a href="./mod/core.html#sethandler">SetHandler</a></code></li></ul></td></tr></table>
-    
+
 
     <p>A "handler" is an internal Apache representation of the
     action to be performed when a file is called. Generally, files
@@ -89,7 +89,7 @@
       <p>The following directives will cause requests for files with
       the <code>html</code> extension to trigger the launch of the
       <code>footer.pl</code> CGI script.</p>
-      
+
       <div class="example"><p><code>
         Action add-footer /cgi-bin/footer.pl<br />
         AddHandler add-footer .html
@@ -99,7 +99,7 @@
       originally requested document (pointed to by the
       <code>PATH_TRANSLATED</code> environment variable) and making
       whatever modifications or additions are desired.</p>
+
     
     <h3><a name="example2" id="example2">Files with HTTP headers</a></h3>
       
         SetHandler send-as-is<br />
         &lt;/Directory&gt;
       </code></p></div>
-      
+
     
   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 <div class="section">
index 3697458c174f2497df29fc8450cdcee56aca6c23..faca3f3c32de81ce7ee05893f3115f0660b52686 100644 (file)
@@ -43,7 +43,7 @@
 <div class="section">
 <h2><a name="security" id="security">Security Warning</a></h2>
     
-    
+
     <p>Anyone who can write to the directory where Apache is
     writing a log file can almost certainly gain access to the uid
     that the server is started as, which is normally root. Do
@@ -61,9 +61,9 @@
 <div class="section">
 <h2><a name="errorlog" id="errorlog">Error Log</a></h2>
     
-    
+
     <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code></li></ul></td></tr></table>
-    
+
     <p>The server error log, whose name and location is set by the
     <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> directive, is the
     most important log file. This is the place where Apache httpd
     is also possible to have the server send errors to
     <code>syslog</code> or <a href="#piped">pipe them to a
     program</a>.</p>
-    
+
     <p>The format of the error log is relatively free-form and
     descriptive. But there is certain information that is contained
     in most error log entries. For example, here is a typical
     message.</p>
-    
+
     <div class="example"><p><code>
       [Wed Oct 11 14:32:52 2000] [error] [client 127.0.0.1]
       client denied by server configuration:
       /export/home/live/ap/htdocs/test
     </code></p></div>
-    
+
     <p>The first item in the log entry is the date and time of the
     message. The second entry lists the severity of the error being
     reported. The <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code>
     Since it is possible to customize the access log, you can
     obtain more information about error conditions using that log
     file.</p>
-    
+
     <p>During testing, it is often useful to continuously monitor
     the error log for any problems. On unix systems, you can
     accomplish this using:</p>
-    
+
     <div class="example"><p><code>
       tail -f error_log
     </code></p></div>
 <div class="section">
 <h2><a name="accesslog" id="accesslog">Access Log</a></h2>
     
-    
+
     <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li></ul></td></tr></table>
-    
+
     <p>The server access log records all requests processed by the
     server. The location and content of the access log are
     controlled by the <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
     analysis, check the <a href="http://dmoz.org/Computers/Software/Internet/Site_Management/Log_analysis/">
     Open Directory</a> or <a href="http://dir.yahoo.com/Computers_and_Internet/Software/Internet/World_Wide_Web/Servers/Log_Analysis_Tools/">
     Yahoo</a>.</p>
-    
+
     <p>Various versions of Apache httpd have used other modules and
     directives to control access logging, including
     mod_log_referer, mod_log_agent, and the
     printf(1) format string. Some examples are presented in the next
     sections. For a complete list of the possible contents of the
     format string, see the <code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code> <a href="mod/mod_log_config.html#formats">format strings</a>.</p>
-    
+
     <h3><a name="common" id="common">Common Log Format</a></h3>
       
-    
+
       <p>A typical configuration for the access log might look as
       follows.</p>
 
         LogFormat "%h %l %u %t \"%r\" %&gt;s %b" common<br />
          CustomLog logs/access_log common
       </code></p></div>
-    
+
       <p>This defines the <em>nickname</em> <code>common</code> and
       associates it with a particular log format string. The format
       string consists of percent directives, each of which tell the
          <em>nickname</em>. The filename for the access log is relative to
          the <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> unless it
          begins with a slash.</p>
-    
+
       <p>The above configuration will write log entries in a format
       known as the Common Log Format (CLF). This standard format can
       be produced by many different web servers and read by many log
         127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
         /apache_pb.gif HTTP/1.0" 200 2326
       </code></p></div>
-    
+
       <p>Each part of this log entry is described below.</p>
-    
+
       <dl>
         <dt><code>127.0.0.1</code> (<code>%h</code>)</dt>
 
         <code>%B</code> instead.</dd>
       </dl>
     
-    
+
     <h3><a name="combined" id="combined">Combined Log Format</a></h3>
       
-      
+
       <p>Another commonly used format string is called the Combined
       Log Format. It can be used as follows.</p>
 
       <code>%{<em>header</em>}i</code>, where <em>header</em> can be
       any HTTP request header. The access log under this format will
       look like:</p>
-      
+
       <div class="example"><p><code>
         127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
         /apache_pb.gif HTTP/1.0" 200 2326
       </code></p></div>
 
       <p>The additional fields are:</p>
-      
+
       <dl>
         <dt><code>"http://www.example.com/start.html"</code>
         (<code>\"%{Referer}i\"</code>)</dt>
         itself.</dd>
       </dl>
     
-    
+
     <h3><a name="multiple" id="multiple">Multiple Access Logs</a></h3>
       
-      
+
       <p>Multiple access logs can be created simply by specifying
       multiple <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> 
       directives in the configuration
       nickname with the <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> directive. Instead,
       the log format can be specified directly in the <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> directive.</p>
     
-    
+
     <h3><a name="conditional" id="conditional">Conditional Logs</a></h3>
       
-      
+
       <p>There are times when it is convenient to exclude certain
       entries from the access logs based on characteristics of the
       client request. This is easily accomplished with the help of <a href="env.html">environment variables</a>. First, an
 <div class="section">
 <h2><a name="rotation" id="rotation">Log Rotation</a></h2>
     
-    
+
     <p>On even a moderately busy server, the quantity of
     information stored in the log files is very large. The access
     log file typically grows 1 MB or more per 10,000 requests. It
 <div class="section">
 <h2><a name="piped" id="piped">Piped Logs</a></h2>
     
-    
+
     <p>Apache httpd is capable of writing error and access log
     files through a pipe to another process, rather than directly
     to a file. This capability dramatically increases the
       CustomLog "|/usr/local/apache/bin/rotatelogs
       /var/log/access_log 86400" common
     </code></p></div>
-    
+
     <p>Notice that quotes are used to enclose the entire command
     that will be called for the pipe. Although these examples are
     for the access log, the same technique can be used for the
 <div class="section">
 <h2><a name="virtualhost" id="virtualhost">Virtual Hosts</a></h2>
     
-    
+
     <p>When running a server with many <a href="vhosts/">virtual
     hosts</a>, there are several options for dealing with log
     files. First, it is possible to use logs exactly as in a
 <div class="section">
 <h2><a name="other" id="other">Other Log Files</a></h2>
     
-    
+
     <table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritelog">RewriteLog</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriteloglevel">RewriteLogLevel</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptloglength">ScriptLogLength</a></code></li></ul></td></tr></table>
-    
+
     <h3><a name="pidfile" id="pidfile">PID File</a></h3>
       
-    
+
       <p>On startup, Apache httpd saves the process id of the parent
       httpd process to the file <code>logs/httpd.pid</code>. This
       filename can be changed with the <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> directive. The
       For more information see the <a href="stopping.html">Stopping
       and Restarting</a> page.</p>    
     
-    
+
     <h3><a name="scriptlog" id="scriptlog">Script Log</a></h3>
       
-      
+
       <p>In order to aid in debugging, the
       <code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code> directive
       allows you to record the input to and output from CGI scripts.
       This should only be used in testing - not for live servers.
       More information is available in the <a href="mod/mod_cgi.html">mod_cgi</a> documentation.</p>
     
-    
+
     <h3><a name="rewritelog" id="rewritelog">Rewrite Log</a></h3>
       
-      
+
       <p>When using the powerful and complex features of <a href="mod/mod_rewrite.html">mod_rewrite</a>, it is almost
       always necessary to use the <code class="directive"><a href="./mod/mod_rewrite.html#rewritelog">RewriteLog</a></code> to help
       in debugging. This log file produces a detailed analysis of how
index 3c1f118bfc7f118e8b11613f4ad3751610799c56..9b1921737c9ea6ed4bedcb96713904d10acfbe0f 100644 (file)
@@ -2494,7 +2494,7 @@ later</td></tr>
       #!C:/Perl/bin/perl.exe
     </code></p></div>
 
-    <p>or, if perl is in <code>PATH</code>, simply:</p>
+    <p>or, if perl is in the <code>PATH</code>, simply:</p>
 
     <div class="example"><p><code>
       #!perl
@@ -2504,29 +2504,31 @@ later</td></tr>
     cause the Windows Registry tree <code>HKEY_CLASSES_ROOT</code> to be
     searched using the script file extension (e.g., <code>.pl</code>) as a
     search key. The command defined by the registry subkey
-    <code>Shell\ExecCGI\Command</code> or if not exists by the subkey
-    <code>Shell\Open\Command</code> is used to open the script file. In absence
-    of the file extension key or both subkeys Apache uses the
+    <code>Shell\ExecCGI\Command</code> or, if it does not exist, by the subkey
+    <code>Shell\Open\Command</code> is used to open the script file. If the
+    registry keys cannot be found, Apache falls back to the behavior of the
     <code>Script</code> option.</p>
 
-    <div class="warning"><h3>Security</h3>
-      <p>Be careful to use <code>ScriptInterpreterSource Registry</code> with 
-      <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>'ed directories,
-      because Apache is trying to execute <strong>every</strong> file within
-      this directory. The <code>Registry</code> setting may cause undesired
-      program calls on files, which are usually not executed. For example, the
-      default open command on <code>.htm</code> files on most Windows systems is
-      executing the Microsoft Internet Explorer, so any HTTP request for an
-      <code>.htm</code> file existing within the script directory would start
-      the browser in background. This is an effective method to crash your
-      system within a minute or so.</p>
+    <div class="warning"><h3>Security</h3> 
+    <p>Be careful when using <code>ScriptInterpreterSource
+    Registry</code> with <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>'ed directories, because
+    Apache will try to execute <strong>every</strong> file within this
+    directory. The <code>Registry</code> setting may cause undesired
+    program calls on files which are typically not executed. For
+    example, the default open command on <code>.htm</code> files on
+    most Windows systems will execute Microsoft Internet Explorer, so
+    any HTTP request for an <code>.htm</code> file existing within the
+    script directory would start the browser in the background on the
+    server. This is a good way to crash your system within a minute or
+    so.</p>
     </div>
 
-    <p>The option <code>Registry-Strict</code> which is new in Apache 2.0
-      does the same as <code>Registry</code> but uses only the subkey
-      <code>Shell\ExecCGI\Command</code>. The <code>ExecCGI</code> key
-      is not a common one. It has to be configured manually and prevents your
-      system from accidental program calls.</p>
+    <p>The option <code>Registry-Strict</code> which is new in Apache
+    2.0 does the same thing as <code>Registry</code> but uses only the
+    subkey <code>Shell\ExecCGI\Command</code>. The
+    <code>ExecCGI</code> key is not a common one. It must be
+    configured manually in the windows registry and hence prevents
+    accidental program calls on your system.</p>
 
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
index 7fbc96ab20ddba1a3a8dd554f6cfc9db958f2fb6..cfa8e1c41bbf076b095096c87897c17e5603115c 100644 (file)
@@ -636,7 +636,7 @@ directive]"</code></td></tr>
 <table class="directive">
 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>String that starts an include element</td></tr>
 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SSIStartTag <var>tag</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>SSIStartTag "&lt;!--"</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>SSIStartTag "&lt;!--#"</code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_include</td></tr>
@@ -659,7 +659,7 @@ directive]"</code></td></tr>
     below:</p>
 
     <div class="example"><h3>SSI directives with alternate start and end tags</h3><p><code>
-      &lt;%#printenv %&gt;
+      &lt;%printenv %&gt;
     </code></p></div>
 
 <h3>See also</h3>
index aaa35df6074f626093251b236c53c310e3cddabd..eec7221e70814f8e92d07d80f7ebb9546277995a 100644 (file)
@@ -621,7 +621,7 @@ verarbeiten</td></tr>
 <tr><td><a href="mod_include.html#ssiendtag">SSIEndTag <var>tag</var></a></td><td> "--&gt;" </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">String that ends an include element</td></tr>
 <tr class="odd"><td><a href="mod_include.html#ssierrormsg">SSIErrorMsg <var>message</var></a></td><td> "[an error occurred +</td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Error message displayed when there is an SSI
 error</td></tr>
-<tr><td><a href="mod_include.html#ssistarttag">SSIStartTag <var>tag</var></a></td><td> "&lt;!--" </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">String that starts an include element</td></tr>
+<tr><td><a href="mod_include.html#ssistarttag">SSIStartTag <var>tag</var></a></td><td> "&lt;!--#" </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">String that starts an include element</td></tr>
 <tr class="odd"><td><a href="mod_include.html#ssitimeformat">SSITimeFormat <var>formatstring</var></a></td><td> "%A, %d-%b-%Y %H:%M +</td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Configures the format in which date strings are
 displayed</td></tr>
 <tr><td><a href="mod_include.html#ssiundefinedecho">SSIUndefinedEcho <var>string</var></a></td><td> "(none)" </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">String displayed when an unset variable is echoed</td></tr>
index add14efd162a8e5da8086e4bad1949f754ce1c7b..c62a9a7fee07cfd15bb68df48dcdc8ec8315fc4f 100644 (file)
@@ -606,7 +606,7 @@ server</td></tr>
 <tr><td><a href="mod_include.html#ssiendtag">SSIEndTag <var>tag</var></a></td><td> "--&gt;" </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">String that ends an include element</td></tr>
 <tr class="odd"><td><a href="mod_include.html#ssierrormsg">SSIErrorMsg <var>message</var></a></td><td> "[an error occurred +</td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Error message displayed when there is an SSI
 error</td></tr>
-<tr><td><a href="mod_include.html#ssistarttag">SSIStartTag <var>tag</var></a></td><td> "&lt;!--" </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">String that starts an include element</td></tr>
+<tr><td><a href="mod_include.html#ssistarttag">SSIStartTag <var>tag</var></a></td><td> "&lt;!--#" </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">String that starts an include element</td></tr>
 <tr class="odd"><td><a href="mod_include.html#ssitimeformat">SSITimeFormat <var>formatstring</var></a></td><td> "%A, %d-%b-%Y %H:%M +</td><td>svdh</td><td>B</td></tr><tr class="odd"><td class="descr" colspan="4">Configures the format in which date strings are
 displayed</td></tr>
 <tr><td><a href="mod_include.html#ssiundefinedecho">SSIUndefinedEcho <var>string</var></a></td><td> "(none)" </td><td>sv</td><td>B</td></tr><tr><td class="descr" colspan="4">String displayed when an unset variable is echoed</td></tr>
index 939674a47229a2dbebf99a0b648d29bbd88ccb6a..a32304a7ad43addc705ae318664b0dd955e3e6d2 100644 (file)
 
       <li>
         <strong>Is the target user <em>NOT</em> superuser?</strong>
-        
+
 
         <p class="indent">
           Presently, suEXEC does not allow 'root' to execute