contrib/unbound/doc/unbound.8

   1 .TH "unbound" "8" "Jun 17, 2019" "NLnet Labs" "unbound 1.9.2"
   2 .\"
   3 .\" unbound.8 -- unbound manual
   4 .\"
   5 .\" Copyright (c) 2007, NLnet Labs. All rights reserved.
   6 .\"
   7 .\" See LICENSE for the license.
   8 .\"
   9 .\"
  10 .SH "NAME"
  11 .B unbound
  12 \- Unbound DNS validating resolver 1.9.2.
  13 .SH "SYNOPSIS"
  14 .B unbound
  15 .RB [ \-h ]
  16 .RB [ \-d ]
  17 .RB [ \-p ]
  18 .RB [ \-v ]
  19 .RB [ \-c
  20 .IR cfgfile ]
  21 .SH "DESCRIPTION"
  22 .B Unbound
  23 is a caching DNS resolver.
  24 .P
  25 It uses a built in list of authoritative nameservers for the root zone (.),
  26 the so called root hints.
  27 On receiving a DNS query it will ask the root nameservers for
  28 an answer and will in almost all cases receive a delegation to a top level
  29 domain (TLD) authoritative nameserver.
  30 It will then ask that nameserver for an answer.
  31 It will recursively continue until an answer is found or no answer is
  32 available (NXDOMAIN).
  33 For performance and efficiency reasons that answer is cached for a
  34 certain time (the answer's time\-to\-live or TTL).
  35 A second query for the same name will then be answered from the cache.
  36 Unbound can also do DNSSEC validation.
  37 .P
  38 To use a locally running
  39 .B Unbound
  40 for resolving put
  41 .sp
  42 .RS 6n
  43 nameserver 127.0.0.1
  44 .RE
  45 .sp
  46 into
  47 .IR resolv.conf (5).
  48 .P
  49 If authoritative DNS is needed as well using
  50 .IR nsd (8),
  51 careful setup is required because authoritative nameservers and
  52 resolvers are using the same port number (53).
  53 .P
  54 The available options are:
  55 .TP
  56 .B \-h
  57 Show the version and commandline option help.
  58 .TP
  59 .B \-c\fI cfgfile
  60 Set the config file with settings for unbound to read instead of reading the
  61 file at the default location, /var/unbound/unbound.conf. The syntax is
  62 described in \fIunbound.conf\fR(5).
  63 .TP
  64 .B \-d
  65 Debug flag: do not fork into the background, but stay attached to
  66 the console.  This flag will also delay writing to the log file until
  67 the thread\-spawn time, so that most config and setup errors appear on
  68 stderr. If given twice or more, logging does not switch to the log file
  69 or to syslog, but the log messages are printed to stderr all the time.
  70 .TP
  71 .B \-p
  72 Don't use a pidfile.  This argument should only be used by supervision
  73 systems which can ensure that only one instance of unbound will run
  74 concurrently.
  75 .TP
  76 .B \-v
  77 Increase verbosity. If given multiple times, more information is logged.
  78 This is in addition to the verbosity (if any) from the config file.
  79 .SH "SEE ALSO"
  80 \fIunbound.conf\fR(5),
  81 \fIunbound\-checkconf\fR(8),
  82 \fInsd\fR(8).
  83 .SH "AUTHORS"
  84 .B Unbound
  85 developers are mentioned in the CREDITS file in the distribution.