Add Q&A about logging Referer: and User-Agent: headers.

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

diff --git a/docs/manual/misc/FAQ.html b/docs/manual/misc/FAQ.html
index e1feed2ccdb88ad0a74988bc91d88b17a3b03b46..969b5d1ea3f0670974d0fcf4943172d74f2f1c3a 100644 (file)
--- a/docs/manual/misc/FAQ.html
+++ b/docs/manual/misc/FAQ.html
@@ -8,7 +8,7 @@
   <!--#include virtual="header.html" -->
   <H1>Apache Server Frequently Asked Questions</H1>
   <P>
-  $Revision: 1.51 $ ($Date: 1997/05/04 16:44:08 $)
+  $Revision: 1.52 $ ($Date: 1997/05/04 17:05:25 $)
   </P>
   <P>
   The latest version of this FAQ is always available from the main
@@ -54,7 +54,6 @@
 <!--   HTTP/1.1 browsers?                                           -->
 <!-- - Is there an Apache for W95/WNT?                              -->
 <!-- - Why does Apache die when a vhost can't be DNS-resolved?      -->
-<!-- - How do I add browsers and referrers to my logs?              -->
 <!-- - How do I setup an access restriction so that people from     -->
 <!--   this domain don't have to authenticate, and all others can   -->
 <!--   do so via a username and password?                           -->
@@ -166,6 +165,9 @@
    <LI><A HREF="#cantbuild">Why won't Apache compile with my
     system's <SAMP>cc</SAMP>?</A>
    </LI>
+   <LI><A HREF="#addlog">How do I add browsers and referrers to my
+    logs?</A>
+   </LI>
   </OL>
  </LI>
 </UL>
@@ -1270,6 +1272,39 @@
   &amp; OS versions and exact error messages.
   </P>
   <HR>
+ </LI>
+ <LI><A NAME="addlog">
+      <STRONG>How do I add browsers and referrers to my logs?</STRONG>
+     </A>
+  <P>
+  Apache provides a couple of different ways of doing this.  The
+  recommended method is to compile the
+  <A
+   HREF="../mod/mod_log_config.html"
+  ><SAMP>mod_log_config</SAMP></A>
+  module into your configuration and use the
+  <A
+   HREF="../mod/mod_log_config.html#customlog"
+  ><SAMP>CustomLog</SAMP></A>
+  directive.
+  </P>
+  <P>
+  You can either log the additional information in files other than your
+  normal transfer log, or you can add them to the records already being
+  written.  For example:
+  </P>
+  <P>
+  <CODE>
+   CustomLog&nbsp;logs/access_log&nbsp;"%h&nbsp;%l&nbsp;%u&nbsp;%t&nbsp;\"%r\"&nbsp;%s&nbsp;%b&nbsp;\"%{Referer}i\"&nbsp;\"%{User-Agent}i\""
+  </CODE>
+  </P>
+  <P>
+  This will add the values of the <SAMP>User-agent:</SAMP> and
+  <SAMP>Referer:</SAMP> headers, which indicate the client and the
+  referring page, respectively, to the end of each line in the access
+  log.
+  </P>
+  <HR>
   <!-- Don't forget to add HR tags at the end of each list item.. -->
  </LI>
 </OL>