NAME
lwip_radv.conf - configuration file for the LWIPV6a router advertising
service
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
SEE ALSO
umview(1), um_add_service(1), lwipv6(1viewos)
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.
LWIPV6a: TCP-IP v4/v6 hybrid stac July 22, 2006