diff --git a/doc/bird.sgml b/doc/bird.sgml index 087a4ebf..3f2e46e7 100644 --- a/doc/bird.sgml +++ b/doc/bird.sgml @@ -2321,22 +2321,25 @@ advertisement packets to connected networks. These packets contain basic information about a local network (e.g. a list of network prefixes), which allows network hosts to autoconfigure network addresses and choose a default route. BIRD implements router behavior -as defined in RFC 4861. +as defined in +RFC 4861 +and also the DNS extensions from +RFC 6106. Configuration -

There are two classes of definitions in RAdv configuration -- -interface definitions and prefix definitions: +

There are several classes of definitions in RAdv configuration -- +interface definitions, prefix definitions and DNS definitions: - interface + interface Interface definitions specify a set of interfaces on which the protocol is activated and contain interface specific options. See common options for detailed description. - prefix - Prefix definitions allows to modify a list of advertised + prefix + Prefix definitions allow to modify a list of advertised prefixes. By default, the advertised prefixes are the same as the network prefixes assigned to the interface. For each network prefix, the matching prefix definition is found and @@ -2350,6 +2353,24 @@ interface definitions and prefix definitions: definitions. As expected, the prefix definition is matching if the network prefix is a subnet of the prefix in prefix definition. + + rdnss { + RDNSS definitions allow to specify a list of advertised + recursive DNS servers together with their options. As options + are seldom necessary, there is also a short variant rdnss + that just specifies one DNS server. Multiple + definitions are cumulative. RDNSS definitions may also be + interface-specific when used inside interface options. By + default, interface uses both global and interface-specific + options, but that can be changed by dnssl { + DNSSL definitions allow to specify a list of advertised DNS + search domains together with their options. Like dnssl that just specifies one DNS + search domain.

Interface specific options: @@ -2362,8 +2383,8 @@ interface definitions and prefix definitions: min ra interval This option specifies the minimum length of that intervals, in - seconds. Must be at least 3 and at most 3/4 * max ra interval. - Default: about 1/3 * max ra interval. + seconds. Must be at least 3 and at most 3/4 * min delay The minimum delay between two consecutive router advertisements, @@ -2400,7 +2421,17 @@ interface definitions and prefix definitions: This option specifies the time (in seconds) how long (after the receipt of RA) hosts may use the router as a default router. 0 means do not use as a default router. Default: 3 * - max ra interval. + rdnss local + Use only local (interface-specific) RDNSS definitions for this + interface. Otherwise, both global and local definitions are + used. Could also be used to disable RDNSS for given interface + if no local definitons are specified. Default: no. + + dnssl local + Use only local DNSSL definitions for this interface. See + @@ -2429,6 +2460,42 @@ interface definitions and prefix definitions: 14400 (4 hours) + +

RDNSS specific options: + + + ns + This option specifies one recursive DNS server. Can be used + multiple times for multiple servers. It is mandatory to have + at least one lifetime [mult] + This option specifies the time how long the RDNSS information + may be used by clients after the receipt of RA. It is + expressed either in seconds or (when + + +

DNSSL specific options: + + + domain + This option specifies one DNS search domain. Can be used + multiple times for multiple domains. It is mandatory to have + at least one lifetime [mult] + This option specifies the time how long the DNSSL information + may be used by clients after the receipt of RA. Details are + the same as for RDNSS + + Example