Technical Documentation

show pim interfaces

Syntax

show pim interfaces<inet | inet6><instance instance-name><logical-system (all | logical-system-name)>

Syntax (EX Series Switch)

show pim interfaces<inet | inet6><instance instance-name>

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 information about the interfaces on which Protocol Independent Multicast (PIM) is configured.

Options

none: Display interface information for all family addresses for all routing instances.
inet | inet6: (Optional) Display interface information for IPv4 or IPv6 family addresses, respectively.
instance instance-name: (Optional) Display information about interfaces for a specific PIM-enabled routing instance.
logical-system (all | logical-system-name): (Optional) Perform this operation on all logical systems or on a particular logical system.

Required Privilege Level

view

List of Sample Output

show pim interfaces
show pim interfaces inet
show pim interfaces inet6

Output Fields

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

Table 1: show pim interfaces Output Fields

Field Name	Field Description
Instance	Name of the routing instance.
Name	Interface name.
State	State of the interface. The state also is displayed in the show interfaces command.
Mode	PIM mode running on the interface: Sparse—In sparse mode, routing devices must join and leave multicast groups explicitly. Upstream routing devices do not forward multicast traffic to this routing device unless this device has sent an explicit request (using a join message) to receive multicast traffic. Dense—Unlike sparse mode, where data is forwarded only to routing devices sending an explicit request, dense mode implements a flood-and-prune mechanism, similar to DVMRP (the first multicast protocol used to support the multicast backbone). Sparse-Dense—Sparse-dense mode allows the interface to operate on a per-group basis in either sparse or dense mode. A group specified as dense is not mapped to a rendezvous point (RP). Instead, data packets destined for that group are forwarded using PIM-Dense Mode (PIM-DM) rules. A group specified as sparse is mapped to an RP, and data packets are forwarded using PIM-Sparse Mode (PIM-SM) rules.
IP	Version number of the address family on the interface: 4 (IPv4) or 6 (IPv6).
V	PIM version running on the interface: 1 or 2.
State	State of PIM on the interface: DR—Designated router. NotDR—Not the designated router. P2P—Point to point.
NbrCnt	Number of neighbors that have been seen on the interface.
JoinCnt(sg)	Number of (s,g) join messages that have been seen on the interface.
JointCnt(*g)	Number of (*,g) join messages that have been seen on the interface.
DR address	Address of the designated router.

Sample Output

show pim interfaces

user@host> show pim interfaces

Instance: PIM.master

Name               Stat Mode       IP V State NbrCnt JoinCnt(sg) JointCnt(*g) DR address
fe-0/0/0.0         Up   Sparse      4 2 DR         1           1            3 10.10.10.2
fe-0/0/3.0         Up   Sparse      4 2 DR         1           1            3 20.20.20.2
lo0.0              Up   Sparse      4 2 DR         0           0            0 10.255.72.54
pe-1/2/0.32769     Up   Sparse      4 2 P2P        0           0            0
t1-0/1/0.0         Up   Sparse      4 2 P2P        1           0            0
lo0.0              Up   Sparse      6 2 DR         0           0            0 fe80::2a0:a5ff:fe5e:209

show pim interfaces inet

user@host> show pim interfaces inet

Instance: PIM.master

Name               Stat Mode       IP V State NbrCnt JoinCnt(sg) JointCnt(*g) DR address
fe-0/0/0.0         Up   Sparse      4 2 DR         1           1            3 10.10.10.2
fe-0/0/3.0         Up   Sparse      4 2 DR         1           1            3 20.20.20.2
lo0.0              Up   Sparse      4 2 DR         0           0            0 10.255.72.54
pe-1/2/0.32769     Up   Sparse      4 2 P2P        0           0            0
t1-0/1/0.0         Up   Sparse      4 2 P2P        1           0            0

show pim interfaces inet6

user@host> show pim interfaces inet6

Instance: PIM.master

Name               Stat Mode       IP V State NbrCnt JoinCnt(sg) JointCnt(*g) DR address
lo0.0              Up   Sparse      6 2 DR         0           0            0 fe80::2a0:a5ff:fe5e:209