# 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