Doc: Documentation for large communities
This commit is contained in:
parent
60566c5c80
commit
cec4a73ccb
1 changed files with 34 additions and 4 deletions
|
@ -1048,7 +1048,16 @@ foot).
|
||||||
for <cf/key/ and <cf/value/ parts, (e.g. <cf/(ro, myas, 3*10)/, where
|
for <cf/key/ and <cf/value/ parts, (e.g. <cf/(ro, myas, 3*10)/, where
|
||||||
<cf/myas/ is an integer variable).
|
<cf/myas/ is an integer variable).
|
||||||
|
|
||||||
<tag/int|pair|quad|ip|prefix|ec|enum set/
|
<tag/lc/
|
||||||
|
This is a specialized type used to represent BGP large community
|
||||||
|
values. It is essentially a triplet of 32bit values, where the first
|
||||||
|
value is reserved for the AS number of the issuer, while meaning of
|
||||||
|
remaining parts is defined by the issuer. Literals of this type are
|
||||||
|
written as <cf/(123, 456, 789)/, with any integer values. Similarly to
|
||||||
|
pairs, LCs can be constructed using expressions for its parts, (e.g.
|
||||||
|
<cf/(myas, 10+20, 3*10)/, where <cf/myas/ is an integer variable).
|
||||||
|
|
||||||
|
<tag/int|pair|quad|ip|prefix|ec|lc|enum set/
|
||||||
Filters recognize four types of sets. Sets are similar to strings: you
|
Filters recognize four types of sets. Sets are similar to strings: you
|
||||||
can pass them around but you can't modify them. Literals of type <cf>int
|
can pass them around but you can't modify them. Literals of type <cf>int
|
||||||
set</cf> look like <cf> [ 1, 2, 5..7 ]</cf>. As you can see, both simple
|
set</cf> look like <cf> [ 1, 2, 5..7 ]</cf>. As you can see, both simple
|
||||||
|
@ -1067,9 +1076,15 @@ foot).
|
||||||
(like <cf/(rt, *, 3)/) are not allowed (as they usually have 4B range
|
(like <cf/(rt, *, 3)/) are not allowed (as they usually have 4B range
|
||||||
for ASNs).
|
for ASNs).
|
||||||
|
|
||||||
You can also use expressions for int, pair and EC set values. However it
|
Also LC sets use similar expressions like pair sets. You can use ranges
|
||||||
must be possible to evaluate these expressions before daemon boots. So
|
and wildcards, but if one field uses that, more specific (later) fields
|
||||||
you can use only constants inside them. E.g.
|
must be wildcards. E.g., <cf/(10, 20..30, *)/ or <cf/(10, 20, 30..40)/
|
||||||
|
is valid, while <cf/(10, *, 20..30)/ or <cf/(10, 20..30, 40)/ is not
|
||||||
|
valid.
|
||||||
|
|
||||||
|
You can also use expressions for int, pair, EC and LC set values.
|
||||||
|
However, it must be possible to evaluate these expressions before daemon
|
||||||
|
boots. So you can use only constants inside them. E.g.
|
||||||
|
|
||||||
<code>
|
<code>
|
||||||
define one=1;
|
define one=1;
|
||||||
|
@ -1205,6 +1220,13 @@ foot).
|
||||||
The same operations (like <cf/add/, <cf/delete/ or <cf/˜/ and
|
The same operations (like <cf/add/, <cf/delete/ or <cf/˜/ and
|
||||||
<cf/!˜/ membership operators) can be used to modify or test
|
<cf/!˜/ membership operators) can be used to modify or test
|
||||||
eclists, with ECs instead of pairs as arguments.
|
eclists, with ECs instead of pairs as arguments.
|
||||||
|
|
||||||
|
<tag/lclist/
|
||||||
|
Lclist is a data type used for BGP large community lists. Like eclists,
|
||||||
|
lclists are very similar to clists, but they are sets of LCs instead of
|
||||||
|
pairs. The same operations (like <cf/add/, <cf/delete/ or <cf/˜/
|
||||||
|
and <cf/!˜/ membership operators) can be used to modify or test
|
||||||
|
lclists, with LCs instead of pairs as arguments.
|
||||||
</descrip>
|
</descrip>
|
||||||
|
|
||||||
|
|
||||||
|
@ -2193,6 +2215,14 @@ some of them (marked with `<tt/O/') are optional.
|
||||||
field. Individual community values are represented using an <cf/ec/ data
|
field. Individual community values are represented using an <cf/ec/ data
|
||||||
type inside the filters.
|
type inside the filters.
|
||||||
|
|
||||||
|
<tag>lclist <cf/bgp_large_community/ [O]</tag>
|
||||||
|
List of large community values associated with the route. Large BGP
|
||||||
|
communities is another variant of communities, but contrary to extended
|
||||||
|
communities they behave very much the same way as regular communities,
|
||||||
|
just larger -- they are uniform untyped triplets of 32bit numbers.
|
||||||
|
Individual community values are represented using an <cf/lc/ data type
|
||||||
|
inside the filters.
|
||||||
|
|
||||||
<tag>quad <cf/bgp_originator_id/ [I, O]</tag>
|
<tag>quad <cf/bgp_originator_id/ [I, O]</tag>
|
||||||
This attribute is created by the route reflector when reflecting the
|
This attribute is created by the route reflector when reflecting the
|
||||||
route and contains the router ID of the originator of the route in the
|
route and contains the router ID of the originator of the route in the
|
||||||
|
|
Loading…
Reference in a new issue