Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Guide That Contains This Content
[+] Expand All
[-] Collapse All

    show ip bgp


    To display information about networks for all address families or for a specific address family other than the L2VPN address family and the route-target address family:

    show ip bgp [ ipv4 unicast | ipv4 multicast | vpnv4 all | vpnv4 vrf vrfName ]
    [ network [ networkMask [ longer-prefixes ] ] ] [ fields fieldOptions ] [ filter ]

    To display information for networks associated with only the L2VPN address family:

    show ip bgp { l2vpn all | l2vpn vpls vplsName | l2vpn vpws vpwsName }
    [ site-id siteId block-offset blockOffset ] [ fields fieldOptions ] [ filter ]

    To display information for networks associated with only the route-target address family:

    show ip bgp route-target signaling rtfPrefix [ longer-prefixes ]
    [ fields fieldOptions ] [ filter ]

    Release Information

    Command introduced before JunosE Release 7.1.0.
    l2vpn and all keywords added in JunosE Release 7.1.0.
    vpls keyword and vplsName variable added in JunosE Release 7.1.0.
    site-id keyword and siteId variable added in JunosE Release 7.1.0.
    block-offset keyword and blockOffset variable added in JunosE Release 7.1.0.
    vpws keyword and vpwsName variable added in JunosE Release 8.1.0.
    route-target signaling keywords and rtMemNlri variable added in JunosE Release 8.2.0.
    rtMemNlri variable replaced by rtfPrefix variable in JunosE Release 9.1.0.


    Displays filtered information about a specified network, or all networks, in the BGP routing table associated with a specified address family or all address families. Only those fields that you specify are displayed, except that the prefix field is always displayed. Default fields can be set with the default-fields route command.


    • 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
    • network—IP address for which the best matching route is displayed; if no network is specified, displays the fields for all networks
    • networkMask—Address mask to be applied to the network address
    • longer-prefixes—Displays all routes with a prefix that is equal to or more specific than the specified prefix
    • l2vpn all—Specifies all VPLS and VPWS instances in the L2VPN address family
    • l2vpn vpls vplsName—Specifies the VPLS instance with the name vplsName
    • l2vpn vpws vpwsName—Specifies the VPWS instance with the name vpwsName
    • siteId—Numerical identifier for the site; must be an unsigned 16-bit integer greater than zero that is unique across the VPLS domain
    • blockOffset—Integer in the range 1–65535 that identifies a block offset for which information is displayed
    • route-target signaling—Specifies the route-target address family
    • rtfPrefix—Prefix representing the route-target membership NLRI (RT-MEM-NLRI), in the format asNumber:extendedCommunity/prefixLength (for example, 320:320:524/36) where:
      • asNumber—AS number for origin of route target information, in the range 1–4294967295
      • extendedCommunity—Two-part number in the format number1:number2 that identifies an extended community of VPNs, in the format number1:number2, where:
        • number1—Autonomous system (AS) number, in the range 1–4294967295, or an IP address
        • number2—Unique integer, in the range 1–4294967295; 32 bits if number1 is a 16-bit AS number; 16 bits if number1 is an IP address or a 32-bit AS number
      • prefixLength—Number that specifies the length of the route prefix, in the range 32–96
    • 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


    Privileged Exec, User Exec

    Published: 2014-08-18