summaryrefslogtreecommitdiffstats
path: root/modules/serve_stale/README.rst
blob: 6d2230c7e448d1abdafa2a9ee75e6036a4db27a6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
.. SPDX-License-Identifier: GPL-3.0-or-later

.. _mod-serve_stale:

Serve stale
===========

Demo module that allows using timed-out records in case kresd is
unable to contact upstream servers.

By default it allows stale-ness by up to one day,
after roughly four seconds trying to contact the servers.
It's quite configurable/flexible; see the beginning of the module source for details.
See also the RFC draft_ (not fully followed) and :any:`cache.ns_tout`.

Running
-------
.. code-block:: lua

    modules = { 'serve_stale < cache' }

.. _draft: https://tools.ietf.org/html/draft-ietf-dnsop-serve-stale-00