BGP Show Commands
This chapter describes the BGP show commands.
show bgp
Use this command to display the status of BGP routes.
Command Syntax
show bgp
show bgp (ipv6)
show bgp (ipv4|ipv6) (unicast|multicast)
show ip bgp
show ip bgp ipv4 (unicast|multicast)
show bgp (vrf (VRFNAME|all|default))
show ip bgp (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
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 A.B.C.D
Use this command to display BGP route information for a network.
Command Syntax
show bgp (ipv4) (unicast|multicast) A.B.C.D
show ip bgp A.B.C.D
show ip bgp ipv4 (unicast|multicast) A.B.C.D
Parameters
ipv4
IPv4 routes
unicast
Unicast prefixes
multicast
Multicast prefixes
A.B.C.D
IP prefix (network), for example, 35.0.0.0
Command Mode
Privileged Exec and Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
OcNOS#show ip bgp 80.80.80.0
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 1 explains the output fields.
Table 1: 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
#show bgp client
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 bgp ip (unicast|multicast) community [AA:NN|local-AS|no-advertise|no-export] (exact-match|)
show ip bgp community
show ip bgp community [AA:NN|local-AS|no-advertise|no-export|internet] (exact-match|)
show ip bgp community (vrf (VRFNAME|all|default))
show ip bgp community [AA:NN|local-AS|no-advertise|no-export|internet] (exact-match|)
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 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 bgp dampening dampened-paths
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
Header
BGP table version is 1, local router ID is 30.30.30.77
• BGP table version
• BGP router ID is 30.30.30.77
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal, S stale
Table 1 shows the status codes displayed at the start of a route entry.
Table 2: 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 3 shows the codes at the end of each route entry that indicate where the route originated.
Table 3: 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 4 explains the output fields.
Table 4: 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. |
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 5 explains the output fields.
Table 5: 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 6 shows the status codes displayed at the start of a route entry.
Table 6: 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 shows the codes at the end of each route entry that indicate where the route originated.
Table 7: 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 8 explains the output fields.
Table 8: 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. |
Local Pref | 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 neighbors
Use this command to display information about BGP neighbor connections.
Command Syntax
show bgp neighbors
show bgp neighbors (A.B.C.D|X:X::X:X|WORD)
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)(advertised-routes|)
show ip bgp ipv4 (unicast|multicast) neighbors (A.B.C.D|X:X::X:X|WORD)
show ip bgp neighbors (A.B.C.D|X:X::X:X|WORD) (hold-time|keepalive-interval|connection-retrytime)
show ip bgp neighbors (A.B.C.D|X:X::X:X|WORD) (sent-msgs|rcvd-msgs|notification|update|open|keepalive)
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
WORD
Interface name
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 9 explains the output fields.
Table 9: 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 14. 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|WORD) 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|WORD) advertised-routes
show ip bgp neighbors (A.B.C.D|X:X::X:X|WORD) routes advertised
show ip bgp ipv4 (unicast|multicast) neighbors (A.B.C.D|X:X::X:X|WORD) advertised-routes
Parameters
A.B.C.D
IPv4 neighbor
X:X::X:X
IPv6 neighbor
WORD
Interface name
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|WORD) advertised-routes
show ip bgp neighbors (A.B.C.D|X:X::X:X|WORD) 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
WORD
Interface name
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 display the received routes from a neighbor.
To display all the received routes from a neighbor, perform a BGP soft reconfigure first.
Command Syntax
show bgp neighbors (A.B.C.D|X:X::X:X|WORD) received-routes
show ip bgp ipv4 (unicast|multicast) neighbors (A.B.C.D|X:X::X:X) received-routes
show ip bgp neighbors (A.B.C.D|X:X::X:X|WORD) received-routes
show ip bgp neighbors (A.B.C.D|X:X::X:X|WORD) routes received
Parameters
A.B.C.D
IPv4 address
X:X::X:X
IPv6 address
WORD
Interface name
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 11.11.11.1 received-routes
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
*>i 33.33.33.33/32 11.11.11.1 0 100 0 i
Total number of prefixes 1
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|WORD) routes
show ip bgp neighbors (A.B.C.D|X:X::X:X|WORD) routes
show ip bgp ipv4 (unicast|multicast) neighbors (A.B.C.D|X:X::X:X|WORD) routes
Parameters
A.B.C.D
IPv4 address
X:X::X:X
IPv6 address
WORD
Interface name
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 10 explains the output fields.
Table 10: 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: • Route refresh • Address family IPv4 Unicast • 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 11 explains the output fields.
Table 11: 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 12 explains the output fields.
Table 12: 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 13 explains the output fields.
Table 13: 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 bgp (ipv4|ipv6) (unicast|multicast|) prefix-list WORD (vrf (VRFNAME|all|default|))
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
#
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 14 explains the fields for each neighbor entry.
Table 14: 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 15 explains the status codes in the header.
Table 15: 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 16 explains the codes are at the end of each routing entry that show where the route originated.
Table 16: 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 17 explains the fields shows for each route.
Table 17: 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 15. |
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 16 |
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
Table 18 explains the status codes in the header.
Table 18: 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 19 explains the codes are at the end of each routing entry that show where the route originated.
Table 19: 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 20 explains the fields shows for each route.
Table 20: 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 18. |
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 19 |
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
NAME
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 rtfilter all
RTFilter's Received
*******************
peer-ip 1.1.1.1
RTFilter's Sent
*******************
peer-ip 1.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 extcommunity-list
Use this command to display BGP routes that match an extended community list.
Command Syntax
show ip extcommunity-list (WORD | )
show ip extcommunity-list (<1-199>|WORD)
show ip bgp extcommunity-list WORD (exact-match|)(vrf VRFNAME|)
Parameters
WORD
Name of extended community list
<1-199>
Number of extended community list
VRFNAME
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 ip extcommunity-list test
Named extended community expanded list test
permit rt 100:100
show ip protocols
Use this command to display information about the IP protocols such as IP routing process parameters and statistics.
Command Syntax
show ip protocols
show ip protocols bgp
Parameters
bgp
BGP information
Command Mode
Privileged Exec mode and Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show ip protocols bgp
Routing Protocol is "bgp 100"
Sending updates every 30 seconds with +/-50%, next due in 12 seconds
Timeout after 180 seconds, garbage collect after 120 seconds
Outgoing update filter list for all interface is not set
Incoming update filter list for all interface is not set
Default redistribution metric is 1
Redistributing: connected static
Default version control: send version 2, receive version 2
Interface Send Recv Key-chain
eth0 2 2
Routing for Networks:
10.10.0.0/24
Routing Information Sources:
Gateway BadPackets BadRoutes Distance Last Update
Distance: (default is 120)
Table 21 explains the fields shows for each route.
Table 21: show ip protocols output details
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. |
show ip vrf
Use this command to display the routing information of the VRF, such as interface, route distinguisher, route-target, and so on.
Command Syntax
show ip vrf
show ip vrf WORD
Parameter
WORD
VRF name
Command Mode
Privileged Exec mode and Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show ip vrf VRF_A
VRF VRF_A; (table=1)
show running-config as-path access-list
Use this command to show the running system status and configuration details for access lists based on autonomous system paths.
Command Syntax
show running-config as-path access-list
Parameters
None
Command Mode
Privileged exec mode, configure mode, router-map mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
(config)#show running-config as-path access-list
!
ip as-path access-list wer permit knsmk
!
(config)#
show running-config community-list
Use this command to show the running system status and configuration details for community lists.
Command Syntax
show running-config community-list
Parameters
None
Command Mode
Privileged exec mode, configure mode, router-map mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
>enable
(config)#show running-config community-list
!
ip community-list standard aspd permit internet
ip community-list expanded cspd deny ljj
ip community-list expanded cspd permit dcv
ip community-list expanded wde permit njhd
ip community-list expanded wer deny sde
(config)#