summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNigel Kukard <nkukard@lbsd.net>2017-09-09 12:09:27 +0200
committerNigel Kukard <nkukard@lbsd.net>2017-09-11 11:12:04 +0200
commit47e7c0b971916aa1e56c4ce35a7cbe8b3bada9a7 (patch)
tree73e2a8bc235ebc52503000021752b65ed4f8a796
parentdoc: Clarified the use of show bgp ipv4/ipv6 for communities (diff)
downloadfrr-47e7c0b971916aa1e56c4ce35a7cbe8b3bada9a7.tar.xz
frr-47e7c0b971916aa1e56c4ce35a7cbe8b3bada9a7.zip
doc: Moved AS regular expressions to BGP regular expressions
Regular expressions are used throughout in bgp commands, it should not be in a section under as paths which cannot be easily found. Signed-off-by: Nigel Kukard <nkukard@lbsd.net>
-rw-r--r--doc/bgpd.texi82
1 files changed, 41 insertions, 41 deletions
diff --git a/doc/bgpd.texi b/doc/bgpd.texi
index 144729bc6..6089ab626 100644
--- a/doc/bgpd.texi
+++ b/doc/bgpd.texi
@@ -33,6 +33,7 @@ BGP-4.
* Capability Negotiation::
* Route Reflector::
* Route Server::
+* BGP Regular Expressions::
* How to set up a 6-Bone connection::
* Dump BGP packets and table::
* BGP Configuration Examples::
@@ -857,54 +858,21 @@ The AS numbers 64512 through 65535 are defined as private AS numbers.
Private AS numbers must not to be advertised in the global Internet.
@menu
-* AS Path Regular Expression::
* Display BGP Routes by AS Path::
* AS Path Access List::
* Using AS Path in Route Map::
* Private AS Numbers::
@end menu
-@node AS Path Regular Expression
-@subsection AS Path Regular Expression
-
-AS path regular expression can be used for displaying BGP routes and
-AS path access list. AS path regular expression is based on
-@code{POSIX 1003.2} regular expressions. Following description is
-just a subset of @code{POSIX} regular expression. User can use full
-@code{POSIX} regular expression. Adding to that special character '_'
-is added for AS path regular expression.
-
-@table @code
-@item .
-Matches any single character.
-@item *
-Matches 0 or more occurrences of pattern.
-@item +
-Matches 1 or more occurrences of pattern.
-@item ?
-Match 0 or 1 occurrences of pattern.
-@item ^
-Matches the beginning of the line.
-@item $
-Matches the end of the line.
-@item _
-Character @code{_} has special meanings in AS path regular expression.
-It matches to space and comma , and AS set delimiter @{ and @} and AS
-confederation delimiter @code{(} and @code{)}. And it also matches to
-the beginning of the line and the end of the line. So @code{_} can be
-used for AS value boundaries match. @code{show ip bgp regexp _7675_}
-matches to all of BGP routes which as AS number include @var{7675}.
-@end table
-
@node Display BGP Routes by AS Path
@subsection Display BGP Routes by AS Path
To show BGP routes which has specific AS path information @code{show
ip bgp} command can be used.
-@deffn Command {show ip bgp regexp @var{line}} {}
-This commands display BGP routes that matches AS path regular
-expression @var{line}.
+@deffn Command {show bgp @{ipv4|ipv6@} regexp @var{line}} {}
+This commands displays BGP routes that matches a regular
+expression @var{line} (@pxref{BGP Regular Expressions}).
@end deffn
@node AS Path Access List
@@ -1021,8 +989,9 @@ empty it matches to any routes.
@deffn Command {ip community-list expanded @var{name} @{permit|deny@} @var{line}} {}
This command defines a new expanded community list. @var{line} is a
-string expression of communities attribute. @var{line} can include
-regular expression to match communities attribute in BGP updates.
+string expression of communities attribute. @var{line} can be a
+regular expression (@pxref{BGP Regular Expressions}) to match
+the communities attribute in BGP updates.
@end deffn
@deffn Command {no ip community-list @var{name}} {}
@@ -1335,8 +1304,8 @@ there is no matched entry, deny will be returned. When
@deffn Command {ip extcommunity-list expanded @var{name} @{permit|deny@} @var{line}} {}
This command defines a new expanded extcommunity-list. @var{line} is
a string expression of extended communities attribute. @var{line} can
-include regular expression to match extended communities attribute in
-BGP updates.
+be a regular expression (@pxref{BGP Regular Expressions}) to match an
+extended communities attribute in BGP updates.
@end deffn
@deffn Command {no ip extcommunity-list @var{name}} {}
@@ -1504,7 +1473,8 @@ Total number of prefixes 1
@subsection More Show IP BGP
@deffn {Command} {show ip bgp regexp @var{line}} {}
-This command display BGP routes using AS path regular expression (@pxref{Display BGP Routes by AS Path}).
+This command displays BGP routes using AS path regular expression
+(@pxref{BGP Regular Expressions}).
@end deffn
@deffn Command {show ip bgp community @var{community}} {}
@@ -1821,6 +1791,36 @@ To display routing table of BGP view, you must specify view name.
Display routing table of BGP view @var{name}.
@end deffn
+@node BGP Regular Expressions
+@section BGP Regular Expressions
+
+BGP regular expressions are based on @code{POSIX 1003.2} regular
+expressions. The following description is just a quick subset of the
+@code{POSIX} regular expressions. Adding to that, the special character
+'_' is added.
+
+@table @code
+@item .
+Matches any single character.
+@item *
+Matches 0 or more occurrences of pattern.
+@item +
+Matches 1 or more occurrences of pattern.
+@item ?
+Match 0 or 1 occurrences of pattern.
+@item ^
+Matches the beginning of the line.
+@item $
+Matches the end of the line.
+@item _
+Character @code{_} has special meanings in BGP regular expressions.
+It matches to space and comma , and AS set delimiter @{ and @} and AS
+confederation delimiter @code{(} and @code{)}. And it also matches to
+the beginning of the line and the end of the line. So @code{_} can be
+used for AS value boundaries match. This character technically evaluates
+to @code{(^|[,@{@}() ]|$)}.
+@end table
+
@node How to set up a 6-Bone connection
@section How to set up a 6-Bone connection