trafficserver-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From js...@apache.org
Subject trafficserver git commit: TS-1699: docs: note the impact of disabling dns lookups on authorization plugins
Date Wed, 23 Mar 2016 16:44:57 GMT
Repository: trafficserver
Updated Branches:
  refs/heads/master 4e4a01aab -> ce7c80986


TS-1699: docs: note the impact of disabling dns lookups on authorization plugins


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

Branch: refs/heads/master
Commit: ce7c809867a45a4178cc22d96ad812340230dd73
Parents: 4e4a01a
Author: Jon Sime <jsime@apache.org>
Authored: Wed Mar 23 16:44:47 2016 +0000
Committer: Jon Sime <jsime@apache.org>
Committed: Wed Mar 23 16:44:47 2016 +0000

----------------------------------------------------------------------
 .../example-plugins/basic-authorization/index.en.rst        | 9 +++++++++
 1 file changed, 9 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/trafficserver/blob/ce7c8098/doc/developer-guide/plugins/example-plugins/basic-authorization/index.en.rst
----------------------------------------------------------------------
diff --git a/doc/developer-guide/plugins/example-plugins/basic-authorization/index.en.rst
b/doc/developer-guide/plugins/example-plugins/basic-authorization/index.en.rst
index 553aeb1..11d56eb 100644
--- a/doc/developer-guide/plugins/example-plugins/basic-authorization/index.en.rst
+++ b/doc/developer-guide/plugins/example-plugins/basic-authorization/index.en.rst
@@ -39,6 +39,15 @@ The parent continuation and global hook are created as follows:
 
 ``TSHttpHookAdd (TS_HTTP_OS_DNS_HOOK, TSContCreate (auth_plugin, NULL));``
 
+.. important::
+
+   Authorization plugins which attach to ``TS_HTTP_OS_DNS_HOOK`` (as shown in
+   the example above) will not operate as expected unless
+   :ts:cv:`proxy.config.http.doc_in_cache_skip_dns` is set to ``0``. Disabling
+   this feature ensures that DNS hooks will still be executed even when a
+   matching document has been located in the cache. The downside is that the
+   performance gain by skipping otherwise unnecessary DNS lookups is lost.
+
 .. toctree::
    :maxdepth: 2
 


Mime
View raw message