Man Linux: Main Page and Category List

NAME

       pdnsd - dns proxy daemon

SYNOPSIS

       pdnsd  [-h]  [-V]  [-s] [-d] [-g] [-t] [-p file] [-vn] [-mxx] [-c file]
       [-4] [-6] [-a]

       This man page is  an  extract  of  the  documentation  of  pdnsd.   For
       complete,  current  documentation,  refer  to  the HTML (or plain text)
       documentation (which you can find  in  the  doc/  subdirectory  of  the
       source   or   in   a   standard   documentation   directory,  typically
       /usr/share/doc/pdnsd/ if you are using a binary package).

DESCRIPTION

       pdnsd is a IPv6 capable proxy domain name server (DNS) which saves  the
       contents of its DNS cache to the disk on exit.

OPTIONS

              -4     enables  IPv4  support.  IPv6  support  is  automatically
                     disabled (should it be available). On by default.

              -6     enables  IPv6  support.  IPv4  support  is  automatically
                     disabled (should it be available). Off by default.

              -a     With  this option, pdnsd will try to detect automatically
                     if the system  supports  IPv6,  and  fall  back  to  IPv4
                     otherwise.

              -V  or  --version
                     Print version information and exit.

              -c FILE  or  --config-file=FILE
                     specifies  that  configuration  is  to be read from FILE.
                     Default is /etc/pdnsd.conf.

              -d  or  --daemon
                     Start pdnsd in daemon mode (as a background process).

              -g  or  --debug
                     Print some debug messages on the console or to  the  file
                     pdnsd.debug in your cache directory (in daemon mode).

              -h  or  --help
                     Print an option summary and exit.

              -i PREFIX  or  --ipv4_6_prefix=PREFIX
                     specifies  the  prefix  pdnsd  uses (when running in IPv6
                     mode) to map IPv4 addresses in the configuration file  to
                     IPv6  addresses. Must be a valid IPv6 address. Default is
                     ::ffff:0.0.0.0

              -p FILE
                     writes the pid  the  server  runs  as  to  the  specified
                     filename. Works only in daemon mode.

              --pdnsd-user
                     Print the user pdnsd will run as and exit.

              -s  or  --status
                     enables  the  status  control  socket. Either this option
                     should be passed to the command  line  or  status_ctl=on;
                     should be specified in the config file if you want to use
                     pdnsd-ctl(8) to control pdnsd at runtime.

              -t  or  --tcp
                     enables the TCP server thread. pdnsd will then serve  TCP
                     and UDP queries.

              -vn    sets  the  verbosity  of  pdnsd.  n is a numeric argument
                     between  0 (normal operation) to  3  (many  messages  for
                     debugging).

              -mxx   sets  the query method pdnsd uses. Possible values for xx
                     are:

                     uo - pdnsd will use UDP only. This is the fastest method,
                     and  should  be  supported  by  all  name  servers on the
                     Internet.

                     to - pdnsd will use TCP only. TCP  queries  usually  take
                     more  time  than UDP queries, but are more secure against
                     certain attacks, where an attacker tries  to  guess  your
                     query  id and to send forged answers. TCP queries are not
                     supported by some name servers.

                     tu - pdnsd will try to use TCP, and will fall back to UDP
                     if its connection is refused or times out.

                     ut - pdnsd will try to use UDP, and will repeat the query
                     using TCP if the UDP reply was truncated (i.e. the tc bit
                     is  set).   This  is the behaviour recommended by the DNS
                     standards.

              Additionally, "no" can be prepended to the  --status,  --daemon,
              --debug  and  --tcp  options  (e.g.  --notcp)  to  reverse their
              effect.

USAGE

       pdnsd is usually run from a startup script. For pdnsd to work, You need
       to:-

              1.  Tell  your  system to use pdnsd as the primary DNS server by
              modifying /etc/resolv.conf.

              2. Tell pdnsd to use an authentic source  for  DNS  records,  by
              including  the  IP addresses of one or more DNS servers, usually
              your ISP’s DNS servers, in /etc/pdnsd.conf.

       For this, put the following line in your /etc/resolv.conf

              nameserver 127.0.0.X

       where X can be any number. (I use 3). Comment out  all  other  entries.
       You  should put the same value in the server_ip= line in global section
       of /etc/pdnsd.conf.
       If you want to use pdnsd as the DNS server for a small  local  network,
       you  should  use  the  IP address or name of the interface connected to
       this network instead of 127.0.0.X.

       To tell pdnsd where to get DNS  information  from,  add  the  following
       lines in /etc/pdnsd.conf:-

              server {
                      label= "myisp";
                      ip=123.456.789.001,123.456.789.002;
                      proxy_only=on;
                      timeout=10;
              }

       Note  the opening and closing braces. Add more such server sections for
       each set of DNS servers  you  want  pdnsd  to  query.   Of  course  the
       configuration  options shown here are just examples.  More examples can
       be  found  in  /etc/pdnsd.conf.sample  or   the   pdnsd.conf   in   the
       documentation  directory.   See  the pdnsd.conf(5) man page for all the
       possible options and their exact meaning.

       If you use a dial up connection,  remember  that  ppp  scripts  usually
       replace  /etc/resolv.conf  when connection with the ISP is established.
       You need  to  configure  ppp  (or  whatever  you  use  to  establish  a
       connection)  so  that  /etc/resolv.conf  is  not  replaced every time a
       connection is established. Read the documentation for the  scripts  run
       when your network comes up.

       If  you  use pppconfig, specify ‘none’ in the  ‘nameservers’ option  in
       the ‘advanced’ tab. If you use multiple ISPs, you should  do  this  for
       each connection/account.

       If  you use multiple ISPs, you should tell pdnsd which DNS servers have
       become available by calling pdnsd-ctl, the pdnsd control utility, in  a
       script  (e.g.  /etc/ppp/ip-up  when  you use pppd) that is run when the
       connection is established.  If the addresses of  the  DNS  servers  are
       obtained through some type of dynamic configuration protocol (e.g. pppd
       with the usepeerdns option or a DHCP client),  you  can  pass  the  DNS
       server  addresses  as an extra argument to pdnsd-ctl to configure pdnsd
       at run time.  See the pdnsd-ctl(8) man page for details.

FILES

       /etc/pdnsd.conf is the pdnsd configuration file.  The file  format  and
       configuration  options are described in the pdnsd.conf(5) man page. You
       can find examples of almost all options in /etc/pdnsd.conf.sample.

       /var/cache/pdnsd/pdnsd.cache

       /var/cache/pdnsd/pdnsd.status is the status control socket, which  must
       be enabled before you can use pdnsd-ctl.

       /etc/init.d/pdnsd  (the name and location of the start-up script may be
       different depending on your distribution.)

       /etc/resolv.conf

       /etc/defaults/pdnsd contains additional parameters or options which may
       be passed to pdnsd at boot time. This saves the hassle of fiddling with
       initscripts (not available on all distributions).

BUGS

       The verbosity option -vn presently does not seem to have much effect on
       the amount of debug output.
       Report any remaining bugs to the authors.

CONFORMING TO

       pdnsd  should  comply with RFCs 1034 and 1035. As of version 1.0.0, RFC
       compliance has been improved and pdnsd is now believed (or hoped?)   to
       be fully RFC compatible. It completely follows RFC 2181 (except for one
       minor issue in the FreeBSD port, see the documentation).

       It does NOT support the following features, of which  most  are  marked
       optional, experimental or obsolete in these RFCs:

              · Inverse queries

              · Status queries

              · Completion queries

              · Namespaces other than IN (Internet)

              · AXFR and IXFR queries (whole zone transfers); since pdnsd does
              not maintain zones, that should not violate the standard

       The following record types, that are extensions  to  the  original  DNS
       standard, are supported if given as options at compile time. (if you do
       not need them, you do not need to compile support for them  into  pdnsd
       and save cache and executable space):

              · RP (responsible person, RFC 1183)

              · AFSDB (AFS database location, RFC 1183)

              · X25 (X25 address, RFC 1183)

              · ISDN (ISDN number/address, RFC 1183)

              · RT (route through, RFC 1183)

              · NSAP (Network Service Access Protocol address , RFC 1348)

              · PX (X.400/RFC822 mapping information, RFC 1995)

              · GPOS (geographic position, deprecated)

              · AAAA (IPv6 address, RFC 1886)

              · LOC (location, RFC 1876)

              · EID (Nimrod EID)

              · NIMLOC (Nimrod locator)

              · SRV (service record, RFC 2782)

              · ATMA (ATM address)

              · NAPTR (URI mapping, RFC 2168)

              · KX (key exchange, RFC 2230)

SEE ALSO

       pdnsd-ctl(8), pdnsd.conf(5), pppconfig(8), resolv.conf(5)

       More documentation is available in the doc/ subdirectory of the source,
       or in /usr/share/doc/pdnsd/ if you are using a binary package.

AUTHORS

       pdnsd was originally written by Thomas Moestl,  <tmoestl@gmx.net>,  and
       was  extensively  revised  by Paul Rombouts <p.a.rombouts@home.nl> (for
       versions 1.1.8b1-par and later).

       Several others have contributed to pdnsd; see files in  the  source  or
       /usr/share/doc/pdnsd/ directory.

       This man page was written by Mahesh T. Pai <paivakil@yahoo.co.in> using
       the documents in /usr/share/docs/pdnsd/ directory for Debian,  but  can
       be used on other distributions too.

       Last revised: 22 Jul 2007 by Paul Rombouts.

COPYRIGHT

       This man page is a part of the pdnsd package, and may be distributed in
       original or modified  form  under  terms  of  the  GNU  General  Public
       License,  as  published by the Free Software Foundation; either version
       3, or (at your option) any later version.

       You can find a copy of the GNU GPL in the file COPYING in the source or
       the  /usr/share/common-licenses/  directory  if  you are using a Debian
       system.