diff options
Diffstat (limited to 'net/openbgpd/files/patch-bgpd_bgpd.8')
| -rw-r--r-- | net/openbgpd/files/patch-bgpd_bgpd.8 | 280 |
1 files changed, 232 insertions, 48 deletions
diff --git a/net/openbgpd/files/patch-bgpd_bgpd.8 b/net/openbgpd/files/patch-bgpd_bgpd.8 index e666cb96d92c..f59cd5269f2c 100644 --- a/net/openbgpd/files/patch-bgpd_bgpd.8 +++ b/net/openbgpd/files/patch-bgpd_bgpd.8 @@ -2,13 +2,13 @@ Index: bgpd/bgpd.8 =================================================================== RCS file: /home/cvs/private/hrs/openbgpd/bgpd/bgpd.8,v retrieving revision 1.1.1.8 -retrieving revision 1.9 -diff -u -p -r1.1.1.8 -r1.9 +retrieving revision 1.10 +diff -u -p -r1.1.1.8 -r1.10 --- bgpd/bgpd.8 14 Feb 2010 20:19:57 -0000 1.1.1.8 -+++ bgpd/bgpd.8 2 Jul 2011 16:06:38 -0000 1.9 ++++ bgpd/bgpd.8 13 Oct 2012 18:36:00 -0000 1.10 @@ -1,4 +1,4 @@ -.\" $OpenBSD: bgpd.8,v 1.28 2009/01/13 23:01:36 sthen Exp $ -+.\" $OpenBSD: bgpd.8,v 1.33 2009/12/16 15:40:55 claudio Exp $ ++.\" $OpenBSD: bgpd.8,v 1.45 2012/08/24 20:13:03 jmc Exp $ .\" .\" Copyright (c) 2003, 2004 Henning Brauer <henning@openbsd.org> .\" @@ -17,7 +17,7 @@ diff -u -p -r1.1.1.8 -r1.9 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: January 13 2009 $ -+.Dd $Mdocdate: June 27 2010 $ ++.Dd $Mdocdate: August 24 2012 $ .Dt BGPD 8 .Os .Sh NAME @@ -35,13 +35,105 @@ diff -u -p -r1.1.1.8 -r1.9 .Ek .Sh DESCRIPTION .Nm -@@ -42,15 +38,15 @@ concerning +@@ -42,15 +38,106 @@ concerning with other BGP systems. .Nm uses the Border Gateway Protocol, Version 4, -as described in RFC 1771. +-Please refer to that document for more information about BGP. +as described in RFC 4271. - Please refer to that document for more information about BGP. ++.Pp ++BGP is an exterior gateway protocol using a multiple step decision process ++to find the best path. ++Advanced filtering can be used to influence the route ++decision for traffic engineering. ++The session engine of ++.Nm ++is responsible for maintaining the TCP session with each neighbor. ++Updates are passed to the Route Decision Engine (RDE) where the paths ++are filtered and used to compute a Routing Information Base (RIB). ++The parent process is responsible for keeping the RIB in sync with ++the kernel routing table. ++.Pp ++The route decision process selects the best path by evaluating all paths to ++the same destination. ++The decision process continues to the next step if paths have equal attributes. ++Paths that are less preferred are taken out of consideration until there is ++only one path left. ++.Bl -enum -width 42 -offset bula ++.It ++All paths with errors or loops are not eligible. ++.It ++Paths with an unreachable nexthop are not eligible. ++After this step all remaining paths are valid. ++.It ++The path with the highest ++.Em LOCAL_PREF ++is selected. ++.It ++The path with the shortest ++.Em AS path ++attribute is selected. ++.It ++The ++.Em ORIGIN ++attribute is compared. ++The order is IGP before EGP before incomplete origins. ++.It ++The path with the lowest ++.Em MULTI_EXIT_DISC ++metric is selected. ++Normally, this value is only considered when choosing between multiple ++routes sent by the same neighbouring AS. ++However, if ++.Dq Li rde med compare always ++is set in the configuration, the metric is compared for routes sent by any AS. ++.It ++Comparison of the BGP session type. ++Paths learned over an external (EBGP) session are preferred over those ++learned via an internal (IBGP) session. ++.It ++The path with the lowest local ++.Em weight ++is selected. ++.It ++If ++.Dq Li rde route-age evaluate ++is set then the oldest path is selected. ++.It ++The path coming from the neighbor with the lowest ++.Em BGP ID ++wins. ++If the ++.Em ORIGINATOR_ID ++attribute is present that value will be used in the comparison instead. ++.It ++The path with the shortest ++.Em CLUSTER_LIST ++attribute is selected. ++If it is not present then a length of 0 is used in the comparison. ++.It ++The path coming from the peer with the lowest IP address is selected. ++IPv4 sessions will be preferred over IPv6 ones. ++.It ++In case of locally announced prefixes ++.Nm ++will prefer statically set prefixes over dynamically inserted ones. ++.El ++.Pp ++Attributes set by filters can be used to tip the decision process to prefer ++particular paths over others. ++This can be achieved by changing the ++.Em localpref , ++.Em med , ++or ++.Em weight ++attributes. ++AS path prepending or changing the ++.Em med ++or ++.Em origin ++attribute can be used to influencing the routing behaviour on remote systems. .Pp .Nm is usually started at boot time, and can be enabled by @@ -54,7 +146,7 @@ diff -u -p -r1.1.1.8 -r1.9 .Pp See .Xr rc 8 -@@ -117,25 +113,16 @@ Use +@@ -117,25 +204,16 @@ Use .Ar file as the configuration file, instead of the default @@ -82,83 +174,175 @@ diff -u -p -r1.1.1.8 -r1.9 default .Nm configuration file -@@ -150,9 +137,9 @@ control socket +@@ -149,55 +227,144 @@ control socket + .Xr bgpctl 8 , .Xr bgplg 8 , .Xr bgplgsh 8 ++.Sh STANDARDS .Rs -.%R RFC 1771 -+.%R RFC 4271 - .%T "A Border Gateway Protocol 4 (BGP-4)" +-.%T "A Border Gateway Protocol 4 (BGP-4)" -.%D March 1995 -+.%D January 2006 +-.Re +-.Rs +-.%R RFC 1997 +-.%T "BGP Communities Attribute" ++.%A R. Chandra ++.%A P. Traina ++.%A "T. Li" + .%D August 1996 ++.%R RFC 1997 ++.%T BGP Communities Attribute .Re ++.Pp .Rs - .%R RFC 1997 -@@ -165,6 +152,11 @@ control socket +-.%R RFC 2385 +-.%T "Protection of BGP Sessions via the TCP MD5 Signature Option" ++.%A A. Heffernan .%D August 1998 ++.%R RFC 2385 ++.%T Protection of BGP Sessions via the TCP MD5 Signature Option .Re ++.Pp .Rs -+.%R RFC 2545 -+.%T "Use of BGP-4 Multiprotocol Extensions for IPv6 Inter-Domain Routing" +-.%R RFC 2796 +-.%T "BGP Route Reflection - An Alternative to Full Mesh IBGP" +-.%D April 2000 ++.%A P. Marques ++.%A F. Dupont +.%D March 1999 -+.Re -+.Rs - .%R RFC 2796 - .%T "BGP Route Reflection - An Alternative to Full Mesh IBGP" - .%D April 2000 -@@ -175,11 +167,6 @@ control socket ++.%R RFC 2545 ++.%T Use of BGP-4 Multiprotocol Extensions for IPv6 Inter-Domain Routing + .Re ++.Pp + .Rs +-.%R RFC 2918 +-.%T "Route Refresh Capability for BGP-4" ++.%A E. Chen .%D September 2000 ++.%R RFC 2918 ++.%T Route Refresh Capability for BGP-4 .Re ++.Pp .Rs -.%R RFC 3392 -.%T "Capabilities Advertisement with BGP-4" -.%D January 1999 --.Re --.Rs - .%R RFC 3682 - .%T "The Generalized TTL Security Mechanism (GTSM)" - .%D February 2004 -@@ -190,6 +177,21 @@ control socket - .%D April 2004 ++.%A G. Huston ++.%D April 2004 ++.%R RFC 3765 ++.%T NOPEER Community for Border Gateway Protocol (BGP) Route Scope Control .Re ++.Pp .Rs +-.%R RFC 3682 +-.%T "The Generalized TTL Security Mechanism (GTSM)" +-.%D February 2004 ++.%A Y. Rekhter ++.%A "T. Li" ++.%A S. Hares ++.%D January 2006 ++.%R RFC 4271 ++.%T A Border Gateway Protocol 4 (BGP-4) + .Re ++.Pp + .Rs +-.%R RFC 3765 +-.%T "NOPEER Community for Border Gateway Protocol" +-.%D April 2004 ++.%A S. Sangli ++.%A D. Tappan ++.%A Y. Rekhter ++.%D February 2006 +.%R RFC 4360 -+.%T "BGP Extended Communities Attribute" ++.%T BGP Extended Communities Attribute + .Re ++.Pp + .Rs +-.%R RFC 4760 +-.%T "Multiprotocol Extensions for BGP-4" ++.%A E. Rosen ++.%A Y. Rekhter +.%D February 2006 ++.%R RFC 4364 ++.%T BGP/MPLS IP Virtual Private Networks (VPNs) +.Re ++.Pp +.Rs -+.%R RFC 4364 -+.%T "BGP/MPLS IP Virtual Private Networks (VPNs)" -+.%D February 2006 ++.%A T. Bates ++.%A E. Chen ++.%A R. Chandra ++.%D April 2006 ++.%R RFC 4456 ++.%T "BGP Route Reflection: An Alternative to Full Mesh Internal BGP (IBGP)" +.Re ++.Pp +.Rs -+.%R RFC 4486 -+.%T "BGP Cease Notification Message Subcodes" ++.%A E. Chen ++.%A V. Gillet +.%D April 2006 ++.%R RFC 4486 ++.%T Subcodes for BGP Cease Notification Message +.Re ++.Pp +.Rs - .%R RFC 4760 - .%T "Multiprotocol Extensions for BGP-4" ++.%A T. Bates ++.%A R. Chandra ++.%A D. Katz ++.%A Y. Rekhter .%D January 2007 -@@ -199,6 +201,21 @@ control socket - .%T "BGP Support for Four-octet AS Number Space" - .%D May 2007 ++.%R RFC 4760 ++.%T Multiprotocol Extensions for BGP-4 .Re ++.Pp + .Rs +-.%R RFC 4893 +-.%T "BGP Support for Four-octet AS Number Space" ++.%A Q. Vohra ++.%A E. Chen + .%D May 2007 ++.%R RFC 4893 ++.%T BGP Support for Four-octet AS Number Space ++.Re ++.Pp +.Rs -+.%R RFC 5492 -+.%T "Capabilities Advertisement with BGP-4" ++.%A V. Gill ++.%A J. Heasley ++.%A D. Meyer ++.%A P. Savola ++.%A C. Pignatoro ++.%D October 2007 ++.%R RFC 5082 ++.%T The Generalized TTL Security Mechanism (GTSM) ++.Re ++.Pp ++.Rs ++.%A J. Scudder ++.%A R. Chandra +.%D February 2009 ++.%R RFC 5492 ++.%T Capabilities Advertisement with BGP-4 +.Re ++.Pp +.Rs -+.%R draft-ietf-idr-optional-transitive-00 -+.%T "Error Handling for Optional Transitive BGP Attributes" +.%D April 2009 ++.%R draft-ietf-idr-optional-transitive-00 ++.%T Error Handling for Optional Transitive BGP Attributes +.Re ++.Pp +.Rs -+.%R draft-ietf-idr-fsm-subcode-00 -+.%T "Subcodes for BGP Finite State Machine Error" -+.%D September 2010 ++.%D August 2011 ++.%R draft-ietf-grow-mrt-17 ++.%T MRT routing information export format +.Re ++.Pp ++.Rs ++.%A J. Dong ++.%A M. Chen ++.%A A. Suryanarayana ++.%D May 2012 ++.%R RFC 6608 ++.%T Subcodes for BGP Finite State Machine Error + .Re .Sh HISTORY The - .Nm |