From 0acce9a290cf8fb81022c98e567c5cd97bbc5927 Mon Sep 17 00:00:00 2001
From: Eugene Bogomazov <eb@qrator.net>
Date: Fri, 10 Jun 2022 19:01:09 +0300
Subject: [PATCH 2/3] [PATCH] Update documentation for RFC 9234

---
 doc/bird.sgml | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/doc/bird.sgml b/doc/bird.sgml
index 1d5ae056..db499e01 100644
--- a/doc/bird.sgml
+++ b/doc/bird.sgml
@@ -2338,6 +2338,7 @@ avoid routing loops.
 <item> <rfc id="8203"> - BGP Administrative Shutdown Communication
 <item> <rfc id="8212"> - Default EBGP Route Propagation Behavior without Policies
 <item> <rfc id="9117"> - Revised Validation Procedure for BGP Flow Specifications
+<item> <rfc id="9234"> - Route Leak Prevention and Detection Using Roles
 </itemize>
 
 <sect1>Route selection rules
@@ -2778,6 +2779,26 @@ using the following configuration parameters:
 	protocol itself (for example, if a route is received through eBGP and
 	therefore does not have such attribute). Default: 100 (0 in pre-1.2.0
 	versions of BIRD).
+
+	<tag><label id="bgp-role">local role <m/role-name/</tag>
+	BGP Roles are defines in <rfc id="9234">. This configuration parameter can
+	be used to simplify process of route leaks prevention, so you don't need
+	to define communities and ingress/egress filters. Instead, filters are
+	automatically configured with help of <cf/OTC/ attribute - a flag that
+	marks routes that should be sent only to customers. The same attribute
+	is also used to automatically detect and filter route leaks created by
+	the third parties.
+        
+	Possible <cf><m/role-name/</cf> values are: <cf/provider/, <cf/rs_server/,
+	<cf/rs_client/, <cf/customer/ and <cf/peer/. Default: No local role
+	assigned.
+
+	<tag><label id="bgp-strict-mode">strict mode <m/switch/</tag>
+	If this option is set BGP session won't become established until BGP
+	neighbor set <ref id="bgp-role" name="local Role"> on its side. This
+	configuratoin parameter is defined in <rfc id="9234"> and used to
+	enforce corresponding configuration at your conter-part side. Default:
+	disabled.
 </descrip>
 
 <sect1>Channel configuration
@@ -3085,6 +3106,11 @@ some of them (marked with `<tt/O/') are optional.
 	This attribute contains accumulated IGP metric, which is a total
 	distance to the destination through multiple autonomous systems.
 	Currently, the attribute is not accessible from filters.
+
+	<tag><label id="bgp-otc">int bgp_otc [O]</tag>
+	This attribute is defined in <rfc id="9234">. OTC is a flag that marks
+	routes that should be sent only to customers. If <ref id="bgp-role"
+	name="local Role"> is configured it set automatically.
 </descrip>
 
 <sect1>Example
-- 
2.25.1