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

FreeBSD Manual Pages


home | help
PDNS_RECURSOR(1)	       PowerDNS	Recursor	      PDNS_RECURSOR(1)

       pdns_recursor - The PowerDNS Recursor binary

       pdns_recursor [OPTION]...

       pdns_recursor  is a high	performance, simple and	secure recursing name-
       server. It currently powers hundreds of millions	internet connections.

       The recursor is configured via a	configuration file, but	each  item  in
       that file can be	overridden on the command line.

       This  manpage lists the core set	of features needed to get the PowerDNS
       Recursor	 working,  for	full  and  up  to   date   details   head   to

       To  listen  on and allow the subnet to recurse,
       and run as in the background, execute:

	  # pdns_recursor --local-address= --allow-from= --daemon

       To stop the recursor by hand, run:

	  # rec_control	quit

       However,	the recommended	way of starting	and stopping the  recursor  is
       to use the init.d script	or systemctl(1).

       For  authoritative listing of options, consult the online documentation
       at _

	      If set, only allow these comma separated networks, with  network
	      mask to recurse. For example:,

	      Where  authzone  is  <zonename>=<filename>.  Serve zonename from
	      filename	       authoritatively.		 For	      example:,

	      chroot the process to directory.

	      Timeout in seconds when talking to TCP clients.

	      Location of configuration	directory (recursor.conf), the default
	      depends on the SYSCONFDIR	option at build-time, which is usually
	      /etc/powerdns.  The  default  can	 be  found  with pdns_recursor
	      --config | grep '	config-dir='.

	      Operate as a daemon.

	      Which domains we only accept delegations from (a	Verisign  spe-

	      Read new entropy from file, defaults to /dev/urandom.

	      If  set,	this  flag  will export	the hostnames and IP addresses
	      mentioned	in /etc/hosts.

	      Where forwardzone	is <zonename>=<address>.  Queries for zonename
	      will  be	forwarded to address. address should be	an IP address,
	      not a hostname (to prevent chicken and egg  problems).  Example:

	      Similar  to --forward-zones, but read the	options	from filename.
	      filename	 should	  contain   one	  zone	 per	line,	 like:

       --help Show a summary of	options.

	      Load root	hints from this	filename

	      Listen  on  address,  separated  by spaces or commas.  Addresses
	      specified	can include port numbers; any  which  do  not  include
	      port numbers will	listen on --local-port.

	      Listen on	port.

	      If we should log rather common errors.

	      Maximum number of	entries	in the main cache.

	      maximum  number  of  seconds  to keep a negative cached entry in

	      Maximum number of	simultaneous TCP clients.

	      If set, maximum number of	TCP sessions per client	(IP address).

	      Use address as Source IP address when sending queries.

	      Suppress logging of questions and	answers.

	      Return text WHen queried for 'id.server' TXT, defaults to	 host-

	      On  by  default, this makes the server authoritatively aware of:,		   and,  which  saves load on the	AS112 servers.
	      Individual parts of these	zones can  still  be  loaded  or  for-

	      If set, change group id to gid for more security.

	      If set, change user id to	uid for	more security.

	      If set, only use a single	socket for outgoing queries.

	      The controlsocket	will live in directory.

	      If non-zero, assume spoofing after this many near	misses.

	      if we should output heaps	of logging.

	      text WILL	be reported on version.pdns or version.bind queries.

       rec_control(1) systemctl(1)

       PowerDNS.COM BV

       2001-2019, PowerDNS.COM BV

				 Jun 30, 2021		      PDNS_RECURSOR(1)


Want to link to this manual page? Use this URL:

home | help