rtradvd.conf(4)rtradvd.conf(4)NAMErtradvd.conf - configuration file for router advertisement daemon
DESCRIPTION
This file describes the information used by rtradvd(1M) when construct‐
ing IPv6 router advertisement packets for a specific interface as spec‐
ified by RFC 2461 ("Neighbor Discovery for IP Version 6"). This file
is read by at initialization time or upon reception of signal
configuration consists of two general statements and one substatement
that is used only by the statement. All statements and substatements
must end with a semicolon. Statements are composed of keywords sepa‐
rated by white space, which can be any combination of blanks and tabs.
The user may create an entry for each interface that is to be enabled
for Router Advertisements. Any configuration information not specified
in the individual or entry is inherited from the statement. In absence
of a statement or specific keywords, the values of options are set
according to their default values as defined in RFC-2461.
The statement can be used to define global values for both and key‐
words. The statement is defined as:
defaults {
# list of interface specific keyword-value pairs;
# list of prefixinfo specific keyword-value pairs;
};
The statement is defined as:
interface interface-name {
# list of interface specific keyword-value pairs;
prefixinfo prefix/prefixlen {
# list of prefixinfo specific keyword-value pairs;
};
};
The specifies the "prefix" and "prefix length" to be advertised on that
interface.
The and specific keywords (if specified) have a precedence over the
keywords defined in the statement.
Comments begin with the pound character (#) and continue to the end of
the line.
INTERFACE SPECIFIC OPTIONS
The following basic keywords and values are defined in RFC 2461:
Enables
or disables sending of periodic Router Advertisements and
responding to Router Solicitations.
DEFAULT: off
Specifies the maximum time, in seconds, between sending unsolicited
multicast Router Advertisements from the interface. Valid val‐
ues are between 4 and 1800 seconds, inclusive. When using
Mobile IPv6 extension, the minimum valid value allowed drops to
0.07.
DEFAULT: 600
Specifies the minimum time, in seconds, between sending unsolicited
multicast Router Advertisements from the interface. Valid val‐
ues are between 3 seconds and .75 * inclusive. The default is
200 seconds. When using Mobile IPv6 extension, the minimum
valid value allowed drops to 0.03.
DEFAULT: 0.33 *
Enables
or disables the setting of the "Managed Address Configuration"
flag in Router Advertisements.
DEFAULT: off
Enables
or disables the setting of the "Other Stateful Configuration"
flag in Router Advertisements.
DEFAULT: off
Specifies the value to be placed in MTU option sent
by the router. A value of zero means unspecified. When set to
0, does not include the MTU option in Router Advertisements. It
can not be greater than the maximum allowed MTU for a specific
interface.
DEFAULT: 0
Specifies a time, in milliseconds,that is placed in the Reachable Time
field in Router Advertisement messages. Valid values are
between 0 and 3,600,000 (1 hour), inclusive. A value of zero
means unspecified by this router.
DEFAULT: 0
Specifies a time, in milliseconds, that is placed in the Retrans
Timer field in Router Advertisement messages. A value of zero
means unspecified by this router.
DEFAULT: 0
Specifies the value to be placed in the Cur Hop Limit field in
Router Advertisement messages sent by the router. A value of
zero means unspecified by this router.
DEFAULT: 64
Specifies a time, in seconds, that is placed in the Router Lifetime
field in Router Advertisement messages. Valid values are 0 or
between and 9000, inclusive. A value of zero indicates that the
router is not to be used as a default router and should not
appear in the default router list of the host receiving this
Router Advertisement message.
DEFAULT: 3 *
Enables
or disables the sending of the interface link-layer address
option in outgoing Router Advertisement messages.
DEFAULT: on
Mobile IPv6 option.
Enables or disables setting of the "Home Agent" flag field in
Router Advertisement messages. When enabled, this indicates
that the router sending this Router Advertisement messages is
also functioning as a Mobile IPv6 home agent on this link. When
enabled, the minimum values specified by Mobile IPv6 extension
can be used for and
DEFAULT: off
Mobile IPv6 option.
Specifies the length of time in seconds that the router is
offering Mobile IPv6 Home Agent service. The maximum value is
65520 seconds (18.2 hours). A value of zero is not allowed.
DEFAULT:
Mobile IPv6 option.
Specifies a preference level for the home agent sending this
Router Advertisement. Higher values indicate a home agent is
more preferable. If both the and are set to their default val‐
ues, the Home Agent Information option will not be included in
Router Advertisement messages sent by this Home Agent router.
DEFAULT: 0
Mobile IPv6 option.
Enables or disable the sending of Advertisement Interval Option
in Router Advertisement messages. If this option is included in
the message, the minimum limits specified by Mobile IPv6 exten‐
sion for and can be used.
DEFAULT: off
PREFIX SPECIFIC OPTIONS
The following address prefix keywords and values are defined in RFC
2461:
Specifies the valid lifetime of the address prefix, in seconds, to be
placed in outgoing Router Advertisement messages. The symbolic
name represents infinity.
DEFAULT: 2592000 seconds (30 days)
Specifies the preferred lifetime of the address prefix, in seconds, to
be placed in outgoing Router Advertisement messages. The sym‐
bolic name represents infinity.
DEFAULT: 604800 seconds (7 days)
Sets or clears the On-link flag field in the Prefix Information
option.
DEFAULT: on
Sets or clears the Autonomous Flag field in the Prefix Information
option.
DEFAULT: on
Mobile IPv6 prefix option.
Sets or clear the Router Flag field in the Prefix Information
option. This indicates that the Prefix field, in addition to
advertising the indicated prefix, contains a complete IP address
assigned to the sending router.
DEFAULT: off
EXAMPLES
Three example configuration files are shown below for a system that has
two interfaces. In these examples, the daemon will use default values
defined in RFC-2461 for those keywords that are not specified in the
configuration file. The second example uses statement to define some
global keywords for the both interfaces and prefixes. Finally, the
last example shows a Mobile IPv6 example.
Example 1
interface lan1
{
AdvCurHopLimit 32;
AdvSendAdvertisement on;
prefixinfo 2008:0:0:4::/64
{
AdvValidLifetime 70100;
AdvPreferredLifetime 50200;
};
prefixinfo 2008:0:0:5::/64
{
AdvValidLifetime 70100;
AdvPreferredLifetime 50200;
};
};
interface lan2
{
AdvCurHopLimit 32;
AdvRouterLifetime 0;
AdvSendAdvertisement on;
prefixinfo 2008:0:0:6::/64
{
AdvValidLifetime 70100;
AdvPreferredLifetime 50200;
};
};
Example 1 specifies that the daemon should send Router Advertisement
messages on both and
must be (the default is The is set to 32 for both interfaces (default
value is 64). The for the second interface is set to 0. It means the
receiving hosts should not add this router in their list of "IPv6
default router".
Example 2
defaults {
AdvCurHopLimit 32;
AdvSendAdvertisement on;
AdvValidLifetime 70100;
AdvPreferredLifetime 50200;
};
interface lan1
{
prefixinfo 2008:0:0:4::/64
{
};
prefixinfo 2008:0:0:5::/64
{
};
};
interface lan2
{
AdvRouterLifetime 0;
prefixinfo 2008:0:0:6::/64
{
};
};
Same as Example 1 but using statement.
Example 3
defaults {
AdvSendAdvertisement on;
MinRtrAdvInterval 2;
MaxRtrAdvInterval 5;
AdvHomeAgentFlag on;
AdvHomeAgentLifetime 1200;
AdvHomeAgentPreference 3;
AdvIntervalOpt on;
};
interface lan1
{
prefixinfo 2008:0:0:4::/64
{
};
prefixinfo 2008::5:210:83ff:fef7:7a9d/64
{
AdvRouterAddress on;
};
};
interface lan2
{
prefixinfo 2008:0:0:6::9/64
{
AdvRouterAddress on;
AdvPreferredLifetime 18000;
};
};
In this example, the Mobile IPv6 options will be included in the Router
Advertisement messages. is turned to also advertise the global address
of the router on and If the kernel part of Mobile IPv6 product is
detected (see mip6mod(7)), the node also acts as "Home Agent" for the
two prefixes configured with set on and In this case, the daemon
enables processing of the four new ICMPv6 messages defined by Mobile
IPv6 (see rtradvd(1M)).
SEE ALSOndp(1M), rtradvd(1M), mip6mod(7), ndp(7P).
1. T. Narten, E. Nordmark, W. Simpson, RFC2461 , December 1998.
2. S. Thompson, T. Narten, RFC2462 , December 1998.
3. D. Johnson, C. Perkins, IETF document.
rtradvd.conf(4)