.\"
.\" Copyright (C) 2011 Red Hat, Inc. All Rights Reserved.
.\" Written by David Howells (dhowells@redhat.com)
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version
.\" 2 of the License, or (at your option) any later version.
.\"
.TH KEY.DNS_RESOLVER 8 "18 May 2020" Linux "Linux Key Management Utilities"
.SH NAME
key.dns_resolver \- upcall for request\-key to handle dns_resolver keys
.SH SYNOPSIS
\fB/sbin/key.dns_resolver \fR<key>
.br
\fB/sbin/key.dns_resolver \fR--dump-config [\-c <configfile>]
.br
\fB/sbin/key.dns_resolver \fR\-D [\-v] [\-v] [\-c <configfile>] <desc>
.br
<calloutinfo>
.SH DESCRIPTION
This program is invoked by request\-key on behalf of the kernel when kernel
services (such as NFS, CIFS and AFS) want to perform a hostname lookup and the
kernel does not have the key cached.  It is not ordinarily intended to be
called directly.
.P
There program has internal parameters that can be changed with a configuration
file (see key.dns_resolver.conf(5) for more information).  The default
configuration file is in /etc, but this can be overridden with the \fB-c\fR
flag.
.P
The program can be called in debugging mode to test its functionality by
passing a \fB\-D\fR or \fB\--debug\fR flag on the command line.  For this to
work, the key description and the callout information must be supplied.
Verbosity can be increased by supplying one or more \fB\-v\fR flags.
.P
The program may also be called with \fB--dump-config\fR to show the values that
configurable parameters will have after parsing the config file.
.SH ERRORS
All errors will be logged to the syslog.
.SH SEE ALSO
.ad l
.nh
.BR key.dns_resolver.conf (5),
.BR request\-key.conf (5),
.BR keyrings (7),
.BR request\-key (8)