summaryrefslogtreecommitdiffstats
path: root/nest/rt-table.c
diff options
context:
space:
mode:
authorMartin Mares <mj@ucw.cz>2000-06-02 14:41:25 +0200
committerMartin Mares <mj@ucw.cz>2000-06-02 14:41:25 +0200
commit9a8f20fc0fda1cf910fe8ca21e850ab1524c4355 (patch)
tree046daaea00ebe05044edb30c1f03d0c672cff5c2 /nest/rt-table.c
parent2eac33f774a2075cff3d28f7fdb36e0482e48f35 (diff)
downloadbird-9a8f20fc0fda1cf910fe8ca21e850ab1524c4355.tar
bird-9a8f20fc0fda1cf910fe8ca21e850ab1524c4355.zip
Better description of the route distribution process.
Diffstat (limited to 'nest/rt-table.c')
-rw-r--r--nest/rt-table.c31
1 files changed, 29 insertions, 2 deletions
diff --git a/nest/rt-table.c b/nest/rt-table.c
index 4649132..de4d4f5 100644
--- a/nest/rt-table.c
+++ b/nest/rt-table.c
@@ -227,6 +227,24 @@ do_rte_announce(struct announce_hook *a, net *net, rte *new, rte *old, ea_list *
rte_free(old);
}
+/**
+ * rte_announce - announce a routing table change
+ * @tab: table the route has been added to
+ * @net: network in question
+ * @new: the new route to be announced
+ * @old: previous optimal route for the same network
+ * @tmpa: a list of temporary attributes belonging to the new route
+ *
+ * This function gets a routing table update and announces it
+ * to all protocols connected to the same table by their announcement hooks.
+ *
+ * For each such protocol, we first call its import_control() hook which
+ * performs basic checks on the route (each protocol has a right to veto
+ * or force accept of the route before any filter is asked) and adds default
+ * values of attributes specific to the new protocol (metrics, tags etc.).
+ * Then it consults the protocol's export filter and if it accepts the
+ * route, the rt_notify() hook of the protocol gets called.
+ */
static void
rte_announce(rtable *tab, net *net, rte *new, rte *old, ea_list *tmpa)
{
@@ -435,10 +453,19 @@ rte_update_unlock(void)
* rta_clone()), call rte_get_temp() to obtain a temporary &rte, fill in all
* the appropriate data and finally submit the new &rte by calling rte_update().
*
- * rte_update() will automatically find the old route defined by the protocol @p
+ * When rte_update() gets any route, it automatically validates it (checks,
+ * whether the network and next hop address are valid IP addresses and also
+ * whether a normal routing protocol doesn't try to smuggle a host or link
+ * scope route to the table), converts all protocol dependent attributes stored
+ * in the &rte to temporary extended attributes, consults import filters of the
+ * protocol to see if the route should be accepted and/or its attributes modified,
+ * stores the temporary attributes back to the &rte.
+ *
+ * Now, having a "public" version of the route, we
+ * automatically find any old route defined by the protocol @p
* for network @n, replace it by the new one (or removing it if @new is %NULL),
* recalculate the optimal route for this destination and finally broadcast
- * the change (if any) to all routing protocols.
+ * the change (if any) to all routing protocols by calling rte_announce().
*
* All memory used for attribute lists and other temporary allocations is taken
* from a special linear pool @rte_update_pool and freed when rte_update()