mirror_frr/doc/user
Philippe Guibert e55b088399 bgpd: add as-notation keyword to 'router bgp' vty command
A new keyword permits changing the BGP as-notation output:
- [no] router bgp <> [vrf BLABLA] [as-notation [<dot|plain|dot+>]]

At the BGP instance creation, the output will inherit the way the
BGP instance is declared. For instance, the 'router bgp 1.1'
command will configure the output in the dot format. However, if
the client wants to choose an alternate output, he will have to
add the extra command: 'router bgp 1.1 as-notation dot+'.

Also, if the user wants to have plain format, even if the BGP
instance is declared in dot format, the keyword can also be used
for that.

The as-notation output is only taken into account at the BGP
instance creation. In the case where VPN instances are used,
a separate instance may be dynamically created. In that case,
the real as-notation format will be taken into acccount at the
first configuration.

Linking the as-notation format with the BGP instance makes sense,
as the operators want to keep consistency of what they configure.

One technical reason why to link the as-notation output with the
BGP instance creation is that the as-path segment lists stored
in the BGP updates use a string representation to handle aspath
operations (by using regexp for instance). Changing on the fly
the output needs to regenerate this string representation to the
correct format. Linking the configuration to the BGP instance
creation avoids refreshing the BGP updates. A similar mechanism
is put in place in junos too.

Signed-off-by: Philippe Guibert <philippe.guibert@6wind.com>
2023-02-10 10:27:23 +01:00
..
_static doc: orange FRR theme 2019-02-18 14:39:13 +01:00
images doc: Augmented pathd documentation. 2021-10-04 18:56:47 +02:00
.gitignore doc: fix distclean 2018-05-18 19:35:24 +00:00
babeld.rst doc: Minor grammar correction 2021-12-23 07:32:33 +10:00
basic.rst vtysh: add motd command 2022-11-30 09:43:55 +05:00
bfd.rst doc: document new static BFD commands 2023-01-13 15:32:12 -03:00
bgp.rst bgpd: add as-notation keyword to 'router bgp' vty command 2023-02-10 10:27:23 +01:00
bmp.rst bmp: add L3VPN support 2022-07-13 17:28:37 +02:00
bugs.rst doc: fix dupe bug-reports label, index entry 2021-02-23 15:49:19 -05:00
conf.py doc: Remove language = none as that sphinx no longer needs this line 2022-10-27 15:59:57 -04:00
eigrpd.rst doc: remove redundant index directives 2021-05-18 15:29:59 +03:00
evpn.rst doc: add documentation for show vrf vni 2023-01-13 13:49:21 -08:00
extlog.rst doc: add new RFC5424 & journald logging targets 2022-01-17 00:39:00 +01:00
fabricd.rst *: remove *.conf.sample files 2021-04-09 13:14:30 -04:00
filter.rst lib: add "json" option to "show ip[v6] prefix-list" 2021-08-02 17:19:45 -03:00
flowspec.rst doc: remove 'no' form of commands 2021-02-22 14:38:21 -05:00
frr-reload.rst doc: add docs for frr-reload.py options 2020-05-26 19:14:12 +02:00
glossary.rst doc: fixup glossary for html build 2018-02-02 15:24:57 -05:00
grpc.rst doc: initial documentation for gRPC 2020-08-10 16:39:06 -03:00
index.rst doc: add FRR/Linux configuration examples for EVPN 2022-12-08 14:34:20 -05:00
installation.rst vtysh: Schedule shell access for deprecation 2023-02-01 10:29:02 -05:00
ipv6.rst doc: add doc for show ipv6 nd ra-interfaces 2021-06-08 15:17:22 -04:00
isisd.rst isisd: Add expected behavior with set-overload-bit 2022-10-12 10:52:27 -07:00
kernel.rst doc: remove obsolete Netlink discussion, fix svi cmd doc 2021-04-30 18:10:56 -05:00
ldpd.rst doc: document ldpd's "ttl-security" commands 2022-06-15 14:12:35 -03:00
Makefile build: non-recursive doc + parallel sphinx 2018-08-30 08:06:44 +02:00
nexthop_groups.rst doc: Add nexthop_groups documentation 2022-11-04 13:34:27 -04:00
nhrpd.rst doc: remove redundant index directives 2021-05-18 15:29:59 +03:00
ospf6d.rst doc: Fix spelling mistakes 2022-02-14 12:51:22 -05:00
ospf_fundamentals.rst doc: replace "passive-interface IFNAME" with "ip ospf passive" 2021-06-05 18:25:01 +03:00
ospfd.rst Revert "doc: Add documentation for BGP ORR support" 2023-01-17 18:15:50 +02:00
overview.rst doc: Update supported BGP RFC list 2022-09-25 11:58:10 +03:00
packet-dumps.rst doc: reorganize into multiple toctrees 2018-06-08 07:54:25 +00:00
pathd.rst pathd: add 'debug pathd policy' command 2022-11-14 17:42:44 +01:00
pbr.rst doc: Add nexthop_groups documentation 2022-11-04 13:34:27 -04:00
pim.rst pim6d: Update BSM cli/show/debug commands in pimv6.rst 2022-10-20 01:07:48 -07:00
pimv6.rst pim6d: Update BSM cli/show/debug commands in pimv6.rst 2022-10-20 01:07:48 -07:00
ripd.rst doc/user/ripd: clarify unicast behaviour 2022-08-05 17:11:43 +10:00
ripngd.rst doc: Fix the rip and ripng distribute-list ... commands 2021-05-04 16:23:37 -04:00
routemap.rst doc: Add documentation for AIGP 2022-10-26 11:26:56 +03:00
routeserver.rst doc: replace the import/export keywords for in/out 2022-06-14 15:39:48 +02:00
rpki.rst bgpd: Handle Origin Validation State extended community via route-map match 2022-09-04 21:54:47 +03:00
scripting.rst *: Fix spelling of overriden 2022-04-19 08:27:02 -04:00
setup.rst doc: Adding a description for a new option 2022-11-23 10:19:33 +01:00
sharp.rst doc: add docs for End.DT46 seg6local route 2022-10-18 16:08:24 +02:00
snmp.rst doc: Add an example of how to query SNMP for BGP 2022-12-22 18:25:50 +02:00
snmptrap.rst bgpd: Adjust symbolic names for cease notifications according to rfc4486 2022-01-06 10:07:41 +02:00
static.rst doc: Add missing static route options and clarify usage 2021-10-12 17:28:11 +02:00
subdir.am build: add doc files missing from dist tarball 2023-01-06 17:07:47 +01:00
Useful_Sysctl_Settings.md doc: update VRF support description 2021-05-31 22:12:55 +03:00
vnc.rst doc: remove 'no' form of commands 2021-02-22 14:38:21 -05:00
vrrp.rst doc: add vrrp interoperability help and command 2022-11-29 03:59:23 +08:00
vtysh.rst doc: Align docs to recommend integrated config 2022-09-23 15:16:40 -04:00
watchfrr.rst doc: remove 'no' form of commands 2021-02-22 14:38:21 -05:00
wecmp_linkbw.rst doc: automatically generate index entries for cli 2021-02-22 14:38:21 -05:00
zebra.rst doc: add documentation for show ip nht route-map 2022-12-16 08:42:53 -08:00