test ip bgp neighbor

Syntax

test ip bgp
[ ipv4 unicast | ipv4 multicast | vpnv6 all | vpnv6 vrf vrfName |
route-target signaling ] neighbor { ipAddress | ipv6Address | peerGroupName } { advertised-routes |
routes } [ routeAddr [ routeMask [ route-rd distinguisher ] ] ]
[ distribute-list accessListName |
filter-list asPathAccessListName [ weight weightValue ] |
prefix-list prefixListName | prefix-tree prefixTreeName | route-map mapTag ]*
[ fields { fieldOptions } ] [ filter ]

Release Information

Command introduced before JunosE Release 7.1.0.
route-target signaling keywords added in JunosE Release 8.2.0.

Description

Tests BGP policy for routes advertised to or received from peers without implementing the policy. There is no no version.

Options

• ipv4 unicast—Specifies the IPv4 unicast address family and routing table; the default option
• ipv4 multicast—Specifies the IPv4 multicast address family and routing table
• vpnv4 all—Specifies the IPv4 VPN address family and all IPv4 VPN routing and forwarding instances
• vpvn4 vrf vrfName—Specifies the IPv4 VPN address family and only the IPv4 VPN routing and forwarding instance with the name vrfName
• route-target signaling—Specifies the route-target address family
• ipAddress—IP address of BGP neighbor
• ipv6Address—IPv6 address of BGP neighbor
• peerGroupName—Name of a BGP peer group. If you specify a BGP peer group by using the peerGroupName argument, all the members of the peer group inherit the characteristic configured with this command, unless it is overridden for a specific peer.
• advertised-routes—Tests only outgoing advertisements to the specified neighbor
• routes—Tests only the incoming advertisements from the specified neighbor
• routeAddr—Prefix advertised by BGP
• routeMask—Subnet mask associated with prefix; if not specified, a best match on routeAddr is performed
• distinguisher—Unique two-part identifier of the format number1:number2 where:
  • number1—AS number or an IP address
  • number2—Unique integer; 32 bits if number1 is an AS number; 16 bits if number1 is an IP address

  If not specified, considers all destinations with the same routeAddress and routeMask.

• accessListName—Name of an access list used as a distribute list to filter routes by prefix; string of up to 32 alphanumeric characters
• asPathAccessListName—Name of a single AS path access list used to filter routes by AS path; string of up to 32 characters
• weightValue—Weight assigned to incoming routes matched by the AS path access list; integer in the range 0–4294967295
• prefixListName—Name of a BGP prefix list used to filter routes by prefix
• prefixTreeName—Name of a BGP prefix tree used to filter routes by prefix
• mapTag—Name of a route map; a string of up to 32 alphanumeric characters
• *—Indicates that one or more parameters can be repeated multiple times in a list in the command line
• fields—Displays only the specified fields; the display order of the fields is hard-coded and not affected by the order in which you enter them
• fieldOptions—Fields to be displayed, in the format
  all | [ afi | aggregator | as-path | atomic-aggregate | best | clusters | communities | extended-communities | imported | intro | in-label | loc-pref | med | next-hop | next-hop-cost | origin | originator-id | out-label | peer | peer-type | rd | safi | stale | unknown-types | weight ]*
  • all—All available information; not recommended, because this information for each network does not fit on a single line and is difficult to read
  • afi—Address family identifier
  • aggregator—AS number and IP address of aggregator
  • as-path—AS path through which this route bas been advertised
  • atomic-aggregate—Whether the atomic aggregate attribute is present
  • best—Whether this is the best route for the prefix
  • clusters—List of cluster IDs through which the route has been advertised
  • communities—Community number associated with the route
  • extended-communities—Extended community
  • imported—Whether the route was imported
  • intro—Introductory information about the state of various BGP attributes; this information is displayed only if you specify this keyword
  • in-label—MPLS label for the route; the label received with incoming MPLS frames; typically, but not always, this is the label advertised to MP-BGP peers
  • loc-pref—Local preference for the route
  • med—Multiexit discriminator for the route
  • next-hop—IP address of the next router that is used when forwarding a packet to the destination network
  • next-hop-cost—Whether the indirect next hop of the route is unreachable, if not, displays IGP cost to the indirect next hop
  • origin—Origin of the route
  • originator-id—Router ID of the router in the local AS that originated the route
  • out-label—MPLS label for the route; the label sent with outgoing MPLS frames; also the label received from MP-BGP peer; typically, but not always, this is the label received from MP-BGP peers
  • peer—IP address of BGP peer from which route was learned
  • peer-type—Type of BGP peer: internal, external, or confederation
  • rd—Route distinguisher
  • safi—Subsequent address family identifier
  • stale—Route that has gone stale due to peer restart
  • unknown-types—Attribute codes for unknown path attributes
  • weight—Weight of the route
  • *—Indicates that one or more parameters can be repeated multiple times in a list in the command line
• filter—See Filtering show Commands

Mode

Privileged Exec, User Exec