BGP Show Commands

BGP routing table entry for 80.80.80.0/24
Paths: (1 available, no best path)
Not advertised to any peer
300
15.15.15.1 (inaccessible) from 11.11.11.2 (15.15.15.2)
Origin incomplete, metric 0, localpref 100, valid, internal
rx path_id: 0 tx path_id: -1
Last update: Wed May 11 15:22:36 2016

Table 7-7 explains the output fields.

Table 7-7: show ip bgp output details
Field	Description
Paths	The paths listed in the routing table, along with path information, and whether the path are being advertised.
Metric	If shown, the value of the inter-autonomous system metric.
LocalPref	Local preference value as set with the set local-preference route-map configuration command.
rx path_id	Autonomous system receive path to the source network. There can be one entry in this field for each autonomous system in the path.
tx path_id	Autonomous system transmit path to the destination network. There can be one entry in this field for each autonomous system in the path.
Last update	Last time since the neighbor transitioned to or from the established state.

show bgp A.B.C.D/M

Use this command to display BGP route information for a network prefix.

Command Syntax

show bgp ipv4 (unicast|multicast) A.B.C.D/M

show ip bgp A.B.C.D/M

show ip bgp ipv4 (unicast|multicast) A.B.C.D/M

show ip bgp A.B.C.D/M (vrf (VRFNAME|all|default))

show ip bgp A.B.C.D/M longer-prefixes

show ip bgp ipv4 (unicast|multicast) A.B.C.D/M longer-prefixes

show ip bgp A.B.C.D/M longer-prefixes (vrf (VRFNAME|all|default))

Parameters

ipv4

IPv4 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

A.B.C.D/M

IP prefix (network/length), for example, 35.0.0.0/8

longer-prefixes

Display route and more specific routes

VRFNAME

VPN routing/forwarding instance name

all

All VRFs

default

Default VRF

Command Mode

Privileged Exec and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Examples

#show bgp ipv4 unicast 22.22.22.22/32

BGP routing table entry for 22.22.22.22/32

Paths: (2 available, best #1, table Default-IP-Routing)

Not advertised to any peer

Local

11.11.11.2 from 11.11.11.2 (2.2.2.2)

Origin IGP, metric 0, localpref 100, valid, internal, best

Last update: Fri Feb 16 09:46:54 2001

Local

11.11.12.2 from 11.11.12.2 (2.2.2.2)

Origin IGP, metric 0, localpref 100, valid, internal

Last update: Fri Feb 16 09:46:52 2001

show bgp client

Use this command to display BGP client information.

Command Syntax

show bgp client

Parameters

None

Command Mode

Privileged Exec and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Examples

R1#sh bgp client

BGP client ID: 11

PIM, socket 10

Service: AS number service, Route Service

Messsage received 1, sent 1

Connection time: Tue May 14 03:11:01 2019

Last message read: Service Request

Last message write: Service Reply

R1#

show bgp community

Use this command to display BGP routes that match a community.

Command Syntax

show bgp ip (unicast|multicast) community

show bgp ip (unicast|multicast) community (vrf (VRFNAME|all|default))

show ip bgp community

show ip bgp community (vrf (VRFNAME|all|default))

show ip bgp community-list WORD (exact-match|) (vrf (VRFNAME|all|default))

show ip bgp ipv4 (unicast|multicast) community

show ip bgp ipv4 (unicast|multicast) community (vrf (VRFNAME|all|default))

Parameters

ipv4

IPv4 routes

ipv6

IPv6 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

VRFNAME

VPN routing/forwarding instance name

all

All VRFs

default

Default VRF

AA:NN

Community number

local-AS

Do not send outside local AS (well-known community)

no-advertise

Do not advertise to any peer (well-known community)

no-export

Do not export to next AS (well-known community)

internet

Internet community (well-known community)

exact-match

Exact match of the communities

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show bgp community

BGP table version is 1, local router ID is 102.67.98.95

Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,

l - labeled, S Stale

Origin codes: i - IGP, e - EGP, ? - incomplete

Network Next H Metric LocPrf Weight Path

*> 2001:43f8:bb1::/64 :: 0 100 32768 ?

Total number of prefixes 1

show bgp community-list

Use this command to display BGP routes that match a community list.

Command Syntax

show bgp community-list WORD (exact-match|)

show bgp ip (unicast|multicast) community-list WORD (exact-match|)

show bgp (ipv4|ipv6) (unicast|multicast) community-list WORD (exact-match|)

show bgp (ipv6) community-list WORD (exact-match|)

show ip bgp community-list WORD (exact-match|)

show ip bgp ipv4 (unicast|multicast) community-list WORD (exact-match|)

Parameters

WORD

Community list name

ipv4

IPv4 routes

ipv6

IPv6 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

exact-match

Only routes that exactly match the community

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show bgp community-list Originate

Named Community expanded list Originate

permit 37721:1[0-2]0[05]$

permit 37721:1[0-2]0[05]

show bgp dampening dampened-paths

Use this command to display detailed information about paths suppressed due to dampening.

Command Syntax

show bgp dampening dampened-paths

show bgp (ipv4|ipv6) (unicast|multicast) dampening dampened-paths

show bgp (ipv6) dampening dampened-paths

show ip bgp dampening dampened-paths

show ip bgp dampening dampened-paths (vrf (VRFNAME|all|default))

show ip bgp ipv4 (unicast|multicast) dampening dampened-paths

Parameters

ipv4

IPv4 routes

ipv6

IPv6 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

VRFNAME

VPN routing/forwarding instance name

all

All VRFs

default

Default VRF

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show ip bgp dampening dampened-paths

BGP table version is 32, local router ID is 3.3.3.3

Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,l - labeled, S Stale

Origin codes: i - IGP, e - EGP, ? - incomplete

Network From Reuse Path

d 11.11.11.0/24 90.90.90.1 00:27:20 200 i

Table 7-8 shows the status codes displayed at the start of a route entry.

Table 7-8: Status details
Status Code	Description	Comments
s	suppressed	Whether the route is suppressed and is not advertised to neighbors.
d	damped	When the penalty of a flapping route exceeds the suppress limit, the route is damped and remains in a withdrawn state until its penalty decreases below the reuse limit.
h	history	When the penalty of a flapping route does not exceed the suppress limit, the route is not damped and BGP maintains a history of the flapping route.
p	stale	When the BGP neighbor from which a route is learned is in graceful restart, the route is retained in the BGP routing table, but marked as stale.
*	valid	Whether the route is valid. When a route is not suppressed, damped, or present in the history, it is valid.
>	best	The selected route to be installed in the kernel routing table.
i	internal	The prefix was learned from an iBGP peer.

Table 7-9 shows the codes at the end of each route entry that indicate where the route originated.

Table 7-9: origin details
Origin Code	Description	Comments
i	IGP	The route is from an Interior Gateway Protocol.
e	EGP	The route is from an Exterior Gateway Protocol.
?	incomplete	Origin not known. Typically, these are routes redistributed from an IGP.

Table 7-10 explains the output fields.

Table 7-10: show bgp dampening dampened-paths output details
Field	Description
Network	Internet address of a network.
From	IP address of the advertising peer.
Reuse	The amount of time remaining until this route will be un-suppressed and can be used again.
Path	Autonomous system path to the destination network.

show bgp dampening flap-statistics

Use this command to display BGP dampening flap statistics.

Command Syntax

show bgp dampening flap-statistics

show bgp (ipv4|ipv6) (unicast|multicast) dampening flap-statistics

show bgp (ipv6) dampening flap-statistics

show ip bgp dampening flap-statistics

show ip bgp dampening flap-statistics (vrf (VRFNAME|all|default))

show ip bgp ipv4 (unicast|multicast) dampening flap-statistics

Parameters

ipv4

IPv4 routes

ipv6

IPv6 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

VRFNAME

VPN routing/forwarding instance name

all

All VRFs

default

Default VRF

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Examples

This sample output shows that the internal route (i), has flapped 3 times and is now categorized as history (h).

#show ip bgp dampening flap-statistics

BGP table version is 1, local router ID is 30.30.30.77

Status codes: s suppressed, d damped, h history, * valid, > best, i - internal, S Stale

Origin codes: i - IGP, e - EGP, ? - incomplete

Network From Flaps Duration Reuse Path

hi1.1.1.0/24 10.100.0.62 3 00:01:20 i

Table 7-11 shows the status codes displayed at the start of a route entry.

Table 7-11: status details
Status Code	Description	Comments
s	suppressed	Whether the route is suppressed and is not advertised to neighbors.
d	damped	When the penalty of a flapping route exceeds the suppress limit, the route is damped and remains in a withdrawn state until its penalty decreases below the reuse limit.
h	history	When the penalty of a flapping route does not exceed the suppress limit, the route is not damped and BGP maintains a history of the flapping route.
p	stale	When the BGP neighbor from which a route is learned is in graceful restart, the route is retained in the BGP routing table, but marked as stale.
*	valid	Whether the route is valid. When a route is not suppressed, damped, or present in the history, it is valid.
>	best	The selected route to be installed in the kernel routing table.
i	internal	The prefix was learned from an iBGP peer.

Table 7-12 shows the codes at the end of each route entry that indicate where the route originated.

Table 7-12: origin details
Origin Code	Description	Comments
i	IGP	The route is from an Interior Gateway Protocol.
e	EGP	The route is from an Exterior Gateway Protocol.
?	incomplete	Origin not known. Typically, these are routes redistributed from an IGP.

Table 7-13 explains the output fields.

Table 7-13: show bgp dampening flap-statistics output details
Field	Description
Network	Internet address of a network.
From	IP address of the advertising peer.
Flaps	Number of times this route has failed and returned (flapped).
Duration	Elapsed time since the first penalty points were assessed.
Reuse	The amount of time remaining until this route will be un-suppressed and can be used again.
Path	Autonomous system path to the destination network.

show bgp dampening parameters

Use this command to display the BGP dampening parameters.

Command Syntax

show bgp dampening parameters

show bgp (ipv4|ipv6) (unicast|multicast) dampening parameters

show bgp (ipv6) dampening parameters

show ip bgp dampening parameters

show ip bgp ipv4 (unicast|multicast) dampening parameters (vrf (VRFNAME|all|default))

show ip bgp dampening parameters (vrf (VRFNAME|all|default))

Parameters

ipv4

IPv4 routes

ipv6

IPv6 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

VRFNAME

VPN routing/forwarding instance name

all

All VRFs

default

Default VRF

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Examples

#show ip bgp dampening parameters

dampening 5 750 2000 60 15

Dampening Control Block(s):

Reachability Half-Life time : 5 min

Reuse penalty : 750

Suppress penalty : 2000

Max suppress time : 60 min

Un-reachability Half-Life time : 15 min

Max penalty (ceil) : 11999

Min penalty (floor) : 375

Table 7-14 explains the output fields.

Table 7-14: show ip bgp dampening parameters output details
Field	Description
Dampening Control Block(s)	Flap damping reduces the number of update messages by marking routes as ineligible for selection as the active or preferable route.
Reachability Half-Life time	Number of minutes after which an arbitrary value is halved if a route stays stable.
Reuse penalty	Reuse threshold—Arbitrary value below which a suppressed route can be used again.
Suppress penalty	Cutoff (suppression) threshold—Arbitrary value above which a route can no longer be used or included in advertisements.
Max suppress time	Maximum hold-down time for a route, in minutes.
Un-reachability Half-Life time	Number of minutes after which an arbitrary value is not halved if a route stays stable.
Max penalty (ceil)	Maximum penalty corresponds to the time it would take max-suppress to decay and reach the reuse level (ceil).
Min penalty (floor)	Maximum penalty corresponds to the time it would take max-suppress to decay and reach the reuse level (floor).

show bgp filter-list

Use this command to display routes that match a regular expression filter list.

Command Syntax

show bgp filter-list WORD

show bgp (ipv4|ipv6) (unicast|multicast) filter-list WORD

show bgp (ipv6) filter-list WORD

show ip bgp filter-list WORD

show ip bgp ipv4 (unicast|multicast) filter-list WORD

show ip bgp filter-list WORD (exact-match)

show ip bgp filter-list WORD (exact-match) (vrf (VRFNAME|all|default))

show ip bgp filter-list WORD (vrf (VRFNAME|all|default))

show ip bgp ipv4 (unicast|multicast) filter-list WORD (exact-match)(vrf (VRFNAME|all|default))

Parameters

WORD

Regular-expression filter list

ipv4

IPv4 routes

ipv6

IPv6 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

exact-match

Exact match of the filter list

VRFNAME

VPN routing/forwarding instance name

all

All VRFs

default

Default VRF

vrf

VPN Routing/Forwarding instance name

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show bgp filter-list bgp-local-only

BGP table version is 1, local router ID is 102.67.98.95

Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,

l - labeled, S Stale

Origin codes: i - IGP, e - EGP, ? - incomplete

Network Next Hop Metric LocPrf Weight Path

*> 2001:43f8:bb1::/6 :: 0 100 32768 ?

Total number of prefixes 1

show bgp inconsistent-as

Use this command to display routes with inconsistent AS paths.

Command Syntax

show bgp inconsistent-as

show bgp (ipv4|ipv6) (unicast|multicast) inconsistent-as

show bgp (ipv6) inconsistent-as

show ip bgp inconsistent-as

show ip bgp ipv4 inconsistent-as

show ip bgp ipv4 (unicast|multicast) inconsistent-as

Parameters

ipv4

IPv4 routes

ipv6

IPv6 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Examples

#show bgp inconsistent-as

BGP table version is 3, local router ID is 2.2.2.2

Status codes: s suppressed, d damped, h history, * valid, > best, i - internal

Origin codes: i - IGP, e - EGP, ? - incomplete

Network Next Hop Metric LocPrf Weight Path

*> 10.1.0.0 172.29.232.55 0 0 100 ?

show bgp ipv6

Use this command to display the BGP routing table.

Command Syntax

show bgp ipv6 (unicast|multicast|labeled|)

show bgp ipv6 (unicast|multicast|labeled|) X:X::X:X/M

Parameters

multicast

IPv6 multicast address prefixes

unicast

IPv6 unicast address prefixes

labeled

Labeled IPv6 routes

X:X::X:X/M

IPv6 prefix network/length, such as 3ffe:a::/64

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example: iBGP and eBGP Routes

This example shows routes learned from both iBGP and eBGP.

#show bgp ipv6

BGP table version is 0, local router ID is 10.100.0.77

Status codes: s suppressed, d damped, h history, * valid, > best, i - internal S stale,

Origin codes: i - IGP, e - EGP, ? - incomplete

Network Metric LocPrf Weight Path

*> 2001:58::/32 0 20 ?

fe80::202:b3ff:fec8:9fdb

*> 2002:58::/32 0 20 i

fe80::202:b3ff:fec8:9fdb

*>i2003:58::/32 100 0 i

fe80::208:a1ff:fe16:797d

Header

BGP table version is 0, local router ID is 10.100.0.77

• BGP table version

• BGP router ID is 10.100.0.77

Status codes: s suppressed, d damped, h history, p stale, * valid, > best, i - internal

Table 7-15 shows the status codes displayed at the start of a route entry.

Table 7-15: status details
Status Code	Description	Comments
s	suppressed	Whether the route is suppressed and is not advertised to neighbors.
d	damped	When the penalty of a flapping route exceeds the suppress limit, the route is damped and remains in a withdrawn state until its penalty decreases below the reuse limit.
h	history	When the penalty of a flapping route does not exceed the suppress limit, the route is not damped and BGP maintains a history of the flapping route.
p	stale	When the BGP neighbor from which a route is learned is in graceful restart, the route is retained in the BGP routing table, but marked as stale.
*	valid	Whether the route is valid. When a route is not suppressed, damped, or present in the history, it is valid.
>	best	The selected route to be installed in the kernel routing table.
i	internal	The prefix was learned from an iBGP peer.

Origin codes: i - IGP, e - EGP, ? - incomplete

Table 7-16 shows the codes at the end of each route entry that indicate where the route originated.

Table 7-16: origin codes
Origin Code	Description	Comments
i	IGP	The route is from an Interior Gateway Protocol.
e	EGP	The route is from an Exterior Gateway Protocol.
?	incomplete	Origin not known. Typically, these are routes redistributed from an IGP.

Route Entry Examples

*> 2002:58::/32 fe80::202:b3ff:fec8:9fdb 0 20 i

• This route entry shows that this route is learned from eBGP.

• The origin code “i” means that the prefix is added by the network statement at originating AS.

• The path 20 indicates that the prefix advertisement originated from AS20.

• The administrative weight parameter applies only to routes within an individual router.

• Since this route was learned from a peer, it has a default weight of 0. All routes generated by the local router have a weight of 32,768.

*> 2001:58::/32 fe80::202:b3ff:fec8:9fdb 0 20 ?

• This route entry shows that the prefix is learnt from eBGP.The origin code i indicates that the prefix is added by network statement at originating AS.The path attribute 20 indicates that the route advertisement originated from AS20.The administrative weight parameter applies only to routes within an individual router. Since this route was learned from a peer, it has a default weight of 0. All routes generated by the local router have a weight of 32,768.The origin code “?” means the route was learned through redistribution.

*>i2003:58::/32 fe80::208:a1ff:fe16:797d 100 0 i

• The status code “i” means that the route was learned through iBGP. The Local Preference attribute of the route, which is used only with the local AS, is set to 100 (the default value).

Example: IPv6 Prefix Routes

This example shows labeled routes for a given IPv6 prefix:

#show bgp ipv6 labeled 3ffe:a::/64

BGP routing table entry for 3ffe:a::/64

Paths: (1 available, best #1, table Default-IP-Routing-Table)

Not advertised to any peer

Local

::ffff:114:1414 from 20.20.20.1 (92.92.92.92)

Origin incomplete metric 0, localpref 100, label 5420,

valid, internal, best

Last update: Mon May 26 17:48:18 2008

Table 7-17 explains the output fields.

Table 7-17: show bgp ipv6 output details
Field	Description
Paths	The paths listed in the routing table, along with path information, and whether the path are being advertised.
Metric	If shown, the value of the inter-autonomous system metric.
LocalPref	Local preference value as set with the set local-preference route-map configuration command.
rx path_id	Autonomous system receive path to the source network. There can be one entry in this field for each autonomous system in the path.
tx path_id	Autonomous system transmit path to the destination network. There can be one entry in this field for each autonomous system in the path.
Last update	Last time since the neighbor transitioned to or from the established state.

show bgp ipv6 peer-group

Use this command to list the BGP peer group information in ipv6 unicast.

Command Syntax

show bgp ipv6 peer-group (WORD|)

Parameters

WORD

Name of the peer group

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced in OcNOS version 4.2.

Example

#show bgp ipv6 peer-group p2

BGP dynamic peer-group is p2, IBGP, remote AS 42949672

BGP dynamic peer-group p2 listen range group members:

5ffe:3::/64

BGP version 4

Minimum time between advertisement runs is 5 seconds

For address family: IPv6 Unicast

Peer-group member:

*5ffe:3::1

Index 2, Offset 0, Mask 0x4

0 accepted prefixes, 0 announced prefixes

show bgp l2vpn vpls

Command Syntax

show bgp l2vpn vpls (rr|) (detail|)

Parameters

Display the information of auto-discovered peers at Route reflector node.

detail

Display the detailed information of auto-discovered peers.

Command Mode

Exec and Privileged Exec Modes

Applicability

This command was introduced in version OcNOS version 1.3.

Example

#show bgp l2vpn vpls

VPLS-ID VE-ID Discovered-Peers Route-Target

10 3 1 10:100

#show bgp l2vpn vpls detail

VPLS ID: 10

VE-ID: 3

Discovered Peers: 1

Route-Target: 10:100

Local RD: 10:100

Mesh Peers:

Address:3.3.3.3, RD:10:100, VE-ID:4

VC Details: VC-ID:34

Remote (LB:52480,VBO:1,VBS:64) Local (LB:52480,VBO:1,VBS:64)

LB sent on known VEID:Yes

In Label:52483, Out Label:52482

PW Status:Established

Table 7-18 explains the output fields.

Table 7-18: show bgp l2vpn vpls output details
Field	Description
VPLS-ID	L2VPN address family database information for the Virtual Private LAN Service (VPLS).
VE-ID	L2VPN address family database information for the Virtual Expansion.
Discovered Peers	Peer discovery is used to find peers that are available for data using LLDP.
Route-Target	An identifier prepended to IP addresses to assure the uniqueness of the address.
Local RD	The Local Route Descriptor – the first two numbers of the Route-Target.
Mesh Peers	Internal BGP peers – devices that do not re-advertise routes to other IBGP devices.
Address	Mesh session information for the peer specified with the ip-address argument.
RD	Mesh peer’s Route-Descriptor.
VC Details	The virtual circuit session information with the ip-address for the Provider Edge (PE) routers.
Remote	LB (Label Base) – the first label value of a free set of labels that can be reserved by the PE router to be used for this VPLS domain. VBO (VE Block Offset) – the offset value to be used when multiple label blocks must be created by a PE router. VBS (VE Block Size) – the size of the label block.
Local	LB (Label Base) – the first label value of a free set of labels that can be reserved by the PE router to be used for this VPLS domain. VBO (VE Block Offset) – the offset value to be used when multiple label blocks must be created by a PE router. VBS (VE Block Size) – the size of the label block.
LB sent on known VEID	Whether the Label Base came on a known Virtual Expansion Identifier – yes or no.
In Label	The ingress (incoming interface) label for this segment.
Out Label	Label received from downstream neighbor for route.
PW Status	The status of the VPLS Pseudo-Wire. Values can be: Idle, Active, Open, or Established.

#show bgp l2vpn vpls rr

RD RR-Clients Non-Clients Route-Target

10:100 2 0 10:100

#show bgp l2vpn vpls rr detail

Route-Target: 10:100

Peer:1.1.1.1

RR Client : Yes

VE-ID:3 LB:52480 VBO:1 VBS:64

Route-Target: 10:100

Peer:3.3.3.3

RR Client : Yes

VE-ID:4 LB:52480 VBO:1 VBS:64

Table 7-19 explains the output fields.

Table 7-19: show bgp l2vpn vpls rr output details
Field	Description
Route-Target	An identifier prepended to IP addresses to assure the uniqueness of the address.
Peer	Internal BGP peers – devices that do not re-advertise routes to other IBGP devices.
RR Client	Device is a client of the Route Reflector – yes or no.
VE-ID	L2VPN address family database information for the Virtual Expansion.
LB	LB (Label Base) – the first label value of a free set of labels that can be reserved by the PE router to be used for this VPLS domain.
VBO	VBO (VE Block Offset) – the offset value to be used when multiple label blocks must be created by a PE router.
VBS	VBS (VE Block Size) – the size of the label block.

show bgp neighbors

Use this command to display information about BGP neighbor connections.

Command Syntax

show bgp neighbors

show bgp ipv6 neighbors

show ip bgp ipv4 (unicast|multicast) neighbors

show ip bgp neighbors

show ip bgp neighbors (A.B.C.D|X:X::X:X)(advertise-routes|)

show ip bgp ipv4 (unicast|multicast) neighbors (A.B.C.D|X:X::X:X)

show ip bgp neighbors (A.B.C.D|X:X::X:X) (hold-time|keepalive-interval|connection-retrytime)

Parameters

ipv4

IPv4 neighbors

ipv6

IPv6 neighbors

unicast

Unicast prefixes

multicast

Multicast prefixes

A.B.C.D

IPv4 neighbor

X:X::X:X

IPv6 neighbor

advertised-routes

Routes advertised to a BGP neighbor

hold-time

Hold time

keepalive-interval

Keepalive interval

connection-retrytime

Connection retry time

sent-msgs

Sent packets

rcvd-msgs

Received packets

notification

Notification messages

update

Update messages

open

Open messages

keepalive

Keepalive messages

Command Mode

Privileged Exec and Exec modes

Applicability

This command was introduced before OcNOS version 1.3.

Examples

#show bgp neighbors

BGP neighbor is 2.2.2.2, remote AS 200, local AS 200, internal link

Member of peer-group myPeer for session parameters

BGP version 4, remote router ID 10.12.7.155

BGP state = Established, up for 00:04:55

Last read 00:04:55, hold time is 90, keepalive interval is 30 seconds

Neighbor capabilities:

Route refresh: advertised and received (old and new)

Address family IPv4 Unicast: advertised and received

Received 11 messages, 0 notifications, 0 in queue

Sent 11 messages, 0 notifications, 0 in queue

Route refresh request: received 0, sent 0

Minimum time between advertisement runs is 5 seconds

For address family: IPv4 IPv4

BGP table version 1, neighbor version 1

Index 1, Offset 0, Mask 0x2

myPeer peer-group member

Community attribute sent to this neighbor (both)

0 accepted prefixes

0 announced prefixes

Connections established 1; dropped 0

Local host: 2.2.2.1, Local port: 33865

Foreign host: 2.2.2.2, Foreign port: 179

Nexthop: 2.2.2.1

Nexthop global: 1111::1

Nexthop local: fe80::a00:27ff:fecc:47a6

BGP connection: non shared network

Last Reset: 00:32:48, due to BGP Notification sent

Notification Error Message: (OPEN Message Error/Bad Peer AS.)

BGP Neighbor Fields

Table 7-20 explains the output fields.

Table 7-20: show bgp neighbor output details
Field	Description
BGP neighbor	BGP session information for the neighbor with the ip-address argument.
remote AS	Remote Autonomous system used to exchange exterior routing information between neighboring ASs.
local AS	Local Autonomous system used to exchange internal routing information within AS.
internal link external link	Internal link is used to forward route advertisements received from an external BGP router through the internal network (in the same AS). External link is used for exchanging routing information between Autonomous Systems (AS) and routing traffic across the Internet (eBGP neighbor).
member of peer-group	Peer group information for the peer group specified with the peer-group argument.
BGP version	Negotiated BGP version for this session.
remote router ID	IP address of the neighbor. BGP uses the highest loopback address as the Router ID. If no loopback interface is configured, BGP uses the highest configured IP address on a system.
BGP state	Session state as explained in Table 7-25. The exchange of routing information begins between peers only after the neighbor session is in an Established state.
up for	Time that the underlying TCP connection has been up.
last read	Time since BGP last received a message from this neighbor.
hold time	Time, in seconds, that BGP will maintain the session with this neighbor without receiving messages. The maximum time that can elapse between successive messages from this neighbor is 180 seconds. If no message is received for 180 seconds, this neighbor will be declared dead.
last write	Time since BGP last sent a message to this neighbor.
keepalive interval	Time interval, in seconds, at which keepalive messages are transmitted to this neighbor. The time interval between successive keepalive messages is 60 seconds. Typically, the hold time value is set to three times the keepalive interval.
neighbor capabilities	BGP capabilities advertised and received from this neighbor. “Advertised and received” is displayed when a capability is successfully exchanged between two routers.
received	Total number of received messages. notifications: Number of notification (error) messages received. in queue: Number of messages in the input queue
sent	Total number of sent messages. notifications: Number of notification (error) messages sent. in queue: Number of messages in the output queue
route refresh request	Number of route refresh request messages sent and received.
minimum time between advertisement runs.	The minimum time gap, in seconds, between successive route updates sent to the neighbor. Generally, a jitter (of 25%) is applied to this time interval, which means that if the time between advertisements is configured as 30, successive advertisements can have a time gap of as low as 22.5 (after applying a 25% jitter to the 30 seconds, which is 7.5 seconds).
for address family	The peers have exchanged address family capability.
BGP table version	For each of the address families agreed upon, BGP maintains a separate table.
neighbor version	Tracks prefixes that have been sent and those that need to be sent.
connections established	The number of times the router has established a TCP connection and the two peers have agreed to speak BGP with each other. “Dropped” means the number of time the connection has failed or gone down.
local host foreign host	Local host is the IP address and the port number of the local system used for the peering session. Foreign host is the IP address and the port of the neighbor. BGP always uses the TCP port number 179 for the peer originating the session.
nexthop	The IP address of the next hop used to reach the neighbor. eBGP or iBGP peers do not need to be directly connected. Peering sessions can be set up across multiple hops. If the neighbors are directly connected, the IP address of the local system is listed as the next hop.
nexthop global	The global IPv6 address of the next hop
nexthop local	The link-local IPv6 address of the next hop
non shared network	The peering session is running on a non shared network.
last reset	Time since this peering session was last reset. The reason for the reset is displayed on this line.
notification error message	Last error message sent.

show bgp neighbors advertised-routes

Use this command to display the routes advertised to a BGP neighbor.

Command Syntax

show bgp neighbors (A.B.C.D|X:X::X:X) advertised-routes

show ip bgp neighbors (A.B.C.D|X:X::X:X) advertised-routes (vrf (VRFNAME|all|default))

show ip bgp neighbors (A.B.C.D|X:X::X:X) advertised-routes

show ip bgp ipv4 (unicast|multicast) neighbors (A.B.C.D|X:X::X:X) advertised-routes

Parameters

A.B.C.D

IPv4 neighbor

X:X::X:X

IPv6 neighbor

ipv4

IPv4 addresses

multicast

Multicast prefixes

unicast

Unicast prefixes

vrf

VPN Routing/Forwarding instance name

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show bgp neighbors 11.11.11.2 advertised-routes

BGP table version is 3, local router ID is 1.1.1.1

Status codes: s suppressed, d damped, h history, * valid, > best, i - internal

Origin codes: i - IGP, e - EGP, ? - incomplete

Network Next Hop Metric LocPrf Weight Path

*>i 33.33.33.33/32 11.11.11.1 0 100 32768 i

Total number of prefixes 1

show bgp neighbors received prefix-filter

Use this command to display the prefix list filter.

Command Syntax

show bgp neighbors (A.B.C.D|X:X::X:X) received prefix-filter

show ip bgp neighbors (A.B.C.D|X:X::X:X) received prefix-filter

show ip bgp ipv4 (unicast|multicast) neighbors (A.B.C.D|X:X::X:X) received prefix-filter

Parameters

A.B.C.D

IPv4 address

X:X::X:X

IPv6 address

ipv4

IPv4 addresses

unicast

Unicast prefixes

multicast

Multicast prefixes

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show bgp neighbors 100.1.1.1 received prefix-filter

Address family: IPv4 Unicast

ip prefix-list 100.1.1.1.1.1: 1 entries

seq 5 permit 1.1.1.1/32

show bgp neighbors received-routes

Use this command to view all the received routes, including all AFI/SAFI routes, from a BGP neighbour.
Executing this CLI displays the received routes from accessing:

• BGP local RIB or

• BGP ADJ_IN RIB only if the 'soft-reconfiguration inbound' feature is supported.

Command Syntax

show ip bgp neighbors (A.B.C.D|X:X::X:X) received-routes (vrf (VRFNAME|all|default)|)

show ip bgp ipv4 (unicast|multicast) neighbors (A.B.C.D|X:X::X:X) received-routes

Parameters

A.B.C.D

IPv4 address

X:X::X:X

IPv6 address

ipv4

IPv4 addresses

unicast

Unicast prefixes

multicast

Multicast prefixes

VRFNAME

VPN Routing/Forwarding instance name

all

All VRFs

deault

Default VRF (Global routing)

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3. and updated in OcNOS version 6.3.1.

Example

DUT3 show bgp neighbors 77.242.226.32 received-routes

% Inbound soft reconfiguration is not supported, displaying the received routes from accessing BGP local RIB

For address family: IPv4 Unicast

BGP table version is 610, local router ID is 14.14.14.14

Status codes: s suppressed, d damped, h history, a add-path, * valid, > best, i - internal,

l - labeled, S Stale

Origin codes: i - IGP, e - EGP, ? - incomplete

Network Next Hop Metric LocPrf Weight Path

* i 20.20.20.0/24 77.242.226.32 0 100 0 ?

*>i 77.242.226.32/32 77.242.226.32 0 100 0 ?

*>i 200.10.1.0 77.242.226.32 0 100 0 ?

Total number of prefixes 3

For address family: VPNv4 Unicast

Status codes: s suppressed, d damped, h history, a add-path, * valid, > best, i - internal, l - labeled

S Stale

Origin codes: i - IGP, e - EGP, ? - incomplete

Network Next Hop Metric LocPrf Weight Path

Route Distinguisher: 77.242.226.32:100

*>i 200.10.1.0 77.242.226.32 0 100 0 ?

Accepted routes count = 1

Route Distinguisher: 65535:22

*>i 10.50.100.160/30 10.10.40.133 0 100 0 ?

*>i 10.202.167.0/24 10.10.40.133 0 100 0 ?

Accepted routes count = 2

DUT#

DUT#sh bgp neighbors 10.10.40.133 received-routes | begin VPNv4

...skipping

For address family: VPNv4 Unicast

Status codes: s suppressed, d damped, h history, a add-path, * valid, > best, i - internal, l - labeled

S Stale

Origin codes: i - IGP, e - EGP, ? - incomplete

Network Next Hop Metric LocPrf Weight Path

Route Distinguisher: 65535:22

*>i 10.50.100.160/30 10.10.40.133 0 100 0 ?

*>i 10.202.167.0/24 10.10.40.133 0 100 0 ?

Accepted routes count = 2

To view the received-routes of particular address-family, use below filter.

“sh bgp neighbors 10.10.40.133 received-routes | begin LINE”

LINE can be of { IPv4 Unicast or

IPv4 Labeled-Unicast or

VPNv4 Unicast or

IPv6 Unicast or

6PE Labeled Unicast or

VPNv6 Unicast

}

show bgp neighbors routes

Use this command to display all accepted routes learned from neighbors.

Command Syntax

show bgp neighbors (A.B.C.D|X:X::X:X) routes

show ip bgp neighbors (A.B.C.D|X:X::X:X) routes

show ip bgp ipv4 (unicast|multicast) neighbors (A.B.C.D|X:X::X:X) routes

Parameters

A.B.C.D

IPv4 address

X:X::X:X

IPv6 address

ipv4

IPv4 addresses

unicast

Unicast prefixes

multicast

Multicast prefixes

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

The following output displays detailed information about the neighbor.

#show bgp neighbors 10.10.10.2 routes

BGP neighbor is fe80::203:47ff:feb0:d72b, remote AS 10, local AS 10, internal link

BGP version 4, remote router ID 10.10.10.50

BGP state = Established, up for 00:02:01

Last read 00:00:01, hold time is 180, keepalive interval is 60 seconds

Neighbor capabilities:

Route refresh: advertised and received (old and new)

Address family IPv4 Unicast: advertised and received

Address family IPv6 Unicast: advertised and received

Received 3 messages, 0 notifications, 0 in queue

Sent 5 messages, 0 notifications, 0 in queue

Route refresh request: received 0, sent 0

Minimum time between advertisement runs is 5 seconds

For address family: IPv4 Unicast

Community attribute sent to this neighbor (both)

0 accepted prefixes

0 announced prefixes

Table 7-21 explains the output fields.

Table 7-21: show bgp neighbors routes output details
Field	Description
BGP neighbor	Neighbor identifier along with the local and remote Autonomous System numbers.
BGP version	The version of BGP being used by the neighbor device, along with the remote router ID number.
BGP state	The current state of the neighbor connection and length of time within the current state. Possible states are: Idle, Connect, Active, and Established.
Last read	The amount of time in Hours: Minutes: Seconds since this device last checked the Hold Time parameters.
hold time	The amount of time this device waits for a Keepalive or Update message before the BGP connection is closed.
Keepalive interval	KEEPALIVE messages are sent periodically to ensure that the connection is live.
Neighbor capabilities	New or optional parameters called “Capabilities.” Provides a graceful way to advertise new or unique options without causing peering to terminate. The capabilities are communicated in TLV fields. (see RFC 3392). In the example output above, the following capabilities were advertised by the neighbor and were received and understood by this device: 1. Route refresh 2. Address family IPv4 Unicast 3. Address family IPv6 Unicast
Route refresh	This helps to identify that and synchronize the peers without a hard reset.
For address family	Address Family Identifier (AFI) IPv4 Unicast.
Received messages	Information received from the neighbors.
notifications	Passes information to a router about sessions.
in que	Number of messages currently residing in the queue awaiting action.
Route refresh request	Information received and sent.
Minimum time between advertisement runs	Interval between exchange of messages.
For address family: IPv4 Unicast	The following three values are subordinate to the IPv4 Unicast Address Family.
Community attributes sent to this neighbor	Both the standard and the extended community information has been sent to the neighbor.
accepted prefixes	Configure a limit to the number of prefixes that can be accepted in a BGP peer session.
announced prefixes	A prefix announced in BGP consists of the IPV4 or IPV6 address block being announced.

show bgp nexthop-tracking

Use this command to display BGP nexthop-tracking status.

Command Syntax

show bgp nexthop-tracking

Parameters

None

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show bgp nexthop-tracking

Configured NHT: ENABLED

NHT Delay time-interval : 6

BGP VRF: (Default) VRF_ID 0

BGP Instance: (Default), AS: 100, router-id 4.4.4.40

NHT is Enabled

Recvd Msg count from RIB: 0

NHT delay-timer remaining seconds: 0

BGP nexthop(s):

Total number of IPV4 nexthops : 0

Total number of IPV6 nexthops : 0

BGP VRF: VRF_A VRF_ID 2

BGP Instance: (Default), AS: 100, router-id 4.4.4.40

NHT is Enabled

Recvd Msg count from RIB: 0

NHT delay-timer remaining seconds: 0

BGP nexthop(s):

Total number of IPV4 nexthops : 0

Total number of IPV6 nexthops : 0

Table 7-22 explains the output fields.

Table 7-22: show bgp nexthop-tracking output details
Field	Description
Configured NHT	Whether Next Hop Tracking (NHT) is enabled or disabled.
NHT Delay time-interval	A delay timer that indicates how long this device waits before checking its RIB for changes.
BGP VRF	Name and ID number of this BGP VRF.
BGP Instance	Autonomous System number and router ID.
NHT is Enabled	NHT Network enables the measurement and comparison of performance.
Recvd Msg count from RIB	Number of received change-messages from the RIB.
NHT delay-timer remaining seconds	Time remaining until the next decision cycle.
BGP nexthop(s)	Nexthop in the BGP to reach a certain destination.
Total number of IPV4 nexthops	Number of nexthops in the IPv4 Address Family.
Total number of IPV6 nexthops	Number of nexthops in the IPv6 Address Family.

show bgp nexthop-tree-details

Use this command to display BGP nexthop-tree details.

Command Syntax

show bgp nexthop-tree-details

Parameters

None

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show bgp nexthop-tree-details

BGP Instance: (Default), AS: 65534, router-id 51.1.1.3

AFI_IP Nexthop count : 0

AFI_IP6 Nexthop count : 0

BGP Instance: (Default), AS: 0, router-id 51.1.1.3

AFI_IP Nexthop count : 0

AFI_IP6 Nexthop count : 0

Table 7-23 explains the output fields.

Table 7-23: show bgp nexthop-tree-details output details
Field	Description
Bgp Instance	The Autonomous System number and router ID.
AFI_IP Nexthop count	Nexthop count for the IPv4 Address Family
AFI_IP6 Nexthop count	Nexthop count for the IPv6 Address Family

show bgp paths

Use this command to display BGP path information.

Command Syntax

show bgp paths

show bgp (ipv6) paths

show ip bgp paths

show ip bgp ipv4 (unicast|multicast) paths

Parameters

ipv4

IPv4 routes

ipv6

IPv6 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show bgp paths

Address Refcnt Path

[0x1af8ee0:0] (21)

[0x1b3ceb0:345] (14) 64602

[0x1c71d40:821] (12008) 64602 65500

[0x1d03fb0:822] (12008) 64602 65501

Table 7-24 explains the output fields.

Table 7-24: show bgp paths output details
Field	Description
Address	Hash and hash key separated by the colon character.
Refcnt	Number of routed using that path.
Path	Autonomous System Number (ASN) for the route.

show bgp prefix-list

Use this command to display routes matching the prefix-list.

Command Syntax

show bgp prefix-list WORD

show ip bgp prefix-list WORD

show ip bgp prefix-list WORD (exact-match)

show ip bgp prefix-list WORD (exact-match) (vrf (VRFNAME|all|default))

show ip bgp ipv4 (unicast|multicast) prefix-list WORD

show ip bgp ipv4 (unicast|multicast) prefix-list WORD (exact-match)

Parameters

WORD

Name of the IP prefix list

ipv4

IPv4 routes

ipv6

IPv6 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

exact-match

Exact match of the prefix list

vrf

VPN Routing/Forwarding instance

VRFNAME

VPN routing/forwarding instance name

all

All VRFs

default

Default VRF

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show ip bgp prefix-list Route1

BGP table version is 1, local router ID is 12.0.0.1

Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,

l - labeled, S Stale

Origin codes: i - IGP, e - EGP, ? - incomplete

Network Next Hop Metric LocPrf Weight Path

*>1.1.1.1/32 0.0.0.0 0 100 32768 i

Total number of prefixes 1

show bgp quote-regexp

Use this command to display route matching an AS path quoted regular expression.

Command Syntax

show bgp quote-regexp WORD

show bgp (ipv4|ipv6) (unicast|multicast|) quote-regexp WORD

show ip bgp quote-regexp WORD

show ip bgp ipv4 (unicast|multicast) quote-regexp WORD

Parameters

WORD

A regular expression to match the AS paths. Use quotes to enclose the regular expression.

ipv4

IPv4 route information

ipv6

IPv6 route information

unicast

Unicast prefixes

multicast

Multicast prefixes

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show bgp quote-regexp ^$

BGP table version is 1, local router ID is 102.67.98.95

Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,

l - labeled, S Stale

Origin codes: i - IGP, e - EGP, ? - incomplete

Network Next Hop Metric LocPrf Weight Path

*> 2001:43f8:bb1::/64 : 0 100 32768 ?

Total number of prefixes 1

show bgp regexp

Use this command to display routes matching the AS path regular expression.

Command Syntax

show bgp regexp LINE

show bgp (ipv4|ipv6) (unicast|multicast) regexp LINE

show bgp (ipv6) regexp LINE

show ip bgp regexp LINE

show ip bgp vrf (VRFNAME|all|default) regexp LINE

show ip bgp ipv4 (unicast|multicast) regexp LINE

Parameters

ipv4

IPv4 routes

ipv6

IPv6 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

LINE

A regular expression to match the AS paths

VRFNAME

VPN routing/forwarding instance name

all

All VRFs

default

Default VRF

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show bgp regexp ^$

BGP table version is 1, local router ID is 102.67.98.95

Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,

l - labeled, S Stale

Origin codes: i - IGP, e - EGP, ? - incomplete

Network Next Hop Metric LocPrf Weight Path

*> 2001:43f8:bb1::/64 :: 0 100 32768 ?

Total number of prefixes 1

show bgp route-map

Use this command to display routes that match the specified route map.

Command Syntax

show bgp route-map WORD

show bgp (ipv4|ipv6) (unicast|multicast) route-map WORD

show bgp (ipv6) route-map WORD

show ip bgp route-map WORD

show ip bgp route-map WORD (vrf (VRFNAME|all|default))

show ip bgp ipv4 (unicast|multicast) route-map WORD

Parameters

WORD

Routes matching the route-map

ipv4

IPv4 routes

ipv6

IPv6 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

vrf

VPN routing/forwarding instance

VRFNAME

VPN routing/forwarding instance name

all

All VRFs

default

Default VRF

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show ip bgp prefix-list Route1

BGP table version is 1, local router ID is 12.0.0.1

Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,

l - labeled, S Stale

Origin codes: i - IGP, e - EGP, ? - incomplete

Network Next Hop Metric LocPrf Weight Path

*>1.1.1.1/32 0.0.0.0 0 100 32768 i

show bgp statistics

Use this command to display BGP statistics.

Command Syntax

show bgp statistics

Parameters

None

Command Mode

Privileged Exec and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Examples

#show bgp statistics

=============================================================

BGP VRF default statistics

=============================================================

Neighbor aggregated statistics (sent/received)

Msgs Bytes Opens Updates

16/17 394/0 1/2 0/0

Keepalives Notifications Route-refresh Capabilities

15/15 0/0 0/0 0/0

BGP I/O Information

Active Open attempts : 0

Passive Open attempts : 0

BGP I/O Open loops : 0

BGP I/O Open calls : 0

BGP I/O Open recv calls : 0

BGP I/O Send calls : 0

BGP I/O Recv calls : 0

BGP I/O Write calls : 0

BGP I/O Write loops : 0

BGP I/O Write loop yields : 0

BGP I/O Read calls : 0

BGP I/O Read loops : 0

BGP I/O Read loop yields : 0

BGP I/O process nlri yields : 0

BGP I/O process withdraw yields : 0

BGP Read time exceeded : 0

BGP Update send pending : 0

BGP Update buffer not available : 0

BGP Update walk suspended : 0

BGP Yielded in updates : 0

BGP Yielded in packing : 0

BGP No sendbuf for peer : 0

BGP No withdraw buf for peer : 0

BGP Yields in update peer loop : 0

No updates pending or no buffers: 0

No data to write : 0

Msg queue recv errors : 0

Sockets create/accept/close : 2/1/2

Sockets create retries/failures : 1/0

Socket fd-close session : 0

MemPool - Advertise : | Total (0/0) blk_size:64

MemPool - AdjOut : | Total (0/0) blk_size:12

MemPool - Advertise Attr : | Total (0/0) blk_size:24

MemPool - BGP Info : | Total (0/0) blk_size:216

MemPool - BGP Attr : | Total (0/0) blk_size:224

MemPool - BGP Node IPv4 : | Total (0/0) blk_size:128

MemPool - BGP Node IPv6 : | Total (0/0) blk_size:136

MemPool - BGP Node EVPN : | Total (0/0) blk_size:160

MemPool - BGP Node Max KeyLen : | Total (0/0) blk_size:176

MemPool - BGP RIB msg4 : | Total (0/0) blk_size:4440

MemPool - BGP RIB msg6 : | Total (0/0) blk_size:424

MemPool - BGP MPLS REQ : | Total (0/0) blk_size:32

show bgp summary

Use this command to display a summary of BGP neighbor status.

Command Syntax

show bgp summary

show bgp (ipv4|ipv6) (unicast|multicast|) summary

show ip bgp summary

show ip bgp summary (vrf (VRFNAME|all|default))

show ip bgp ipv4 (unicast|multicast) summary

Parameters

ipv4

IPv4 routes

ipv6

IPv6 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

VRFNAME

VPN routing/forwarding instance name

all

All VRFs

default

Default VRF

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show bgp summary

BGP router identifier 6.6.6.6, local AS number 64601

BGP table version is 1

1 BGP AS-PATH entries

0 BGP community entries

Neighbor V AS MsgRcv MsgSen TblVer InQ OutQ Up/Down State/PfxRcd

*12.1.1.24 64902 7 7 1 0 0 00:02:54 0

* Dynamically created based on a listen range command

BGP dynamic peer-group: group1

listen range: 12.1.0.0/16

Total number of dynamically created neighbors/limit: 1/(200)

Total number of dynamically created neighbors: 1

Total number of activated dynamic peer-groups for IPv4 Unicast address-family:

Total number of neighbors 1

Total number of Established sessions 1

BGP dynamic peer-group: group2

listen range: 12.2.0.0/16

Total number of dynamically created neighbors/limit: 0/(200)

Total number of dynamically created neighbors: 0

Total number of activated dynamic peer-groups for IPv4 Unicast address-family: 1

Header

BGP router identifier 10.10.15.50, local AS number 65000

1 BGP AS-PATH entries

0 BGP community entries

• The BGP router identifier is 10.10.15.50 and the local router AS number is 65000.

• The BGP table version tracks the local BGP table version. Any time the BGP best path algorithm executes, the table version increments.

• There is one BGP AS-PATH entry and no community entries.

Neighbor Entry Fields

Table 7-25 explains the fields for each neighbor entry.

Table 7-25: neighbor entry fields
Field	Description
Neighbor	IP address of peer.
V	BGP version of peer.
AS	Autonomous system number of peer.
MsgRcvd	Messages received since the BGP connection was established.
MsgSent	Messages sent since the BGP connection was established.
TblVer	Last version of the local router’s BGP database advertised to the peer.
InQ	Received messages waiting in the input queue for further processing.
OutQ	Messages waiting in the output queue to be sent.
Up/Down	Connection up time and down time.
State/PfxRcd	If the TCP session is up and the BGP peers have formed an adjacency, this field shows how many prefixes have been received from the remote neighbor. Other states: Idle: The local router has not allocated resources for the peer connection, so incoming connection requests are refused Idle (Admin): The peer has shut down Idle (PfxCt): Prefix overflow Idle (G-shut): Graceful shutdown Connect: BGP is waiting for the TCP connection to complete Active: the local router is trying to establish a TCP connection to the remote peer. You might see this if the local peer has been configured, but the remote peer is unreachable or has not been configured. OpenSent: BGP is waiting for an open message from its peer OpenConfirm: BGP received an open message from the peer and is now waiting for a keepalive or notification message. If BGP receives a keepalive message from the peer, the state changes to established. If the message is a notification, the state changes to idle. Established: BGP is ready to exchange update, notification, and keepalive messages with its peer Invalid: The session state is invalid

Neighbor Entry Example

10.10.14.51 4 100 93 120 0 0 0 00:42:16 0

• The neighbor has the IP address 10.10.14.51 and AS number 100.

• The neighbor uses BGP version 4.

• 93 messages have been received.

• 120 messages have been sent.

• The BGP routing table version is 0.

• There are no received messages waiting in the input queue for further processing.

• There are no messages waiting in the output queue to be sent.

• The connection has been up for 0 hours, 42 minutes and 53 seconds.

• The local router has received no prefixes from this neighbor.

show bgp X:X::X:X

Use this command to display BGP network information in an IPv6 environment.

Command Syntax

show bgp X:X::X:X

show bgp (ipv6) X:X::X:X

show bgp (ipv6) (unicast|multicast) X:X::X:X

Parameters

ipv6

IPv6 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

X:X::X:X

IPv6 prefix (network), for example, 2003::

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show bgp ipv6 6666::/64

BGP routing table entry for 6666::/64

Paths: (1 available, best #1, table Default-IP-Routing-Table)

Advertised to peer-groups:

Book-v6

Local

:: from :: (102.67.98.95)

Origin incomplete,metric 0, localpref 100, weight 32768 valid, sourced, best, source safi: 0

Community: 37721:2000

Last update: Thu Feb 4 09:00:50 2021

show bgp X:X::X:X/M longer prefixes

Use this command to display BGP network information along with mask information.

Command Syntax

show bgp X:X::X:X/M longer-prefixes

Parameters

X:X::X:X/M

IPv6 prefix (network/length), for example, 2003::/16

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Examples

#show bgp 2001:43f8:bb1::/64 longer-prefixes

BGP table version is 1, local router ID is 102.67.98.95

Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,

l - labeled, S Stale

Origin codes: i - IGP, e - EGP, ? - incomplete

Network Next Hop Metric LocPrf Weight Path

*>2001:43f8:bb1::/64 :: 0 100 32768 ?

Total number of prefixes 1

show debugging bgp

Use this command to display BGP debugging options.

Command Syntax

show debugging bgp

Parameters

None

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

This is a sample output from the show debugging bgp command.

#show debugging bgp

BGP debugging status:

BGP debugging is on

BGP events debugging is on

BGP updates debugging is on

BGP fsm debugging is on

show ip bgp

Use this command to display BGP routes.

Command Syntax

show ip bgp

show ip bgp ipv4 (unicast|multicast)(vrf (VRFNAME|all|default))

Parameters

ipv4

IPv4 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

VRFNAME

VPN routing/forwarding instance name

all

All VRFs

default

Default VRF

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Examples

This example shows routes learned from both iBGP and eBGP peers.

#show ip bgp

BGP table version is 0, local router ID is 10.100.0.77

Status codes: s suppressed, d damped, h history, * valid, > best, i - internal, S stale,

Origin codes: i - IGP, e - EGP,? - incomplete

Network Next Hop Metric LocPrf Weight Path

*> 172.16.1.0/24 10.10.10.78 0 1 4 i

*> 192.16.1.0 10.10.10.78 200 0 1 4 ?

* 10.100.0.62 100 0 3 4 ?

*>i 192.17.1.0 10.100.0.62 100 0 i

Total number of prefixes 2

Header

BGP table version is 0, local router ID is 10.100.0.77

• The BGP table version tracks the local BGP table version. Any time the BGP best path algorithm executes, the table version increments.

• The Router ID of the local router is 10.100.0.77.

Status codes: s suppressed, d damped, h history, p stale, * valid, > best, i - internal

Table 7-26 explains the status codes in the header.

Table 7-26: status codes
Status code	Description	Comments
s	suppressed	Whether the route is suppressed and will not be advertised to the neighbors.
d	damped	When the penalty of a flapping route exceeds the suppress limit, the route is damped and remains in a withdrawn state until its penalty decreases below the reuse limit.
h	history	When the penalty of a flapping route does not exceed the suppress limit, the route is not damped and BGP maintains a history of the flapping route.
p	stale	When the BGP neighbor from which a route is learned is in graceful restart, the route is retained in the BGP routing table, but marked as stale.
*	valid	Whether the route is valid. When a route is not suppressed, damped, or present in the history, it is valid.
>	best	The route selected as the best path and installed in the kernel routing table.
i	internal	Whether the route is learned from an iBGP peer. If this symbol is not present, the route was learned from an eBGP peer.

Origin codes: i - IGP, e - EGP, ? - incomplete

Table 7-27 explains the codes are at the end of each routing entry that show where the route originated.

Table 7-27: origin codes
Origin code	Description	Comments
i	IGP	The route originated from an Interior Gateway Protocol.
e	EGP	The route originated from an Exterior Gateway Protocol.
?	incomplete	Origin not known. Typically, these are routes redistributed from an Interior Gateway Protocol.

Route Entry Fields

Table 7-28 explains the fields shows for each route.

Table 7-28: route entry fields
Field	Description
Network	Network prefix installed in BGP. If multiple routes exist for the same prefix, only the first prefix is identified and others have blank spaces. The status codes are explained in Table 7-26.
Next Hop	IP address of the nexthop for this route.
Metric	Multiple-Exit Discriminator (MED). If there are multiple paths to the same destination from a single routing protocol, then the multiple paths have the same administrative distance and the best path is selected based on this metric. The path with the lowest metric is selected as the optimal path and installed in the routing table.
LocPrf	Local preference set with the set local-preference command. This value is used only with iBGP sessions within the local autonomous system to determine if a route towards a destination is the “best” one. The path with the highest local preference is preferred.
Weight	This field applies only to routes within an individual router. If a route was learned from a peer, it has a default weight of 0. All routes generated by the local router have a weight of 32,768.
Path and origin	The autonomous systems through which the prefix advertisement passed. The origin codes are explained in Table 7-27

Route Entry Examples

*> 172.16.1.0/24 10.10.10.78 0 1 4 i

• The absence of status code “i” means the route is external and was learned from an eBGP peer.

• The “>” means this route is selected to be installed in the kernel routing table. Its network address is 172.16.1.0/24.

• The IP address of the nexthop for this route is 10.10.10.78.

• This route was learned from a peer, so it has a default weight of 0.

• The path “1 4” means the prefix advertisement passed through AS1 and AS4.

• The origin code “i” means the prefix was added by a network statement at an originating AS.

*> 192.16.1.0 10.10.10.78 200 0 1 4 ?

* 10.100.0.62 100 0 3 4 ?

• The same prefix was learned from two different ASs, AS1 and AS3.

• The route learned from AS1 is chosen as the best route because AS1 has a lower Router ID (10.10.10.78) than AS2 (10.100.0.62). Although the metric of the route learned from AS1 is higher (200) than the route learned from AS3 (100), this attribute is not used in the best path selection decision because the metrics are compared only if the first (neighboring) AS is the same in the two paths.

• The origin code “?” indicates that the routes were learned through redistribution.

*>i192.17.1.0 10.100.0.62 100 0 i

• The route is learned through an iBGP peer as indicated by the status code “i”.

• The preference of the route, used only with the local AS, is 100 (the default value).

show ip bgp cidr-only

Use this command to display routes with non-natural network masks.

Command Syntax

show ip bgp cidr-only

show ip bgp ipv4 (unicast|multicast) cidr-only

Parameters

ipv4

IPv4 routes

unicast

Unicast prefixes

multicast

Multicast prefixes

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

This is a sample output from the show ip bgp cidr-only command.

#show ip bgp cidr-only

BGP table version is 0, local router ID is 10.10.10.50

Status codes: s suppressed, d damped, h history, p stale, * valid, > best, i - internal

Origin codes: i - IGP, e - EGP, ? - incomplete

Network Next Hop Metric LocPrf Weight Path

*> 3.3.3.0/24 10.10.10.10 0 11 i

Total number of prefixes 2

show ip bgp community-info

Use this command to list all BGP community information.

Command Syntax

show ip bgp community-info

Parameters

None

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show ip bgp community-info

Address Refcnt Community

[0x262a4c0] (1) 1:1

show ip bgp peer-group

Use this command to list the BGP peer group information in ipv4 unicast.

Command Syntax

show ip bgp peer-group (WORD|)

Parameters

WORD

Name of the peer group

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show ip bgp peer-group group1

BGP dynamic peer-group is group1, EBGP, remote AS 64902

BGP dynamic peer-group group1 listen range group members:

12.1.0.0/16

BGP version 4

Minimum time between advertisement runs is 30 seconds

For address family: IPv4 Unicast

Peer-group member:

*12.1.1.2

Index 0, Offset 0, Mask 0x1

0 accepted prefixes, 0 announced prefixes

show ip bgp peer-group vrf all

Use this command to list all BGP peer group VRF information.

Command Syntax

show ip bgp peer-group vrf all

Parameters

None

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show ip bgp peer-group vrf all

% VRF: VRF1

BGP dynamic peer-group is group2, EBGP, remote AS 64902

BGP dynamic peer-group group2 listen range group members:

12.2.0.0/16

BGP version 4

Minimum time between advertisement runs is 30 seconds

% VRF: management

Peer-Group not found

% VRF: default

BGP dynamic peer-group is group1, EBGP, remote AS 64902

BGP dynamic peer-group group1 listen range group members:

12.1.0.0/16

BGP version 4

Minimum time between advertisement runs is 30 seconds

For address family: IPv4 Unicast

Peer-group member:

*12.1.1.2

Index 0, Offset 0, Mask 0x1

0 accepted prefixes, 0 announced prefixes

show ip bgp rtfilter all

Use this command to display route target filters sent and received.

Command Syntax

show ip bgp rtfilter all

Parameters

None

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show ip bgp community-info

Address Refcnt Community

[0x262a4c0] (1) 1:1

show ip bgp scan

Use this command to display BGP scan status.

Command Syntax

show ip bgp scan

Parameters

None

Command Mode

Privileged Exec mode and Exec mode

Applicability

This command was introduced before OcNOS version 1.3.

Example

#show ip bgp scan

BGP VRF: (Default) VRF_ID 0

BGP scan interval is 60 secs

scan remain-time: 3 secs

Current BGP nexthop cache:

BGP connected route:

10.10.10.0/24

10.10.11.0/24

show ip bgp vpnv4

Use this command to display information relating to VPNv4.

Command Syntax

show ip bgp vpnv4 all

show ip bgp vpnv4 all A.B.C.D

show ip bgp vpnv4 all neighbors

show ip bgp vpnv4 all neighbors A.B.C.D

show ip bgp vpnv4 all neighbors A.B.C.D routes

show ip bgp vpnv4 all summary

show ip bgp vpnv4 all tags

show ip bgp vpnv4 rd WORD

show ip bgp vpnv4 rd WORD A.B.C.D

show ip bgp vpnv4 rd WORD label

show ip bgp vpnv4 rd WORD neighbors

show ip bgp vpnv4 rd WORD neighbors A.B.C.D

show ip bgp vpnv4 rd WORD summary

show ip bgp vpnv4 view WORD all

show ip bgp vpnv4 vrf NAME

show ip bgp vpnv4 vrf NAME A.B.C.D

show ip bgp vpnv4 vrf NAME label

show ip bgp vpnv4 vrf NAME summary

Parameters

all

Displays information about all VPNv4 NLRIs

A.B.C.D

Network

neighbors

TCP and BGP neighbor connections

A.B.C.D

Network

routes

Display routes learned from neighbor

summary

Summary display

Field	Description
Routing Protocol is "bgp 100"	Specifies the routing protocol used.
Sending updates every 30 seconds	Specifies the time between sending updates.
Next due in 12 seconds	Precisely when the next update is due to be sent.
Timeout after 180 seconds	Specifies the value of the timeout parameter.
Redistributing	Lists the protocol that is being redistributed.
Routing for Networks	Specifies the networks for which the routing process is currently injecting routes.
Routing Information Sources	Lists all the routing sources the IP Infusion software is using to build its routing table.

Field	Description
BGP neighbor	Router ID of the BGP neighbor.
remote AS	Autonomous system number of the neighbor.
local AS	Autonomous system number of the local system.
internal link	internal link: iBGP neighbor (in the same AS).
BGP version	The version of BGP being used by the neighbor device.
BGP state	The current state of the neighbor connection and length of time within the current state.Possible states are: Idle, Connect, Active, and Established.
Last read	The amount of time in Hours : Minutes : Seconds since this device last checked the Hold Time parameters.
hold time	The amount of time this device waits for a Keepalive or Update message before the BGP connection is closed.
Keepalive interval	KEEPALIVE messages are sent periodically to ensure that the connection is live.
Neighbor capabilities	New or optional parameters called “Capabilities.” Provides a graceful way to advertise new or unique options without causing peering to terminate. The capabilities are communicated in TLV fields. (see RFC 3392). In the example output above, the following capabilities were advertised by the neighbor and were received and understood by this device: 1. Route refresh 2. Address family IPv4 Unicast 3. Address family IPv6 Unicast
Received	Message count, notification count, number of messages waiting in the queue.
Sent	Message count, notification count, number of messages waiting in the queue.
Route refresh request	Route requests sent and received.
For address family	As stated – in this case IPv4 Unicast.
BGP table version	For each of the address families agreed upon, BGP maintains a separate table.
neighbor version	Tracks prefixes that have been sent and those that need to be sent.
connections established	The number of times the router has established a TCP connection and the two peers have agreed to speak BGP with each other. “Dropped” means the number of time the connection has failed or gone down.
local host foreign host	Local host is the IP address and the port number of the local system used for the peering session. Foreign host is the IP address and the port of the neighbor. BGP always uses the TCP port number 179 for the peer originating the session.
nexthop	The IP address of the next hop used to reach the neighbor. eBGP or iBGP peers do not need to be directly connected. Peering sessions can be set up across multiple hops. If the neighbors are directly connected, the IP address of the local system is listed as the next hop.
nexthop global	The global IPv6 address of the next hop
nexthop local	The link-local IPv6 address of the next hop
non shared network	The peering session is running on a non shared network.
last reset	Time since this peering session was last reset. The reason for the reset is displayed on this line.
notification error message	Last error message sent.