09-IP组播命令参考

anycast-rp anycast-rp-address member-address

undo anycast-rp anycast-rp-address member-address

PIM视图

anycast-rp-address：指定Anycast-RP地址。必须是除127.0.0.0/8网段以外的合法单播IP地址。

member-address：指定Anycast-RP成员地址。必须是除127.0.0.0/8网段以外的合法单播IP地址，不能与anycast-rp-address相同。

本命令可重复配置，配置时如果指定了相同的Anycast-RP地址，则将Anycast-RP成员地址添加到该Anycast-RP地址所属的Anycast-RP集中。

# 在公网实例中配置如下Anycast-RP集：Anycast-RP地址为1.1.0.0，两个成员的地址分别为1.1.0.1和1.2.0.1（前者为本地接口LoopBack1的地址）。

[Sysname] pim

[Sysname-pim] anycast-rp 1.1.0.0 1.1.0.1

[Sysname-pim] anycast-rp 1.1.0.0 1.2.0.1

· display pim rp-info

1.1.2 bidir-pim enable (PIM view)

bidir-pim enable命令用来使能双向PIM。

undo bidir-pim enable命令用来关闭双向PIM。

undo bidir-pim enable

bidir-pim enable

双向PIM处于关闭状态。

PIM视图

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

# 使能公网实例中的IP组播路由，并使能双向PIM。

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] pim

[Sysname-pim] bidir-pim enable

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

1.1.3 bidir-rp-limit (PIM view)

bidir-rp-limit命令用来配置双向PIM RP的最大数目。

undo bidir-rp-limit命令用来恢复缺省情况。

bidir-rp-limit limit

undo bidir-rp-limit

缺省情况下，双向PIM RP的最大数目为6。

PIM视图

limit：指定双向PIM RP的最大数目，取值范围为1到系统所允许的最大值。

设备各款型对于本节所描述的参数的支持情况有所不同，详细差异信息如下：

型号	参数	描述
MSR 2630	limit	1~64
MSR3600-28/3600-51		1~64
MSR 3610/3620/3620-DP/3640/3660		1~128
MSR 5620/5660/5680		1~256
MSR2600-10-X1		1~64

由于双向PIM为每个RP都要在所有PIM接口上进行DF选举，因此实际组网中不建议配置多个双向PIM RP。通过本命令可以限制双向PIM RP的数目，超出限制值的RP不会生效，仅能进行DF选举而无法指导转发。

# 在公网实例中配置双向PIM RP的最大数目为3。

[Sysname] pim

[Sysname-pim] bidir-rp-limit 3

1.1.4 bsm-fragment enable (PIM view)

bsm-fragment enable命令用来使能自举报文语义分片功能。

undo bsm-fragment enable命令用来关闭自举报文语义分片功能。

bsm-fragment enable

undo bsm-fragment enable

PIM视图

当PIM-SM域中存在不支持自举报文语义分片的设备时，请关闭本功能。

# 在公网实例中关闭自举报文语义分片功能。

[Sysname] pim

[Sysname-pim] undo bsm-fragment enable

1.1.5 bsr-policy (PIM view)

bsr-policy命令用来配置合法的BSR地址范围，以防止BSR欺骗。

undo bsr-policy命令用来取消BSR地址范围的限制。

bsr-policy acl-number

undo bsr-policy

BSR的地址范围不受任何限制，即认为来自任意源的自举报文都是合法的。

PIM视图

acl-number：指定IPv4基本ACL的编号，取值范围为2000～2999。

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

# 在公网实例中配置合法的BSR地址范围，只允许网段10.1.1.0/24中的设备充当BSR。

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 10.1.1.0 0.0.0.255

[Sysname-acl-basic-2000] quit

[Sysname] pim

[Sysname-pim] bsr-policy 2000

· c-bsr (PIM view)

1.1.6 c-bsr (PIM view)

c-bsr命令用来配置C-BSR。

undo c-bsr命令用来删除C-BSR的相关配置。

c-bsr ip-address [ scope group-address { mask-length | mask } ] [ hash-length hash-length | priority priority ] *

undo c-bsr ip-address [ scope group-address { mask-length | mask } ]

PIM视图

ip-address：指定C-BSR的IP地址。

scope group-address：指定管理域C-BSR所服务的组播组地址，取值范围为239.0.0.0～239.255.255.255。如果未指定本参数，表示配置服务于Global域的C-BSR。

mask-length：指定组播组地址的掩码长度，取值范围为8～32。

mask：指定组播组地址的掩码。

hash-length hash-length：指定哈希掩码长度，取值范围为0～32，缺省值为30。

priority priority：指定C-BSR的优先级，取值范围为0～255，缺省值为64。数值越大，优先级越高。

· C-BSR的IP地址必须有对应的本地接口，且该接口上必须使能PIM，否则配置不会生效。

· 如果对同一个域多次执行本命令，新配置将覆盖旧配置；而针对不同域的C-BSR则允许指定相同的IP地址。

# 在公网实例中将IP地址为1.1.1.1的设备配置为Global域的C-BSR。

[Sysname] pim

[Sysname-pim] c-bsr 1.1.1.1

1.1.7 c-rp (PIM view)

c-rp命令用来配置C-RP。

undo c-rp命令用来删除C-RP的相关配置。

c-rp ip-address [ advertisement-interval adv-interval | group-policy acl-number | holdtime hold-time | priority priority ] * [ bidir ]

undo c-rp ip-address

PIM视图

ip-address：指定C-RP的IP地址。

advertisement-interval adv-interval：指定发送宣告报文的间隔时间，取值范围为1～65535，单位为秒，缺省值为60秒。

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

holdtime hold-time：指定C-RP的超时时间，取值范围为1～65535，单位为秒，缺省值为150秒。

priority priority：指定C-RP的优先级，取值范围为0～255，缺省值为192。数值越大，优先级越低。

bidir：指定该C-RP服务于双向PIM。如果未指定本参数，该C-RP将服务于PIM-SM。

· C-RP的IP地址必须有对应的本地接口，且该接口上必须使能PIM，否则配置不会生效。

· ACL规则中的source参数用来指定C-RP所服务的组播组范围（若指定的不是组播组地址，则此规则不生效），而其它可选参数都将被忽略。该ACL规则用来定义该C-RP所服务的组播组范围，只有permit的组播组都才会作为RP的服务组范围通告出去。

· 如果设备想要成为多个组范围的C-RP，则需要在配置group-policy所对应的ACL时将多个组范围用多个rule规则表示出来。

· 如果对同一IP地址多次执行本命令，新配置将覆盖旧配置。

# 在公网实例中将IP地址为1.1.1.1配置为225.1.0.0/16和226.2.0.0/16的C-RP，且C-RP的优先级为10。

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 225.1.0.0 0.0.255.255

[Sysname-acl-basic-2000] rule permit source 226.2.0.0 0.0.255.255

[Sysname-acl-basic-2000] quit

[Sysname] pim

[Sysname-pim] c-rp 1.1.1.1 group-policy 2000 priority 10

1.1.8 crp-policy (PIM view)

crp-policy命令用来配置合法的C-RP地址范围及其服务的组播组范围，以防止C-RP欺骗。

undo crp-policy命令用来取消C-RP地址范围及其服务的组播组范围的限制。

crp-policy acl-number

undo crp-policy

C-RP地址范围及其服务的组播组范围不受任何限制，即认为所有收到的C-RP报文都是合法的。

PIM视图

acl-number：指定IPv4高级ACL的编号，取值范围为3000～3999。

· ACL规则中的source参数用来指定合法C-RP的地址范围，destination参数用来指定该C-RP所服务的组播组地址范围，若指定了vpn-instance参数则此规则不生效，而除fragment和time-range以外的其它可选参数都将被忽略。

· 本命令在对C-RP所宣告的组播组范围进行过滤时，只取其前缀部分进行匹配。例如，C-RP宣告的组播组范围为224.1.0.0/16，如果其前缀部分“224.1.0.0”能匹配上本命令所引用的ACL规则，就认为整个组播组范围“224.1.0.0/16”都通过了过滤。

# 在公网实例中配置C-RP策略，只允许1.1.1.1/24范围内的设备充当C-RP，且只允许其为225.1.1.0/24范围内的组播组服务。

[Sysname] acl number 3000

[Sysname-acl-adv-3000] rule permit ip source 1.1.1.1 0.0.0.255 destination 225.1.1.0 0.0.0.255

[Sysname-acl-adv-3000] quit

[Sysname] pim

[Sysname-pim] crp-policy 3000

· c-rp (PIM view)

1.1.9 display interface register-tunnel

display interface register-tunnel命令用来显示Register-Tunnel接口的相关信息。

display interface [ register-tunnel [ interface-number ] ] [ brief [ description | down ] ]

register-tunnel：显示指定Register-Tunnel接口的信息。

interface-number：表示Register-Tunnel接口的编号。设备上只存在一个Register-Tunnel接口，其编号为0。

brief：显示概要信息。如果未指定本参数，将显示详细信息。

description：当用户配置的接口描述信息超过27个字符时，在概要信息中显示完整的接口描述信息。如果未指定本参数，在概要信息中将只显示前27个字符，超出部分不会显示。

down：显示当前物理状态为down的接口的信息以及down的原因。如果未指定本参数，将不会根据接口物理状态来过滤显示信息。

· 如果未指定接口类型，将显示设备支持的所有接口的信息。

Register-Tunnel接口是在组播源注册过程初期，用于在组播源侧DR与RP之间建立一个传输注册报文的通道，具体过程为：当组播源侧DR第一次收到组播源发来的组播数据时，由于组播源侧DR与RP之间尚未建立SPT，于是组播源侧DR通过其Register-Tunnel接口将封装到注册报文中的组播数据发给RP，而RP也通过其Register-Tunnel接口接收注册报文，并将解封装后的组播数据转发给接收者。

在上述过程中，RP从组播数据中获取到了组播源的位置，于是向组播源方向发送加入报文并最终建立起SPT。此后，组播源侧DR便不再通过Register-Tunnel接口，而是通过SPT将组播数据发送给RP。

需要注意的是：

· 由于设备上只存在一个Register-Tunnel接口（即Register-Tunnel0），因此只要指定了register-tunnel参数，不论是否指定interface-number参数，都将显示接口Register-Tunnel0的相关信息。

<Sysname> display interface register-tunnel 0

# 显示接口Register-Tunnel0的详细信息。

Current state: UP

Line protocol state: DOWN

Description: Register-Tunnel0 Interface

Maximum Transmit Unit: 1536

Internet protocol processing: disabled

Physical: Unknown

Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec

Last 300 seconds output rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec

Input: 0 packets, 0 bytes, 0 drops

Output: 0 packets, 0 bytes, 0 drops

# 显示接口Register-Tunnel0的概要信息。

<Sysname> display interface register-tunnel 0 brief

Brief information on interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Protocol Main IP Description

REG0 UP -- --

表1-1 display interface register-tunnel命令显示信息描述表

字段	描述
Current state	接口的物理状态，Register-Tunnel接口的物理状态始终为UP
Line protocol state	接口的链路状态，Register-Tunnel接口的链路状态始终为DOWN
Description	接口的描述信息，不可配置
Maximum Transmit Unit	接口的最大传输单元，不可配置
Internet protocol processing	接口能否配置IP地址，始终为disabled，表示不能
Physical	接口的物理类型，始终为Unknown，表示未知
Last 300 seconds input rate	最近300秒钟的平均输入速率，始终均为0
Last 300 seconds output rate	最近300秒钟的平均输出速率，始终均为0
Input	接口输入的报文数、字节数、丢弃报文数，始终均为0
Output	接口输出的报文数、字节数、丢弃报文数，始终均为0
Brief information on interface(s) under route mode	三层接口的概要信息
Link: ADM - administratively down; Stby - standby	接口的物理连接状态： · UP：表示接口在物理上连通 · DOWN：表示接口在物理上不通 · ADM：表示接口被手工关闭，需执行undo shutdown命令才能打开 · Stby：表示接口为备份接口，可使用display interface-backup state命令查看其主接口
Protocol: (s) - spoofing	如果某接口的Protocol属性值中带有“(s)”，表示该接口的数据链路层协议状态显示为UP，但实际可能没有对应的链路，或者对应的链路不是永久存在而是按需建立的。通常NULL、LoopBack等接口会具有该属性
Protocol	接口的协议连接状态，对Register-Tunnel接口无意义，始终为“--”
Main IP	接口的IP地址，不可配置。对Register-Tunnel接口无意义，始终为“--”
Cause	接口物理状态为down的原因，始终为Not connected，表示没有物理连接

1.1.10 display pim bsr-info

display pim bsr-info命令用来显示PIM-SM域中的BSR信息。

display pim [ vpn-instance vpn-instance-name ] bsr-info

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

<Sysname> display pim bsr-info

# 显示公网实例PIM-SM域中的BSR信息。

Scope: non-scoped

State: Accept Preferred

Bootstrap timer: 00:01:44

Elected BSR address: 12.12.12.1

Priority: 64

Hash mask length: 30

Uptime: 00:21:56

Scope: 239.4.0.0/16

State: Accept Any

Scope-zone expiry timer: 00:21:12

Scope: 239.1.0.0/16

State: Elected

Bootstrap timer: 00:00:26

Elected BSR address: 17.1.11.1

Priority: 64

Hash mask length: 30

Uptime: 02:53:37

Candidate BSR address: 17.1.11.1

Priority: 64

Hash mask length: 30

Scope: 239.2.2.0/24

State: Candidate

Bootstrap timer: 00:01:56

Elected BSR address: 61.2.37.1

Priority: 64

Hash mask length: 30

Uptime: 02:53:32

Candidate BSR address: 17.1.12.1

Priority: 64

Hash mask length: 30

Scope: 239.3.3.0/24

State: Pending

Bootstrap timer: 00:00:07

Candidate BSR address: 17.1.13.1

Priority: 64

Hash mask length: 30

表1-2 display pim bsr-info命令显示信息描述表

字段	描述
Scope	域
State	域状态
Bootstrap timer	BSR定时器
Scope-zone expiry timer	域老化定时器
Elected BSR address	当选BSR的地址
Candidate BSR address	候选BSR的地址
Priority	BSR的优先级
Hash mask length	哈希掩码长度
Uptime	BSR已存在的时间

1.1.11 display pim claimed-route

display pim claimed-route命令用来显示PIM所使用的路由信息。

display pim [ vpn-instance vpn-instance-name ] claimed-route [ source-address ]

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

source-address：组播源的IP地址，显示到达指定组播源的路由信息。如果未指定本参数，将显示PIM所使用的所有路由信息。

<Sysname> display pim claimed-route

# 显示PIM在公网实例中使用的所有路由信息。

RPF-route selecting rule: longest-match

Route/mask: 7.11.0.0/16 (unicast (direct))

RPF interface: Vlan-interface2, RPF neighbor: 8.0.0.2

Total number of (S,G) or (*,G) dependent on this route entry: 4

(7.11.0.10, 225.1.1.1)

(7.11.0.10, 226.1.1.1)

(7.11.0.10, 227.1.1.1)

(*, 228.1.1.1)

Route/mask: 7.12.0.0/16 (multicast static)

RPF interface: Vlan-interface2, RPF neighbor: 8.0.0.3,

Config NextHop: 8.0.0.5

Total number of (S,G) or (*,G) dependent on this route entry: 2

(7.12.0.10, 226.1.1.1)

(7.12.0.10, 225.1.1.1)

表1-3 display pim claimed-route命令显示信息描述表

字段	描述
RPF-route selecting rule	RPF路由的选择规则
Route/mask	路由项。括号内为路由类型，包括： · igp：单播路由（内部网关协议） · egp：单播路由（外部网关协议） · unicast (direct)：单播路由（直连） · unicast：其它单播路由（如单播静态路由等） · mbgp：MBGP路由 · multicast static：组播静态路由
RPF interface	RPF接口的名称
RPF neighbor	RPF邻居的IP地址
Config NextHop	配置的下一跳地址，本字段只在组播静态路由配置下一跳时显示
Total number of (S,G) or (*,G) dependent on this route entry	基于此RPF路由的（S，G）或（*，G）个数及列表

1.1.12 display pim c-rp

display pim c-rp命令用来显示PIM-SM域中的C-RP信息。

display pim [ vpn-instance vpn-instance-name ] c-rp [ local ]

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

local：显示本地配置且生效的C-RP信息。如果未指定本参数，将显示所有学习到的C-RP信息。

只有当选的BSR上才会有学习到的C-RP信息，其它设备上只能查看到本地配置生效的C-RP信息。

<Sysname> display pim c-rp

# 显示公网实例中学习到的C-RP信息。

Scope: non-scoped

Group/MaskLen: 224.0.0.0/4

C-RP address Priority HoldTime Uptime Expires

1.1.1.1 (local) 192 150 03:01:36 00:02:29

2.2.2.2 192 150 1d:13h 00:02:02

Group/MaskLen: 226.1.1.0/24 [B] Expires: 00:00:33

Group/MaskLen: 225.1.0.0/16 [B]

C-RP Address Priority HoldTime Uptime Expires

3.3.3.3 192 150 12w:5d 00:02:05

# 显示本地配置生效的C-RP信息。

<Sysname> display pim c-rp local

Candidate RP: 12.12.12.9(Loop1)

Priority: 192

HoldTime: 150

Advertisement interval: 60

Next advertisement scheduled at: 00:00:48

表1-4 display pim c-rp命令显示信息描述表

字段	描述
Scope	域
Group/MaskLen	C-RP所服务的组播组
[B]	表示C-RP服务于双向PIM。如果未显示本字段，则表示服务于PIM-SM
C-RP address	C-RP的IP地址，local表示本地地址
Priority	C-RP的优先级
HoldTime	C-RP的超时时间
Uptime	C-RP已存在的时间，w表示星期，d表示天，h表示小时
Expires	C-RP/组播组的超时剩余时间
Candidate RP	本地C-RP的IP地址
Advertisement interval	本地C-RP发送通告报文时间间隔
Next advertisement scheduled at	本地C-RP发送下一个通告报文的剩余时间

1.1.13 display pim df-info

display pim df-info命令用来显示双向PIM的DF信息。

display pim [ vpn-instance vpn-instance-name ] df-info [ rp-address ]

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

rp-address：指定双向PIM的RP地址。

<Sysname> display pim df-info

# 显示公网实例中双向PIM的DF信息。

RP address: 1.1.0.3

Interface State DF-Pref DF-Metric DF-Uptime DF-Address

GE2/0/1 Lose 0 0 00:20:13 8.13.0.3

Vlan2 Win 10 1 00:20:12 7.11.0.1 (local)

表1-5 display pim df-info命令显示信息描述表

字段	描述
RP address	双向PIM的RP地址
Interface	接口名称
State	DF的选举状态： · Win：竞选DF成功 · Lose：竞选DF落败 · Offer：竞选DF的初始状态 · Backoff：正在充当DF，但有更优的设备正在竞选DF · -：不参与DF竞选
DF-Pref	DF通告的路由优先级
DF-Metric	DF通告的路由度量值
DF-Uptime	DF已存在的时间
DF-Address	DF的IP地址，local表示本地地址

1.1.14 display pim interface

display pim interface命令用来显示接口上的PIM信息。

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

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

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

verbose：显示详细信息。如果未指定本参数，将显示概要信息。

<Sysname> display pim interface

# 显示公网实例所有接口上的PIM概要信息。

Interface NbrCnt HelloInt DR-Pri DR-Address

GE2/0/1 1 30 1 10.1.1.2

GE2/0/2 0 30 1 172.168.0.2 (local)

GE2/0/3 1 30 1 20.1.1.2

表1-6 display pim interface命令显示信息描述表

字段	描述
Interface	接口名称
NbrCnt	PIM邻居的数量
HelloInt	发送Hello报文的时间间隔
DR-Pri	竞选DR的优先级
DR-Address	DR的IP地址，local表示本地地址

# 显示公网实例接口GigabitEthernet2/0/1上的PIM详细信息。

<Sysname> display pim interface gigabitethernet 2/0/1 verbose

Interface: GigabitEthernet2/0/1, 10.1.1.1

PIM version: 2

PIM mode: Sparse

PIM DR: 10.1.1.2

PIM DR Priority (configured): 1

PIM neighbor count: 1

PIM hello interval: 30 s

PIM LAN delay (negotiated): 500 ms

PIM LAN delay (configured): 500 ms

PIM override interval (negotiated): 2500 ms

PIM override interval (configured): 2500 ms

PIM neighbor tracking (negotiated): disabled

PIM neighbor tracking (configured): disabled

PIM generation ID: 0xF5712241

PIM require generation ID: disabled

PIM hello hold interval: 105 s

PIM assert hold interval: 180 s

PIM triggered hello delay: 5 s

PIM J/P interval: 60 s

PIM J/P hold interval: 210 s

PIM BSR domain border: disabled

PIM BFD: disabled

Number of routers on network not using DR priority: 0

Number of routers on network not using LAN delay: 0

Number of routers on network not using neighbor tracking: 2

表1-7 display pim interface verbose命令显示信息描述表

字段	描述
Interface	接口名称与IP地址
PIM version	PIM协议的版本号
PIM mode	PIM协议的模式，是密集模式还是稀疏模式
PIM DR	DR的IP地址
PIM DR Priority (configured)	竞选DR优先级的配置值
PIM neighbor count	PIM邻居的总数
PIM hello interval	发送Hello报文的时间间隔
PIM LAN delay (negotiated)	剪枝报文传输延迟的协商值
PIM LAN delay (configured)	剪枝报文传输延迟的配置值
PIM override interval (negotiated)	剪枝否决时间的协商值
PIM override interval (configured)	剪枝否决时间的配置值
PIM neighbor tracking (negotiated)	邻居跟踪使能与否的协商情况
PIM neighbor tracking (configured)	邻居跟踪使能与否的配置情况
PIM generation ID	Generation_ID参数值
PIM require generation ID	是否使能不接受无Generation ID的Hello报文
PIM hello hold interval	保持PIM邻居的可达状态的时间
PIM assert hold interval	保持断言状态的时间
PIM triggered hello delay	发送Hello报文的最大延迟时间
PIM J/P interval	发送加入/剪枝报文的时间间隔
PIM J/P hold interval	加入/剪枝状态的保持时间
PIM BSR domain border	该接口是否配置了BSR的服务边界
PIM BFD	该接口是否使能了PIM与BFD联动功能
Number of routers on network not using DR priority	该接口所在网段上没有使用DR优先级字段的路由器数量
Number of routers on network not using LAN delay	该接口所在网段上未使用LAN-delay字段的路由器数量
Number of routers on network not using neighbor tracking	该接口所在网段上未使能邻居跟踪的路由器数量

1.1.15 display pim nbma-link

display pim nbma-link 命令用来显示PIM模块维护的ADVPN隧道接口上对端的信息。

display pim [ vpn-instance vpn-instance-name ] nbma-link [ interface { interface-type interface-number } ]

interface interface-type interface-number：接口类型和接口编号，显示指定接口上的PIM维护的ADVPN隧道接口上对端的信息。如果未指定本参数，将显示所有ADVPN隧道接口上对端的信息。

<Sysname> display pim nbma-link

#显示公网所有PIM维护的ADVPN隧道接口上对端的信息。

Interface: Tunnel1

Number of links: 1

Remote address: 10.0.0.1

Private index : 0XCC000000

Private interface: Multicast-NBMA0

Interface: Tunnel2

Number of links: 1

Remote address: 20.0.0.2

Private index : 0XCC000001

Private interface: Multicast-NBMA1

#显示公网指定PIM维护的ADVPN隧道接口上对端的信息。

<Sysname> display pim nbma-link interface tunnel 1

Interface: Tunnel1

Number of links: 1

Remote address: 10.0.0.1

Private index : 0XCC000000

Private interface: Multicast-NBMA0

表1-8 display pim nbma-link命令显示信息描述表

字段	描述
Interface	隧道接口名称
Number of links	该隧道下的远端连接的个数
Remote address	远端连接的地址
Private index	对应远端连接的索引
Private interface	对应远端连接的接口

1.1.16 display pim neighbor

display pim neighbor命令用来显示PIM邻居信息。

display pim [ vpn-instance vpn-instance-name ] neighbor [ neighbor-address | interface interface-type interface-number | verbose ] *

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

neighbor-address：PIM邻居的IP地址，显示指定PIM邻居的信息。如果未指定本参数，将显示所有PIM邻居的信息。

interface interface-type interface-number：接口类型和接口编号，显示指定接口上的PIM邻居信息。如果未指定本参数，将显示所有接口上的PIM邻居信息。

verbose：显示详细信息。如果未指定本参数，将显示概要信息。

<Sysname> display pim neighbor

# 显示公网实例所有PIM邻居的概要信息。

Total Number of Neighbors = 2

Neighbor Interface Uptime Expires DR-Priority Mode

10.1.1.2 GE2/0/1 02:50:49 00:01:31 1 B

20.1.1.2 GE2/0/2 02:49:39 00:01:42 1 P

# 显示公网实例中IP地址为11.110.0.20的PIM邻居的详细信息。

<Sysname> display pim neighbor 11.110.0.20 verbose

Neighbor: 11.110.0.20

Interface: GigabitEthernet2/0/3

Uptime: 00:00:10

Expiry time: 00:00:30

DR Priority: 1

Generation ID: 0x2ACEFE15

Holdtime: 105 s

LAN delay: 500 ms

Override interval: 2500 ms

State refresh interval: 60 s

Neighbor tracking: Disabled

Bidirectional PIM: Enabled

RPF proxy vector: Enabled

表1-9 display pim neighbor命令显示信息描述表

字段	描述
Total Number of Neighbors	PIM邻居的总数
Neighbor	PIM邻居的IP地址
Interface	PIM邻居所在接口的名称
Uptime	PIM邻居已存在的时间
Expires/Expiry time	PIM邻居超时的剩余时间，never表示PIM邻居永不超时，即永远可达
DR-Priority/DR Priority	PIM邻居的优先级
Mode	PIM邻居的模式，B表示双向PIM模式，P表示开启RPF代理向量功能，显示为空则表示非双向PIM模式且关闭RPF代理向量功能
Generation ID	PIM邻居的Generation ID（状态随机数）
Holdtime	PIM邻居的生存时间，forever表示PIM邻居永远存在，即永远可达
LAN delay	PIM报文在共享网段中的传输延迟
Override interval	剪枝否决的时间间隔
State refresh interval	状态刷新的时间间隔，只有当PIM邻居工作在PIM-DM模式下且具备状态刷新能力时才会显示本字段
Neighbor tracking	邻居跟踪功能是否使能
Bidirectional PIM	双向PIM是否使能
RPF proxy vector	RPF代理向量功能（请参见“IP组播配置指导”中的“组播VPN”）是否使能

1.1.17 display pim routing-table

display pim routing-table命令用来显示PIM路由表的内容。

display pim [ vpn-instance vpn-instance-name ] routing-table [ group-address [ mask { mask-length | mask } ] | source-address [ mask { mask-length | mask } ] | flags flag-value | fsm | incoming-interface interface-type interface-number | mode mode-type | outgoing-interface { exclude | include | match } interface-type interface-number | proxy ] *

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

group-address：组播组地址，显示指定组播组的PIM路由项，取值范围为224.0.0.0～239.255.255.255。如果未指定本参数，将显示所有组播组的PIM路由项。

source-address：组播源地址，显示包含指定组播源的PIM路由项。

mask-length：指定组播组或组播源地址的掩码长度，取值范围为0～32，缺省值为32。

mask：指定组播组或组播源地址的掩码，缺省值为255.255.255.255。

flags flag-value：PIM标志，显示包含指定标志的PIM路由项。如果未指定本参数，将显示包含所有标志的PIM路由项。flag-value的取值及含义如下：

· 2msdp：表示准备向MSDP发出通知，在下一个SA报文中包含的PIM路由项；

· act：表示已经有实际数据到达的PIM路由项；

· del：表示计划删除的PIM路由项；

· exprune：表示某些出接口被其它组播路由协议剪枝的PIM路由项；

· ext：表示包含了由其它组播路由协议提供出接口的PIM路由项；

· loc：表示在与组播源处于同一网段的路由器上的PIM路由项；

· msdp：表示从MSDP的SA报文中学习到的PIM路由项；

· niif：表示未确定入接口的PIM路由项；

· nonbr：表示PIM邻居查找失败的PIM路由项；

· rpt：表示向RP方向发送过（S，G）RPT位剪枝的PIM路由项；

· rq：表示Data-MDT切换接收端的PIM路由项；

· spt：表示SPT上的PIM路由项；

· sq：表示Data-MDT切换发起端的PIM路由项；

· swt：表示正处于向SPT切换过程中的PIM路由项；

· wc：表示带WC通配符的PIM路由项。

fsm：显示有限状态机的详细信息。

incoming-interface interface-type interface-number：显示指定入接口的PIM路由项。如果未指定本参数，将显示所有入接口的PIM路由项。

mode mode-type：PIM模式，显示指定模式下的PIM路由项。如果未指定本参数，将显示所有模式下的PIM路由项。mode-type的取值及含义如下：

· bidir：表示双向PIM模式；

· dm：表示PIM-DM模式；

· sm：表示PIM-SM模式；

· ssm：表示PIM-SSM模式。

outgoing-interface { exclude | include | match } interface-type interface-number：显示指定出接口的PIM路由项。其中，exclude表示不包含指定接口；include表示包含指定接口；match表示包含且仅包含指定接口。如果未指定本参数，将显示所有出接口的PIM路由项。

proxy：显示PIM路由项使用的RPF代理向量信息。

<Sysname> display pim routing-table proxy

# 显示公网实例PIM路由表的内容。

<Sysname> display pim routing-table

Total 0 (*, G) entry; 1 (S, G) entr

(172.168.0.12, 227.0.0.1)

RP: 2.2.2.2

Protocol: pim-sm, Flag: SPT LOC ACT

UpTime: 02:54:43

Upstream interface: GigabitEthernet2/0/1

Upstream neighbor: NULL

RPF prime neighbor: NULL

Downstream interface(s) information:

Total number of downstreams: 1

1: Vlan-interface2

Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47

表1-10 display pim routing-table命令显示信息描述表

字段	描述
Total 0 (*, G) entry; 1 (S, G) entry	PIM路由表中（S，G）与（*，G）表项的总数
(172.168.0.12, 227.0.0.1)	PIM路由表中的（S，G）表项
Protocol	PIM的模式
Flag	PIM路由表中（S，G）或（*，G）表项的标志： · ACT：表示已有实际数据到达 · DEL：表示计划要删除 · EXPRUNE：表示某些出接口被其它组播路由协议剪枝 · EXT：表示包含了由其它组播路由协议提供的出接口 · LOC：表示与组播源处于同一网段 · NIIF：表示未确定入接口 · NONBR：表示PIM邻居查找失败 · RPT：表示向RP方向发送过（S，G）RPT位剪枝 · SPT：表示在SPT上 · SWT：表示正在向SPT切换 · WC：表示带WC通配符
Uptime	（S，G）或（*，G）表项已存在的时间
Upstream interface	（S，G）或（*，G）表项的入接口
Upstream neighbor	（S，G）或（*，G）表项的上游邻居
RPF prime neighbor	（S，G）或（，G）表项的RPF邻居： · 对（，G）表项来说，当该路由器是RP时，（*，G）表项的RPF邻居是NULL · 对（S，G）表项来说，当该路由器直连源时，（S，G）表项的RPF邻居是NULL
RPF proxy vector	RPF代理向量，本字段只有在B类跨AS的MD VPN（请参见“IP组播配置指导”中的“组播VPN”）组网中才会显示
Downstream interface(s) information	下游接口的信息，包括： · 下游接口的总数 · 下游接口的名称 · 下游接口使用的协议类型 · 下游接口的存在时间 · 下游接口的超时时间

# 在PE设备上显示公网实例PIM路由项使用的RPF代理向量信息。

(100.0.0.8, 232.1.1.1)

Proxy: 10:1/192.168.0.4

Assigner: 0.0.0.0 Origin: BGP MDT

Uptime: 02:08:18 Expires: Off

# 在P设备上显示公网实例PIM路由项使用的RPF代理向量信息。

<Sysname> display pim routing-table proxy

(100.0.0.8, 232.1.1.1)

Proxy: 10:1/192.168.0.4

Assigner: 1.0.3.1 Origin: PIM

Uptime: 02:19:33 Expires: 00:02:12

# 在ASBR设备上显示公网实例PIM路由项使用的RPF代理向量信息。

<Sysname> display pim routing-table proxy

(100.0.0.1, 232.1.1.1)

Proxy: 10:1/local

Assigner: 1.0.5.9 Origin: PIM

Uptime: 02:22:04 Expires: 00:02:35

(100.0.0.8, 232.1.1.1)

Proxy: 10:1/local

Assigner: 1.0.4.1 Origin: PIM

Uptime: 02:21:10 Expires: 00:02:35

表1-11 display pim routing-table proxy命令显示信息描述表

字段	描述
Proxy	代理向量信息，包括RD（Route Distinguisher，路由标识符）和RPF代理向量的地址，local表示RPF代理向量为本地地址（比如在ASBR上）
Assigner	分配RPF代理向量的设备地址： · 在PE上，RPF代理向量是从BGP MDT路由中获取的，显示为0.0.0.0 · 在非PE上，RPF代理向量是从下游PIM邻居发来的PIM加入报文中学到的，显示为下游PIM邻居的接口地址
Origin	产生RPF代理向量的协议： · 在PE上，RPF代理向量是从BGP MDT路由中获取的，显示为BGP MDT · 在非PE上，RPF代理向量是从下游PIM邻居发来的PIM加入报文中学到的，显示为PIM
Uptime	RPF代理向量已存在的时间
Expires	RPF代理向量的的超时剩余时间，Off表示该定时器关闭

1.1.18 display pim rp-info

display pim rp-info命令用来显示PIM-SM域中的RP信息。

display pim [ vpn-instance vpn-instance-name ] rp-info [ group-address ]

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

group-address：组播组地址，显示指定组播组所对应的RP信息，取值范围为224.0.1.0～239.255.255.255。如果未指定本参数，将显示所有组播组对应的RP信息。

<Sysname> display pim rp-info

# 显示公网实例中组播组224.0.1.1所对应的RP信息。

<Sysname> display pim rp-info 224.0.1.1

BSR RP address is: 2.2.2.2

Priority: 192

HoldTime: 180

Uptime: 03:01:10

Expires: 00:02:30

Static RP address is: 3.3.3.5

Preferred: Yes

Configured ACL: 2003

RP mapping for this group is: 3.3.3.5

Anycast-RP 3.3.3.5 members:

Member address State

1.1.0.1 Active

1.2.0.2 Local

1.2.0.1 Remote

# 显示公网实例中所有组播组对应的RP信息。

BSR RP information:

Scope: non-scoped

Group/MaskLen: 224.0.0.0/4

RP address Priority HoldTime Uptime Expires

1.1.1.1 (local) 192 180 03:01:36 00:02:29

2.2.2.2 192 180 1d:13h 00:02:02

Group/MaskLen: 225.1.0.0/16 [B]

RP address Priority HoldTime Uptime Expires

3.3.3.3 192 180 12w:5d 00:02:05

Static RP information:

RP address ACL Mode Preferred

3.3.3.1 2000 pim-sm No

3.3.3.2 2001 bidir Yes

3.3.3.3 2002 pim-sm No

3.3.3.4 pim-sm No

3.3.3.5 2002 pim-sm Yes

Anycast-RP information:

RP address Member address State

3.3.3.5 1.1.0.1 Active

3.3.3.5 1.1.0.2 Local

3.3.3.5 1.2.0.1 Remote

表1-12 display pim rp-info命令显示信息描述表

字段	描述
BSR RP address is	RP的IP地址
BSR RP information	BSR RP信息
Scope	域
Group/MaskLen	RP所服务的组播组
[B]	表示RP服务于双向PIM。如果不显示该字段，则表示RP服务于PIM-SM
RP address	RP的IP地址，local表示本地地址
Priority	RP的优先级
HoldTime	RP的超时时间
Uptime	RP已存在的时间
Expires	RP超时的剩余时间
Static RP information	静态RP信息
Static RP address is/RP address	静态RP的IP地址
Preferred	是否指定了静态RP优先
Configured ACL/ACL	静态RP所服务的组播组列表
Mode	为PIM-SM服务还是为双向PIM服务
RP mapping for this group	服务于当前组播组的RP的IP地址
Anycast-RP 3.3.3.5 members	Anycast-RP 3.3.3.5的成员
Member address	Anycast-RP成员的IP地址
State	Anycast-RP成员地址的来源： · Active：表示本端激活接口的地址 · Local：表示本端未激活接口的地址 · Remote：表示远端的地址
Anycast-RP information	Anycast-RP信息

1.1.19 display pim statistics

display pim statistics命令用来显示PIM协议报文的统计信息。

display pim statistics

# 显示PIM协议报文的统计信息。

<Sysname> display pim statistics

Received PIM packets: 3295

Sent PIM packets : 5975

Valid Invalid Succeeded Failed

Hello : 3128 0 4333 0

Reg : 14 0 0 0

Reg-stop : 0 0 0 0

JP : 151 0 561 0

BSM : 0 0 1081 0

Assert : 0 0 0 0

Graft : 0 0 0 0

Graft-ACK: 0 0 0 0

C-RP : 0 0 0 0

SRM : 0 0 0 0

DF : 0 0 0 0

表1-13 display pim statistics命令显示信息描述表

字段	描述
Received PIM packets	收到的PIM协议报文总数
Sent PIM packets	发出的PIM协议报文总数
Valid	收到的合法PIM协议报文数量
Invalid	收到的非法PIM协议报文数量
Succeeded	发送成功的PIM协议报文数量
Failed	发送失败的PIM协议报文数量
Hello	Hello报文统计
Reg	注册报文统计
Reg-stop	注册停止报文统计
JP	加入/剪枝报文统计
BSM	自举报文统计
Assert	断言报文统计
Graft	嫁接报文统计
Graft-ACK	嫁接应答报文统计
C-RP	C-RP报文统计
SRM	状态刷新报文统计
DF	指定转发者报文统计

1.1.20 hello-option dr-priority (PIM view)

hello-option dr-priority命令用来全局配置竞选DR的优先级。

undo hello-option dr-priority命令用来恢复缺省情况。

hello-option dr-priority priority

undo hello-option dr-priority

竞选DR的优先级为1。

PIM视图

priority：指定竞选DR的优先级，取值范围为0～4294967295。数值越大，优先级越高。

本配置既可在PIM视图又可在接口视图下进行，前者对所有接口都生效，而后者只对当前接口生效，但后者的配置优先级较高。

# 在公网实例中全局配置竞选DR的优先级为3。

[Sysname] pim

[Sysname-pim] hello-option dr-priority 3

1.1.21 hello-option holdtime (PIM view)

hello-option holdtime命令用来全局配置保持PIM邻居可达状态的时间。

undo hello-option holdtime命令用来恢复缺省情况。

hello-option holdtime time

undo hello-option holdtime

保持PIM邻居可达状态的时间为105秒。

PIM视图

time：指定保持PIM邻居可达状态的超时时间，取值范围为1～65535，单位为秒。如果指定为65535秒，则表示PIM邻居永远可达。

本配置既可在PIM视图又可在接口视图下进行，前者对所有接口都生效，而后者只对当前接口生效，但后者的配置优先级较高。

# 在公网实例中全局配置保持PIM邻居可达状态的时间为120秒。

[Sysname] pim

[Sysname-pim] hello-option holdtime 120

· pim hello-option holdtime

1.1.22 hello-option lan-delay (PIM view)

hello-option lan-delay命令用来全局配置PIM报文在共享网段中的传输延迟。

undo hello-option lan-delay命令用来恢复缺省情况。

hello-option lan-delay delay

undo hello-option lan-delay

PIM报文在共享网段中的传输延迟为500毫秒。

PIM视图

delay：指定PIM报文在共享网段中的传输延迟，取值范围为1～32767，单位为毫秒。

本配置既可在PIM视图又可在接口视图下进行，前者对所有接口都生效，而后者只对当前接口生效，但后者的配置优先级较高。

# 在公网实例中全局配置PIM报文在共享网段中的传输延迟为200毫秒。

· pim hello-option lan-delay

[Sysname] pim

[Sysname-pim] hello-option lan-delay 200

· pim hello-option override-interval

1.1.23 hello-option neighbor-tracking (PIM view)

hello-option neighbor-tracking命令用来全局使能邻居跟踪功能，即禁止加入报文抑制能力。

undo hello-option neighbor-tracking命令用来恢复缺省情况。

hello-option neighbor-tracking

undo hello-option neighbor-tracking

邻居跟踪功能处于关闭状态，即不禁止加入报文抑制能力。

PIM视图

本配置既可在PIM视图又可在接口视图下进行，前者对所有接口都生效，而后者只对当前接口生效，但后者的配置优先级较高。

# 在公网实例中全局使能邻居跟踪功能。

[Sysname] pim

[Sysname-pim] hello-option neighbor-tracking

1.1.24 hello-option override-interval (PIM view)

hello-option override-interval命令用来全局配置剪枝否决时间。

undo hello-option override-interval命令用来恢复缺省情况。

hello-option override-interval interval

undo hello-option override-interval

剪枝否决时间为2500毫秒。

PIM视图

interval：指定剪枝否决时间，取值范围为1～65535，单位为毫秒。

本配置既可在PIM视图又可在接口视图下进行，前者对所有接口都生效，而后者只对当前接口生效，但后者的配置优先级较高。

# 在公网实例中全局配置剪枝否决时间为2000毫秒。

[Sysname] pim

[Sysname-pim] hello-option override-interval 2000

· hello-option lan-delay (PIM view)

· pim hello-option lan-delay

· pim hello-option override-interval

1.1.25 holdtime join-prune (PIM view)

holdtime join-prune命令用来全局配置加入/剪枝状态的保持时间。

undo holdtime join-prune命令用来恢复缺省情况。

holdtime join-prune time

undo holdtime join-prune

加入/剪枝状态的保持时间为210秒。

PIM视图

time：指定加入/剪枝状态的保持时间，取值范围为1～65535，单位为秒。

· 本配置既可在PIM视图又可在接口视图下进行，前者对所有接口都生效，而后者只对当前接口生效，但后者的配置优先级较高。

· PIM接口向上游邻居发送加入/剪枝报文的时间间隔必须小于加入/剪枝状态的保持时间，以免上游邻居老化超时。

# 在公网实例中全局配置加入/剪枝状态的保持时间为280秒。

[Sysname] pim

[Sysname-pim] holdtime join-prune 280

· pim holdtime join-prune

· timer join-prune (PIM view)

1.1.26 jp-pkt-size (PIM view)

jp-pkt-size命令用来配置加入/剪枝报文的最大长度。

undo jp-pkt-size命令用来恢复缺省情况。

jp-pkt-size size

加入/剪枝报文的最大长度为8100字节。

PIM视图

size：指定加入/剪枝报文的最大长度，取值范围为100～8100，单位为字节。

# 在公网实例中配置加入/剪枝报文的最大长度为1500字节。

[Sysname] pim

[Sysname-pim] jp-pkt-size 1500

1.1.27 pim

pim命令用来进入PIM视图。

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

pim [ vpn-instance vpn-instance-name ]

undo pim [ vpn-instance vpn-instance-name ]

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

# 先使能公网实例中的IP组播路由，再进入公网实例的PIM视图。

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] pim

[Sysname-pim]

# 先使能VPN实例mvpn中的IP组播路由，再进入该VPN实例的PIM视图。

[Sysname] multicast routing vpn-instance mvpn

[Sysname-mrib-mvpn] quit

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn]

1.1.28 pim bfd enable

pim bfd enable命令用来使能PIM与BFD联动功能。

undo pim bfd enable命令用来关闭PIM与BFD联动功能。

pim bfd enable

undo pim bfd enable

PIM与BFD联动功能处于关闭状态。

只有在接口上先使能了PIM-DM或PIM-SM，本命令才能生效。

# 使能公网实例中的IP组播路由，在接口GigabitEthernet2/0/1上使能PIM-DM，并使能PIM与BFD联动功能。

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim dm

[Sysname-GigabitEthernet2/0/1] pim bfd enable

· pim dm

· pim sm

1.1.29 pim bsr-boundary

pim bsr-boundary命令用来配置BSR的服务边界，即PIM-SM域的边界。

undo pim bsr-boundary命令用来删除BSR的服务边界。

undo pim bsr-boundary

pim bsr-boundary

没有配置BSR的服务边界。

# 配置接口GigabitEthernet2/0/1为BSR的服务边界。

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim bsr-boundary

· c-bsr (PIM view)

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

1.1.30 pim dm

pim dm命令用来使能PIM-DM。

undo pim dm命令用来关闭PIM-DM。

PIM-DM处于关闭状态。

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

# 使能公网实例中的IP组播路由，并在接口GigabitEthernet2/0/1上使能PIM-DM。

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim dm

【相关命令】

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

1.1.31 pim hello-option dr-priority

pim hello-option dr-priority命令用来在接口上配置竞选DR的优先级。

undo pim hello-option dr-priority命令用来恢复缺省情况。

pim hello-option dr-priority priority

undo pim hello-option dr-priority

竞选DR的优先级为1。

priority：指定竞选DR的优先级，取值范围为0～4294967295。数值越大，优先级越高。

本配置既可在PIM视图又可在接口视图下进行，前者对所有接口都生效，而后者只对当前接口生效，但后者的配置优先级较高。

# 在接口GigabitEthernet2/0/1上配置竞选DR的优先级为3。

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim hello-option dr-priority 3

1.1.32 pim hello-option holdtime

pim hello-option holdtime命令用来在接口上配置保持PIM邻居的可达状态的时间。

undo pim hello-option holdtime命令用来恢复缺省情况。

pim hello-option holdtime time

undo pim hello-option holdtime

保持PIM邻居可达状态的时间为105秒。

time：指定保持PIM邻居可达状态的时间，取值范围为1～65535，单位为秒。如果指定为65535秒，则表示PIM邻居永远可达。

本配置既可在PIM视图又可在接口视图下进行，前者对所有接口都生效，而后者只对当前接口生效，但后者的配置优先级较高。

# 在接口GigabitEthernet2/0/1上配置保持PIM邻居可达状态的时间为120秒。

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim hello-option holdtime 120

· hello-option holdtime (PIM view)

1.1.33 pim hello-option lan-delay

pim hello-option lan-delay命令用来在接口上配置PIM报文在共享网段中的传输延迟。

undo pim hello-option lan-delay命令用来恢复缺省情况。

pim hello-option lan-delay delay

undo pim hello-option lan-delay

PIM报文在共享网段中的传输延迟为500毫秒。

delay：指定PIM报文在共享网段中的传输延迟，取值范围为1～32767，单位为毫秒。

本配置既可在PIM视图又可在接口视图下进行，前者对所有接口都生效，而后者只对当前接口生效，但后者的配置优先级较高。

# 在接口GigabitEthernet2/0/1上配置PIM报文在共享网段中的传输延迟为200毫秒。

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim hello-option lan-delay 200

· hello-option lan-delay (PIM view)

· hello-option override-interval (PIM view)

· pim hello-option override-interval

1.1.34 pim hello-option neighbor-tracking

pim hello-option neighbor-tracking命令用来在接口上使能邻居跟踪功能，即禁止加入报文抑制能力。

pim hello-option neighbor-tracking disable命令用来在全局使能了邻居跟踪功能的情况下，关闭当前接口上的邻居跟踪功能。

undo pim hello-option neighbor-tracking命令用来抵消上述两条命令的配置，即让接口与全局配置保持一致。

pim hello-option neighbor-tracking

pim hello-option neighbor-tracking disable

undo pim hello-option neighbor-tracking

邻居跟踪功能处于关闭状态，即不禁止加入报文抑制能力。

本配置既可在PIM视图又可在接口视图下进行，前者对所有接口都生效，而后者只对当前接口生效，但后者的配置优先级较高。

# 在接口GigabitEthernet2/0/1上使能邻居跟踪功能。

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim hello-option neighbor-tracking

# 在公网实例全局使能了邻居跟踪功能的情况下，关闭接口GigabitEthernet2/0/1上的邻居跟踪功能。

[Sysname] pim

[Sysname-pim] hello-option neighbor-tracking

[Sysname-pim] quit

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim hello-option neighbor-tracking disable

1.1.35 pim hello-option override-interval

pim hello-option override-interval命令用来在接口上配置剪枝否决时间。

undo pim hello-option override-interval命令用来恢复缺省情况。

pim hello-option override-interval interval

undo pim hello-option override-interval

剪枝否决时间为2500毫秒。

interval：指定剪枝否决时间，取值范围为1～65535，单位为毫秒。

本配置既可在PIM视图又可在接口视图下进行，前者对所有接口都生效，而后者只对当前接口生效，但后者的配置优先级较高。

# 在接口GigabitEthernet2/0/1上配置剪枝否决时间为2000毫秒。

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim hello-option override-interval 2000

· pim hello-option lan-delay

· hello-option lan-delay (PIM view)

· hello-option override-interval (PIM view)

1.1.36 pim holdtime join-prune

pim holdtime join-prune命令用来在接口上配置加入/剪枝状态的保持时间。

undo pim holdtime join-prune命令用来恢复缺省情况。

pim holdtime join-prune time

undo pim holdtime join-prune

加入/剪枝状态的保持时间为210秒。

time：指定加入/剪枝状态的保持时间，取值范围为1～65535，单位为秒。

· 本配置既可在PIM视图又可在接口视图下进行，前者对所有接口都生效，而后者只对当前接口生效，但后者的配置优先级较高。

· PIM接口向上游邻居发送加入/剪枝报文的时间间隔必须小于加入/剪枝状态的保持时间，以免上游邻居老化超时。

# 在接口GigabitEthernet2/0/1上配置加入/剪枝状态的保持时间为280秒。

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim holdtime join-prune 280

· holdtime join-prune (PIM view)

· pim timer join-prune

1.1.37 pim nbma-mode

pim nbma-mode命令用来在ADVPN隧道tunnel口上使能NBMA模式。

pim nbma-mode

undo pim nbma-mode

Tunnle接口视图

只有在相应实例中先使能了IP组播路由，接口上使能PIM SM协议，本命令才能生效。本命令不支持PIM DM模式。

# 使能公网实例中的IP组播路由，并在ADVPN隧道接口Tunnel 0上使能NBMA。

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface Tunnel 0 mode advpn gre

[Sysname- Tunnel0] pim sm

[Sysname- Tunnel0] pim nbma-mode

1.1.38 pim neighbor-policy

pim neighbor-policy命令用来配置合法Hello报文的源地址范围，以防止Hello报文欺骗。

undo pim neighbor-policy命令用来恢复缺省情况。

pim neighbor-policy acl-number

undo pim neighbor-policy

Hello报文的源地址范围不受任何限制，即认为所有收到的Hello报文都是合法的。

acl-number：指定IPv4基本ACL的编号，取值范围为2000～2999。

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

# 在接口GigabitEthernet2/0/1上配置合法Hello报文的源地址范围，只允许与来自网段10.1.1.0/24中的设备建立PIM邻居关系。

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 10.1.1.0 0.0.0.255

[Sysname-acl-basic-2000] quit

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim neighbor-policy 2000

1.1.39 pim require-genid

pim require-genid命令用来配置拒绝无Generation ID的Hello报文。

undo pim require-genid命令用来恢复缺省情况。

undo pim require-genid

pim require-genid

接受无Generation ID的Hello报文。

# 配置接口GigabitEthernet2/0/1拒绝无Generation ID的Hello报文。

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim require-genid

1.1.40 pim sm

pim sm命令用来使能PIM-SM。

undo pim sm命令用来关闭PIM-SM。

PIM-SM处于关闭状态。

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

# 使能公网实例中的IP组播路由，并在接口GigabitEthernet2/0/1上使能PIM-SM。

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim sm

【相关命令】

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

1.1.41 pim state-refresh-capable

pim state-refresh-capable命令用来使能状态刷新能力。

undo pim state-refresh-capable命令用来关闭状态刷新能力。

pim state-refresh-capable

undo pim state-refresh-capable

# 在接口GigabitEthernet2/0/1上关闭状态刷新能力。

· state-refresh-interval (PIM view)

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] undo pim state-refresh-capable

【相关命令】

· state-refresh-rate-limit (PIM view)

· state-refresh-ttl (PIM view)

1.1.42 pim timer graft-retry

pim timer graft-retry命令用来配置嫁接报文的重传时间。

undo pim timer graft-retry命令用来恢复缺省情况。

pim timer graft-retry interval

undo pim timer graft-retry

interval：指定嫁接报文的重传时间，取值范围为1～65535，单位为秒。

# 在接口GigabitEthernet2/0/1上配置嫁接报文的重传时间为80秒。

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim timer graft-retry 80

1.1.43 pim timer hello

pim timer hello命令用来在接口上配置发送Hello报文的时间间隔。

undo pim timer hello命令用来恢复缺省情况。

pim timer hello interval

undo pim timer hello

发送Hello报文的时间间隔为30秒。

interval：指定发送Hello报文的时间间隔，取值范围为0～18000，单位为秒。0表示无穷大，即永不发送Hello报文。

本配置既可在PIM视图又可在接口视图下进行，前者对所有接口都生效，而后者只对当前接口生效，但后者的配置优先级较高。

# 在接口GigabitEthernet2/0/1上配置发送Hello报文的时间间隔为40秒。

· timer hello (PIM view)

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim timer hello 40

【相关命令】

1.1.44 pim timer join-prune

pim timer join-prune命令用来在接口上配置发送加入/剪枝报文的时间间隔。

undo pim timer join-prune命令用来恢复缺省情况。

pim timer join-prune interval

undo pim timer join-prune

发送加入/剪枝报文的时间间隔为60秒。

interval：指定发送加入/剪枝报文的时间间隔，取值范围为0～18000，单位为秒。0表示无穷大，即永不发送加入/剪枝报文。

· 本命令不会立即生效，新配置的发送间隔将在当前发送间隔完成后生效。

· 本配置既可在PIM视图又可在接口视图下进行，前者对所有接口都生效，而后者只对当前接口生效，但后者的配置优先级较高。

· PIM接口向上游邻居发送加入/剪枝报文的时间间隔必须小于加入/剪枝状态的保持时间，以免上游邻居老化超时。

# 在接口GigabitEthernet2/0/1上配置发送加入/剪枝报文的时间间隔为80秒。

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim timer join-prune 80

· pim holdtime join-prune

· timer join-prune (PIM view)

1.1.45 pim triggered-hello-delay

pim triggered-hello-delay命令用来配置触发Hello报文的最大延迟时间。

undo pim triggered-hello-delay命令用来恢复缺省情况。

pim triggered-hello-delay delay

undo pim triggered-hello-delay

触发Hello报文的最大延迟时间为5秒。

delay：指定触发Hello报文的最大延迟时间，取值范围为1～60，单位为秒。

# 在接口GigabitEthernet2/0/1上配置触发Hello报文的最大延迟时间为3秒。

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] pim triggered-hello-delay 3

1.1.46 register-policy (PIM view)

register-policy命令用来配置注册报文的过滤策略。

undo register-policy命令用来删除注册报文的过滤策略。

register-policy acl-number

undo register-policy

PIM视图

acl-number：指定IPv4高级ACL的编号，取值范围为3000～3999。

ACL规则中的source参数用来指定注册报文中的组播源地址范围，destination参数用来指定组播组地址范围，若指定了vpn-instance参数则此规则不生效，而除fragment和time-range以外的其它可选参数都将被忽略。只有与该ACL规则中的permit语句匹配的注册报文才会被RP接受。

# 在公网实例中配置RP上对注册报文的过滤策略，只接收来自10.10.0.0/16网段的组播源发向225.1.0.0/16网段的组播组的注册报文。

[Sysname] acl number 3000

[Sysname-acl-adv-3000] rule permit ip source 10.10.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255

[Sysname-acl-adv-3000] quit

[Sysname] pim

[Sysname-pim] register-policy 3000

1.1.47 register-suppression-timeout (PIM view)

register-suppression-timeout命令用来配置注册抑制时间。

undo register-suppression-timeout命令用来恢复缺省情况。

register-suppression-timeout interval

undo register-suppression-timeout

注册抑制时间为60秒。

PIM视图

interval：指定注册抑制时间，取值范围为1～65535，单位为秒。

# 在公网实例中配置注册抑制时间为70秒。

[Sysname] pim

[Sysname-pim] register-suppression-timeout 70

1.1.48 register-whole-checksum (PIM view)

register-whole-checksum命令用来配置根据注册报文的全部内容来计算校验和。

undo register-whole-checksum命令用来恢复缺省情况。

register-whole-checksum

undo register-whole-checksum

PIM视图

# 在公网实例中配置根据注册报文的全部内容来计算校验和。

[Sysname] pim

[Sysname-pim] register-whole-checksum

1.1.49 snmp-agent trap enable pim

snmp-agent trap enable pim命令用来开启PIM的告警功能。

undo snmp-agent trap enable pim命令用来关闭PIM的告警功能。

snmp-agent trap enable pim [ candidate-bsr-win-election | elected-bsr-lost-election | neighbor-loss ] *

undo snmp-agent trap enable pim [ candidate-bsr-win-election | elected-bsr-lost-election | neighbor-loss ] *

PIM的告警功能处于开启状态。

candidate-bsr-win-election：表示C-BSR成功当选BSR的告警信息。

elected-bsr-lost-election：表示原BSR在新的选举中失败的告警信息。

neighbor-loss：表示邻居丢失的告警信息。

如果未指定任何可选参数，表示开启或关闭PIM的全部告警功能。

开启了PIM的告警功能之后，PIM会生成告警信息，以向网管软件报告本模块的重要事件。该信息将发送至SNMP模块，通过设置SNMP中告警信息的发送参数，来决定告警信息输出的相关属性。有关告警信息的详细介绍，请参见“网络管理和监控配置指导”中的“SNMP”。

# 关闭PIM的全部告警功能。

[Sysname] undo snmp-agent trap enable pim

1.1.50 source-lifetime (PIM view)

source-lifetime命令用来配置组播源的生存时间。

undo source-lifetime命令用来恢复缺省情况。

source-lifetime time

undo source-lifetime

PIM视图

time：指定组播源的生存时间，取值范围为0～31536000，单位为秒。0表示无穷大，即组播源永不老化。

# 在公网实例中配置组播源的生存时间为200秒。

[Sysname] pim

[Sysname-pim] source-lifetime 200

1.1.51 source-policy (PIM view)

source-policy命令用来配置组播数据过滤器。

undo source-policy命令用来删除组播数据过滤器。

source-policy acl-number

undo source-policy

没有配置组播数据过滤器。

PIM视图

acl-number：指定IPv4基本或高级ACL的编号，取值范围为2000～3999。

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

· 对于IPv4高级ACL，该ACL规则中的source参数用来指定组播数据报文的源地址范围，destination参数用来指定组播组地址范围，若指定了vpn-instance参数则此规则不生效，而除fragment和time-range以外的其它可选参数都将被忽略。未通过该过滤规则的报文将被丢弃。

· 重复执行本命令，新配置将覆盖旧配置。

# 在公网实例中配置接收组播源为10.10.1.2的组播数据，丢弃组播源为10.10.1.1的组播数据。