Internet Engineering Task Force                                   PIM WG
INTERNET-DRAFT                                       Nidhi Bhaskar/Cisco
draft-ietf-pim-sm-bsr-04.txt                       Alexander Gall/SWITCH
                                                     Stig Venaas/UNINETT
                                                            18 July 2004
                                                   Expires: January 2005



                Bootstrap Router (BSR) Mechanism for PIM




Status of this Document


By submitting this Internet-Draft, I certify that any applicable patent
or other IPR claims of which I am aware have been disclosed, or will be
disclosed, and any of which I become aware will be disclosed, in
accordance with RFC 3668.


Internet-Drafts are working documents of the Internet Engineering Task
Force (IETF), its areas, and its working groups.  Note that other groups
may also distribute working documents as Internet-Drafts.


Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time.  It is inappropriate to use Internet-Drafts as reference material
or to cite them other than a "work in progress."


The list of current Internet-Drafts can be accessed at
http://www.ietf.org/1id-abstracts.html


The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html


This document is a product of the IETF PIM WG.  Comments should be
addressed to the authors, or the WG's mailing list at
pim@catarina.usc.edu.


Copyright Notice


Copyright (C) The Internet Society (2004). All Rights Reserved.







Bhaskar/Gall/Venaas                                             [Page 1]


INTERNET-DRAFT            Expires: January 2005                July 2004



                                Abstract



     This document specifies the Bootstrap Router (BSR) mechanism
     for the class of multicast routing protocols in the PIM
     (Protocol Independent Multicast protocol) family that use the
     concept of a Rendezvous Point as a means for receivers to
     discover the sources that send to a particular multicast
     group.  BSR is one way that a multicast router can learn the
     set of group-to-RP mappings required in order to function.
     The mechanism is dynamic, largely self-configuring, and robust
     to router failure.








































Bhaskar/Gall/Venaas                                             [Page 2]


INTERNET-DRAFT            Expires: January 2005                July 2004



                           Table of Contents



     1. Introduction. . . . . . . . . . . . . . . . . . . . . .   4
      1.1. General Overview and Background. . . . . . . . . . .   4
      1.2. Overview of Bootstrap and RP Discovery for
      Global Scope. . . . . . . . . . . . . . . . . . . . . . .   7
      1.3. Administratively Scoped Multicast and BSR. . . . . .   8
      1.4. Bi-directional PIM . . . . . . . . . . . . . . . . .   9
     2. BSR State and Timers. . . . . . . . . . . . . . . . . .   9
     3. Bootstrap Router Election and RP-Set
     Distribution . . . . . . . . . . . . . . . . . . . . . . .  10
      3.1. Sending Candidate-RP-Advertisements. . . . . . . . .  19
      3.2. Creating the RP-Set at the BSR . . . . . . . . . . .  20
      3.3. Forwarding Bootstrap Messages. . . . . . . . . . . .  21
      3.4. Receiving and Using the RP-Set . . . . . . . . . . .  22
     4. Message Formats . . . . . . . . . . . . . . . . . . . .  22
      4.1. Bootstrap Message Format . . . . . . . . . . . . . .  25
       4.1.1. Semantic Fragmentation of BSMs. . . . . . . . . .  28
      4.2. Candidate-RP-Advertisement Format. . . . . . . . . .  30
     5. Default Values for Timers . . . . . . . . . . . . . . .  31
     6. Security Considerations . . . . . . . . . . . . . . . .  32
      6.1. Possible Threats . . . . . . . . . . . . . . . . . .  32
      6.2. Limiting Third-Party DoS Attacks . . . . . . . . . .  33
      6.3. BS Message Security. . . . . . . . . . . . . . . . .  33
      6.4. C-RP-Advertisement Security. . . . . . . . . . . . .  35
      6.5. Denial of Service using IPsec. . . . . . . . . . . .  36
     7. Contributors. . . . . . . . . . . . . . . . . . . . . .  36
     8. Acknowledgments . . . . . . . . . . . . . . . . . . . .  36
     9. IANA Considerations . . . . . . . . . . . . . . . . . .  37
     10. Normative References . . . . . . . . . . . . . . . . .  37
     11. Informative References . . . . . . . . . . . . . . . .  37
     12. Authors' Addresses . . . . . . . . . . . . . . . . . .  37




                            List of Figures



     Figure 1. Per-Scope-Zone State-machine for a candi-
     date BSR . . . . . . . . . . . . . . . . . . . . . . . . .  11
     Figure 2. Per-Scope-Zone State-machine for a router
     not configured as C-BSR. . . . . . . . . . . . . . . . . .  13









Bhaskar/Gall/Venaas                                             [Page 3]


INTERNET-DRAFT            Expires: January 2005                July 2004



1.  Introduction


This document assumes familiarity with the workings of Rendezvous Point-
based multicast routing protocols in the PIM protocol family, in
particular with Protocol Independent Multicast - Sparse Mode (PIM-SM),
as defined in [1], and Bi-directional Protocol Independent Multicast
(BIDIR-PIM), as defined in [3], as well as with Administratively Scoped
Multicast, as described in [2].


Throughout the document, any reference to the PIM protocol family is
restricted to the subset of RP-based protocols unless stated otherwise.


For correct operation, every multicast router within a PIM domain must
be able to map a particular multicast group address to the same RP.  If
this is not the case then black holes may appear, where some receivers
in the domain cannot receive some groups.  A PIM domain in this context
is a contiguous set of routers that all implement the multicast routing
protocol and are configured to operate within a common boundary defined
by PIM Multicast Border Routers (PMBRs).  PMBRs connect each PIM domain
to the rest of the internet.


A PIM domain may also be broken up into multiple administrative scope
regions - these are regions where a border has been configured so that a
range of multicast groups will not be forwarded across that border.  For
more information on Administratively Scoped IP Multicast, see RFC 2365
[2]. The modified criteria for admin-scoped regions are that the region
is convex with respect to forwarding based on the MRIB, and that all PIM
routers within the same scope region map a particular scoped group to
the same RP within that region.


The PIM specifications do not mandate the use of a single mechanism to
provide routers with the information to perform the group-to-RP mapping.
This document describes the Bootstrap Router (BSR) mechanism.  BSR was
first defined in RFC 2362 [5], which has since been obsoleted.  This
document provides an updated specification of the BSR mechanism from RFC
2362, and also extends it to cope with administratively scoped region
boundaries and different flavours of routing protocols.


1.1.  General Overview and Background


Every PIM multicast group needs to be associated with the IP address of
a Rendezvous Point (RP).  This address is used to build a group-specific
distribution tree rooted at that address whose branches extend to all
nodes in the domain that want to receive traffic sent to the group.
Senders inject packets into the tree in such a manner that they reach
all connected receivers.  How this is done and how the packets are
forwarded along the distribution tree depends on the particular routing
protocol.




Bhaskar/Gall/Venaas                               Section 1.1.  [Page 4]


INTERNET-DRAFT            Expires: January 2005                July 2004



For all senders to reach all receivers, it is crucial that there exists
a single distribution tree.  This can only be achieved when all routers
in the domain use the same mappings of group addresses to RP addresses.


There are a number of ways how such group-to-RP mappings can be
established.  The simplest solution is for all the routers in the domain
to be statically configured with the same information.  However, static
configuration generally doesn't scale well, and also does not
dynamically adapt to route around router or link failures.  The
mechanism specified in this document is known as the PIM BootStrap
Router mechanism, or BSR for short, and provides a dynamic, adaptive
mechanism to distribute group-to-RP mapping information rapidly
throughout a domain.


A group-to-RP mapping contains the following elements.


o Multicast group range, expressed as an address and prefix length


o RP Priority


o <<<<<<< bsr.nrf IP address of RP.


o RP Holdtime ======= IP address of RP


o RP Holdtime >>>>>>> 1.49


o Hash mask length


The collection of all group-to-RP mappings known to a router at any
point in time is called the RP-set.  The router that assumes the role of
the BSR maintains a logically distinct RP-set called the C-RP-set, from
which it constructs the actual RP-set as explained below.


In general, these mapping entries may overlap in arbitrary ways; a
particular multicast group may be covered by multiple mapping entries.
When this is the case, the router chooses only one of the entries by
applying a deterministic algorithm so that all routers in the domain
make the same choice and hence apply the same group-to-RP mapping.  It
is important to note that this algorithm is part of the specification of
the individual routing protocols (and may differ among them), not of the
BSR specification.


The BSR mechanism provides a way in which viable group-to-RP mappings
can be created and distributed to all the PIM routers in a domain.  It
is adaptive, in that if an RP becomes unreachable, this will be detected
and the mapping tables will be modified so that the unreachable RP is no
longer used, and the new tables will be rapidly distributed throughout
the domain.




Bhaskar/Gall/Venaas                               Section 1.1.  [Page 5]


INTERNET-DRAFT            Expires: January 2005                July 2004



The general idea behind the BSR-mechanism is that some of the PIM
routers within a PIM domain are configured to be potential RPs for the
domain.  These are known as candidate-RPs (C-RPs).  A subset of the C-
RPs will eventually be used as the actual RPs for the domain.  In
addition, some of the PIM routers in the domain are configured as
candidate bootstrap routers (C-BSRs).  One of these C-BSRs will be
elected to serve as the bootstrap router (BSR) for the domain, and all
the PIM routers in the domain will learn the result of this election
through Bootstrap messages.  The C-RPs will then report their candidacy
to the elected BSR, which stores the group-to-C-RP mappings in its C-RP-
set.  It will chose a subset of these mappings as the actual RP-set and
distribute it to all the routers in the domain through Bootstrap
messages.


The mechanism is complicated slightly by the presence of
administratively-scoped multicast regions within the PIM domain.  An
admin-scope region is a convex connected set of PIM routers surrounded
by an admin-scope boundary.  The boundary specifies a range of multicast
addresses that will not be forwarded into or out of the scoped region.
This complicates BSR because we do not want a PIM router within the
scoped region to use an RP outside the scoped region (or vice-versa).
Thus we need to modify the basic mechanism to ensure that this doesn't
happen - this is done by electing a BSR for every admin-scope region
within a PIM domain, and also a global BSR for the whole PIM domain.  C-
RPs typically register multiple times; once to the BSR of every admin
scope zone the C-RP is in.  For the remainder of this overview we will
ignore admin-scope regions, and concentrate on the global BSR and its
role.  Within each scope zone, the BSR for that zone acts in a similar
manner to how the global BSR acts for the whole domain.


There are four basic phases to the BSR mechanism (although in practice
all phases may be occurring simultaneously):


1.   BSR election.  Each Candidate-BSR originates bootstrap messages
     (BSMs).  Every BSM contains a BSR priority field.  Routers within
     the domain flood the BSMs throughout the domain.  A C-BSR that
     hears about a higher-priority C-BSR than itself then suppresses its
     sending of further BSMs for some period of time.  The single
     remaining C-BSR becomes the elected BSR, and its BSMs inform all
     the other routers in the domain that it is the elected BSR.


2.   C-RP advertisement.  Each Candidate-RP within a domain sends
     periodic Candidate-RP-Advertisement (C-RP-Adv) messages to the
     elected BSR.  In this way, the BSR learns about possible RPs that
     are currently up and reachable.


3.   C-RP-Set Formation.  The BSR selects a subset of the C-RPs that it
     has received C-RP-Adv messages from to form the RP-Set.  In general




Bhaskar/Gall/Venaas                               Section 1.1.  [Page 6]


INTERNET-DRAFT            Expires: January 2005                July 2004



     it should do this in such a way that the RP-Set is neither too
     large to inform all the routers in the domain about, nor too small
     so that load is overly concentrated on some RPs.  It should also
     attempt to produce an RP-Set that does not change frequently.


4.   RP-Set Flooding.  In future bootstrap messages, the BSR includes
     the RP-Set information.  As bootstrap messages are flooded rapidly
     through the domain, this ensures that the RP-Set rapidly reaches
     all the routers in the domain.  BSMs are originated periodically to
     ensure consistency after failure restoration.


     When a PIM router receives a Bootstrap message, it adds the group-
     to-RP mappings contained therein to its pool of mappings obtained
     from other sources (e.g. static configuration).  It calculates the
     final mappings of group addresses to RP addresses from this pool
     according to rules specific to the particular routing protocol and
     uses that information to construct multicast distribution trees.


In the following sections we discuss more details about BSR for global
scope and for admin scoping, before specifying the protocol starting in
section 2.


1.2.  Overview of Bootstrap and RP Discovery for Global Scope


A small set of routers from a domain are configured as candidate
bootstrap routers (C-BSRs) and, through a simple election mechanism, a
single BSR is selected for that domain.  A set of routers within a
domain are also configured as candidate RPs (C-RPs); typically these
will be the same routers that are configured as C-BSRs.  Candidate RPs
periodically unicast Candidate-RP-Advertisement messages (C-RP-Advs) to
the BSR of that domain, advertising their willingness to be an RP.  A C-
RP-Adv message includes the address of the advertising C-RP, as well as
an optional list of group addresses and mask length fields, indicating
the group prefix(es) for which the candidacy is advertised.  The BSR
then includes a set of these Candidate-RPs (the RP-Set), along with
their corresponding group prefixes, in Bootstrap messages it
periodically originates.  Bootstrap messages are distributed hop-by-hop
throughout the domain.


If a PIM domain becomes partitioned, each area separated from the old
BSR will elect its own BSR, which will distribute an RP-Set containing
RPs that are reachable within that partition.  When the partition heals,
another election will occur automatically and only one of the BSRs will
continue to send out Bootstrap messages.  As is expected at the time of
a partition or healing, some disruption in packet delivery may occur.
This time will be on the order of the region's round-trip time and the
bootstrap router timeout value.





Bhaskar/Gall/Venaas                               Section 1.2.  [Page 7]


INTERNET-DRAFT            Expires: January 2005                July 2004



1.3.  Administratively Scoped Multicast and BSR


Administratively Scoped IP Multicast, as defined in RFC 2365 [2],
permits a network provider to configure scope boundaries at multicast
routers.  Such a scope boundary consists of a range of multicast
addresses (expressed as an address and mask) that the router will not
forward across the boundary.  For correct operation, such a scope zone
border must be complete and convex.  By this we mean that there must be
no path from inside the scoped zone to outside it that does not pass
through a configured scope border router, and that the multicast capable
path between any arbitrary pair of multicast routers in the scope zone
must remain in the zone.


For BSR to function correctly with admin scoping, there must be a BSR
and at least one C-RP within every admin scope region.  Admin scope zone
boundaries must be configured at the Zone Border Routers (ZBRs), as they
need to filter PIM Join messages that might inadvertently cross the
border due to error conditions.  In addition, at least one C-BSR within
the admin scope zone must be configured to be a C-BSR for the admin
scope zone's address range.


A separate BSR election will then take place (using bootstrap messages)
for every admin scope range (plus one for the global range).  Admin
scope ranges are identified in the bootstrap message because the group
range is marked (using the "Admin Scope" bit, previously a "Reserved"
bit) to indicate that this is an administrative scope range, and not
just a range that a particular set of RPs are configured to handle.


Such admin scoped bootstrap message packets are flooded in the normal
way, but will not be forwarded by another ZBR across the boundary for
that scope zone (see Section 3.3 for the specifics of this).


We do not require that C-RPs within the scope zone be configured to know
about the scope zone, as they can learn of its existence from bootstrap
messages.  However, we recommend that router vendors implement
configuration options that allow a C-RP to be configured to be a C-RP
for global scope only, for one of more admin scopes only, or for all
scopes, both global and admin scoped.  We also recommend that the
default be that a C-RP is a C-RP for all scopes, both global and admin
scoped.


Unless configured otherwise, C-RPs discover the existence of the admin
scope zone and its group range from receiving a bootstrap message from
the scope zone's elected BSR containing the scope zone's group-range,
marked using the "Admin Scope" bit.  A C-RP stores each elected BSR's
address and the admin scope range contained in its bootstrap message.
It separately unicasts Candidate-RP-Advertisement messages to the
appropriate BSR for every admin scope range within which it is willing




Bhaskar/Gall/Venaas                               Section 1.3.  [Page 8]


INTERNET-DRAFT            Expires: January 2005                July 2004



to serve as an RP.


All PIM routers within a PIM bootstrap domain where admin scope ranges
are in use must be capable of receiving bootstrap messages and storing
the winning BSR and RP-set for all admin scope zones that apply.  Thus
PIM routers that only implement RFC 2362 (which only allows one BSR per
domain) cannot be used in PIM domains where admin scope zones are
configured.



1.4.  Bi-directional PIM


Routers doing Bi-directional PIM [3] need group-to-RP mappings similar
to PIM-SM.  Group ranges for use by Bi-directional PIM are identified in
bootstrap messages by a "Bi-dir" bit (previously a "Reserved" bit).
Routers that don't support Bi-directional PIM MUST NOT ignore these
ranges.  They MUST NOT treat them as having the default mode, i.e. PIM-
SM.



2.  BSR State and Timers


A PIM router implementing BSR holds the following state


     At all routers:


          List of Active Scope Zones


          Per Scope Zone:


               Bootstrap State:


                    o Bootstrap Router's IP Address


                    o BSR Priority


                    o Bootstrap Timer (BST)


                    o Last BSM received from this BSR


          RP-Set


     At a Candidate BSR:


          Per Scope Zone:


               o My state: One of "Candidate-BSR", "Pending-BSR",
                 "Elected-BSR"




Bhaskar/Gall/Venaas                                 Section 2.  [Page 9]


INTERNET-DRAFT            Expires: January 2005                July 2004



     At a router that is not a Candidate BSR:


          Per Scope Zone:


               My state: One of "Accept Any", "Accept Preferred"


               Scope-Zone Expiry Timer: SZT(Z)


Bootstrap state is described in section 3, and the RP-Set is described
in section 3.4.


The following timers are also required:


     At the Bootstrap Router only:


          Per Scope Zone (Z):


               Per group-to-C-RP mapping (M):


                    Group-to-C-RP mapping Expiry Timer: CGET(M,Z)


     At the C-RPs only:


          C-RP Advertisement Timer: CRPT


     At all routers:


          Per Scope Zone (Z):


               Per group-to-RP mapping (M):


                    Group-to-RP mapping Expiry Timer: GET(M,Z)



3.  Bootstrap Router Election and RP-Set Distribution


For simplicity, bootstrap messages (BSMs) are used in both the BSR
election and the RP-Set distribution mechanisms.


The state-machine for bootstrap messages depends on whether or not a
router has been configured to be a Candidate-BSR for a particular scope
zone.  The per-scope-zone state-machine for a C-BSR is given below,
followed by the state-machine for a router that is not configured to be
a C-BSR.








Bhaskar/Gall/Venaas                                Section 3.  [Page 10]


INTERNET-DRAFT            Expires: January 2005                July 2004



Per-Scope-Zone Candidate-BSR State Machine



Figure 1: Per-Scope-Zone State-machine for a candidate BSR in tabular form


+-----------------------------------------------------------------------+
|                         When in C-BSR state                           |
+------------+-------------------+-------------------+------------------+
| Event      |  Receive          |  BS Timer         |  Receive non-    |
|            |  Preferred BSM    |  Expires          |  preferred BSM   |
|            |                   |                   |  from Elected    |
|            |                   |                   |  BSR             |
+------------+-------------------+-------------------+------------------+
|            |  -> C-BSR state   |  -> P-BSR state   |  -> P-BSR state  |
|            |  Forward BSM;     |  Set BS Timer     |  Set BS Timer    |
| Action     |  Store RP-Set;    |  to               |  to              |
|            |  Set BS Timer     |  rand_override    |  rand_override   |
|            |  to BS Timeout    |                   |                  |
+------------+-------------------+-------------------+------------------+



+-----------------------------------------------------------------------+
|               When in P-BSR state                                     |
+-------------+-------------------+------------------+------------------+
| Event       |  Receive          | BS Timer         |  Receive Non-    |
|             |  Preferred BSM    | Expires          |  preferred BSM   |
+-------------+-------------------+------------------+------------------+
|             |  -> C-BSR state   | -> E-BSR state   |  -> P-BSR state  |
|             |  Forward BSM;     | Originate BSM;   |                  |
| Action      |  Store RP-Set;    | Set BS Timer     |                  |
|             |  Set BS Timer     | to BS Period     |                  |
|             |  to BS Timeout    |                  |                  |
+-------------+-------------------+------------------+------------------+



+-----------------------------------------------------------------------+
|               When in E-BSR state                                     |
+-------------+-------------------+------------------+------------------+
| Event       |  Receive          | BS Timer         |  Receive Non-    |
|             |  Preferred BSM    | Expires          |  preferred BSM   |
+-------------+-------------------+------------------+------------------+
|             |  -> C-BSR state   | -> E-BSR state   |  -> E-BSR state  |
|             |  Forward BSM;     | Originate BSM;   |  Originate BSM;  |
| Action      |  Store RP-Set;    | Set BS Timer     |  Set BS Timer    |
|             |  Set BS Timer     | to BS Period     |  to BS Period    |
|             |  to BS Timeout    |                  |                  |
+-------------+-------------------+------------------+------------------+
A candidate-BSR may be in one of three states for a particular scope




Bhaskar/Gall/Venaas                                Section 3.  [Page 11]


INTERNET-DRAFT            Expires: January 2005                July 2004



zone:


Candidate-BSR (C-BSR)
     The router is a candidate to be the BSR for the scope zone, but
     currently another router is the preferred BSR.


Pending-BSR (P-BSR)
     The router is a candidate to be the BSR for the scope zone.
     Currently no other router is the preferred BSR, but this router is
     not yet the BSR.  For comparisons with incoming BS messages, the
     router treats itself as the BSR.  This is a temporary state that
     prevents rapid thrashing of the choice of BSR during BSR election.


Elected-BSR (E-BSR)
     The router is the elected bootstrap router for the scope zone and
     it must perform all the BSR functions.


On startup, the initial state for this configured scope zone is
"Pending-BSR"; the BS Timer is initialized to the BS Timeout value.


In addition to the three states, there is one timer:


o The bootstrap timer (BS Timer) - that is used to time out old
  bootstrap router information, and used in the election process to
  terminate P-BSR state.



























Bhaskar/Gall/Venaas                                Section 3.  [Page 12]


INTERNET-DRAFT            Expires: January 2005                July 2004



Per-Scope-Zone State-machine for Non-Candidate-BSR Routers



Figure 2: Per-Scope-Zone State-machine for a router not configured as C-
                          BSR in tabular form


+-----------------------------------------------------------------------+
|                         When in NoInfo state                          |
+--------------------+--------------------------------------------------+
|     Event          |         Receive BSM for unknown Admin Scope      |
+--------------------+--------------------------------------------------+
|                    |         -> AP State                              |
|     Action         |         Forward BSM; Store RP-Set;               |
|                    |         Set BS Timer to BS Timeout;              |
|                    |         Set SZ Timer to SZ Timeout               |
+--------------------+--------------------------------------------------+



+-----------------------------------------------------------------------+
|                       When in Accept Any state                        |
+---------------+-----------------------------+-------------------------+
|   Event       |     Receive BSM             |     SZ Timer Expires    |
+---------------+-----------------------------+-------------------------+
|               |     -> AP State             |     -> NoInfo state     |
|               |     Forward BSM; Store      |     cancel timers;      |
|               |     RP-Set; Set BS          |     clear state         |
|   Action      |     Timer to BS             |                         |
|               |     Timeout; Set SZ         |                         |
|               |     Timer to SZ             |                         |
|               |     Timeout                 |                         |
+---------------+-----------------------------+-------------------------+



+-----------------------------------------------------------------------+
|         When in Accept Preferred state                                |
+------------+--------------------+------------------+------------------+
| Event      |  Receive           |   BS Timer       |  Receive Non-    |
|            |  Preferred BSM     |   Expires        |  preferred BSM   |
+------------+--------------------+------------------+------------------+
|            |  -> AP State       |   -> AA State    |  -> AP State     |
|            |  Forward BSM;      |   Refresh RP-    |                  |
|            |  Store RP-Set;     |   set; Remove    |                  |
| Action     |  Set BS Timer      |   BSR state      |                  |
|            |  to BS Timeout;    |                  |                  |
|            |  Set SZ Timer      |                  |                  |
|            |  to SZ Timeout     |                  |                  |
+------------+--------------------+------------------+------------------+





Bhaskar/Gall/Venaas                                Section 3.  [Page 13]


INTERNET-DRAFT            Expires: January 2005                July 2004



A router that is not a candidate-BSR may be in one of three states:


NoInfo
     The router has no information about this scope zone.  This state
     does not apply if the router is configured to know about this scope
     zone, or for the global scope zone.  When in this state, no state
     information is held and no timers run that refer to this scope
     zone.


Accept Any (AA)
     The router does not know of an active BSR, and will accept the
     first bootstrap message it sees as giving the new BSR's identity
     and the RP-Set.


Accept Preferred (AP)
     The router knows the identity of the current BSR, and is using the
     RP-Set provided by that BSR.  Only bootstrap messages from that BSR
     or from a C-BSR with higher weight than the current BSR will be
     accepted.


On startup, the initial state for this scope zone is "Accept Any" for
routers that know about this scope zone, either through configuration or
because the scope zone is the global scope which always exists; the SZ
Timer is considered to be always running for such scope zones.  For
routers that do not know about a particular scope zone, the initial
state is NoInfo; no timers exist for the scope zone.


In addition to the three states, there are two timers:


o The bootstrap timer (BS Timer) - that is used to time out old
  bootstrap router information.


o The scope zone timer (SZ Timer) - that is used to time out the scope
  zone itself if BS messages specifying this scope zone stop arriving.


Bootstrap Message Processing Checks


When a bootstrap message is received, the following initial checks must
be performed:













Bhaskar/Gall/Venaas                                Section 3.  [Page 14]


INTERNET-DRAFT            Expires: January 2005                July 2004



if ( (DirectlyConnected(BSM.src_ip_address) == FALSE)
     OR (we have no Hello state for BSM.src_ip_address)) {
  drop the BS message silently
}
if (BSM.dst_ip_address == ALL-PIM-ROUTERS group) {
  if ( BSM.src_ip_address != RPF_neighbor(BSM.BSR_ip_address) ) {
     drop the BS message silently
  }
} else if (BSM.dst_ip_address is one of my addresses) {
  if (Any previous BSM for this scope has been accepted) {
     #the packet was unicast, but this wasn't
     #a quick refresh on startup
     drop the BS message silently
  }
} else {
  drop the BS message silently
}
if (the interface the message arrived on is an Admin Scope
    border for the BSM.first_group_address) {
  drop the BS message silently
}


Basically, the packet must have come from a directly connected neighbor
for which we have active Hello state.  It must have been sent to the
ALL-PIM-ROUTERS group by the correct upstream router towards the BSR
that originated the BS message, or the router must have no BSR state for
that admin scope (it just restarted) and have received the BS message by
unicast.  In addition it must not have arrived on an interface that is a
configured admin scope border for the first group address contained in
the BS message.



BS State-machine Transition Events


If the bootstrap message passes the initial checks above without being
discarded, then it may cause a state transition event in one of the
above state-machines.  For both candidate and non-candidate BSRs, the
following transition events are defined:


     Receive Preferred BSM
          A bootstrap message is received from a BSR that has greater
          than or equal weight than the current BSR.  If a router is in
          P-BSR state, then it uses its own weight as that of the
          current BSR.


          The weighting for a BSR is the concatenation in fixed-
          precision unsigned arithmetic of the BSR priority field from
          the bootstrap message and the IP address of the BSR from the




Bhaskar/Gall/Venaas                                Section 3.  [Page 15]


INTERNET-DRAFT            Expires: January 2005                July 2004



          bootstrap message (with the BSR priority taking the most-
          significant bits and the IP address taking the least
          significant bits).


     Receive BSM
          A bootstrap message is received, regardless of BSR weight.


A non-candidate BSR also has the following transition event defined:


     Receive BSM for unknown Admin Scope
          As "Receive BSM", except that the admin scope zone indicated
          in the BSM was not previously known at this router.


BS State-machine Actions


The state-machines specify actions that include setting the BS timer to
the following values:


     BS Period
          The periodic interval with which bootstrap messages are
          normally sent.  The default value is 60 seconds.


     BS Timeout
          The interval after which bootstrap router state is timed out
          if no bootstrap message from that router has been heard.  The
          default value is 2 times the BS Period plus 10 seconds, which
          is 130 seconds.


     Randomized Override Interval
          The randomized interval during which a router avoids sending a
          bootstrap message while it waits to see if another router has
          a higher bootstrap weight.  This interval is to reduce control
          message overhead during BSR election.  The following
          pseudocode is proposed as an efficient implementation of this
          "randomized" value:


          Delay = 5 + 2 * log_2(1 + bestPriority - myPriority)
                  + AddrDelay



          where myPriority is the Candidate-BSR's configured priority,
          and bestPriority equals:


          bestPriority = Max(storedPriority, myPriority)


          and AddrDelay is given by the following for IPv4:






Bhaskar/Gall/Venaas                                Section 3.  [Page 16]


INTERNET-DRAFT            Expires: January 2005                July 2004



          if ( bestPriority == myPriority) {
              AddrDelay = log_2(storedAddr - myAddr) / 16
          } else {
              AddrDelay = 2 - (myAddr / 2^31)
          }


          and AddrDelay is given by the following for IPv6:


          if ( bestPriority == myPriority) {
              AddrDelay = log_2(storedAddr - myAddr) / 64
          } else {
              AddrDelay = 2 - (myAddr / 2^127)
          }



          where myAddr is the Candidate-BSR's address, storedAddr is the
          stored BSR's address, and storedPriority is the stored BSR's
          priority.


     SZ Timeout
          The interval after which a router will time out an Admin Scope
          zone that it has dynamically learned.  The interval MUST be
          larger than the BS Timeout.  The default value is ten times
          the BS Timeout, which is 1300 seconds.


In addition to setting the timers, the following actions may be
triggered by state-changes in the state-machines:


     Forward BSM
          A bootstrap message that passes the Bootstrap Message
          Processing Checks is forwarded out of all interfaces with PIM
          neighbors (including the interface it is received on), except
          where this would cause the BSM to cross an admin-scope
          boundary for the scope zone indicated in the message.  For
          details, see section 3.3.


     Originate BSM
          A new bootstrap message is constructed by the BSR, giving the
          BSR's address and BSR priority, and containing the BSR's
          chosen RP-Set.  The message is forwarded out of all multicast-
          capable interfaces, except where this would cause the BSM to
          cross an admin-scope boundary for the scope zone indicated in
          the message.  The IP source address of the message is the
          originating router's IP address on the interface the message
          is being forwarded from, the destination address is ALL-PIM-
          ROUTERS, and the TTL of the message is set to 1.






Bhaskar/Gall/Venaas                                Section 3.  [Page 17]


INTERNET-DRAFT            Expires: January 2005                July 2004



     Store RP-Set
          The router uses the group-to-RP mappings contained in a BSM to
          update its local RP-set.


          If a mapping does not yet exist, it is created and the
          associated group-to-RP mapping expiry timer (GET) is
          initialized with the holdtime from the BSM.


          If a mapping already exists, its GET is set to the holdtime
          from the BSM.  If the holdtime is zero, the mapping is removed
          immediately.


          In addition, the entire BSM is stored for use in the action
          Refresh RP-Set and to prime a new PIM neighbor as described
          below.


     Refresh RP-Set
          When the BS Timer expires, the router uses the copy of the
          last BSM that it has received to refresh its RP-set according
          to the action Store RP-Set as if it had just received it.
          This will increase the chance that the group-to-RP mappings
          will not expire during the election of the new BSR.


     Remove BSR state
          When the BS Timer expires, all state associated with the
          current BSR is removed (see section 2). Note that this does
          not include any group-to-RP mappings.


In addition to the above state-machine actions, a DR also unicasts a
stored copy of the Bootstrap message to each new PIM neighbor, i.e.,
after the DR receives the neighbor's first Hello message, and sends a
Hello message in response.  It does so even if the new neighbor becomes
the DR.


3.1.  Sending Candidate-RP-Advertisements


Every C-RP periodically unicasts a C-RP-Adv to the BSR for that scope
zone to inform the BSR of the C-RP's willingness to function as an RP.
Unless configured otherwise, it does this for every Admin Scope zone for
which it has state, and for the global scope zone.  If the same router
is the BSR for more than one scope zone, the C-RP-Adv for these scope
zones MAY be combined into a single message.


If the C-RP is a ZBR for an admin scope zone, then the Admin Scope bit
MUST be set in the C-RP-Adv messages it sends for that scope zone;
otherwise this bit MUST NOT be set.  This information is currently only
used for logging purposes by the BSR, but might allow for future
extensions of the protocol.




Bhaskar/Gall/Venaas                              Section 3.1.  [Page 18]


INTERNET-DRAFT            Expires: January 2005                July 2004



The interval for sending these messages is subject to local
configuration at the C-RP, but must be smaller than the HoldTime in the
C-RP-Adv.


[NOTE: possible optimization: prime the CRPT with a small random value
when a new BSR is elected.  This will allow the newly elected BSR to
learn group mappings fast.]


A Candidate-RP-Advertisement carries a list of group address and group
mask field pairs.  This enables the C-RP router to restrict the
advertisement to certain prefixes or scopes of groups.  If the C-RP
becomes an RP, it may enforce this scope acceptance when receiving
Registers or Join/Prune messages.


The C-RP priority field determines which C-RPs get selected by the BSR
to be in the RP-Set.  Note that a value of zero is the highest possible
priority.  C-RPs should by default send C-RP-Adv messages with the
`Priority' field set to 192.


When a C-RP is being shut down, it SHOULD immediately send a C-RP-Adv to
the BSR for each scope for which it is currently serving as an RP; the
HoldTime in this C-RP-Adv message should be zero.  The BSR will then
immediately time out the C-RP and generate a new BSR message removing
the shut down RP from the RP-set.


[NOTE: Should a new BSM be sent immediately when C-RP-Adv with HoldTime
of 0 is received?  Need to clarify.]


[NOTE: what happens if the message becomes too large to fit in a single
packet?  With the per-mapping timers, it's not a problem to send several
advertisements.  We need to say something about this.]



3.2.  Creating the RP-Set at the BSR


Upon receiving a C-RP-Adv, if the router is not the elected BSR, it
silently ignores the message.


If the router is the BSR, it creates a group-to-C-RP mapping for every
group range in the C-RP-Adv.  These mappings have identical values for
the C-RP address, C-RP priority and holdtime.  The hash mask length is a
global property of the BSR and is therefore the same for all mappings
managed by the BSR.


[NOTE: This is substantially different from version 03, where state was
kept per C-RP.  The behaviour is the same if a C-RP always sends all
advertisements in a single message.  However, there seems to be no
requirement for this (and the case where all advertisements don't fit in




Bhaskar/Gall/Venaas                              Section 3.2.  [Page 19]


INTERNET-DRAFT            Expires: January 2005                July 2004



a single message seems not to be covered).  Keeping state per group
mapping allows a C-RP to send C-RP-Advs in chunks and even allows for
different holdtimes for different group ranges (which may or may not be
useful) while being compatible with the old version.]


Every mapping that is not part of the C-RP-set is added to the C-RP-set
and the associated group-to-C-RP mapping expiry timer (CGET) is
initialized to the holdtime.


If a mapping already exists (i.e. the C-RP-set contains a mapping with
identical group-range and C-RP-address), it is updated with the
information from the BSM and its associated CGET is reset to the
holdtime from the BSM.  If the holdtime is zero, the mapping is
immediately removed from the C-RP-set.


When a CGET expires, the corresponding group-to-C-RP mapping is removed
from the C-RP-set.


The BSR constructs the RP-set from the C-RP-set.  It may apply a local
policy to limit the number of Candidate RPs included in the RP-set.  The
BSR may override the prefix indicated in a C-RP-Adv unless the
`Priority' field from the C-RP-Adv is less than 128.


For inclusion in a BSM, the RP-set is subdivided into sets of {group-
prefix, RP-Count, RP-addresses}.  For each RP-address, the corresponding
HoldTime is included in the "RP-HoldTime" field.  The format of the
Bootstrap message allows `semantic fragmentation', if the length of the
original Bootstrap message exceeds the packet maximum boundaries.
However, we recommend against configuring a large number of routers as
C-RPs, to reduce the semantic fragmentation required.


When an elected BSR is being shut down, it should immediately originate
a Bootstrap message listing its current RP-Set, but with the BSR
priority field set to the lowest priority value possible.  This will
cause the election of a new BSR to happen more quickly.



3.3.  Forwarding Bootstrap Messages


Bootstrap messages originate at the BSR, and are hop-by-hop forwarded by
intermediate routers if they pass the Bootstrap Message Processing
Check.  Bootstrap messages are multicast to the `ALL-PIM-ROUTERS' group.
When a BS message is forwarded, it is forwarded out of every multicast-
capable interface which has PIM neighbors (including the one over which
the message was received).  The exception to this is if the interface is
an administrative scope boundary for the admin scope zone indicated in
the first group address in the BS message packet.  The IP source address
on the bootstrap message should be set to the forwarding router's IP




Bhaskar/Gall/Venaas                              Section 3.3.  [Page 20]


INTERNET-DRAFT            Expires: January 2005                July 2004



address on the interface the message is being forwarded from.  Bootstrap
messages are always originated or forwarded with an IP TTL value of 1.


As an optimization, a router MAY choose not to forward a BSM out of the
interface the message was received on if that interface is a point-to-
point interface.  On interfaces with multiple PIM neighbors, a router
SHOULD forward an accepted BSM onto the interface that BSM was received
on, but if the number of PIM neighbors on that interface is large, it
MAY delay forwarding a BSM onto that interface by a small randomized
interval to prevent message implosion. A configuration option MAY be
provided to disable forwarding onto the interface a message was received
on, but we recommend that the default behavior is to forward onto that
interface.


Rationale: A BSM needs to be forwarded onto the interface the message
was received on (in addition to the other interfaces) because the
routers on a LAN may not have consistent routing information.  If three
routers on a LAN are A, B, and C, and at router B RPF(BSR)==A and at
router C RPF(BSR)==B, then router A originally forwards the BSM onto the
LAN, but router C will only accept it when router B re-forwards the
message onto the LAN.  If the underlying routing protocol configuration
guarantees that the routers have consistent routing information, then
forwarding onto the incoming interface may safely be disabled.



3.4.  Receiving and Using the RP-Set


[NOTE: what should go into this section?  It doesn't make sense to
repeat what is said in the "Store RP-set" action.]


The RP-set maintained by BSR is used by RP-based multicast routing
protocols like PIM-SM and Bi-directional PIM.  These protocols may
obtain RP-sets from other sources as well.  How the final group-to-RP
mappings are obtained from these RP-sets is not part of the BSR
specification.  In general, the routing protocols need to re-calculate
the mappings when any of their RP-sets change.  How such a change is
signalled to the routing protocol is also not part of the present
specification.


4.  Message Formats


BSR messages are PIM messages, as defined in [1]. The values of the PIM
message Type field for BSR messages are:


4    Bootstrap Message


8    Candidate-RP-Advertisement





Bhaskar/Gall/Venaas                                Section 4.  [Page 21]


INTERNET-DRAFT            Expires: January 2005                July 2004



In this section we use the following terms defined in the PIM-SM [1]:


o    Encoded-Unicast format


o    Encoded-Group format


We repeat these here to aid readability.


Encoded-Unicast address


An Encoded-Unicast address takes the following format:


 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|  Addr Family  | Encoding Type |     Unicast Address
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+...



Addr Family
     The PIM address family of the `Unicast Address' field of this
     address.


     Values of 0-127 are as assigned by the IANA for Internet Address
     Families in [7]. Values 128-250 are reserved to be assigned by the
     IANA for PIM-specific Address Families.  Values 251 though 255 are
     designated for private use.  As there is no assignment authority
     for this space, collisions should be expected.


Encoding Type
     The type of encoding used within a specific Address Family.  The
     value `0' is reserved for this field, and represents the native
     encoding of the Address Family.



Unicast Address
     The unicast address as represented by the given Address Family and
     Encoding Type.



Encoded-Group address











Bhaskar/Gall/Venaas                                Section 4.  [Page 22]


INTERNET-DRAFT            Expires: January 2005                July 2004



Encoded-Group addresses take the following format:


 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|  Addr Family  | Encoding Type |B| Reserved  |Z|  Mask Len     |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                Group multicast Address
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+...



Addr Family
     described above.



Encoding Type
     described above.



[B]IDIR bit
     When set, all BIDIR capable PIM routers will operate the protocol
     described in [3] for the specified group range.



Reserved
     Transmitted as zero. Ignored upon receipt.



Admin Scope [Z]one
     When set, this bit indicates that this group address range is an
     administratively scoped range.



Mask Len
     The Mask length field is 8 bits. The value is the number of
     contiguous one bits left justified used as a mask which, combined
     with the group address, describes a range of groups. It is less
     than or equal to the address length in bits for the given Address
     Family and Encoding Type. If the message is sent for a single group
     then the Mask length must equal the address length in bits for the
     given Address Family and Encoding Type.  (e.g. 32 for IPv4 native
     encoding and 128 for IPv6 native encoding).



Group multicast Address
     Contains the group address.






Bhaskar/Gall/Venaas                                Section 4.  [Page 23]


INTERNET-DRAFT            Expires: January 2005                July 2004



4.1.  Bootstrap Message Format



A bootstrap message is divided up into `semantic fragments' if the
original message exceeds the maximum packet size boundaries.  Basically,
a single bootstrap message can be sent as multiple packets (semantic
fragments), so long as the fragment tags of all the packets comprising
the message is the same.


If the bootstrap message contains information about more than one admin
scope zone, each different scope zone MUST occupy a different semantic
fragment.  This allows Zone Border Routers for an admin scope zone to
not forward only those fragments that should not traverse the admin
scope boundary.


The format of a single `fragment' is given below:




































Bhaskar/Gall/Venaas                              Section 4.1.  [Page 24]


INTERNET-DRAFT            Expires: January 2005                July 2004



 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|PIM Ver| Type  |   Reserved    |           Checksum            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|         Fragment Tag          | Hash Mask len | BSR-priority  |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|             BSR Address (Encoded-Unicast format)              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|            Group Address 1 (Encoded-Group format)             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| RP Count 1    | Frag RP Cnt 1 |         Reserved              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|             RP Address 1 (Encoded-Unicast format)             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|          RP1 Holdtime         | RP1 Priority  |   Reserved    |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|             RP Address 2 (Encoded-Unicast format)             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|          RP2 Holdtime         | RP2 Priority  |   Reserved    |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                               .                               |
|                               .                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|             RP Address m (Encoded-Unicast format)             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|          RPm Holdtime         | RPm Priority  |   Reserved    |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|            Group Address 2 (Encoded-Group format)             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                               .                               |
|                               .                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|            Group Address n (Encoded-Group format)             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| RP Count n    | Frag RP Cnt n |          Reserved             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|             RP Address 1 (Encoded-Unicast format)             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|          RP1 Holdtime         | RP1 Priority  |   Reserved    |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|             RP Address 2 (Encoded-Unicast format)             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|          RP2 Holdtime         | RP2 Priority  |   Reserved    |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                               .                               |
|                               .                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+




Bhaskar/Gall/Venaas                              Section 4.1.  [Page 25]


INTERNET-DRAFT            Expires: January 2005                July 2004



|             RP Address m (Encoded-Unicast format)             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|          RPm Holdtime         | RPm Priority  |   Reserved    |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+



PIM Version, Reserved, Checksum
     Described in [1].


Type PIM Message Type.  Value is 4 for a Bootstrap Message.



Fragment Tag
     A randomly generated number, acts to distinguish the fragments
     belonging to different Bootstrap messages; fragments belonging to
     same Bootstrap message carry the same `Fragment Tag'.



Hash Mask len
     The length (in bits) of the mask to use in the hash function. For
     IPv4 we recommend a value of 30. For IPv6 we recommend a value of
     126.



BSR priority
     Contains the BSR priority value of the included BSR.  This field is
     considered as a high order byte when comparing BSR addresses.  Note
     that for historical reasons, the highest BSR priority is 255 (the
     higher the better), whereas the highest RP Priority (see below) is
     0 (the lower the better).



BSR Address
     The address of the bootstrap router for the domain.  The format for
     this address is given in the Encoded-Unicast address in [1].


Group Address 1..n
     The group prefix (address and mask) with which the Candidate RPs
     are associated.  Format described in [1]. In a fragment containing
     admin scope ranges, the first group address in the fragment MUST be
     the group range for the entire admin scope range, and this MUST
     have the Admin Scope bit set.  This is the case even if there are
     no RPs in the RP-Set for the entire admin scope range - in this
     case the sub-ranges for the RP-Set are specified later in the
     fragment along with their RPs.







Bhaskar/Gall/Venaas                              Section 4.1.  [Page 26]


INTERNET-DRAFT            Expires: January 2005                July 2004



RP Count 1..n
     The number of Candidate RP addresses included in the whole
     Bootstrap message for the corresponding group prefix. A router does
     not replace its old RP-Set for a given group prefix until/unless it
     receives `RP-Count' addresses for that prefix; the addresses could
     be carried over several fragments.  If only part of the RP-Set for
     a given group prefix was received, the router discards it, without
     updating that specific group prefix's RP-Set.



Frag RP Cnt 1..m
     The number of Candidate RP addresses included in this fragment of
     the Bootstrap message, for the corresponding group prefix. The
     `Frag RP Cnt' field facilitates parsing of the RP-Set for a given
     group prefix, when carried over more than one fragment.



RP address 1..m
     The address of the Candidate RPs, for the corresponding group
     prefix.  The format for these addresses is given in the Encoded-
     Unicast address in [1].


RP1..m Holdtime
     The Holdtime for the corresponding RP.  This field is copied from
     the `Holdtime' field of the associated RP stored at the BSR.



RP1..m Priority
     The `Priority' of the corresponding RP and Encoded-Group Address.
     This field is copied from the `Priority' field stored at the BSR
     when receiving a Candidate-RP-Advertisement.  The highest priority
     is `0' (i.e. unlike BSR priority, the lower the value of the
     `Priority' field, the better).  Note that the priority is per RP
     per Group Address.



4.1.1.  Semantic Fragmentation of BSMs


Bootstrap messages may be split over several PIM Bootstrap Message
Fragment (BSMF) packets; this is known as semantic fragmentation.  There
are two reasons for semantic fragmentation:


o    The BSM would exceed the link MTU the packet will be forwarded
     over.


o    The BSM includes information about more than one admin scope zone.






Bhaskar/Gall/Venaas                            Section 4.1.1.  [Page 27]


INTERNET-DRAFT            Expires: January 2005                July 2004



Let us initially consider only the former case; the packet would be too
large because the set of group prefixes and the RPs for each group
prefix are too long to fit in one packet.  The BSR will then split the
BSM across several BSMF packets; each of these must be a well-formed
BSMF packet in its own right.


If the BSR can split up the BSM so that different group prefixes (and
their RP information) can fit in different fragments, then it should do
so.  If one of these BSMF packets is then lost, the state from the
previous BSM for the group-prefix from the missing packet will be
retained.  Each fragment that does arrive will update the RP information
for the group-prefixes contained in that fragment, and the new group-to-
RP mapping for those can be used immediately.  The information from the
missing fragment will be obtained when the BSM is next transmitted.  In
this case, whilst the Fragment Tag must be set to the same value for all
BSMFs comprising a single BSM, the tag is not actually used by routers
receiving the BSM.


If the list of RPs for a single group-prefix is too long to fit in a
single BSMF packet, then that information must be split across multiple
BSMF packets.  In this case, all the BSMF packets comprising the
information for that group-prefix must be received before the group-to-
RP mapping in use can be modified.  This is the purpose of the RP Count
field - a router receiving BSMF packets from the same BSM (ie that have
the same fragment tag) must wait until the BSMFs providing RP Count RPs
for that group-prefix have been received before the new group-to-RP
mapping can be used for that group-prefix.  If a single BSMF from such a
large group-prefix is lost, then that entire group-prefix will have to
wait until the next BSM is originated.


Next we need to consider how a BSR would remove group-prefixes from the
BSM.  A router receiving a set of BSMFs cannot tell if a group-prefix is
missing.  If it has seen a group-prefix before, it must assume that that
group-prefix still exists, and that the BSMF describing it has been
lost.  It should retain this information for BS Timeout seconds.  Thus
for a BSR to remove a group-prefix from the BSR, it should include that
group-prefix, but with a RP Count of zero, and it should resend this
information in each BSM for BS Timeout seconds.


Finally, we come to the case of fragments for the purpose of conveying
admin scope group-prefixes.  In general, the information for each admin
scope range is independent of information about other admin scope
ranges.  As no BSMF is allowed to convey information for more than one
admin scope range, then the procedure above also applies to BSMs that
are fragmented due to admin scoping.  However, to time out all the state
for an entire admin scope zone requires waiting SZ Timeout rather than
BS Timeout, as admin scope zones are not expected to come and go
frequently.




Bhaskar/Gall/Venaas                            Section 4.1.1.  [Page 28]


INTERNET-DRAFT            Expires: January 2005                July 2004



4.2.  Candidate-RP-Advertisement Format


Candidate-RP-Advertisements are periodically unicast from the C-RPs to
the BSR.


 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|PIM Ver| Type  |   Reserved    |           Checksum            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Prefix Count  |   Priority    |           Holdtime            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|             RP Address (Encoded-Unicast format)               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|            Group Address 1 (Encoded-Group format)             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                               .                               |
|                               .                               |
|                               .                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|            Group Address n (Encoded-Group format)             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+



PIM Version, Reserved, Checksum
     Described in [1].


Type PIM Message Type.  Value is 8 for a Candidate-RP-Advertisement
     Message.



Prefix Count
     The number of encoded group addresses included in the message;
     indicating the group prefixes for which the C-RP is advertising. A
     Prefix Count of `0' implies all multicast groups, e.g. for IPv4 a
     prefix of 224.0.0.0 with mask length of 4.  If the C-RP is not
     configured with Group-prefix information, the C-RP puts a default
     value of `0' in this field.



Priority
     The `Priority' of the included RP, for the corresponding Encoded-
     Group Address (if any).  highest priority is `0' (i.e. the lower
     the value of the `Priority' field, the higher the priority). This
     field is stored at the BSR upon receipt along with the RP address
     and corresponding Encoded-Group Address.






Bhaskar/Gall/Venaas                              Section 4.2.  [Page 29]


INTERNET-DRAFT            Expires: January 2005                July 2004



Holdtime
     The amount of time the advertisement is valid. This field allows
     advertisements to be aged out.



RP Address
     The address of the interface to advertise as a Candidate RP.  The
     format for this address is given in the Encoded-Unicast address in
     [1].


Group Address-1..n
     The group prefixes for which the C-RP is advertising.  Format
     described in Encoded-Group-Address in [1].


5.  Default Values for Timers


Timer Name: Bootstrap Timer (BST)



+-------------------+--------------------------+------------------------+
|  Value Name       |   Value                  |   Explanation          |
+-------------------+--------------------------+------------------------+
|  BS Period        |   Default: 60 secs       |   Period between       |
|                   |                          |   originating          |
|                   |                          |   bootstrap messages   |
+-------------------+--------------------------+------------------------+
|  BS Timeout       |   2 * BS_Period + 10     |   Period after last    |
|                   |   seconds                |   BS message before    |
|                   |                          |   BSR is timed out     |
|                   |                          |   and election         |
|                   |                          |   begins               |
+-------------------+--------------------------+------------------------+
|  rand_override    |   rand(0, 5.0 secs)      |   Suppression period   |
|                   |                          |   in BSR election to   |
|                   |                          |   prevent thrashing    |
+-------------------+--------------------------+------------------------+


Timer Name: Group-to-C-RP apping Expiry Timer (CGET(M,Z))



+----------------------+--------------+---------------------------------+
|Value Name            |Value         | Explanation                     |
+----------------------+--------------+---------------------------------+
|C-RP Mapping Timeout  |from message  | Hold time from C-RP-Adv message |
+----------------------+--------------+---------------------------------+


C-RP Advertisement messages are sent periodically with period C-RP-Adv-
Period.  C-RP-Adv-Period defaults to 60 seconds.  The holdtime to be




Bhaskar/Gall/Venaas                                Section 5.  [Page 30]


INTERNET-DRAFT            Expires: January 2005                July 2004



specified in a C-RP-Adv message should be set to (2.5 * C-RP-Adv-Period
).  This timer is used for group-to-C-RP mappings in the C-RP-set at the
BSR.


Timer Name: Group-to-RP mapping Expiry Timer (GET(M,Z))



+------------------------+--------------------+-------------------------+
|  Value Name            |    Value           |    Explanation          |
+------------------------+--------------------+-------------------------+
|  RP Mapping Timeout    |    from message    |    Hold time from BSM   |
+------------------------+--------------------+-------------------------+


This timer is identical to CGET, except that it applies to the mappings
in the RP-set rather than the C-RP-set.


Timer Name: C-RP Advertisement Timer (CRPT)



+--------------------+--------------------------+-----------------------+
| Value Name         |   Value                  |  Explanation          |
+--------------------+--------------------------+-----------------------+
| C-RP-Adv-Period    |   Default: 60 seconds    |  Period with which    |
|                    |                          |  periodic C-RP        |
|                    |                          |  Advertisements are   |
|                    |                          |  sent to BSR          |
+--------------------+--------------------------+-----------------------+


Timer Name: Scope Zone Expiry Timer (SZT(Z))



+------------------------------------+--------------+--------------------+
|Value Name      Value   Explanation |              |                    |
+------------------------------------+--------------+--------------------+
|SZ Timeout                          | 1300 seconds | Interval after     |
|                                    |              | which a scope zone |
|                                    |              | will be timed out  |
|                                    |              | if the state is    |
|                                    |              | not refreshed      |
+------------------------------------+--------------+--------------------+



6.  Security Considerations


6.1.  Possible Threats


Threats affecting the PIM BSR mechanism are primarily of two forms:
denial of service attacks, and traffic diversion attacks.  An attacker




Bhaskar/Gall/Venaas                              Section 6.1.  [Page 31]


INTERNET-DRAFT            Expires: January 2005                July 2004



that subverts the BSR mechanism can prevent multicast traffic from
reaching the intended recipients, can divert multicast traffic to a
place where they can monitor it, and can potentially flood third parties
with traffic.


Traffic can be prevented from reaching the intended recipients by one of
two mechanisms:


o    Subverting a BSM, and specifying RPs that won't actually forward
     traffic.


o    Registering with the BSR as a C-RP, and then not forwarding
     traffic.


Traffic can be diverted to a place where it can be monitored by both of
the above mechanisms; in this case the RPs would forward the traffic,
but are located so as to aid monitoring or man-in-the-middle attacks on
the multicast traffic.


A third party can be flooded by either of the above two mechanisms by
specifying the third party as the RP, and register-encapsulated traffic
will then be forwarded to them.


6.2.  Limiting Third-Party DoS Attacks


The third party DoS attack above can be greatly reduced if PIM routers
acting as DR do not continue to forward Register traffic to the RP in
the presence of ICMP Protocol Unreachable or ICMP Host Unreachable
responses.  If a PIM router sending Register packets to an RP receives
one of these responses to a data packet it has sent, it should rate-
limit the transmission of future Register packets to that RP for a short
period of time.


As this does not affect interoperability, the precise details are left
to the implementor to decide.  However we note that a router
implementing such rate limiting must only do so if the ICMP packet
correctly echoes part of a Register packet that was sent to the RP.  If
this check were not made, then simply sending ICMP Unreachable packets
to the DR with the source address of the RP spoofed would be sufficient
to cause a denial-of-service attack on the multicast traffic originating
from that DR.


6.3.  BS Message Security


If a legitimate PIM router is compromised, there is little any security
mechanism can do to prevent that router subverting PIM traffic in that
domain.  However we recommend that implementors provide a mechanism
whereby a PIM router using the BSR mechanisms can be configured with the




Bhaskar/Gall/Venaas                              Section 6.3.  [Page 32]


INTERNET-DRAFT            Expires: January 2005                July 2004



IP addresses of valid BSR routers, and that any BS Message from any
other BSR should then be dropped and logged as a security issue.  We
also recommend that this not be enabled by default, as it makes the
initial configuration of a PIM domain problematic - it is the sort of
feature that might be enabled once the configuration of a domain has
stabilized.


The primary security requirement for BSR (as for PIM) is that it is
possible to prevent hosts that are not legitimate PIM routers, either
within or outside the domain, from subverting the BSR mechanism.


The Bootstrap Message Processing Checks prevent a router from accepting
a BS message from outside of the PIM Domain, as the source address on BS
Messages must be an immediate PIM neighbor.  There is however a small
window of time after a reboot where a PIM router will accept a bad BS
Message unicast from an immediate neighbor, and it might be possible to
unicast a BS Message to a router during this interval from outside the
domain, using the spoofed source address of a neighbor.  This can be
prevented if PMBRs perform source-address filtering to prevent packets
entering the PIM domain with IP source addresses that are infrastructure
addresses in the PIM domain.


The principal threat to BS Message security comes from hosts within the
PIM domain that attempt to subvert the BSR mechanism.  They may be able
to do this by sending PIM messages to their local router, or by
unicasting a BS message to another PIM router during the brief interval
after it has restarted.



All BS Messages SHOULD carry the Router Alert IP option.  If a PIM
router receives a BS Message that does not carry the router alert
option, it SHOULD drop it (a configuration option should also be
provided to disable this check on a per-interface basic for backward
compatibility with older PIM routers).  The Router Alert option allows a
PIM router to perform checks on unicast packets it would otherwise
blindly forward.  All PIM routers should check that packets with Router
Alert that are not destined for the router itself are not PIM Bootstrap
messages.  Any such packets should be dropped and logged as a possible
security issue - it is never acceptable for a PIM BS message to travel
multiple IP hops.



Most hosts that are likely to attempt to subvert PIM BSR are likely to
be located on leaf subnets.  We recommend that implementors provide a
configuration option that specifies an interface is a leaf subnet, and
that no PIM packets are accepted on such interfaces.






Bhaskar/Gall/Venaas                              Section 6.3.  [Page 33]


INTERNET-DRAFT            Expires: January 2005                July 2004



On multi-access subnets with multiple PIM routers and hosts that are not
trusted, we recommend that IPsec AH is used to protect communication
between PIM routers, and that such routers are configured to drop and
log communication attempts from any host that do not pass the
authentication check.  When all the PIM routers are under the same
administrative control, this authentication may use a configured shared
secret.  The securing of interactions between PIM neighbors is discussed
in more detail in the Security Considerations section of [1], and so we
do not discuss the details further here.  The same security mechanisms
that can be used to secure PIM Join, Prune and Assert messages should
also be used to secure BS messages.


6.4.  C-RP-Advertisement Security


Even if it is not possible to subvert BS Messages, an attacker might be
able to perform most of the same attacks by simply sending C-RP-Adv
messages to the BSR specifying the attacker's choice of RPs.  Thus it is
necessary to control the sending of C-RP-Adv messages in essentially the
same ways that we control BS Messages.  However, C-RP-Adv messages are
unicast and normally travel multiple hops, so controlling them is a
little harder.



We specify that C-RP-Adv messages SHOULD also carry the Router Alert IP
option, and that the BSR SHOULD by default drop and log C-RP-Adv
messages that do not carry this option.  Setting Router Alert on these
packets is practical because the rate of C-RP-Adv messages should be
very low, so the extra load on routers forwarding these packets will be
insignificant.  All PIM routers forwarding such a packet are then
capable of checking whether the packet came from a valid neighbor.  On
interfaces that are configured to be leaf subnets, all C-RP-Adv messages
should be dropped.  On multi-access subnets with multiple PIM routers
and hosts that are not trusted, the router can at least check that the
source MAC address is that of a valid PIM neighbor.  PMBRs should ensure
that no C-RP-Adv messages enter the domain from an external neighbor.



For true security, we recommend that all C-RPs are configured to use
IPsec authentication.  The authentication process for a C-RP-Adv message
between a C-RP and the BSR is identical to the authentication process
for PIM Register messages between a DR and the relevant RP, except that
there will normally be fewer C-RPs in a domain than there are DRs, so
key management is a little simpler.  We do not describe the details of
this process further here, but refer to the Security Considerations
section of [1]. Note that the use of cryptographic security for C-RP-
Advs does not remove the need for the non-cryptographic mechanisms, as
explained below.





Bhaskar/Gall/Venaas                              Section 6.4.  [Page 34]


INTERNET-DRAFT            Expires: January 2005                July 2004



6.5.  Denial of Service using IPsec


An additional concern is that of Denial-of-Service attacks caused by
sending high volumes of BS Messages or C-RP-Adv messages with invalid
IPsec authentication information.  It is possible that these messages
could overwhelm the CPU resources of the recipient.


The non-cryptographic security mechanisms above prevent unicast BS
messages from traveling multiple hops, and constrain who can originate
such messages.  However, it is obviously important that PIM Messages
that are required to have Router Alert checked are checked for this
option before the IPsec AH is checked.  Thus the remaining vulnerability
primarily exists for hosts on multi-access subnets containing more than
one PIM router.  A PIM router receiving PIM packets with Router Alert
set from such a subnet should already be checking that the source MAC
address is that of a valid PIM neighbor, but this is hardly strong
security.  In addition, we recommend that rate-limiting mechanisms can
be configured, to be applied to the forwarding of unicast PIM packets
containing Router Alert options.  The rate-limiter MUST independently
rate-limit different types of PIM packets - for example a flood of C-RP-
Adv messages MUST NOT cause a rate limiter to drop low-rate BS Messages.
Such a rate-limiter might itself be used to cause a denial of service
attack by causing valid packets to be dropped, but in practice this is
more likely to constrain bad PIM Messages close to their origin.  In
addition, the rate limiter will prevent attacks on PIM from affecting
other activity on the destination router, such as unicast routing.



7.  Contributors


Bill Fenner, Mark Handley, Roger Kermode and David Thaler have
contributed greatly to this draft.  They were authors of this draft up
to version 03.  Most of the current text is identical to 03.



8.  Acknowledgments


PIM-SM was designed over many years by a large group of people,
including ideas from Deborah Estrin, Dino Farinacci, Ahmed Helmy, Steve
Deering, Van Jacobson, C. Liu, Puneet Sharma, Liming Wei, Tom Pusateri,
Tony Ballardie, Scott Brim, Jon Crowcroft, Paul Francis, Joel Halpern,
Horst Hodel, Polly Huang, Stephen Ostrowski, Lixia Zhang, Girish
Chandranmenon, Pavlin Radoslavov, John Zwiebel, Isidor Kouvelas and Hugh
Holbrook.  This BSR specification draws heavily on text from RFC 2362.








Bhaskar/Gall/Venaas                                Section 8.  [Page 35]


INTERNET-DRAFT            Expires: January 2005                July 2004



9.  IANA Considerations


This document has no actions for IANA.



10.  Normative References


[1] W. Fenner, M. Handley, H. Holbrook, I. Kouvelas, "Protocol
     Independent Multicast - Sparse Mode (PIM-SM): Protocol
     Specification (Revised)", Internet Draft draft-ietf-pim-sm-
     v2-new-09.ps


[2] D. Meyer, "Administratively Scoped IP Multicast", RFC 2365, Jul
     1998.


[3] M. Handley, I. Kouvelas, T. Speakman, L. Vicisano, "Bi-directional
     Protocol Independent Multicast (BIDIR-PIM)", Internet Draft draft-
     ietf-pim-bidir-06.txt



11.  Informative References


[4] S. Deering , W. Fenner , B. Haberman, "Multicast Listener Discovery
     (MLD) for IPv6", RFC 2710, Oct 1999.


[5] D. Estrin et al., "Protocol Independent Multicast - Sparse Mode
     (PIM-SM): Protocol Specification", RFC 2362, June 1998 (now
     obsolete).


[6] W. Fenner, "Internet Group Management Protocol, Version 2", RFC
     2236, Nov 1997.


[7] IANA, "Address Family Numbers", linked from
     http://www.iana.org/numbers.html



12.  Authors' Addresses


     Nidhi Bhaskar
     Cisco Systems
     170 W. Tasman Drive
     San Jose, CA 95134
     USA
     nbhaskar@cisco.com








Bhaskar/Gall/Venaas                               Section 12.  [Page 36]


INTERNET-DRAFT            Expires: January 2005                July 2004



     Alexander Gall
     SWITCH
     Limmatquai 138
     P.O. Box
     CH-8021 Zurich
     Switzerland
     gall@switch.ch



     Stig Venaas
     UNINETT
     NO-7465 Trondheim
     Norway
     venaas@uninett.no



Copyright Statement


Copyright (C) The Internet Society (2004).  This document is subject to
the rights, licenses and restrictions contained in BCP 78, and except as
set forth therein, the authors retain all their rights.


Disclaimer of Validity


This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR
IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.





















Bhaskar/Gall/Venaas                               Section 12.  [Page 37]