trafficserver-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From a..@apache.org
Subject [trafficserver] branch master updated: Doc: Clarify negative revalidating.
Date Mon, 24 Apr 2017 18:20:27 GMT
This is an automated email from the ASF dual-hosted git repository.

amc pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/trafficserver.git

The following commit(s) were added to refs/heads/master by this push:
       new  e2f0a04   Doc: Clarify negative revalidating.
e2f0a04 is described below

commit e2f0a047b0a3945c056d3bba30b606fe511417fd
Author: Alan M. Carroll <amc@apache.org>
AuthorDate: Fri Apr 7 08:46:42 2017 -0500

    Doc: Clarify negative revalidating.
---
 doc/admin-guide/files/records.config.en.rst | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/doc/admin-guide/files/records.config.en.rst b/doc/admin-guide/files/records.config.en.rst
index 3580d2d..482d7e4 100644
--- a/doc/admin-guide/files/records.config.en.rst
+++ b/doc/admin-guide/files/records.config.en.rst
@@ -1608,15 +1608,18 @@ Negative Response Caching
    :reloadable:
    :overridable:
 
-   Enables (``1``) or disables (``0``) forcing revalidation of cached documents
-   when |TS| receives a negative (``5xx`` only) response from the origin server. That is,
-   when enabled, |TS| will serve stale when it can not reach the origin server.
+   Negative revalidating allows |TS| to return stale content if revalidation to the origin
fails due
+   to network or HTTP errors. If it is enabled, rather than caching the negative response,
the
+   current stale content is preserved and served. Note this is considered only on a revalidation
of
+   already cached content. A revalidation failure means a connection failure or a 50x response
code.
+
+   A value of ``0`` disables serving stale content and a value of ``1`` enables keeping and
serving stale content if revalidation fails.
 
 .. ts:cv:: CONFIG proxy.config.http.negative_revalidating_lifetime INT 1800
 
-   How long, in seconds, to consider a stale cached document valid if during the
-   revalidation attempt |TS| receives a negative (``5xx`` only) response from
-   the origin server.
+   How long, in seconds, to consider a stale cached document valid if If
+   :ts:cv:`proxy.config.http.negative_revalidating_enabled` is enabled and |TS| receives
a negative
+   (``5xx`` only) response from the origin server during revalidation.
 
 Proxy User Variables
 ====================

-- 
To stop receiving notification emails like this one, please contact
['"commits@trafficserver.apache.org" <commits@trafficserver.apache.org>'].

Mime
View raw message