httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rj...@apache.org
Subject svn commit: r989598 - in /httpd/httpd/branches/2.2.x/docs/manual: logs.xml mod/core.xml mod/mod_log_config.xml
Date Thu, 26 Aug 2010 10:51:43 GMT
Author: rjung
Date: Thu Aug 26 10:51:43 2010
New Revision: 989598

URL: http://svn.apache.org/viewvc?rev=989598&view=rev
Log:
Add information about "||" piped log syntax
to the docs.

Modified:
    httpd/httpd/branches/2.2.x/docs/manual/logs.xml
    httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml
    httpd/httpd/branches/2.2.x/docs/manual/mod/mod_log_config.xml

Modified: httpd/httpd/branches/2.2.x/docs/manual/logs.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/logs.xml?rev=989598&r1=989597&r2=989598&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/logs.xml (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/logs.xml Thu Aug 26 10:51:43 2010
@@ -513,6 +513,22 @@
     <p>As with conditional logging, piped logs are a very powerful
     tool, but they should not be used where a simpler solution like
     off-line post-processing is available.</p>
+
+    <p>By default the piped log process is spawned using a shell.
+    (usually with <code>/bin/sh -c</code>).
+    Depending on the shell specifics invocation via shell might
+    lead to an additional shell process for the lifetime of the
+    logging pipe program and signal handling problems during
+    restart.</p>
+
+    <p>Use "<code>||</code>" instead of "<code>|</code>"
+    to spawn without invoking a shell:</p>
+
+    <example>
+      # Invoke "rotatelogs" without using a shell<br />
+      CustomLog "||/usr/local/apache/bin/rotatelogs
+      /var/log/access_log 86400" common
+    </example>
   </section>
 
   <section id="virtualhost">

Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml?rev=989598&r1=989597&r2=989598&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/core.xml Thu Aug 26 10:51:43 2010
@@ -1098,13 +1098,16 @@ in case of an error</description>
     </example>
 
     <p>If the <var>file-path</var>
-    begins with a pipe (|) then it is assumed to be a command to spawn
-    to handle the error log.</p>
+    begins with a pipe character "<code>|</code>" then it is assumed to be a
+    command to spawn to handle the error log.</p>
 
     <example><title>Example</title>
     ErrorLog "|/usr/local/bin/httpd_errors"
     </example>
 
+    <p>See the notes on <a href="../logs.html#piped">piped logs</a> for
+    more information.</p>
+
     <p>Using <code>syslog</code> instead of a filename enables logging
     via syslogd(8) if the system supports it. The default is to use
     syslog facility <code>local7</code>, but you can override this by

Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/mod_log_config.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/mod/mod_log_config.xml?rev=989598&r1=989597&r2=989598&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/mod_log_config.xml (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/mod_log_config.xml Thu Aug 26 10:51:43 2010
@@ -377,7 +377,8 @@
       <dt><var>pipe</var></dt>
       <dd>The pipe character "<code>|</code>", followed by the path
       to a program to receive the log information on its standard
-      input.
+      input. See the notes on <a href="../logs.html#piped">piped logs</a>
+      for more information.
 
       <note type="warning"><title>Security:</title>
       <p>If a program is used, then it will be run as the user who



Mime
View raw message