show bgp neighbor
Syntax
Syntax (EX Series Switch)
Release Information
Command introduced before Junos OS Release 7.4.
Command introduced in Junos OS Release 9.0 for EX Series switches.
orf option introduced in Junos OS Release 9.2.
orf option introduced in Junos OS Release 9.2 for EX Series switches.
Description
Display information about Border Gateway Protocol (BGP) peers.
Options
- none
Display information about all BGP peers.
- instance instance-name
(Optional) Display information about BGP peers for only the specified routing instance.
- logical-system (all | logical-system-name)
(Optional) Perform this operation on all logical systems or on a particular logical system.
- neighbor-address
(Optional) Display information for only the BGP peer at the specified IP address.
- orf (detail | neighbor-address)
(Optional) Display outbound route-filtering information for all BGP peers or only for the BGP peer at the specified IP address. The default is to display brief output. Use the detail option to display detailed output.
Additional Information
For information about the local-address, nlri, hold-time, and preference statements, see the Junos Routing Protocols Configuration Guide.
Required Privilege Level
view
Related Topics
List of Sample Output
show bgp neighbor (CLNS)show bgp neighbor (Layer 2 VPN)
show bgp neighbor (Layer 3 VPN)
show bgp neighbor (With Dropped Path Attributes and Ignored Path Attributes
show bgp neighbor neighbor-address
show bgp neighbor neighbor-address
show bgp neighbor orf neighbor-address detail
Output Fields
Table 1 describes the output fields for the show bgp neighbor command. Output fields are listed in the approximate order in which they appear.
Table 1: show bgp neighbor Output Fields
Field Name | Field Description |
|---|---|
Peer | Address of the BGP neighbor. The address is followed by the neighbor’s port number. |
AS | AS number of the peer. |
Local | Address of the local routing device. The address is followed by the peer’s port number. |
Type | Type of peer: Internal or External. |
State | Current state of the BGP session:
|
Flags | Internal BGP flags:
|
Last state | Previous state of the BGP session:
|
Last event | Last activity that occurred in the BGP session:
|
Last error | Last error that occurred in the BGP session:
|
Export | Name of the export policy that is configured on the peer. |
Import | Name of the import policy that is configured on the peer. |
Options | Configured BGP options:
|
Path-attributes dropped | Path attribute codes that are dropped from neighbor updates. |
Path-attributes ignored | Path attribute codes that are ignored during neighbor updates. |
Authentication key change | Name of the authentication key chain enabled. |
Authentication algorithm | Type of authentication algorithm enabled: hmac or md5 |
Address families configured | Names of configured address families for the VPN. |
Local Address | Address of the local routing device. |
Holdtime | Hold time configured with the hold-time statement. The hold time is three times the interval at which keepalive messages are sent. |
Flags for NLRI inet-label-unicast | Flags related to labeled-unicast:
|
Traffic statistics | Information about labeled-unicast traffic statistics:
|
Traffic Statistics Interval | Time between sample periods for labeled-unicast traffic statistics, in seconds. |
Preference | Preference value configured with the preference statement. |
Number of flaps | Number of times the BGP session has gone down and then come back up. |
Peer ID | Router identifier of the peer. |
Peer Index | Index of this peer in its group. |
Local ID | Router identifier of the local routing device. |
Local Interface | Name of the interface on the local routing device. |
Active holdtime | Hold time the local routing device negotiated with the peer. |
Keepalive Interval | Keepalive interval, in seconds. |
BFD | Status of BFD failure detection. |
Local Address | Name of directly connected interface over which the direct EBGP peering is established. |
NLRI for restart configured on peer | Names of address families configured for restart. |
NLRI advertised by peer | Address families supported by the peer: unicast or multicast. |
NLRI for this session | Address families being used for this session. |
Peer supports Refresh capability | Remote peer’s ability to send and request full route table readvertisement (route refresh capability). For more information, see RFC 2918, Route Refresh Capability for BGP-4. |
Restart time configured on peer | Configured time allowed for restart on the neighbor. |
Stale routes from peer are kept for | When graceful restart is negotiated, the maximum time allowed to hold routes from neighbors after the BGP session has gone down. |
Restart time requested by this peer | Restart time requested by this neighbor during capability negotiation. |
Restart flag received from the peer | When this field appears, the BGP speaker has restarted (Restarting) and this peer should not wait for the end-of-rib marker from the speaker before advertising routing information to the speaker. |
NLRI that peer supports restart for | Neighbor supports graceful restart for this address family. |
NLRI peer can save forwarding state | Neighbor supporting this address family saves all forwarding states. |
NLRI that peer saved forwarding for | Neighbor saves all forwarding states for this address family. |
NLRI that restart is negotiated for | Router supports graceful restart for this address family. |
NLRI of received end-of-rib markers | Address families for which end-of-routing-table markers are received from the neighbor. |
NLRI of all end-of-rib markers sent | Address families for which end-of-routing-table markers are sent to the neighbor. |
Table inet.number | Information about the routing table:
|
Last traffic (seconds) | Last time any traffic was received from the peer or sent to the peer, and the last time the local routing device checked. |
Input messages | Messages that BGP has received from the receive socket buffer, showing the total number of messages, number of update messages, number of times a policy is changed and refreshed, and the buffer size in octets. The buffer size is 16 KB. |
Output messages | Messages that BGP has written to the transmit socket buffer, showing the total number of messages, number of update messages, number of times a policy is changed and refreshed, and the buffer size in octets. The buffer size is 16 KB. |
Input dropped path attributes | Information about dropped path attributes:
|
Input ignored path attributes | Information about ignored path attributes:
|
Output queue | Number of BGP packets that are queued to be transmitted to a particular neighbor for a particular routing table. Output queue 0 is for unicast NLRIs, and queue 1 is for multicast NLRIs. |
Trace options | Configured tracing of BGP protocol packets and operations. |
Trace file | Name of the file to receive the output of the tracing operation. |
Filter Updates recv | (orf option only) Number of outbound-route filters received for each configured address family. Note: The counter is cumulative. For example, the counter is increased after the remote peer either resends or clears the outbound route filtering prefix list. |
Immediate | (orf option only) Number of route updates received with the immediate flag set. The immediate flag indicates that the BGP peer should readvertise the updated routes. Note: The counter is cumulative. For example, the counter is increased after the remote peer either resends or clears the outbound route filtering prefix list. |
Filter | (orf option only) Type of prefix filter received: prefix-based or extended-community. |
Received filter entries | (orf option only) List of received filters displayed. |
seq | (orf option only) Numerical order assigned to this prefix entry among all the received outbound route filter prefix entries. |
prefix | (orf option only) Address for the prefix entry that matches the filter. |
minlength | (orf option only) Minimum prefix length, in bits, required to match this prefix. |
maxlength | (orf option only) Maximum prefix length, in bits, required to match this prefix. |
match | (orf option only) For this prefix match, whether to permit or deny route updates. |
Sample Output
show bgp neighbor (CLNS)
user@host> show bgp neighbor Peer: 10.245.245.1+179 AS 200 Local: 10.245.245.3+3770 AS 100
Type: External State: Established Flags: <ImportEval Sync>
Last State: OpenConfirm Last Event: RecvKeepAlive
Last Error: None
Options: <Multihop Preference LocalAddress HoldTime AddressFamily PeerAS Rib-group Refresh>
Address families configured: iso-vpn-unicast
Local Address: 10.245.245.3 Holdtime: 90 Preference: 170
Number of flaps: 0
Peer ID: 10.245.245.1 Local ID: 10.245.245.3 Active Holdtime: 90
Keepalive Interval: 30 Peer index: 0
NLRI advertised by peer: iso-vpn-unicast
NLRI for this session: iso-vpn-unicast
Peer supports Refresh capability (2)
Table bgp.isovpn.0 Bit: 10000
RIB State: BGP restart is complete
RIB State: VPN restart is complete
Send state: in sync
Active prefixes: 3
Received prefixes: 3
Suppressed due to damping: 0
Advertised prefixes: 3
Table aaaa.iso.0
RIB State: BGP restart is complete
RIB State: VPN restart is complete
Send state: not advertising
Active prefixes: 3
Received prefixes: 3
Suppressed due to damping: 0
Last traffic (seconds): Received 6 Sent 5 Checked 5
Input messages: Total 1736 Updates 4 Refreshes 0 Octets 33385
Output messages: Total 1738 Updates 3 Refreshes 0 Octets 33305
Output Queue[0]: 0
Output Queue[1]: 0
show bgp neighbor (Layer 2 VPN)
user@host> show bgp neighbor Peer: 10.69.103.2 AS 65100 Local: 10.69.103.1 AS 65103
Type: External State: Active Flags: <ImportEval>
Last State: Idle Last Event: Start
Last Error: None
Export: [ BGP-INET-import ]
Options: <Preference LocalAddress HoldTime GracefulRestart AddressFamily PeerAS Refresh>
Address families configured: inet-unicast
Local Address: 10.69.103.1 Holdtime: 90 Preference: 170
Number of flaps: 0
Peer: 10.69.104.2 AS 65100 Local: 10.69.104.1 AS 65104
Type: External State: Active Flags: <ImportEval>
Last State: Idle Last Event: Start
Last Error: None
Export: [ BGP-L-import ]
Options: <Preference LocalAddress HoldTime GracefulRestart AddressFamily PeerAS Refresh>
Address families configured: inet-labeled-unicast
Local Address: 10.69.104.1 Holdtime: 90 Preference: 170
Number of flaps: 0
Peer: 10.255.14.182+179 AS 69 Local: 10.255.14.176+2131 AS 69
Type: Internal State: Established Flags: <ImportEval>
Last State: OpenConfirm Last Event: RecvKeepAlive
Last Error: None
Options: <Preference LocalAddress HoldTime GracefulRestart AddressFamily Rib-group Refresh>
Address families configured: inet-vpn-unicast l2vpn
Local Address: 10.255.14.176 Holdtime: 90 Preference: 170
Number of flaps: 0
Peer ID: 10.255.14.182 Local ID: 10.255.14.176 Active Holdtime: 90
Keepalive Interval: 30
NLRI for restart configured on peer: inet-vpn-unicast l2vpn
NLRI advertised by peer: inet-vpn-unicast l2vpn
NLRI for this session: inet-vpn-unicast l2vpn
Peer supports Refresh capability (2)
Restart time configured on the peer: 120
Stale routes from peer are kept for: 300
Restart time requested by this peer: 120
NLRI that peer supports restart for: inet-vpn-unicast l2vpn
NLRI peer can save forwarding state: inet-vpn-unicast l2vpn
NLRI that peer saved forwarding for: inet-vpn-unicast l2vpn
NLRI that restart is negotiated for: inet-vpn-unicast l2vpn
NLRI of received end-of-rib markers: inet-vpn-unicast l2vpn
Table bgp.l3vpn.0 Bit: 10000
RIB State: BGP restart in progress
RIB State: VPN restart in progress
Send state: in sync
Active prefixes: 10
Received prefixes: 10
Suppressed due to damping: 0
Table bgp.l2vpn.0 Bit: 20000
RIB State: BGP restart in progress
RIB State: VPN restart in progress
Send state: in sync
Active prefixes: 1
Received prefixes: 1
Suppressed due to damping: 0
Table BGP-INET.inet.0 Bit: 30000
RIB State: BGP restart in progress
RIB State: VPN restart in progress
Send state: in sync
Active prefixes: 2
Received prefixes: 2
Suppressed due to damping: 0
Table BGP-L.inet.0 Bit: 40000
RIB State: BGP restart in progress
RIB State: VPN restart in progress
Send state: in sync
Active prefixes: 2
Received prefixes: 2
Suppressed due to damping: 0
Table LDP.inet.0 Bit: 50000
RIB State: BGP restart is complete
RIB State: VPN restart in progress
Send state: in sync
Active prefixes: 1
Received prefixes: 1
Suppressed due to damping: 0
Table OSPF.inet.0 Bit: 60000
RIB State: BGP restart is complete
RIB State: VPN restart in progress
Send state: in sync
Active prefixes: 2
Received prefixes: 2
Suppressed due to damping: 0
Table RIP.inet.0 Bit: 70000
RIB State: BGP restart is complete
RIB State: VPN restart in progress
Send state: in sync
Active prefixes: 2
Received prefixes: 2
Suppressed due to damping: 0
Table STATIC.inet.0 Bit: 80000
RIB State: BGP restart is complete
RIB State: VPN restart in progress
Send state: in sync
Active prefixes: 1
Received prefixes: 1
Suppressed due to damping: 0
Table L2VPN.l2vpn.0 Bit: 90000
RIB State: BGP restart is complete
RIB State: VPN restart in progress
Send state: in sync
Active prefixes: 1
Received prefixes: 1
Suppressed due to damping: 0
Last traffic (seconds): Received 0 Sent 0 Checked 0
Input messages: Total 14 Updates 13 Refreshes 0 Octets 1053
Output messages: Total 3 Updates 0 Refreshes 0 Octets 105
Output Queue[0]: 0
Output Queue[1]: 0
Output Queue[2]: 0
Output Queue[3]: 0
Output Queue[4]: 0
Output Queue[5]: 0
Output Queue[6]: 0
Output Queue[7]: 0
Output Queue[8]: 0
show bgp neighbor (Layer 3 VPN)
user@host> show bgp neighbor Peer: 4.4.4.4+179 AS 10045 Local: 5.5.5.5+1214 AS 10045
Type: Internal State: Established Flags: <ImportEval>
Last State: OpenConfirm Last Event: RecvKeepAlive
Last Error: None
Export: [ match-all ] Import: [ match-all ]
Options: <Preference LocalAddress HoldTime GracefulRestart AddressFamily Rib-group Refresh>
Address families configured: inet-vpn-unicast
Local Address: 5.5.5.5 Holdtime: 90 Preference: 170
Flags for NLRI inet-labeled-unicast: TrafficStatistics
Traffic Statistics: Options: all File: /var/log/bstat.log
size 131072 files 10
Traffic Statistics Interval: 60
Number of flaps: 0
Peer ID: 192.168.1.110 Local ID: 192.168.1.111 Active Holdtime: 90
Keepalive Interval: 30
NLRI for restart configured on peer: inet-vpn-unicast
NLRI advertised by peer: inet-vpn-unicast
NLRI for this session: inet-vpn-unicast
Peer supports Refresh capability (2)
Restart time configured on the peer: 120
Stale routes from peer are kept for: 300
Restart time requested by this peer: 120
NLRI that peer supports restart for: inet-vpn-unicast
NLRI peer can save forwarding state: inet-vpn-unicast
NLRI that peer saved forwarding for: inet-vpn-unicast
NLRI that restart is negotiated for: inet-vpn-unicast
NLRI of received end-of-rib markers: inet-vpn-unicast
NLRI of all end-of-rib markers sent: inet-vpn-unicast
Table bgp.l3vpn.0 Bit: 10000
RIB State: BGP restart is complete
RIB State: VPN restart is complete
Send state: in sync
Active prefixes: 2
Received prefixes: 2
Suppressed due to damping: 0
Table vpn-green.inet.0 Bit: 20001
RIB State: BGP restart is complete
RIB State: VPN restart is complete
Send state: in sync
Active prefixes: 2
Received prefixes: 2
Suppressed due to damping: 0
Last traffic (seconds): Received 15 Sent 20 Checked 20
Input messages: Total 40 Updates 2 Refreshes 0 Octets 856
Output messages: Total 44 Updates 2 Refreshes 0 Octets 1066
Output Queue[0]: 0
Output Queue[1]: 0
Trace options: detail packets
Trace file: /var/log/bgpgr.log size 131072 files 10
show bgp neighbor (With Dropped Path Attributes and Ignored Path Attributes
user@host> show bgp neighbor regress@pro9-b1# run show bgp neighbor Peer: 1.1.3.2+179 AS 2 Local: 1.1.3.1+62746 AS 1 Type: External State: Established Flags: <ImportEval Sync RSync> Last State: OpenConfirm Last Event: RecvKeepAlive Last Error: None Options: <Preference KeepAll PeerAS LocalAS Refresh> Options: <ConnectRetryInterval DropPathAttributes IgnorePathAttributes> Path-attributes dropped: 4 10 128 Path-attributes ignored: 8 50 113 Holdtime: 90 Preference: 170 Local AS: 1 Local System AS: 10 . . . Input messages: Total 525 Updates 2 Refreshes 0 Octets 10022 Output messages: Total 522 Updates 0 Refreshes 0 Octets 9981 Input dropped path attributes: Code: 4 Count: 1 Input ignored path attributes: Code: 8 Count: 1 Output Queue[0]: 0 Trace file: /var/log/bgp_nsr size 131072 files 10
show bgp neighbor neighbor-address
user@host> show bgp neighbor 192.168.1.111 Peer: 10.255.245.12+179 AS 35 Local: 10.255.245.13+2884 AS 35
Type: Internal State: Established (route reflector client)Flags: <Sync>
Last State: OpenConfirm Last Event: RecvKeepAlive
Last Error: None
Options: <Preference LocalAddress HoldTime Cluster AddressFamily Rib-group Refresh>
Address families configured: inet-vpn-unicast inet-labeled-unicast
Local Address: 10.255.245.13 Holdtime: 90 Preference: 170
Flags for NLRI inet-vpn-unicast: AggregateLabel
Flags for NLRI inet-labeled-unicast: AggregateLabel
Number of flaps: 0
Peer ID: 10.255.245.12 Local ID: 10.255.245.13 Active Holdtime: 90
Keepalive Interval: 30
BFD: disabled
NLRI advertised by peer: inet-vpn-unicast inet-labeled-unicast
NLRI for this session: inet-vpn-unicast inet-labeled-unicast
Peer supports Refresh capability (2)
Restart time configured on the peer: 300
Stale routes from peer are kept for: 60
Restart time requested by this peer: 300
NLRI that peer supports restart for: inet-unicast inet6-unicast
NLRI that restart is negotiated for: inet-unicast inet6-unicast
NLRI of received end-of-rib markers: inet-unicast inet6-unicast
NLRI of all end-of-rib markers sent: inet-unicast inet6-unicast
Table inet.0 Bit: 10000
RIB State: restart is complete
Send state: in sync
Active prefixes: 4
Received prefixes: 6
Suppressed due to damping: 0
Table inet6.0 Bit: 20000
RIB State: restart is complete
Send state: in sync
Active prefixes: 0
Received prefixes: 2
Suppressed due to damping: 0
Last traffic (seconds): Received 3 Sent 3 Checked 3
Input messages: Total 9 Updates 6 Refreshes 0 Octets 403
Output messages: Total 7 Updates 3 Refreshes 0 Octets 365
Output Queue[0]: 0
Output Queue[1]: 0
Trace options: detail packets
Trace file: /var/log/bgpgr size 131072 files 10
show bgp neighbor neighbor-address
user@host> show bgp neighbor 192.168.4.222Peer: 192.168.4.222+4902 AS 65501 Local: 192.168.4.221+179 AS 65500
Type: External State: Established Flags: <Sync>
Last State: OpenConfirm Last Event: RecvKeepAlive
Last Error: Cease
Export: [ export-policy ] Import: [ import-policy ]
Options: <Preference HoldTime AddressFamily PeerAS PrefixLimit Refresh>
Address families configured: inet-unicast inet-multicast
Holdtime: 60000 Preference: 170
Number of flaps: 4
Last flap event: RecvUpdate
Error: 'Cease' Sent: 5 Recv: 0
Peer ID: 10.255.245.6 Local ID: 10.255.245.5 Active Holdtime: 60000
Keepalive Interval: 20000 Peer index: 0
BFD: disabled, down
Local Interface: fxp0.0
NLRI advertised by peer: inet-unicast inet-multicast
NLRI for this session: inet-unicast inet-multicast
Peer supports Refresh capability (2)
Table inet.0 Bit: 10000
RIB State: BGP restart is complete
Send state: in sync
Active prefixes: 8
Received prefixes: 10
Accepted prefixes: 10
Suppressed due to damping: 0
Advertised prefixes: 3
Table inet.2 Bit: 20000
RIB State: BGP restart is complete
Send state: in sync
Active prefixes: 0
Received prefixes: 0
Accepted prefixes: 0
Suppressed due to damping: 0
Advertised prefixes: 0
Last traffic (seconds): Received 357 Sent 357 Checked 357
Input messages: Total 4 Updates 2 Refreshes 0 Octets 211
Output messages: Total 4 Updates 1 Refreshes 0 Octets 147
Output Queue[0]: 0
Output Queue[1]: 0
Trace options: all
Trace file: /var/log/bgp size 10485760 files 10show bgp neighbor orf neighbor-address detail
user@host > show bgp neighbor orf 192.168.165.56
detailPeer: 192.168.165.56+179 Type: External
Group: ext1
inet-unicast
Filter updates recv: 1 Immediate: 1
Filter: prefix-based receive
Received filter entries:
seq 1: prefix 2.2.2.2/32: minlen 32: maxlen 32: match deny:
inet6-unicast
Filter updates recv: 0 Immediate: 1
Filter: prefix-based receive
Received filter entries:
*:*
