[prev in list] [next in list] [prev in thread] [next in thread] 

List:       squid-cvs
Subject:    /bzr/squid3/trunk/ r12325: Release Notes: document cache_store_log changes in 3.2
From:       Amos Jeffries <squid3 () treenet ! co ! nz>
Date:       2012-09-22 7:17:28
Message-ID: 20120922072004.87568.qmail () squid-cache ! org
[Download RAW message or body]

--===============1269713153==
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

------------------------------------------------------------
revno: 12325
fixes bug(s): http://bugs.squid-cache.org/show_bug.cgi?id=3614
committer: Amos Jeffries <squid3@treenet.co.nz>
branch nick: trunk
timestamp: Sat 2012-09-22 19:17:28 +1200
message:
  Release Notes: document cache_store_log changes in 3.2
  
  Store log uses logFile*() infrastructure and was caught in the access.log
  change upgrades (in a good way). But was not documented.
modified:
  doc/release-notes/release-3.2.sgml
  src/cf.data.pre

--===============1269713153==
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"; name="r12325.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

=== modified file 'doc/release-notes/release-3.2.sgml'
--- a/doc/release-notes/release-3.2.sgml	2012-08-15 11:18:28 +0000
+++ b/doc/release-notes/release-3.2.sgml	2012-09-22 07:17:28 +0000
@@ -341,7 +341,8 @@
   direct filesystem logging (stdio, daemon) to network logging (syslog, UDP and \
TCP). The daemon logging  interface allows for a custom helper to be written to \
process logs in real-time.  
-<p>Upgrading: the <em>access_log</em> was previously logged via what is now called \
the <em>stdio</em> module. +<p>Upgrading: the <em>access_log</em> and \
<em>cache_store_log</em> were previously logged via what is +  now called the \
<em>stdio</em> module.  This is still supported and used by default if no module is \
named. For best performance particularly in SMP  environments we recommend the \
<em>daemon</em> be used. The provided <em>log_file_daemon</em> helper  performs the \
traditional logging to local filesystem. @@ -353,8 +354,8 @@
   logging a single cache.log at relatively high debug levels on a high-traffic \
system. Or one which is  required to store a long period of access.log and needs to \
conserve disk space.  
-<p>The referer_log and useragent_log directives have been converted to built-in log \
                formats.
-  These logs are now created using an access_log line with the format "referrer" or \
"useragent". +<p>The <em>referer_log</em> and <em>useragent_log</em> directives have \
been converted to built-in log formats. +  These logs are now created using an \
<em>access_log</em> line with the format "referrer" or "useragent".  They also now \
log all client requests, if there was no Referer or User-Agent header a dash (-) is \
logged.  
 <p>Known Issue: The TCP logging module does not recover from broken connections \
well. @@ -610,6 +611,10 @@
 	<p><em>htcp-*</em> options collapsed into <em>htcp=</em> taking an optional \
comma-separated list of flags.  The old form is deprecated but still accepted.
 
+	<tag>cache_store_log</tag>
+	<p>Now uses logging modules. Example: stdio:/file/path
+	   see <em>access_log</em> for a list of supported modules and their parameters.
+
 	<tag>clientside_mark</tag>
 	<p>New configuration parameter <em>clientside_mark</em>
 	<p>Allows packets leaving Squid on the client side to be marked with a Netfilter \
mark value in the same way as the existing clientside_tos feature.

=== modified file 'src/cf.data.pre'
--- a/src/cf.data.pre	2012-08-30 15:36:03 +0000
+++ b/src/cf.data.pre	2012-09-22 07:17:28 +0000
@@ -3642,12 +3642,16 @@
 DOC_START
 	Logs the activities of the storage manager.  Shows which
 	objects are ejected from the cache, and which objects are
-	saved and for how long.  To disable, enter "none" or remove the line.
+	saved and for how long.
 	There are not really utilities to analyze this data, so you can safely
-	disable it.
-
+	disable it (the default).
+	
+	Store log uses modular logging outputs. See access_log for the list
+	of modules supported.
+	
 	Example:
-		cache_store_log @DEFAULT_STORE_LOG@
+		cache_store_log stdio:@DEFAULT_STORE_LOG@
+		cache_store_log daemon:@DEFAULT_STORE_LOG@
 DOC_END
 
 NAME: cache_swap_state cache_swap_log


--===============1269713153==--


[prev in list] [next in list] [prev in thread] [next in thread]