rtradvd.conf(4) 					     Kernel Interfaces Manual						   rtradvd.conf(4)

NAME

       rtradvd.conf - configuration file for router advertisement daemon

DESCRIPTION

       This  file  describes  the  information used by rtradvd(1M) when constructing IPv6 router advertisement packets for a specific interface as
       specified 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 separated 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 speci-
       fied 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 keywords.  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 values 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 values 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 sec-
	      onds (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 values, 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 extension 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 symbolic 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 adver-
	      tising 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 ALSO

       ndp(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)