From 950e2d99541a7eb87870cfab9236cf64cd3c4c63 Mon Sep 17 00:00:00 2001 From: Tatsuhiro Tsujikawa Date: Fri, 16 Dec 2016 21:30:13 +0900 Subject: [PATCH] Mention dynamic hostname lookup in nghttpx how-to --- doc/sources/nghttpx-howto.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/sources/nghttpx-howto.rst b/doc/sources/nghttpx-howto.rst index 12ee6255..f7ba5b28 100644 --- a/doc/sources/nghttpx-howto.rst +++ b/doc/sources/nghttpx-howto.rst @@ -356,6 +356,21 @@ TLS can be enabed per pattern basis: In the above case, connection to serv1 will be encrypted by TLS. On the other hand, connection to serv2 will not be encrypted by TLS. +Dynamic hostname lookup +----------------------- + +By default, nghttpx performs backend hostname lookup at start up, or +configuration reload, and keeps using them in its entire session. To +make nghttpx perform hostname lookup dynamically, use ``dns`` +parameter in :option:`--backend` option, like so: + +.. code-block:: text + + backend=foo.example.com;;dns + +nghttpx will cache resolved addresses for certain period of time. To +change this cache period, use :option:`--dns-cache-cache-timeout`. + Migration from nghttpx v1.8.0 or earlier ----------------------------------------