mirror of
https://github.com/coredns/coredns.git
synced 2025-10-27 08:14:18 -04:00
f8aa208cc0
Mmark recently became able to create manual pages. This removed the dependency on 'ronn' and just uses mmark (Go program). Re-hookup Makefile.doc to generate the correct header mmark needs to see and regenate them all. Spot checking a few pages suggest they look good and actually better than rendered with ronn, esp. lists in lists. Fixes #2757 Signed-off-by: Miek Gieben <miek@miek.nl>
80 lines
1.3 KiB
Groff
80 lines
1.3 KiB
Groff
.\" Generated by Mmark Markdown Processer - mmark.nl
|
|
.TH "COREDNS-NSID" "7" "April 2019" "CoreDNS" "CoreDNS Plugins"
|
|
|
|
.SH NSID
|
|
.SH NAME
|
|
.PP
|
|
\fInsid\fP - adds an identifier of this server to each reply.
|
|
|
|
.SH DESCRIPTION
|
|
.PP
|
|
This plugin implements RFC 5001
|
|
\[la]https://tools.ietf.org/html/rfc5001\[ra] 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.
|
|
|
|
.PP
|
|
This plugin can only be used once per Server Block.
|
|
|
|
.SH SYNTAX
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
nsid [DATA]
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
\fBDATA\fP is the string to use in the nsid record.
|
|
|
|
.PP
|
|
If \fBDATA\fP is not given, the host's name is used.
|
|
|
|
.SH EXAMPLES
|
|
.PP
|
|
Enable nsid:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
\&. {
|
|
whoami
|
|
nsid Use The Force
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
And now a client with NSID support will see an OPT record with the NSID option:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
% 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
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.SH ALSO SEE
|
|
.PP
|
|
RFC 5001
|
|
\[la]https://tools.ietf.org/html/rfc5001\[ra]
|
|
|