From: Donald Sharp Date: Tue, 10 Oct 2023 20:42:58 +0000 (-0400) Subject: Revert "doc: add the bgp link-state user documentation" X-Git-Tag: base_10.0~373^2~16 X-Git-Url: https://git.puffer.fish/?a=commitdiff_plain;h=da622a28e6faa35cd8992c27e3c818d43ff164a9;p=matthieu%2Ffrr.git Revert "doc: add the bgp link-state user documentation" This reverts commit 115f4f1dddb47a05c3e9454cc0fc88f34ebeb281. --- diff --git a/doc/user/bgp-linkstate.rst b/doc/user/bgp-linkstate.rst deleted file mode 100644 index 7d0b6da977..0000000000 --- a/doc/user/bgp-linkstate.rst +++ /dev/null @@ -1,107 +0,0 @@ -.. _bgp-link-state: - -BGP Link-State -============== - -Overview --------- - -BGP Link-State (BGP-LS) is an extension of the BGP protocol designed to -redistribute information from an IGP database to a remote controller (most -likely a Path Computation Element - PCE). BGP-LS does nothing more than -transport IGP information. Therefore, it cannot be used to replace a Link State -routing protocol like OSPF and IS-IS. - -Historically, the only way to get a network controller to collect an IGP -database was to have it participate in the IGP itself as if it were a standard -router. Since the controllers were usually located far from the IGP area, -tunnels such as GRE were used to connect the controllers to the IGP area. This -method was so impractical that an alternative solution was imagined: using the -already deployed inter-domain BGP protocol to redistribute the various IGP -databases. - -BGP Link-State as defined in `RFC7752 -`_ uses the AFI 16388 and SAFI 71. -The BGP Link-State pseudo-prefixes distributed by the `NLRI (Network Layer -Reachability Information)` uniquely define the following -IGP information: - -- Nodes -- Link -- IPv4 Prefix -- IPv6 Prefix - -They are called descriptors. In addition, a new type of BGP Attributes called -"BGP-LS attributes" carries the other information related to a descriptor. - -NLRI and attribute information for BGP-LS is organized using the TLV format -already used by IS-IS LSPs and OSPF opaque LSAs. The `list of TLV code points -`_ -is maintained by IANA. - -Current implementation ----------------------- - -The current version can participate in BGP Link-State AFI / SAFI with -third-party routers and forward the BGP Link-State descriptors and attributes to -other routers. However, it can not generate BGP Link-State data from OSPF and -IS-IS. - -IANA maintains a `registry of BGP-LS NRLI descriptor types -`_. -Only the following RFC7752 NRLI types are supported by the current version: - -- Nodes -- Link -- IPv4 Prefix -- IPv6 Prefix - -The BGP-LS attribute TLVs for these NLRI types are transmitted as is to other -routers which means that all the current and future version are already -supported. - -Show commands -------------- - -The following configuration enables the negotiation of the link-state AFI / SAFI -with the 192.0.2.2 eBGP peer. - -.. code-block:: frr - - router bgp 65003 - neighbor 192.0.2.2 remote-as 65002 - neighbor 192.0.2.2 update-source 192.0.2.3 - ! - address-family link-state link-state - neighbor 192.0.2.2 activate - neighbor 192.0.2.2 route-map PERMIT-ALL in - neighbor 192.0.2.2 route-map PERMIT-ALL out - exit-address-family - exit - ! - route-map PERMIT-ALL permit 1 - -The BGP-LS table can be displayed. - -.. code-block:: frr - - frr# show bgp link-state link-state - BGP table version is 8, local router ID is 192.0.2.3, vrf id 0 - Default local pref 100, local AS 65003 - Network Next Hop Metric LocPrf Weight Path - *> Node OSPFv2 ID:0x20 Local{AS:65001 ID:0 Area:0 Rtr:10.10.10.10:1.1.1.1}/48 - 0 65002 65001 i - *> IPv4-Prefix OSPFv2 ID:0x20 Local{AS:65001 ID:0 Area:0 Rtr:10.10.10.10:1.1.1.1} Prefix{IPv4:89.10.11.0/24}/64 - 0 65002 65001 i - *> IPv6-Prefix ISIS-L2 ID:0x20 Local{AS:65001 ID:0 Rtr:0000.0000.1003.00} Prefix{IPv6:12:12::12:12/128 MT:2}/74 - 0 65002 65001 i - *> IPv6-Prefix OSPFv3 ID:0x20 Local{AS:65001 ID:0 Area:0 Rtr:10.10.10.10} Prefix{OSPF-Route-Type:1 IPv6:12:12::12:12/128 MT:2}/74 - 0 65002 65001 i - *> Node OSPFv2 ID:0x20 Local{AS:65001 ID:0 Area:0 Rtr:10.10.10.10}/48 - 0 65002 65001 i - *> Node ISIS-L1 ID:0x20 Local{AS:65001 ID:0 Rtr:0000.0000.1003.00}/48 - 0 65002 65001 i - *> Link ISIS-L1 ID:0x20 Local{AS:65001 ID:0 Rtr:0000.0000.1001} Remote{AS:65001 ID:0 Rtr:0000.0000.1000} Link{IPv4:10.1.0.1 Neigh-IPv4:10.1.0.2 IPv6:2001::1 Neigh-IPv6:2001::2 MT:0,2}/132 - 0 65002 65001 i - - diff --git a/doc/user/bgp.rst b/doc/user/bgp.rst index 36eb8315f7..5ddaaffe1e 100644 --- a/doc/user/bgp.rst +++ b/doc/user/bgp.rst @@ -1837,13 +1837,6 @@ Configuring Peers and is not displayed. The `bgp default l2vpn-evpn` form of the command is displayed. -.. clicmd:: bgp default link-state - - This command allows the user to specify that the link-state link-state - address family is turned on by default or not. This command defaults to off - and is not displayed. - The `bgp default link-state` form of the command is displayed. - .. clicmd:: bgp default show-hostname This command shows the hostname of the peer in certain BGP commands @@ -5243,7 +5236,6 @@ Show command json output: .. include:: flowspec.rst -.. include:: bgp-linkstate.rst .. _bgp-fast-convergence: diff --git a/doc/user/conf.py b/doc/user/conf.py index 40accc1bd2..728f9c9364 100644 --- a/doc/user/conf.py +++ b/doc/user/conf.py @@ -130,7 +130,6 @@ exclude_patterns = [ "rpki.rst", "routeserver.rst", "ospf_fundamentals.rst", - "bgp-linkstate.rst", "flowspec.rst", "snmptrap.rst", "wecmp_linkbw.rst",