summaryrefslogtreecommitdiffstats
path: root/modules/nsid/README.rst
blob: ed052c9ac72d8bc1172e9fc4e46c5f96c219901c (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
.. _mod-nsid:

Name Server Identifier (NSID)
-----------------------------

This module provides server-side support for :rfc:`5001`
and is not enabled by default.

DNS clients can request resolver to send back its NSID along with the reply
to a DNS request.  This is useful for identification of resolver instances
in larger services (using anycast or load balancers).


This is useful tool for debugging larger services,
as it reveals which particular resolver instance sent the reply.

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

.. code-block:: lua

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

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')