From 6d1dfcfcbb548a220a1124e842f3068f3334b32a Mon Sep 17 00:00:00 2001 From: Amos Jeffries Date: Sat, 22 Sep 2012 19:17:28 +1200 Subject: [PATCH] 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. --- doc/release-notes/release-3.2.sgml | 11 ++++++++--- src/cf.data.pre | 12 ++++++++---- 2 files changed, 16 insertions(+), 7 deletions(-) diff --git a/doc/release-notes/release-3.2.sgml b/doc/release-notes/release-3.2.sgml index 26bfeee8e6..fcb0a57633 100644 --- a/doc/release-notes/release-3.2.sgml +++ b/doc/release-notes/release-3.2.sgml @@ -341,7 +341,8 @@ Most user-facing changes are reflected in squid.conf (see below). 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. -

Upgrading: the access_log was previously logged via what is now called the stdio module. +

Upgrading: the access_log and cache_store_log were previously logged via what is + now called the stdio module. This is still supported and used by default if no module is named. For best performance particularly in SMP environments we recommend the daemon be used. The provided log_file_daemon helper performs the traditional logging to local filesystem. @@ -353,8 +354,8 @@ Most user-facing changes are reflected in squid.conf (see below). 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. -

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". +

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". They also now log all client requests, if there was no Referer or User-Agent header a dash (-) is logged.

Known Issue: The TCP logging module does not recover from broken connections well. @@ -610,6 +611,10 @@ This section gives a thorough account of those changes in three categories:

htcp-* options collapsed into htcp= taking an optional comma-separated list of flags. The old form is deprecated but still accepted. + cache_store_log +

Now uses logging modules. Example: stdio:/file/path + see access_log for a list of supported modules and their parameters. + clientside_mark

New configuration parameter clientside_mark

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. diff --git a/src/cf.data.pre b/src/cf.data.pre index 814ae05ea0..f640b8d943 100644 --- a/src/cf.data.pre +++ b/src/cf.data.pre @@ -3642,12 +3642,16 @@ LOC: Config.Log.store 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 -- 2.47.2