Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
unbound(8)			unbound	1.19.1			    unbound(8)

NAME
       unbound - Unbound DNS validating	resolver 1.19.1.

SYNOPSIS
       unbound [-h] [-d] [-p] [-v] [-c cfgfile]

DESCRIPTION
       Unbound is a caching DNS	resolver.

       It  uses	a built	in list	of authoritative nameservers for the root zone
       (.), the	so called root hints.  On receiving a DNS query	 it  will  ask
       the root	nameservers for	an answer and will in almost all cases receive
       a  delegation to	a top level domain (TLD) authoritative nameserver.  It
       will then ask that nameserver for an answer.  It	will recursively  con-
       tinue  until  an	 answer	is found or no answer is available (NXDOMAIN).
       For performance and efficiency reasons that answer is cached for	a cer-
       tain time (the answer's time-to-live or TTL).  A	second query  for  the
       same  name  will	 then be answered from the cache.  Unbound can also do
       DNSSEC validation.

       To use a	locally	running	Unbound	for resolving put

	     nameserver	127.0.0.1

       into resolv.conf(5).

       If authoritative	DNS is needed as well using nsd(8), careful  setup  is
       required	 because authoritative nameservers and resolvers are using the
       same port number	(53).

       The available options are:

       -h     Show the version number and commandline option help, and exit.

       -c cfgfile
	      Set the config file with settings	for Unbound to read instead of
	      reading the file at  the	default	 location,  /usr/local/etc/un-
	      bound/unbound.conf. The syntax is	described in unbound.conf(5).

       -d     Debug  flag:  do not fork	into the background, but stay attached
	      to the console.  This flag will also delay writing  to  the  log
	      file  until the thread-spawn time, so that most config and setup
	      errors appear on stderr. If given	twice or  more,	 logging  does
	      not  switch  to  the log file or to syslog, but the log messages
	      are printed to stderr all	the time.

       -p     Don't use	a pidfile.  This argument should only be used  by  su-
	      pervision	systems	which can ensure that only one instance	of Un-
	      bound will run concurrently.

       -v     Increase verbosity. If given multiple times, more	information is
	      logged.  This is added to	the verbosity (if any) from the	config
	      file.

       -V     Show the version number and build	options, and exit.

SEE ALSO
       unbound.conf(5),	unbound-checkconf(8), nsd(8).

AUTHORS
       Unbound	developers  are	mentioned in the CREDITS file in the distribu-
       tion.

NLnet Labs			 Feb 13, 2024			    unbound(8)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=unbound&sektion=8&manpath=FreeBSD+14.0-RELEASE+and+Ports>

home | help