.. _example_protocols_bgp_neighbor_capability:

##########
Capability
##########

Test BGP **capability** options for neighbor sessions. BGP capabilities are negotiated
during session establishment to determine what features both peers support. The dynamic
option enables renegotiation of capabilities without tearing down the BGP session, allowing
new features or address families to be added on-the-fly. The orf prefix-list option enables
Outbound Route Filtering, which allows a router to send its inbound prefix-list filters to
a neighbor so the neighbor can apply them as outbound filters. This reduces bandwidth and
processing overhead by filtering unwanted routes at the source instead of receiving and then
discarding them. ORF requires one peer configured in send mode to push its import filter,
and the other peer in receive mode to accept and apply it as an export filter.

******************************************
Test iBGP - Capability dynamic negotiation
******************************************

Description
===========

Test BGP **capability dynamic** which enables dynamic capability negotiation.
When enabled, both peers advertise the dynamic capability during session setup.
This allows future capability changes without resetting the session. The test
verifies that the capability is successfully negotiated between both peers.

Scenario
========

.. include:: capability/testibgp-capabilitydynamicnegotiation

.. raw:: html

  <hr>

*******************************************
Test iBGP - Without ORF receives all routes
*******************************************

Description
===========

Baseline test without ORF to demonstrate default behavior. DUT1 advertises two
networks (1.1.1.0/24 and 2.2.2.0/24) and DUT0 receives both of them.
This serves as a comparison point for the ORF test that follows.

Scenario
========

.. include:: capability/testibgp-withoutorfreceivesallroutes

.. raw:: html

  <hr>

***************************************************************
Test iBGP - Capability ORF prefix-list filters routes at source
***************************************************************

Description
===========

Test BGP **capability orf prefix-list** which enables Outbound Route Filtering.
DUT0 is configured with ORF send mode and has a prefix-list that only permits
1.1.1.0/24. DUT0 sends this filter to DUT1 via ORF. DUT1 is configured with
ORF receive mode, so it accepts the filter and applies it to its outbound updates.
As a result, DUT1 only sends 1.1.1.0/24 to DUT0, even though it has both
1.1.1.0/24 and 2.2.2.0/24 in its routing table. This demonstrates how
ORF reduces unnecessary route advertisements by filtering at the source.

Scenario
========

.. include:: capability/testibgp-capabilityorfprefix-listfiltersroutesatsource

.. raw:: html

  <hr>