rdnssd(8)

1RDNSSD(8)                   System Manager's Manual                  RDNSSD(8)
2
3
4

NAME

6       rdnssd - IPv6 Recursive DNS Server discovery Daemon
7

SYNOPSIS

9       rdnssd [-f] [-H merge-hook] [-r resolv-file] [-p pidfile] [-u username]
10
11

DESCRIPTON

13       rdnssd  is  a daemon program providing client-side support for DNS con‐
14       figuration using the Recursive DNS Server (RDNSS) option, as  described
15       in  RFC  5006.   Its  purpose  is  to supply IPv6 DNS resolvers through
16       stateless autoconfiguration, carried by Router Advertisements.
17
18       rdnssd parses RDNSS options and keeps track of resolvers to write name‐
19       servers  entries to a resolv.conf(5) configuration file. By default, it
20       writes its own separate file, and may call an external hook to merge it
21       with  the  main  /etc/resolv.conf.  This is aimed at easing coexistence
22       with   concurrent   daemons,    especially    IPv4    ones,    updating
23       /etc/resolv.conf too.
24
25       On Linux, since version 2.6.24, rdnssd takes advantage of a new netlink
26       interface, forwarding RDNSS options validated by the  kernel  to  user‐
27       land.  Otherwise, it merely listens to all ICMPv6 traffic through a raw
28       socket.
29
30

OPTIONS

32       -f or --foreground
33              Do not detach from the console. Run the  program  in  the  fore‐
34              ground.
35
36
37       -H merge-hook or --merge-hook merge-hook
38              Execute  this  hook  whenever  resolv.conf  is  updated. If this
39              option is not specified, then no hook will be called.
40
41
42       -h or --help
43              Display some help and exit.
44
45
46       -p pidfile or --pidfile pidfile
47              Override the location of the pidfile.
48
49
50       -r resolv-file or --resolv-file resolv-file
51              Set the path to the generated resolv.conf file.
52
53
54       -u username or --user username
55              Override the user that the program will run as. By  default,  it
56              runs as nobody.
57
58
59       -V or --version
60              Display program version and license and exit.
61
62

FILES

64       /etc/rdnssd/merge-hook
65              A basic merge hook shipped with rdnssd, to be called with the -H
66              option.
67
68
69       /var/run/rdnssd/resolv.conf
70              The default resolv.conf(5) file that rdnssd writes its  configu‐
71              ration to.
72
73
74       /var/run/rdnssd.pid
75              The process-id file.
76
77

BUGS

79       rdnssd  does  not keep track of the lifetimes of the routers associated
80       with some DNS resolvers, whereas it should to strictly comply with  RFC
81       5006.
82
83       When  rdnssd uses a raw socket instead of the netlink kernel interface,
84       it does not validate received Neighbor Discovery traffic  in  any  way.
85       For  example,  it  will  always  consider Router Advertisement packets,
86       whereas it should not if the host is configured as a router.  When  the
87       netlink interface is used, such validation is done by the kernel.
88
89

AUTHOR

95       Pierre Ynard <linkfanel at yahoo.fr>
96
97       http://www.remlab.net/ndisc6/
98
99
100
101rdnssd                              $Date$                           RDNSSD(8)