Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
COREDNS-NSID(7) 		 CoreDNS Plugins		 COREDNS-NSID(7)

NAME
     nsid - adds an identifier of this server to each reply.

DESCRIPTION
     This  plugin  implements RFC 5001 <https://tools.ietf.org/html/rfc5001> and
     adds an EDNS0 OPT resource record to replies  that  uniquely  identify  the
     server.  This is useful in anycast setups to see which server was responsi-
     ble for generating the reply and for debugging.

     This plugin can only be used once per Server Block.

SYNTAX
	    nsid [DATA]

     DATA is the string to use in the nsid record.

     If DATA is not given, the host's name is used.

EXAMPLES
     Enable nsid:

	    example.org {
		whoami
		nsid Use The Force
	    }

     And now a client with NSID support will see an OPT record with the NSID op-
     tion:

	    % dig +nsid @localhost a whoami.example.org

	    ;; Got answer:
	    ;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 46880
	    ;; flags: qr aa rd; QUERY: 1, ANSWER: 0, AUTHORITY: 0, ADDITIONAL: 3

	    ....

	    ; OPT PSEUDOSECTION:
	    ; EDNS: version: 0, flags:; udp: 4096
	    ; NSID: 55 73 65 20 54 68 65 20 46 6f 72 63 65 ("Use The Force")
	    ;; QUESTION SECTION:
	    ;whoami.example.org.	IN    A

SEE ALSO
     RFC 5001 <https://tools.ietf.org/html/rfc5001>

CoreDNS 			   March 2026			 COREDNS-NSID(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=coredns-nsid&sektion=7&manpath=FreeBSD+Ports+15.1.quarterly>

home | help