Configuration : family

Family

This document present the NEW, not yet complete process API which is due to be used after the 3.4.x releases.

This statement can be found under the following group:

• BGP
• BGP/group
• BGP/neighbor
• BGP/group/neigbor

with every more specific setting overwriting the previous more generic one.

Syntax

family {
   all;
   minimal; # announce the AFI/SAFI of the routes in the configuration

   ipv4 unicast;
   ipv4 multicast;
   ipv4 nlri-mpls;
   ipv4 mpls-vpn;
   ipv4 flow;
   ipv4 flow-vpn;
   ipv6 unicast;
   ipv6 flow;
   ipv6 flow-vpn;
}

---

Defines which AFI/SAFI family will be accepted with the BGP connection.

ExaBGP does not make any attempt to provide sanity regarding the command issued vs the family negotiated. Therefore you will be able to send an IPv6 unicast route to a peer which has only negotiated IPv4 unicast, this will however most likely result in the peer terminating the session with a NOTIFICATION.

ExaBGP provides two "macros" to make your life easier

all

This is the default setting and will announce to the peer all the families we know.

minimum

ExaBGP will look at all the family issued within the configuration file and will only announce the minimum set to announce the routes defined. This is not recommended if you are using the process feature as family negotiation are done at session start up and can not be change without a session bounce. Furthermore ExaBGP will not detect any family used through the use of the process API.