From: Rich Bowen <rbowen@apache.org>
Date: Mon, 28 Oct 2002 01:52:01 +0000 (+0000)
Subject: Add examples of using ErrorLog, particularly logging to syslog.
X-Git-Tag: 2.0.44~210
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=63b5ab7783c610a6b72b501ad4fdc60e2fa549ad;p=apache

Add examples of using ErrorLog, particularly logging to syslog.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@97318 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/core.html.en b/docs/manual/mod/core.html.en
index 49c7468ebd..b7f094fd25 100644
--- a/docs/manual/mod/core.html.en
+++ b/docs/manual/mod/core.html.en
@@ -759,10 +759,20 @@ ErrorLog logs/error.log (Windows and OS/2)</code></td></tr><tr><th><a href="dire
     <p>The <code class="directive">ErrorLog</code> directive sets the name of
     the file to which the server will log any errors it encounters. If
     the <var>file-path</var> does not begin with a slash (/) then it is
-    assumed to be relative to the <code class="directive"><a href="#serverroot">ServerRoot</a></code>. If the <var>file-path</var>
+    assumed to be relative to the <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
+
+    <div class="example"><h3>Example</h3><p><code>
+    ErrorLog /var/log/httpd/error_log
+    </code></p></div>
+    
+    <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>
 
+    <div class="example"><h3>Example</h3><p><code>
+    ErrorLog "|/usr/local/bin/httpd_errors"
+    </code></p></div>
+
     <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
@@ -770,6 +780,10 @@ ErrorLog logs/error.log (Windows and OS/2)</code></td></tr><tr><th><a href="dire
     <var>facility</var> can be one of the names usually documented in
     syslog(1).</p>
 
+    <div class="example"><h3>Example</h3><p><code>
+    ErrorLog syslog:user
+    </code></p></div>
+
     <p>SECURITY: See the <a href="../misc/security_tips.html#serverroot">security tips</a>
     document for details on why your security could be compromised
     if the directory where logfiles are stored is writable by
diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index ae88d9b231..03dd1ec54f 100644
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -851,10 +851,20 @@ ErrorLog logs/error.log (Windows and OS/2)</default>
     the file to which the server will log any errors it encounters. If
     the <var>file-path</var> does not begin with a slash (/) then it is
     assumed to be relative to the <directive
-    module="core">ServerRoot</directive>. If the <var>file-path</var>
+    module="core">ServerRoot</directive>.</p>
+
+    <example><title>Example</title>
+    ErrorLog /var/log/httpd/error_log
+    </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>
 
+    <example><title>Example</title>
+    ErrorLog "|/usr/local/bin/httpd_errors"
+    </example>
+
     <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
@@ -862,6 +872,10 @@ ErrorLog logs/error.log (Windows and OS/2)</default>
     <var>facility</var> can be one of the names usually documented in
     syslog(1).</p>
 
+    <example><title>Example</title>
+    ErrorLog syslog:user
+    </example>
+
     <p>SECURITY: See the <a
     href="../misc/security_tips.html#serverroot">security tips</a>
     document for details on why your security could be compromised