summaryrefslogtreecommitdiffstats
path: root/modules/nsid/README.rst
blob: 3d0bf4eba0bda944e68a15ee1bc839fbfc282441 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
.. SPDX-License-Identifier: GPL-3.0-or-later

.. _mod-nsid:

Name Server Identifier (NSID)
=============================

Module ``nsid`` provides server-side support for :rfc:`5001`
which allows DNS clients to request resolver to send back its NSID
along with the reply to a DNS request.
This is useful for debugging larger resolver farms
(e.g. when using :ref:`systemd-multiple-instances`, anycast or load balancers).

NSID value can be configured in the resolver's configuration file:

.. code-block:: lua

   modules.load('nsid')
   nsid.name('instance 1')

.. tip:: When dealing with Knot Resolver running in `multiple instances`
        managed with systemd see :ref:`instance-specific-configuration`.

You can also obtain configured NSID value:

.. code-block:: lua

   > nsid.name()
   'instance 1'

The module can be disabled at run-time:

.. code-block:: lua

   modules.unload('nsid')