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 <[email protected]> Authored: Wed Mar 23 16:44:47 2016 +0000 Committer: Jon Sime <[email protected]> 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
