Technical Documentation

show multicast route

Syntax

show multicast route<brief | detail | extensive><active | all | inactive><group group><inet | inet6><instance instance name><logical-system (all |  logical-system-name)><regular-expression><source-prefix source-prefix>

Syntax (EX Series Switch)

show multicast route<brief | detail | extensive><active | all | inactive><group group><inet | inet6><instance instance name><regular-expression><source-prefix source-prefix>

Release Information

Command introduced before Junos OS Release 7.4.

Command introduced in Junos OS Release 9.0 for EX Series switches.

inet6 and instance options introduced in Junos OS Release 10.0 for EX Series switches.

Description

Display the entries in the IP multicast forwarding table. You can display similar information with the show route table inet.1 command.

Options

none

Display standard information about all entries in the multicast forwarding table for all routing instances.

brief | detail | extensive

(Optional) Display the specified level of output.

active | all | inactive

(Optional) Display all active entries, all entries, or all inactive entries, respectively, in the multicast forwarding table.

group group

(Optional) Display the cache entries for a particular group.

inet | inet6

(Optional) Display multicast forwarding table entries for IPv4 or IPv6 family addresses, respectively.

instance instance-name

(Optional) Display entries in the multicast forwarding table for a specific multicast instance.

logical-system (all | logical-system-name)

(Optional) Perform this operation on all logical systems or on a particular logical system.

regular-expression

(Optional) Display information about the multicast forwarding table entries that match a UNIX-style regular expression.

source-prefix source-prefix

(Optional) Display the cache entries for a particular source prefix.

Required Privilege Level

view

List of Sample Output

show multicast route
show multicast route brief
show multicast route detail
show multicast route extensive

Output Fields

Table 1 describes the output fields for the show multicast route command. Output fields are listed in the approximate order in which they appear.

Table 1: show multicast route Output Fields

Field Name

Field Description

Level of Output

Address family

IPv4 address family (INET) or IPv6 address family (INET6).

All levels

Group

Group address.

All levels

Source

Prefix and length of the source as it is in the multicast forwarding table.

All levels

Upstream interface

Name of the interface on which the packet with this source prefix is expected to arrive.

All levels

Downstream interface list

List of interface names to which the packet with this source prefix is forwarded.

All levels

Session description

Name of the multicast session.

detail extensive

Statistics

Rate at which packets are being forwarded for this source and group entry (in Kbps and pps), and number of packets that have been forwarded to this prefix. If one or more of the kilobits per second packet forwarding statistic queries fails or times out, the statistics field displays Forwarding statistics are not available.

detail extensive

Next-hop ID

Next-hop identifier of the prefix. The identifier is returned by the routing device’s Packet Forwarding Engine and is also displayed in the output of the show multicast nexthops command.

detail extensive

Upstream protocol

Protocol running on the interface on which the packet with this source prefix is expected to arrive.

detail extensive

Route state

Whether the group is Active or Inactive.

extensive

Forwarding state

Whether the prefix is pruned or forwarding.

extensive

Cache lifetime/timeout

Number of seconds until the prefix is removed from the multicast forwarding table. A value of never indicates a permanent forwarding entry.

extensive

Wrong incoming interface notifications

Number of times that the upstream interface was not available.

extensive

Sample Output

show multicast route

user@host> show multicast route
Family: INET

Group: 228.0.0.0
    Source: 10.255.14.144/32
    Upstream interface: local
    Downstream interface list:
        so-1/0/0.0

Group: 239.1.1.1
    Source: 10.255.14.144/32
    Upstream interface: local
    Downstream interface list:
        so-1/0/0.0

Group: 239.1.1.1
    Source: 10.255.70.15/32
    Upstream interface: so-1/0/0.0
    Downstream interface list:
        mt-1/1/0.49152

Family: INET6

show multicast route brief

The output for the show multicast route brief command is identical to that for the show multicast route command. For sample output, see show multicast route.

show multicast route detail

user@host> show multicast route detail
Family: INET

Group: 228.0.0.0
    Source: 10.255.14.144/32
    Upstream interface: local
    Downstream interface list:
        so-1/0/0.0
    Session description: Unknown
    Statistics: 8 kBps, 100 pps, 45272 packets
    Next-hop ID: 262142
    Upstream protocol: PIM

Group: 239.1.1.1
    Source: 10.255.14.144/32
    Upstream interface: local
    Downstream interface list:
        so-1/0/0.0
    Session description: Administratively Scoped
    Statistics: 0 kBps, 0 pps, 13404 packets
    Next-hop ID: 262142
    Upstream protocol: PIM

Group: 239.1.1.1
    Source: 10.255.70.15/32
    Upstream interface: so-1/0/0.0
    Downstream interface list:
        mt-1/1/0.49152
    Session description: Administratively Scoped
    Statistics: 0 kBps, 0 pps, 38 packets
    Next-hop ID: 262143
    Upstream protocol: PIM

Family: INET6

show multicast route extensive

user@host> show multicast route extensive
Family: INET

Group: 228.0.0.0
    Source: 10.255.14.144/32
    Upstream interface: local
    Downstream interface list:
        so-1/0/0.0
    Session description: Unknown
    Statistics: 8 kBps, 100 pps, 46454 packets
    Next-hop ID: 262142
    Upstream protocol: PIM
    Route state: Active
    Forwarding state: Forwarding
    Cache lifetime/timeout: 360 seconds
    Wrong incoming interface notifications: 0

Group: 239.1.1.1
    Source: 10.255.14.144/32
    Upstream interface: local
    Downstream interface list:
        so-1/0/0.0
    Session description: Administratively Scoped
    Statistics: 0 kBps, 0 pps, 13404 packets
    Next-hop ID: 262142
    Upstream protocol: PIM
    Route state: Active
    Forwarding state: Forwarding
    Cache lifetime/timeout: 348 seconds
    Wrong incoming interface notifications: 0

Group: 239.1.1.1
    Source: 10.255.70.15/32
    Upstream interface: so-1/0/0.0
    Downstream interface list:
        mt-1/1/0.49152
    Session description: Administratively Scoped
    Statistics: 0 kBps, 0 pps, 40 packets
    Next-hop ID: 262143
    Upstream protocol: PIM
    Route state: Active
    Forwarding state: Forwarding
    Cache lifetime/timeout: 360 seconds
    Wrong incoming interface notifications: 1

Family: INET6

Published: 2010-07-13

Help
|
My Account
|
Log Out