06 IP组播命令参考

05-IGMP命令

1 IGMP

1.1 IGMP配置命令

1.1.1 display igmp group

1.1.2 display igmp interface

1.1.3 display igmp ssm-mapping

1.1.4 igmp

1.1.5 igmp enable

1.1.6 igmp fast-leave

1.1.7 igmp group-policy

1.1.8 igmp last-member-query-count

1.1.9 igmp last-member-query-interval

1.1.10 igmp max-response-time

1.1.11 igmp other-querier-present-interval

1.1.12 igmp query-interval

1.1.13 igmp robust-count

1.1.14 igmp startup-query-count

1.1.15 igmp startup-query-interval

1.1.16 igmp static-group

1.1.17 igmp version

1.1.18 last-member-query-count (IGMP view)

1.1.19 last-member-query-interval (IGMP view)

1.1.20 max-response-time (IGMP view)

1.1.21 other-querier-present-interval (IGMP view)

1.1.22 query-interval (IGMP view)

1.1.23 reset igmp group

1.1.24 robust-count (IGMP view)

1.1.25 ssm-mapping (IGMP view)

1.1.26 startup-query-count (IGMP view)

1.1.27 startup-query-interval (IGMP view)

1 IGMP

本章中所指的“接口”为三层口，包括VLAN接口、三层以太网接口等。三层以太网接口是指在以太网接口视图下通过port link-mode route命令切换为三层模式的以太网接口，有关以太网接口模式切换的操作，请参见“二层技术-以太网交换配置指导”中的“以太网接口配置”。

1.1 IGMP配置命令

字段	描述
IGMP groups in total	IGMP组播组的总数
IGMP groups reported in total	当前接口上动态加入的IGMP组播组总数
Group address	组播组地址
Last reporter	最后发送报告报文的主机地址
Uptime	组播组的运行时间
Expires	组播组的超时时间，Off表示该定时器关闭

字段	描述
IGMP groups reported in total	当前接口上动态加入的IGMP组播组总数
Group	组播组地址
Uptime	组播组的运行时间
Exclude expires	EXCLUDE模式下组播组的超时时间，Off表示该定时器关闭
Mapping expires	IGMP SSM Mapping规则所生成组播组的超时时间。只有运行IGMP SSM Mapping时才会显示本字段
Last reporter	最后发送报告报文的主机地址
Last-member-query-counter	最后组成员查询次数
Last-member-query-timer-expiry	最后组成员查询定时器的超时时间，Off表示该定时器关闭
Mapping last-member-query-counter	IGMP SSM Mapping规则所生成组播组的最后组成员查询次数。只有运行IGMP SSM Mapping时才会显示本字段
Mapping last-member-query-timer-expiry	IGMP SSM Mapping规则所生成组播组的最后组成员查询定时器的超时时间，Off表示该定时器关闭。只有运行IGMP SSM Mapping时才会显示本字段
Group mode	对组播源的过滤模式： · Include：表示INCLUDE模式 · Exclude：表示EXCLUDE模式 IGMPv1/v2本身并不区分过滤模式，但当运行IGMP SSM Mapping时，会根据具体配置以及加入的组播组来显示相应的模式；而当未运行IGMP SSM Mapping时，则固定显示为Exclude
Version1-host-present-timer-expiry	IGMPv1主机超时时间，Off表示该定时器关闭。只有运行IGMPv2或IGMPv3时才会显示本字段
Version2-host-present-timer-expiry	IGMPv2主机超时时间，Off表示该定时器关闭。只有运行IGMPv3时才会显示本字段
Mapping version1-host-present-timer-expiry	运行IGMP SSM Mapping时IGMPv1主机的超时时间，Off表示该定时器关闭。只有运行IGMP SSM Mapping时才会显示本字段
Source list (sources in total: 1)	组播源列表及总数。只有运行IGMPv3或IGMP SSM Mapping时才会显示本字段
Source	组播源地址。只有运行IGMPv3或IGMP SSM Mapping时才会显示本字段
Uptime	组播源的运行时间。只有运行IGMPv3或IGMP SSM Mapping时才会显示本字段
V3 expires	IGMPv3组播源的超时时间，Off表示该定时器关闭，“---”表示该组播源由IGMP SSM Mapping规则生成。只有运行IGMPv3或IGMP SSM Mapping时才会显示本字段
Mapping expires	IGMP SSM Mapping规则所生成组播源的超时时间。只有运行IGMP SSM Mapping时才会显示本字段
Last-member-query-counter	最后源组成员查询次数。只有运行IGMPv3或IGMP SSM Mapping时才会显示本字段
Last-member-query-timer-expiry	最后源组成员查询定时器的超时时间，Off表示该定时器关闭。只有运行IGMPv3或IGMP SSM Mapping时才会显示本字段

字段	描述
Entries in total	IGMP组播组的总数
Group address	组播组地址
Source address	组播源地址
Interface	接口名称
Expires	组播组的超时时间，固定显示为Never，表示永不超时

1.1.2 display igmp interface

display igmp interface命令用来显示接口上IGMP配置和运行的信息。

【命令】

display igmp [ vpn-instance vpn-instance-name ] interface [ interface-type interface-number ] [ verbose ]

interface-type interface-number：显示指定接口上的信息。如果未指定本参数，将显示所有接口上的信息。

verbose：显示详细信息。

【举例】

# 显示公网实例接口Vlan-interface1上IGMP配置和运行的详细信息。

<Sysname> display igmp interface vlan-interface 1 verbose

Vlan-interface1(10.10.1.20):

IGMP is enabled.

IGMP version: 2

Query interval for IGMP: 125s

Other querier present time for IGMP: 255s

Maximum query response time for IGMP: 10s

Last member query interval: 1s

Last member query count: 2

Startup query interval: 31s

Startup query count: 2

General query timer expiry (hh:mm:ss): 00:00:54

Querier for IGMP: 10.10.1.20 (This router)

IGMP activity: 1 join(s), 0 leave(s)

Multicast routing on this interface: Enabled

Robustness: 2

Require-router-alert: Disabled

Fast-leave: Disabled

Startup-query: Off

Other-querier-present-timer-expiry (hh:mm:ss): --:--:--

IGMP groups reported in total: 1

表1-4 display igmp interface命令显示信息描述表

字段	描述
Vlan-interface1(10.10.1.20)	接口的名称和IP地址
IGMP is enabled	IGMP已使能
IGMP version	此接口运行的IGMP版本
Query interval for IGMP	发送IGMP普遍组查询报文的时间间隔（秒）
Other querier present time for IGMP	IGMP其它查询器的存在时间（秒）
Maximum query response time for IGMP	IGMP普遍组查询的最大响应时间（秒）
Last member query interval	最后组成员查询间隔（秒）
Last member query count	最后组成员查询次数
Startup query interval	IGMP查询器启动查询间隔（秒）
Startup query count	IGMP查询器启动查询次数
General query timer expiry	IGMP普遍组查询的超时时间，Off表示该定时器关闭
Querier for IGMP	IGMP查询器的IP地址。当本设备运行IGMPv1且不是IGMPv1查询器时，将不会显示本字段 IGMPv1查询器由PIM DR来担任，可通过display pim interface命令查看
No querier elected	没有进行IGMP查询器选举。只有本设备运行IGMPv1且不是IGMPv1查询器时才会显示本字段 IGMPv1查询器由PIM DR来担任，可通过display pim interface命令查看
IGMP activity: 1 join(s), 0 leave(s)	IGMP的活动统计： · join(s)：表示加入过的组播组总数 · leave(s)：表示离开过的组播组总数
Multicast routing on this interface	是否使能组播路由与转发功能： · Enabled：表示已使能 · Disabled：表示未使能
Robustness	IGMP查询器的健壮系数
Require-router-alert	是否使能丢弃未携带Router-Alert选项的IGMP报文功能： · Enabled：表示已使能 · Disabled：表示未使能
Fast-leave	是否使能快速离开功能： · Enabled：表示已使能 · Disabled：表示未使能
Startup-query	是否处于启动查询状态： · On：表示处于启动查询状态 · Off：表示未处于启动查询状态
Other-querier-present-timer-expiry	IGMP其它查询器的存在超时时间，Off表示该定时器关闭
IGMP groups reported in total	此接口上动态加入的组播组数量。没有加入组时不显示本字段
Version1-querier-present-timer-expiry	IGMPv1查询器的存在超时时间
Version2-querier-present-timer-expiry	IGMPv2查询器的存在超时时间

1.1.3 display igmp ssm-mapping

display igmp ssm-mapping命令用来显示IGMP SSM Mapping规则。

【命令】

display igmp [ vpn-instance vpn-instance-name ] ssm-mapping group-address

group-address：显示指定组播组的信息，取值范围为224.0.1.0～239.255.255.255。

【举例】

# 显示公网实例中组播组232.1.1.1对应的IGMP SSM Mapping规则。

<Sysname> display igmp ssm-mapping 232.1.1.1

Group: 232.1.1.1

Source list:

1.2.3.4

5.5.5.5

10.1.1.1

100.1.1.10

表1-5 display igmp ssm-mapping命令显示信息描述表

字段	描述
Group	组播组地址
Source list	组播源地址列表

1.1.4 igmp

igmp命令用来进入IGMP视图。

undo igmp命令用来清除IGMP视图下的所有配置。

【命令】

igmp [ vpn-instance vpn-instance-name ]

undo igmp [ vpn-instance vpn-instance-name ]

vpn-instance vpn-instance-name：指定VPN实例，vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，表示公网实例。

【举例】

# 进入公网实例的IGMP视图。

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp]

# 进入VPN实例mvpn的IGMP视图。

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn]

1.1.5 igmp enable

igmp enable命令用来在接口上使能IGMP。

undo igmp enable命令用来在接口上关闭IGMP。

【命令】

igmp enable

undo igmp enable

接口上的IGMP处于关闭状态。

· 只有在相应实例中先使能了IP组播路由，本命令才能生效。

· 只有在接口上使能了IGMP，在该接口上所做的IGMP配置才能生效。

【举例】

# 使能公网实例中的IP组播路由，并在接口Vlan-interface100上使能IGMP。

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp enable

【相关命令】

· multicast routing（IP组播命令参考/组播路由与转发）

1.1.6 igmp fast-leave

igmp fast-leave命令用来在接口上使能组播组成员快速离开功能。

undo igmp fast-leave命令用来在接口上关闭组播组成员快速离开功能。

【命令】

igmp fast-leave [ group-policy acl-number ]

undo igmp fast-leave

【缺省情况】

组播组成员快速离开功能处于关闭状态，即IGMP查询器在收到主机发送的IGMP离开组报文后将发送IGMP特定组查询报文或IGMP特定源组查询报文，而不会直接向上游发送离开通告。

acl-number：指定IPv4基本ACL的编号，取值范围为2000～2999。如果指定了本参数，快速离开功能将只为该ACL规则所允许的组播组服务；如果未指定本参数、指定的ACL不存在或ACL中未配置有效规则，则快速离开功能将为所有组播组服务。

【使用指导】

ACL规则中的source参数用来指定组播组的范围，若指定了vpn-instance参数则此规则不生效，而除fragment和time-range以外的其它可选参数都将被忽略。

【举例】

# 在接口Vlan-interface100上使能组播组成员快速离开功能。

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp fast-leave

1.1.7 igmp group-policy

igmp group-policy命令用来在接口上配置组播组过滤器，以限定该接口下的主机所能加入的组播组。

undo igmp group-policy命令用来在接口上删除组播组过滤器。

【命令】

igmp group-policy acl-number [ version-number ]

undo igmp group-policy

【缺省情况】

接口上没有配置组播组过滤器，即该接口下的主机可以加入任意组播组。

acl-number：指定IPv4基本或高级ACL的编号，取值范围为2000～3999。主机只能加入该ACL规则中所允许的组播组。当指定的ACL不存在或ACL中未配置有效规则，将过滤掉所有组播组。

version-number：指定IGMP的版本号，取值范围为1～3。缺省情况下，系统同时支持对IGMPv1、IGMPv2和IGMPv3报告报文的过滤。

【使用指导】

· 对于IPv4基本ACL，该ACL规则中的source参数用来指定IGMP报文中的组播组地址范围，若指定了vpn-instance参数则此规则不生效，而除fragment和time-range以外的其它可选参数都将被忽略。

· 对于IPv4高级ACL，该ACL规则中的source参数用来指定IGMP报文中的组播源地址（对于IGMPv1/v2报文和未携带组播源地址的IS_EX/TO_EX类型的IGMPv3报文，视其组播源地址为0.0.0.0）范围，destination参数用来指定组播组地址范围，若指定了vpn-instance参数则此规则不生效，而除fragment和time-range以外的其它可选参数都将被忽略。

· 由于本命令只能过滤IGMP报文，因此无法对接口静态加入组播组或组播源组进行限制。

【举例】

# 限定接口Vlan-interface100下的主机只能加入组播组225.1.1.1。

<Sysname> system-view

[Sysname] acl number 2005

[Sysname-acl-basic-2005] rule permit source 225.1.1.1 0

[Sysname-acl-basic-2005] quit

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp group-policy 2005