SYNOPSIS

lwip_radv.conf

DESCRIPTION

The LWIPV6 stack implements the Routing Advertising protocol (RFC. 2461) and this files contains the protocol settings for each virtual network interface.

Each interface configuration has the following form:

[ interface-name ]
list of interface parameters
list of prefix definitions

INTERFACE PARAMETERS

In general, all parameters have the following syntax: "Parameter = value". This is the list of all valid interface parameters:

AdvSendAdvert = on | off

A flag indicating whether or not the router sends periodic router advertisements and responds to router solicitations.

This option no longer has to be specified first, but it needs to be on to enable advertisement on this interface.

Default: off

UnicastOnly = on | off

Indicates that the interface link type only supports unicast. This will prevent unsolicited advertisements from being sent, and will cause solicited advertisements to be unicast to the soliciting node. This option is necessary for non-broadcast, multiple-access links, such as ISATAP.

Default: off

MaxRtrAdvInterval = seconds

The maximum time allowed between sending unsolicited multicast router advertisements from the interface, in seconds.

Must be no less than 4 seconds and no greater than 1800 seconds.

Minimum when using Mobile IPv6 extensions: 0.07.

For values less than 0.2 seconds, 0.02 seconds is added to account for scheduling granularities as specified in RFC3775.

Default: 600 seconds

MinRtrAdvInterval = seconds

The minimum time allowed between sending unsolicited multicast router advertisements from the interface, in seconds.

Must be no less than 3 seconds and no greater than 0.75 * MaxRtrAdvInterval.

Minimum when using Mobile IPv6 extensions: 0.03.

Default: 0.33 * MaxRtrAdvInterval

MinDelayBetweenRAs = seconds

The minimum time allowed between sending multicast router advertisements from the interface, in seconds.

This applies to solicited multicast RAs. This is defined as the protocol constant MIN_DELAY_BETWEEN_RAS in RFC2461. MIPv6 redefines this parameter to have a minimum of 0.03 seconds.

Minimum when using Mobile IPv6 extensions: 0.03.

Default: 3

AdvManagedFlag = on | off

When set, hosts use the administered (stateful) protocol for address autoconfiguration in addition to any addresses autoconfigured using stateless address autoconfiguration. The use of this flag is described in RFC 2462.

Default: off

AdvOtherConfigFlag = on | off

When set, hosts use the administered (stateful) protocol for autoconfiguration of other (non-address) information. The use of this flag is described in RFC 2462.

Default: off

AdvLinkMTU = integer value

The MTU option is used in router advertisement messages to insure that all nodes on a link use the same MTU value in those cases where the link MTU is not well known.

If specified, i.e. not 0, must not be smaller than 1280 and not greater than the maximum MTU allowed for this link (e.g. ethernet has a maximum MTU of 1500. See RFC 2464).

Default: 0

AdvReachableTime = milliseconds

The time, in milliseconds, that a node assumes a neighbor is reachable after having received a reachability confirmation. Used by the Neighbor Unreachability Detection algorithm (see Section 7.3 of RFC 2461). A value of zero means unspecified (by this router).

Must be no greater than 3,600,000 milliseconds (1 hour).

Default: 0

AdvRetransTimer = milliseconds

The time, in milliseconds, between retransmitted Neighbor Solicitation messages. Used by address resolution and the Neighbor Unreachability Detection algorithm (see Sections 7.2 and 7.3 of RFC 2461). A value of zero means unspecified (by this router).

Default: 0

AdvCurHopLimit = integer value

The default value that should be placed in the Hop Count field of the IP header for outgoing (unicast) IP packets. The value should be set to the current diameter of the Internet. The value zero means unspecified (by this router).

Default: 64

AdvDefaultLifetime = seconds

The lifetime associated with the default router in units of seconds. The maximum value corresponds to 18.2 hours. A lifetime of 0 indicates that the router is not a default router and should not appear on the default router list. The router lifetime applies only to the router's usefulness as a default router; it does not apply to information contained in other message fields or options. Options that need time limits for their information include their own lifetime fields.

Must be either zero or between MaxRtrAdvInterval and 9000 seconds.

Default: 3 * MaxRtrAdvInterval (Minimum 1 second).

AdvSourceLLAddress = on | off

When set, the link-layer address of the outgoing interface is included in the RA.

Default: on

PREFIX DEFINITION

The prefix definition is used to add a new prefix to a particular interface. The syntax of the prefix definition is:

AddPrefix = prefix [ , parameters-list ]

where prefix syntax is IPv6 address/len. Each prefix can be followed by a list of comma-separeted parameters (parameters-list). These are all possible prefix parameters:

AdvOnLink = on | off

When set, indicates that this prefix can be used for on-link determination. When not set the advertisement makes no statement about on-link or off-link properties of the prefix. For instance, the prefix might be used for address configuration with some of the addresses belonging to the prefix being on-link and others being off-link.

Default: on

AdvAutonomous = on | off

When set, indicates that this prefix can be used for autonomous address configuration as specified in RFC 2462.

Default: on

AdvRouterAddr = on | off

When set, indicates that the address of interface is sent instead of network prefix, as is required by Mobile IPv6. When set, minimum limits specified by Mobile IPv6 are used for MinRtrAdvInterval and MaxRtrAdvInterval.

Default: off

AdvValidLifetime = seconds | infinity

The length of time in seconds (relative to the time the packet is sent) that the prefix is valid for the purpose of on-link determination. The symbolic value infinity represents infinity (i.e. a value of all one bits (0xffffffff)). The valid lifetime is also used by RFC 2462.

Default: 2592000 seconds (30 days)

AdvPreferredLifetime = seconds | infinity

The length of time in seconds (relative to the time the packet is sent) that addresses generated from the prefix via stateless address autoconfiguration remain preferred. The symbolic value infinity represents infinity (i.e. a value of all one bits (0xffffffff)). See RFC 2462.

Default: 604800 seconds (7 days)

FILES

lwip_radv.conf

EXAMPLES

This is a simple configuration file with two interface configuration sections (vd0 and tp0) .

[vd0]
AdvSendAdvert = on
MaxRtrAdvInterval = 20
AdvLinkMTU = 1321
MinRtrAdvInterval = 5
AddPrefix = 2001:1234:5678::/64 , AdvOnLinkFlag = on , AdvAutonomousFlag = on

[tp0]
AdvLinkMTU = 1000
AddPrefix = 2001:1234:aa00::/56

AUTHORS

LWIPV6a is parte of the View-OS project of the Computer Science Department, University of Bologna.
Project Leader: Renzo Davoli.
Project Team: Alberto Bacchelli, Andrea Forni, Andrea Gasparini, Andrea Seraghiti, Christian Martellini, Daniele Lacamera, Diego Billi, Ludovico Gardenghi, Mattia Belletti, Paolo Angelelli, Paolo Beverini

<http://savannah.nongnu.org/projects/view-os>.

HISTORY

July 2006 - Originally written by Diego Billi.