From fc06fb62443c135773ee4c05ed83925cc47b046d Mon Sep 17 00:00:00 2001 From: Ondrej Zajicek Date: Sat, 7 Jul 2012 10:40:00 +0200 Subject: Implements RDNSS and DNSSL support for RAdv. --- doc/bird.sgml | 14 ++++++++++++++ 1 file changed, 14 insertions(+) (limited to 'doc') diff --git a/doc/bird.sgml b/doc/bird.sgml index b43eb263..087a4ebf 100644 --- a/doc/bird.sgml +++ b/doc/bird.sgml @@ -2450,6 +2450,20 @@ protocol radv { prefix 2001:0DB8:2000::/48 { autonomous off; # Do not autoconfigure }; + + rdnss 2001:0DB8:1234::10; # Short form of RDNSS + + rdnss { + lifetime mult 10; + ns 2001:0DB8:1234::11; + ns 2001:0DB8:1234::12; + }; + + dnssl { + lifetime 3600; + domain "abc.com"; + domain "xyz.com"; + }; } -- cgit v1.2.3 From 0e224d598579626e03d3727d5901ba2d654ac521 Mon Sep 17 00:00:00 2001 From: Ondrej Zajicek Date: Sun, 22 Jul 2012 12:35:04 +0200 Subject: RDNSS and DNSSL documentation for RAdv. --- doc/bird.sgml | 85 ++++++++++++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 76 insertions(+), 9 deletions(-) (limited to 'doc') 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

-- cgit v1.2.3 From 48cf5e84e6ed17578e4ad43c5ef54d6ff7d825c4 Mon Sep 17 00:00:00 2001 From: Ondrej Zajicek Date: Tue, 24 Jul 2012 20:12:14 +0200 Subject: Documentation update, --- doc/bird.sgml | 53 +++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 45 insertions(+), 8 deletions(-) (limited to 'doc') diff --git a/doc/bird.sgml b/doc/bird.sgml index 3f2e46e7..86ae5b0d 100644 --- a/doc/bird.sgml +++ b/doc/bird.sgml @@ -215,7 +215,27 @@ an