Provided by: umview_0.4a-2ubuntu1_i386 bug

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 stacJuly 22, 2006                      LWIPV6a(5)