Provided by: umview_0.6-1_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)