Return-Path: 
 <commits-return-11159-apmail-trafficserver-commits-archive=trafficserver.apache.org@trafficserver.apache.org>
X-Original-To: apmail-trafficserver-commits-archive@www.apache.org
Delivered-To: apmail-trafficserver-commits-archive@www.apache.org
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by minotaur.apache.org (Postfix) with SMTP id D15BE11E71
	for <apmail-trafficserver-commits-archive@www.apache.org>;
 Wed, 21 May 2014 23:44:24 +0000 (UTC)
Received: (qmail 45175 invoked by uid 500); 21 May 2014 23:44:24 -0000
Delivered-To: apmail-trafficserver-commits-archive@trafficserver.apache.org
Received: (qmail 45126 invoked by uid 500); 21 May 2014 23:44:24 -0000
Mailing-List: contact commits-help@trafficserver.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:commits-help@trafficserver.apache.org>
List-Unsubscribe: <mailto:commits-unsubscribe@trafficserver.apache.org>
List-Post: <mailto:commits@trafficserver.apache.org>
List-Id: <commits.trafficserver.apache.org>
Reply-To: dev@trafficserver.apache.org
Delivered-To: mailing list commits@trafficserver.apache.org
Received: (qmail 45115 invoked by uid 99); 21 May 2014 23:44:24 -0000
Received: from tyr.zones.apache.org (HELO tyr.zones.apache.org)
 (140.211.11.114)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 21 May 2014 23:44:24 +0000
Received: by tyr.zones.apache.org (Postfix, from userid 65534)
	id 8914A99B3B8; Wed, 21 May 2014 23:44:24 +0000 (UTC)
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: bcall@apache.org
To: commits@trafficserver.apache.org
Message-Id: <95d102d959a04d1da897aeafccb07559@git.apache.org>
X-Mailer: ASF-Git Admin Mailer
Subject: git commit: TS-2636: Enhance ATS custom logging to support
 WIPE_FIELD_VALUE filter action Adding documentation
Date: Wed, 21 May 2014 23:44:24 +0000 (UTC)

Repository: trafficserver
Updated Branches:
  refs/heads/master cbe14547d -> 5acff2c66


TS-2636: Enhance ATS custom logging to support WIPE_FIELD_VALUE filter action
Adding documentation


Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo
Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/5acff2c6
Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/5acff2c6
Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/5acff2c6

Branch: refs/heads/master
Commit: 5acff2c66d7b9ae795cd6d4bfac196c3acbe3d1a
Parents: cbe1454
Author: Sudheer Vinukonda <sudheerv@yahoo-inc.com>
Authored: Wed May 21 16:43:04 2014 -0700
Committer: Bryan Call <bcall@apache.org>
Committed: Wed May 21 16:44:12 2014 -0700

----------------------------------------------------------------------
 .../configuration/logs_xml.config.en.rst        | 21 +++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/trafficserver/blob/5acff2c6/doc/reference/configuration/logs_xml.config.en.rst
----------------------------------------------------------------------
diff --git a/doc/reference/configuration/logs_xml.config.en.rst b/doc/reference/configuration/logs_xml.config.en.rst
index 4599968..ddf4cae 100644
--- a/doc/reference/configuration/logs_xml.config.en.rst
+++ b/doc/reference/configuration/logs_xml.config.en.rst
@@ -145,9 +145,15 @@ The following list shows the ``LogFilter`` specifications.
     ``REJECT`` the record.
 
 ``<Action = "valid_action_field"/>``
-    Required: ``ACCEPT`` or ``REJECT`` .
-    This instructs Traffic Server to either accept or reject records
-    that satisfy the filter condition.
+    Required: ``ACCEPT`` or ``REJECT`` or ``WIPE_FIELD_VALUE``.
+    ACCEPT or REJECT instructs Traffic Server to either accept or reject records
+    that satisfy the filter condition. WIPE_FIELD_VALUE wipes out
+    the values of the query params in the url fields specified in the Condition.
+
+NOTES: 1. WIPE_FIELD_VALUE action is only applied to the parameters in the query part.
+       2. Multiple parameters can be listed in a single WIPE_FIELD_VALUE filter
+       3. If the same parameter appears more than once in the query part , only
+          the value of the first occurance is wiped
 
 .. _LogObject:
 
@@ -331,6 +337,15 @@ The following is an example of a ``LogFilter`` that will cause only
              <Condition = "pssc MATCH REFRESH_HIT"/>
          </LogFilter>
 
+The following is an example of a ``LogFilter`` that will cause the value of
+passwd field be wiped in cquc
+
+<LogFilter>
+    <Name = "wipe_password"/>
+    <Condition = "cquc CONTAIN passwd"/>
+    <Action = "WIPE_FIELD_VALUE"/>
+</LogFilter>
+
 The following is an example of a ``LogObject`` specification that
 creates a local log file for the minimal format defined earlier. The log
 filename will be ``minimal.log`` because this is an ASCII log file (the