History

Miek Gieben fd7abd9849 Add OWNERS file (#1486 ) This should have everyone, but the process was quite manual. The rename from middleware -> plugin also meant I had to do some extra digging on who actually submitted the PR. I also double checked the current list of people with commit access. Every plugin now has an OWNERS, except reverse. I'll file a bug for that.		2018-02-08 10:55:51 +00:00
..
nsid.go	plugin/nsid: Small doc cleanup (#1293 )	2017-12-09 09:37:02 +00:00
nsid_test.go	Add NSID plugin support for CoreDNS (#1273 )	2017-12-04 08:28:27 -08:00
OWNERS	Add OWNERS file (#1486 )	2018-02-08 10:55:51 +00:00
README.md	Manual pages (#1346 )	2018-01-04 12:53:07 +00:00
setup.go	Add NSID plugin support for CoreDNS (#1273 )	2017-12-04 08:28:27 -08:00
setup_test.go	Add NSID plugin support for CoreDNS (#1273 )	2017-12-04 08:28:27 -08:00

README.md

nsid

Name

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

Description

This plugin implements RFC 5001 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 responsible for generating the reply and for debugging.

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:

. {
    whoami
    nsid Use The Force
}

And now a client with NSID support will see an OPT record with the NSID option:

% 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