]> git.ipfire.org Git - thirdparty/unbound.git/commitdiff
dnstap io, dnstap tls default is yes, and man page documentation.
authorW.C.A. Wijngaards <wouter@nlnetlabs.nl>
Fri, 14 Feb 2020 09:01:37 +0000 (10:01 +0100)
committerW.C.A. Wijngaards <wouter@nlnetlabs.nl>
Fri, 14 Feb 2020 09:01:37 +0000 (10:01 +0100)
doc/example.conf.in
doc/unbound.conf.5.in
util/config_file.c

index ec1b1ac70f8ae5b28af48c7f48dbdf4ddbc13ebb..277ea1977076d62c9a3e7014142cc81a4545468d 100644 (file)
@@ -1026,7 +1026,7 @@ remote-control:
 #      # set it to "IPaddress[@port]" of the destination.
 #      dnstap-ip: ""
 #      # if set to yes if you want to use TLS to dnstap-ip, no for TCP.
-#      dnstap-tls: no
+#      dnstap-tls: yes
 #      # name for authenticating the upstream server. or "" disabled.
 #      dnstap-tls-server-name: ""
 #      # if "", it uses the cert bundle from the main unbound config.
index 38c2d29842e827c1b4428d8b4ef2641ee4fe860e..86a962430991332b1138f0833ac84a53676d6ee1 100644 (file)
@@ -2114,6 +2114,78 @@ If this timeout expires Unbound closes the connection, treats it as
 if the Redis server does not have the requested data, and will try to
 re-establish a new connection later.
 This option defaults to 100 milliseconds.
+.SS DNSTAP Logging Options
+DNSTAP support, when compiled in, is enabled in the \fBdnstap:\fR section.
+.TP
+.B dnstap-enable: \fI<yes or no>
+If dnstap is enabled.  Default no.  If yes, it connects to the dnstap server
+and if any of the dnstap-log-..-messages options is enabled it sends logs
+for those messages to the server.
+.TP
+.B dnstap-socket-path: \fI<file name>
+Sets the unix socket file name for connecting to the server that is
+listening on that socket.  Default is "@DNSTAP_SOCKET_PATH@".
+.TP
+.B dnstap-ip: \fI<IPaddress[@port]>
+If "", the unix socket is used, if set with an IP address (IPv4 or IPv6)
+that address is used to connect to the server.
+.TP
+.B dnstap-tls: \fI<yes or no>
+Set this to use TLS to connect to the server specified in \fBdnstap-ip\fR.
+The default is yes.  If set to no, TCP is used to connect to the server.
+.TP
+.B dnstap-tls-server-name: \fI<name of TLS authentication>
+The TLS server name to authenticate the server with.  Used when \fBdnstap-tls\fR is enabled.  If "" it is ignored, default "".
+.TP
+.B dnstap-tls-cert-bundle: \fI<file name of cert bundle>
+The pem file with certs to verify the TLS server certificate. If "" the
+server default cert bundle is used, or the windows cert bundle on windows.
+Default is "".
+.TP
+.B dnstap-tls-client-key-file: \fI<file name>
+The client key file for TLS client authentication. If "" client
+authentication is not used.  Default is "".
+.TP
+.B dnstap-tls-client-cert-file: \fI<file name>
+The client cert file for TLS client authentication.  Default is "".
+.TP
+.B dnstap-send-identity: \fI<yes or no>
+If enabled, the server identity is included in the log messages.
+Default is no.
+.TP
+.B dnstap-send-version: \fI<yes or no>
+If enabled, the server version if included in the log messages.
+Default is no.
+.TP
+.B dnstap-identity: \fI<string>
+The identity to send with messages, if "" the hostname is used.
+Default is "".
+.TP
+.B dnstap-version: \fI<string>
+The version to send with messages, if "" the package version is used.
+Default is "".
+.TP
+.B dnstap-log-resolver-query-messages: \fI<yes or no>
+Enable to log resolver query messages.  Default is no.
+These are messages from unbound to upstream servers.
+.TP
+.B dnstap-log-resolver-response-messages: \fI<yes or no>
+Enable to log resolver response messages.  Default is no.
+These are replies from upstream servers to unbound.
+.TP
+.B dnstap-log-client-query-messages: \fI<yes or no>
+Enable to log client query messages.  Default is no.
+These are client queries to unbound.
+.TP
+.B dnstap-log-client-response-messages: \fI<yes or no>
+Enable to log client response messages.  Default is no.
+These are responses from unbound to clients.
+.TP
+.B dnstap-log-forwarder-query-messages: \fI<yes or no>
+Enable to log forwarder query messages.  Default is no.
+.TP
+.B dnstap-log-forwarder-response-messages: \fI<yes or no>
+Enable to log forwarder response messages.  Default is no.
 .SS Response Policy Zone Options
 .LP
 Response Policy Zones are configured with \fBrpz:\fR, and each one must have a
index 19a5a0bcdea8d306be7b0000b84521b46c23492a..394cf17f33aabd38c02a17962b94629ab0f0f7f6 100644 (file)
@@ -295,6 +295,7 @@ config_create(void)
        if(!(cfg->dnstap_socket_path = strdup(DNSTAP_SOCKET_PATH)))
                goto error_exit;
 #endif
+       cfg->dnstap_tls = 1;
        cfg->disable_dnssec_lame_check = 0;
        cfg->ip_ratelimit = 0;
        cfg->ratelimit = 0;