diff --git a/doc/bird.sgml b/doc/bird.sgml index 8a8c2275..a00dbb74 100644 --- a/doc/bird.sgml +++ b/doc/bird.sgml @@ -1602,11 +1602,22 @@ protocol ospf <name> { tick <num>; ecmp <switch> [limit <num>]; area <id> { + stub <switch>; + nssa <switch>; + summary <switch>; stub cost <num>; + translator <switch>; + translator stability <num>; + networks { <prefix>; <prefix> hidden; } + external { + <prefix>; + <prefix> hidden; + <prefix> tag <num>; + } stubnet <prefix>; stubnet <prefix> { hidden <switch>; @@ -1683,15 +1694,56 @@ protocol ospf <name> { address, similarly to a router ID). The most important area is the backbone (ID 0) to which every other area must be connected. + stub switch + This option configures the area to be a stub area. External + routes are not flooded into stub areas. Also summary LSAs can be + limited in stub areas (see option nssa switch + This option configures the area to be a NSSA (Not-So-Stubby + Area). NSSA is a variant of a stub area which allows a + limited way of external route propagation. Global external + routes are not propagated into a NSSA, but an external route + can be imported into NSSA as a (area-wide) NSSA-LSA (and + possibly translated and/or aggregated on area boundary). + Default value is no. (Area is not NSSA.) + + summary switch + This option controls propagation of summary LSAs into stub or + NSSA areas. If enabled, summary LSAs are propagated as usual, + otherwise just the default summary route (0.0.0.0/0) is + propagated (this is sometimes called totally stubby area). If + a stub area has more area boundary routers, propagating + summary LSAs could lead to more efficient routing at the cost + of larger link state database. Default value is no. + stub cost num - No external (except default) routes are flooded into stub areas. - Setting this value marks area stub with defined cost of default route. - Default value is no. (Area is not stub.) + This option controls the cost of a default route propagated to + stub and NSSA areas. Default value is 1000. + + translator switch + This option controls translation of NSSA-LSAs into external + LSAs. By default, one translator per NSSA is automatically + elected from area boundary routers. If enabled, this area + boundary router would unconditionally translate all NSSA-LSAs + regardless of translator election. Default value is no. + + translator stability num + This option controls the translator stability interval (in + seconds). When the new translator is elected, the old one + keeps translating until the interval is over. Default value + is 40. networks { Definition of area IP ranges. This is used in summary LSA origination. Hidden networks are not propagated into other areas. + external { + Definition of external area IP ranges for NSSAs. This is used + for NSSA-LSA translation. Hidden networks are not translated + into external LSAs. Networks can have configured route tag. + stubnet Stub networks are networks that are not transit networks between OSPF routers. They are also propagated through an