Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show igmp interface

Syntax

Syntax (EX Series Switches and the QFX Series)

Description

Display information about Internet Group Management Protocol (IGMP)-enabled interfaces.

Options

none

Display standard information about all IGMP-enabled interfaces.

brief | detail

(Optional) Display the specified level of output.

interface-name

(Optional) Display information about the specified IGMP-enabled interface only.

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

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

Required Privilege Level

view

Output Fields

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

Table 1: show igmp interface Output Fields

Field Name

Field Description

Level of Output

Interface

Name of the interface.

All levels

Querier

Address of the routing device that has been elected to send membership queries.

All levels

State

State of the interface: Up or Down.

All levels

SSM Map Policy

Name of the source-specific multicast (SSM) map policy that has been applied to the IGMP interface.

All levels

Timeout

How long until the IGMP querier is declared to be unreachable, in seconds.

All levels

Version

IGMP version being used on the interface: 1 , 2 , or 3.

All levels

Groups

Number of groups on the interface.

All levels

Group limit

Maximum number of groups allowed on the interface. Any joins requested after the limit is reached are rejected.

All levels

Group threshold

Configured threshold at which a warning message is generated.

This threshold is based on a percentage of groups received on the interface. If the number of groups received reaches the configured threshold, the device generates a warning message.

All levels

Group log-interval

Time (in seconds) between consecutive log messages.

All levels

Immediate Leave

State of the immediate leave option:

  • On—Indicates that the router removes a host from the multicast group as soon as the router receives a leave group message from a host associated with the interface.

  • Off—Indicates that after receiving a leave group message, instead of removing a host from the multicast group immediately, the router sends a group query to determine if another receiver responds.

All levels

Promiscuous Mode

State of the promiscuous mode option:

  • On—Indicates that the router can accept IGMP reports from subnetworks that are not associated with its interfaces.

  • Off—Indicates that the router can accept IGMP reports only from subnetworks that are associated with its interfaces.

All levels

Distributed

State of IGMP, which, by default, takes place on the Routing Engine for MX Series routers but can be distributed to the Packet Forwarding Engine to provide faster processing of join and leave events.

  • On—distributed IGMP is enabled.

All levels

Passive

State of the passive mode option:

  • On—Indicates that the router can run IGMP on the interface but not send or receive control traffic such as IGMP reports, queries, and leaves.

  • Off—Indicates that the router can run IGMP on the interface and send or receive control traffic such as IGMP reports, queries, and leaves.

The passive statement enables you to selectively activate up to two out of a possible three available query or control traffic options. When enabled, the following options appear after the on state declaration:

  • send-general-query—The interface sends general queries.

  • send-group-query—The interface sends group-specific and group-source-specific queries.

  • allow-receive—The interface receives control traffic.

All levels

OIF map

Name of the OIF map (if configured) associated with the interface.

All levels

SSM map

Name of the source-specific multicast (SSM) map (if configured) used on the interface.

All levels

Configured Parameters

Information configured by the user:

  • IGMP Query Interval—Interval (in seconds) at which this router sends membership queries when it is the querier.

  • IGMP Query Response Interval—Time (in seconds) that the router waits for a report in response to a general query.

  • IGMP Last Member Query Interval—Time (in seconds) that the router waits for a report in response to a group-specific query.

  • IGMP Robustness Count—Number of times the router retries a query.

All levels

Derived Parameters

Derived information:

  • IGMP Membership Timeout—Timeout period (in seconds) for group membership. If no report is received for these groups before the timeout expires, the group membership is removed.

  • IGMP Other Querier Present Timeout—Time (in seconds) that the router waits for the IGMP querier to send a query.

All levels

Sample Output

show igmp interface

show igmp interface brief

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

show igmp interface detail

The output for the show igmp interface detail command is identical to that for the show igmp interface command. For sample output, see show igmp interface.

show igmp interface <interface-name>

Release Information

Command introduced before Junos OS Release 7.4.