mirror of
https://github.com/coredns/coredns.git
synced 2025-11-24 04:34:01 -05:00
Remove the word middleware (#1067)
* Rename middleware to plugin first pass; mostly used 'sed', few spots where I manually changed text. This still builds a coredns binary. * fmt error * Rename AddMiddleware to AddPlugin * Readd AddMiddleware to remain backwards compat
This commit is contained in:
61
plugin/dnstap/README.md
Normal file
61
plugin/dnstap/README.md
Normal file
@@ -0,0 +1,61 @@
|
||||
# dnstap
|
||||
|
||||
*dnstap* enables logging to dnstap, a flexible, structured binary log format for DNS software: http://dnstap.info.
|
||||
|
||||
There is a buffer, expect at least 13 requests before the server sends its dnstap messages to the socket.
|
||||
|
||||
## Syntax
|
||||
|
||||
~~~ txt
|
||||
dnstap SOCKET [full]
|
||||
~~~
|
||||
|
||||
* **SOCKET** is the socket path supplied to the dnstap command line tool.
|
||||
* `full` to include the wire-format DNS message.
|
||||
|
||||
## Examples
|
||||
|
||||
Log information about client requests and responses to */tmp/dnstap.sock*.
|
||||
|
||||
~~~ txt
|
||||
dnstap /tmp/dnstap.sock
|
||||
~~~
|
||||
|
||||
Log information including the wire-format DNS message about client requests and responses to */tmp/dnstap.sock*.
|
||||
|
||||
~~~ txt
|
||||
dnstap unix:///tmp/dnstap.sock full
|
||||
~~~
|
||||
|
||||
Log to a remote endpoint.
|
||||
|
||||
~~~ txt
|
||||
dnstap tcp://127.0.0.1:6000 full
|
||||
~~~
|
||||
|
||||
## Dnstap command line tool
|
||||
|
||||
~~~ sh
|
||||
go get github.com/dnstap/golang-dnstap
|
||||
cd $GOPATH/src/github.com/dnstap/golang-dnstap/dnstap
|
||||
go build
|
||||
./dnstap
|
||||
~~~
|
||||
|
||||
The following command listens on the given socket and decodes messages to stdout.
|
||||
|
||||
~~~ sh
|
||||
dnstap -u /tmp/dnstap.sock
|
||||
~~~
|
||||
|
||||
The following command listens on the given socket and saves message payloads to a binary dnstap-format log file.
|
||||
|
||||
~~~ sh
|
||||
dnstap -u /tmp/dnstap.sock -w /tmp/test.dnstap
|
||||
~~~
|
||||
|
||||
Listen for dnstap messages on port 6000.
|
||||
|
||||
~~~ sh
|
||||
dnstap -l 127.0.0.1:6000
|
||||
~~~
|
||||
Reference in New Issue
Block a user