.. _example_protocols_bgp_neighbor_unsuppress-map:

##############
Unsuppress-Map
##############

Test BGP **unsuppress-map** functionality. When aggregate-address is configured with
summary-only, the more specific routes are suppressed and only the aggregate is advertised.
The unsuppress-map command allows selectively leaking specific routes to a particular
neighbor while keeping them suppressed for other neighbors. This is useful when you want
to advertise both the aggregate and certain more-specific routes to selected peers, for
example to provide more granular routing to preferred customers while giving others only
the summary route.

***************************************************
Test iBGP - Summary-only suppresses specific routes
***************************************************

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

Baseline test showing that aggregate-address summary-only suppresses specific routes.
DUT0 has routes 192.168.1.0/24 and 192.168.2.0/24 and creates an aggregate 192.168.0.0/16.
With summary-only, DUT1 should receive only the aggregate, not the specific /24 routes.

Scenario
========

.. include:: unsuppress-map/testibgp-summary-onlysuppressesspecificroutes

.. raw:: html

  <hr>

************************************************
Test iBGP - Unsuppress-map leaks specific routes
************************************************

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

Test BGP unsuppress-map which selectively leaks suppressed routes to a neighbor.
DUT0 has aggregate-address summary-only configured, but also an unsuppress-map
that permits 192.168.1.0/24. DUT1 should receive both the aggregate 192.168.0.0/16
AND the specific route 192.168.1.0/24, while 192.168.2.0/24 remains suppressed.

Scenario
========

.. include:: unsuppress-map/testibgp-unsuppress-mapleaksspecificroutes

.. raw:: html

  <hr>