C-BSR一旦通过自举机制竞选为BSR后，其他C-BSR会在等待接收来自BSR的自举报文的超时时间（holdtime，可通过c-bsr holdtime进行配置）内，停止向其所服务的区域内的其他设备发送自举报文，BSR选举过程暂停。之后，将由BSR会周期性地（发送的周期通过本命令配置）向其所服务的区域内的其他设备发送携带自己的IP地址、RP-Set信息和RP实际老化时间的自举报文，其他设备根据RP-Set信息计算出特定组播组范围所对应的RP。当自举超时时间超时后，所有的C-BSR之间会互相发送自举报文，触发新一轮的BSR选举过程。

在存在主备RP的双向PIM组网中，当主RP所在的组播流量转发链路发生故障时，备RP必须要等待主RP老化后才能代替主RP转发组播流量，导致组播流量中断转发时间较长。由于RP老化时间必须大于自举报文的发送时间间隔，因此，若要缩小RP老化时间，需要先通过本命令调小自举报文的发送时间间隔。

配置interval和holdtime时，请注意：

· 如果同时配置了interval和holdtime，请保证interval小于holdtime，否则将导致频繁触发BSR选举过程。

· 如果只配置了其中之一，那么另一个取值可由以下公式计算得出：interval＝（holdtime－10）÷2。

· 只配置了holdtime时，若根据公式计算得出的interval小于interval取值范围的最小值（1秒），则interval的取值为1秒。

· 只配置了interval时，若根据公式计算得出的holdtime大于holdtime取值范围的最大值（2147483647秒），则holdtime取值为2147483647秒。

· 属于同一个PIM域的所有C-BSR必须配置相同的interval和holdtime。如果配置值不同，则可能导致BSR选举不稳定，从而引发组播流量转发故障。

【举例】

# 在公网实例中，配置C-BSR发送自举报文的时间间隔为30秒。

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr interval 30

# 在VPN实例mvpn中，配置C-BSR发送自举报文的时间间隔为30秒。

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] c-bsr interval 30

1.1.11 c-rp (PIM view)

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

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

【命令】

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

undo c-rp ip-address

【缺省情况】

不存在C-RP。

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

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

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

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

group-policy name ipv4-acl-name：指定IPv4基本或者高级ACL的名称，为1～63个字符的字符串，不区分大小写，必须以英文字母a～z或A～Z开头。为避免混淆，ACL的名称不允许使用英文单词all。如果指定了本参数，该C-RP将只为ACL规则所允许的组播组服务；如果未指定本参数、指定的ACL名称不存在或为高级ACL名称和ACL中未配置有效规则，则该C-RP将为所有组播组服务。

仅Release 6616及以上版本支持name ipv4-acl-name参数。

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，则需要在配置group-policy所对应的ACL时将多个组范围用多个rule规则表示出来。

对于IPv4基本ACL，该ACL规则中的source参数用来指定C-RP宣告报文中的组播组地址范围，只要C-RP宣告报文中的组播组地址匹配该规则，该规则便生效。该规则中除source、fragment和time-range以外的其它可选参数都将被忽略。

若ACL中指定了vpn-instance参数则该条规则不生效。

如果对同一IP地址多次执行本命令，最后一次执行的命令生效。

【举例】

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

<Sysname> system-view

[Sysname] acl basic 2000

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

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

[Sysname-acl-ipv4-basic-2000] quit

[Sysname] pim

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

1.1.12 crp-policy (PIM view)

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

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

【命令】

crp-policy ipv4-acl-number

undo crp-policy

【缺省情况】

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

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

配置合法的C-RP地址范围及其服务的组播组范围可以防止C-RP欺骗。

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

该ACL规则中的source参数用来指定C-RP宣告报文中的C-RP地址范围，destination参数用来指定该C-RP所服务的组播组地址范围，并且该规则中除source、destination、fragment和time-range以外的其它可选参数都将被忽略。

若ACL中指定了vpn-instance参数则该条规则不生效。

多次执行本命令，最后一次执行的命令生效。

【举例】

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

<Sysname> system-view

[Sysname] acl advanced 3000

[Sysname-acl-ipv4-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-ipv4-adv-3000] quit

[Sysname] pim

[Sysname-pim] crp-policy 3000

【相关命令】

· c-rp (PIM view)

1.1.13 display interface register-tunnel

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

register-tunnel [ interface-number ]：指定Register-Tunnel接口的信息。interface-number为Register-Tunnel接口的编号。由于设备上只存在一个Register-Tunnel接口（即Register-Tunnel0），因此只要指定了register-tunnel参数，不论是否指定interface-number参数，都将显示接口Register-Tunnel0的相关信息。如果未指定接口类型，将显示设备支持的所有接口的信息。

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-Tunnel0的详细信息。

<Sysname> display interface register-tunnel 0

Current state: UP

Line protocol state: DOWN

Description: Register-Tunnel0 Interface

Maximum transmission 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 interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Protocol Primary IP Description

REG0 UP -- --

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

字段	描述
Current state	接口的物理状态，Register-Tunnel接口的物理状态始终为UP
Line protocol state	接口的链路状态，Register-Tunnel接口的链路状态始终为DOWN
Description	接口的描述信息
Maximum transmission unit	接口的MTU
Internet protocol processing: Disabled	接口能否配置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 interfacesin 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等接口会具有该属性
Link	接口的链路状态，由于不依赖任何资源，所以可以直接UP
Protocol	接口的协议连接状态，对Register-Tunnel接口无意义，始终为“--”
Primary IP	接口的IP地址，不可配置。对Register-Tunnel接口无意义，始终为“--”
Description	接口的描述，由于所有描述信息均不可配置,所以此处显示为空

【相关命令】

· reset counters interface register-tunnel

1.1.14 display pim bsr-info

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

【举例】

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

<Sysname> display pim bsr-info

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.15 display pim claimed-route

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

【举例】

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

<Sysname> display pim claimed-route

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.16 display pim c-rp

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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信息。

【举例】

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

<Sysname> display pim 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.17 display pim df-info

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

【举例】

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

<Sysname> display pim df-info

RP address: 12.12.12.12

Interface: Vlan-interface1

State : Win DF preference: 10

DF metric : 1562 DF uptime : 00:06:59

DF address: 30.1.1.11 (local)

Interface: Tunnel2, 100.1.1.12

State : Lose DF preference: 0

DF metric : 0 DF uptime : 00:06:59

DF address: 100.1.1.12

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

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

1.1.18 display pim interface

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

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

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

【举例】

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

<Sysname> display pim interface

Interface NbrCnt HelloInt DR-Pri DR-Address

Vlan1 1 30 1 10.1.1.2

Vlan2 0 30 1 172.168.0.2 (local)

Vlan3 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表示本地地址

# 显示公网实例接口Vlan-interface1上的PIM详细信息。

<Sysname> display pim interface vlan-interface 1 verbose

Interface: Vlan-interface1, 10.1.1.1

PIM version: 2

PIM mode: Sparse

PIM DR: 10.1.1.2

PIM DR Priority (configured): 1

PIM neighbors 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

PIM passive: 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 neighbors 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联动功能
PIM passive	该接口是否配置了PIM消极模式
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.19 display pim neighbor

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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：显示详细信息。如果未指定本参数，将显示概要信息。

【举例】

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

<Sysname> display pim neighbor

Total Number of Neighbors = 2

Neighbor Interface Uptime Expires DR-Priority Mode

10.1.1.2 Vlan1 02:50:49 00:01:31 1

20.1.1.2 Vlan2 02:49:39 00:01:42 1

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

<Sysname> display pim neighbor 11.110.0.20 verbose

Neighbor: 11.110.0.20

Interface: Vlan-interface3

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: Disabled

Secondary address(es):

22.1.1.2

22.1.1.3

22.1.1.4

22.1.1.5

22.1.1.6

22.1.1.7

22.1.1.8

表1-8 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	‌（暂不支持RPF代理向量功能）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是否使能
Secondary address(es)	PIM邻居的从地址

1.1.20 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 ] *

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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路由项；

· 2mvpn：表示已经通知MVPN相关路由信息的PIM路由项；

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

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

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

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

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

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

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

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

· rc：表示已经收到C-Multicast Route路由信息的PIM路由项；

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

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

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

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

· src-act：表示已经收到Source Active A-D Route路由信息的PIM路由项；

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

· vxlan：表示是vxlan的overlay表项；

· 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代理向量信息。

【举例】

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

<Sysname> display pim routing-table

Total 0 (*, G) entries; 1 (S, G) entries

(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: Vlan-interface1

Upstream neighbor: NULL

RPF prime neighbor: NULL

Downstream interface information:

Total number of downstream interfaces: 1

1: Vlan-interface2

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

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

字段	描述
Total 0 (*, G) entries; 1 (S, G) entries	PIM路由表中（S，G）表项的总数与（*，G）表项的总数
(172.168.0.12, 227.0.0.1)	PIM路由表中的（S，G）表项
Protocol	PIM的模式
Flag	PIM路由表中（S，G）或（*，G）表项的标志： · 2MSDP：表示准备向MSDP发出通知，在下一个SA报文中包含的PIM路由项 · 2MVPN：表示已经通知MVPN相关路由信息的PIM路由项 · ACT：表示已有实际数据到达 · DEL：表示计划要删除 · EXPRUNE：表示某些出接口被其它组播路由协议剪枝 · EXT：表示包含了由其它组播路由协议提供的出接口 · LOC：表示与组播源处于同一网段 · MSDP：表示从MSDP的SA报文中学习到的PIM路由项 · NIIF：表示未确定入接口 · NONBR：表示PIM邻居查找失败 · RC：表示已经收到C-Multicast Route路由信息的PIM路由项 · RPT：表示向RP方向发送过（S，G）RPT位剪枝 · SPT：表示在SPT上 · SQ：表示Data-MDT切换发起端的PIM路由项 · SRC-ACT：表示已经收到Source Active A-D Route路由信息的PIM路由项 · SWT：表示正在向SPT切换 · VXLAN：表示是VXLAN的overlay表项 · 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 information	下游接口的信息，包括： · 下游接口的总数 · 下游接口的名称 · 下游接口使用的协议类型 · 下游接口的存在时间 · 下游接口的超时时间

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

<Sysname> display pim routing-table proxy

(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-10 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.21 display pim rp-info

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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信息。

【举例】

# 显示公网实例中组播组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信息。

<Sysname> display pim rp-info

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 pim-sm 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-11 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.22 display pim statistics

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

【命令】

display pim statistics

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示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

AutoRP : 0 0 0 0

表1-12 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	指定转发者报文统计
AutoRP	自动RP报文统计

1.1.23 dscp

dscp命令用来配置设备发送的PIM协议报文的DSCP优先级。

undo dscp命令用来恢复缺省情况。

【命令】

dscp dscp-value

undo dscp

【缺省情况】

设备发送的PIM协议报文的DSCP优先级为48。

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

dscp-value： DSCP值，取值范围为0～63。

【使用指导】

DSCP（Differentiated Services Code Point，差分服务编码点）携带在IP报文中的ToS字段，用来体现报文自身的优先等级，决定报文传输的优先程度。DSCP优先级的取值越大，报文的优先级越高。

【举例】

# 配置设备发送的PIM协议报文的DSCP优先级63。

<Sysname> system-view

[Sysname] pim

[Sysname-pim] dscp 63

1.1.24 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视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

【举例】

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

<Sysname> system-view

[Sysname] pim

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

【相关命令】

· pim hello-option dr-priority

1.1.25 hello-option holdtime (PIM view)

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

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

【命令】

hello-option holdtime time

undo hello-option holdtime

【缺省情况】

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

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

【举例】

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

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option holdtime 120

【相关命令】

· pim hello-option holdtime

1.1.26 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视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

【举例】

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

<Sysname> system-view

[Sysname] pim

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

【相关命令】

· hello-option override-interval (PIM view)

· pim hello-option lan-delay

· pim hello-option override-interval

1.1.27 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视图

【缺省用户角色】

network-admin

【使用指导】

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

【举例】

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

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option neighbor-tracking

【相关命令】

· pim hello-option neighbor-tracking

1.1.28 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视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

【举例】

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

<Sysname> system-view

[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.29 holdtime join-prune (PIM view)

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

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

【命令】

holdtime join-prune time

undo holdtime join-prune

【缺省情况】

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

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

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

【举例】

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

<Sysname> system-view

[Sysname] pim

[Sysname-pim] holdtime join-prune 280

【相关命令】

· pim holdtime join-prune

· timer join-prune (PIM view)

1.1.30 jp-pkt-size (PIM view)

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

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

【命令】

jp-pkt-size size

undo jp-pkt-size

【缺省情况】

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

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

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

【举例】

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

<Sysname> system-view

[Sysname] pim

[Sysname-pim] jp-pkt-size 1500

1.1.31 pim

pim命令用来进入PIM视图。

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

【命令】

pim [ vpn-instance vpn-instance-name ]

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

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

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

【举例】

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

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] pim

[Sysname-pim]

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

<Sysname> system-view

[Sysname] multicast routing vpn-instance mvpn

[Sysname-mrib-mvpn] quit

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn]

1.1.32 pim bfd enable

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

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

【命令】

pim bfd enable

undo pim bfd enable

【缺省情况】

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

【视图】

接口视图

【缺省用户角色】

network-admin

【使用指导】

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

【举例】

# 使能公网实例中的IP组播路由，在接口Vlan-interface100上使能PIM-DM，并开启PIM与BFD联动功能。

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim dm

[Sysname-Vlan-interface100] pim bfd enable

【相关命令】

· pim dm

· pim sm

1.1.33 pim bsr-boundary

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

undo pim bsr-boundary命令用来恢复缺省情况。

【命令】

pim bsr-boundary

undo pim bsr-boundary

【缺省情况】

不存在BSR的服务边界。

【视图】

接口视图

【缺省用户角色】

network-admin

【举例】

# 配置接口Vlan-interface100为BSR的服务边界。

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim bsr-boundary

【相关命令】

· c-bsr (PIM view)

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

1.1.34 pim distributed-dr

pim distributed-dr命令用来配置接口为分布式DR接口。

undo pim distributed-dr命令用来恢复缺省情况。

【命令】

pim distributed-dr

undo pim distributed-dr

【缺省情况】

接口不是分布式DR接口。

【视图】

VLAN接口视图

VSI虚接口视图

【缺省用户角色】

network-admin

mdc-admin

【使用指导】

在三层组播支持多级DRNI级联组网中，需要在组成DR系统的所有成员设备的VLAN接口上执行本命令，将VLAN接口配置为分布式DR接口，从而强制指定自己为DR，以便将组播流量转发至本地网络。

在组播VXLAN组网中，需要在分布式EVPN网关的VSI虚接口上执行本命令将VSI虚接口配置为分布式DR接口，从而强制指定自己为DR，用于将组播流量转发至本地站点。关于组播VXLAN的详细介绍，请参见“EVPN配置指导”中的“组播VXLAN”。

【举例】

# 配置接口Vlan-interface1为分布式DR接口。

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] pim distributed-dr

1.1.35 pim dm

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

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

【命令】

pim dm

undo pim dm

【缺省情况】

PIM-DM处于关闭状态。

【视图】

接口视图

【缺省用户角色】

network-admin

【使用指导】

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

【举例】

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

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim dm

【相关命令】

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

1.1.36 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。

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

【举例】

# 在接口Vlan-interface100上配置竞选DR的优先级为3。

<Sysname> system-view

[Sysname] interface vlan-interface 100

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

【相关命令】

· hello-option dr-priority (PIM view)

1.1.37 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秒。

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

【举例】

# 在接口Vlan-interface100上配置保持PIM邻居可达状态的时间为120秒。

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option holdtime 120

【相关命令】

· hello-option holdtime (PIM view)

1.1.38 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毫秒。

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

【举例】

# 在接口Vlan-interface100上配置PIM报文在共享网段中的传输延迟为200毫秒。

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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.39 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

【缺省情况】

接口上的邻居跟踪功能处于关闭状态。

【视图】

接口视图

【缺省用户角色】

network-admin

【使用指导】

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

【举例】

# 在接口Vlan-interface100上开启邻居跟踪功能。

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option neighbor-tracking

# 在公网实例全局开启了邻居跟踪功能的情况下，关闭接口Vlan-interface100上的邻居跟踪功能。

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option neighbor-tracking

[Sysname-pim] quit

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option neighbor-tracking disable

【相关命令】

· hello-option neighbor-tracking (PIM view)

1.1.40 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毫秒。

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

【举例】

# 在接口Vlan-interface100上配置剪枝否决时间为2000毫秒。

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] 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.41 pim holdtime join-prune

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

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

【命令】

pim holdtime join-prune time

undo pim holdtime join-prune

【缺省情况】

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

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

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

【举例】

# 在接口Vlan-interface100上配置加入/剪枝状态的保持时间为280秒。

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim holdtime join-prune 280

【相关命令】

· holdtime join-prune (PIM view)

· pim timer join-prune

1.1.42 pim join-policy

pim join-policy命令用来在接口上配置PIM加入/剪枝报文中加入信息的过滤规则。

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

仅Release 6616及以上版本支持本命令。

【命令】

pim join-policy { { ipv4-acl-number | name ipv4-acl-name } | [ asm { ipv4-acl-number | name ipv4-acl-name } | ssm { ipv4-acl-number | name ipv4-acl-name } ] * }

undo pim join-policy

【缺省情况】

不过滤PIM加入/剪枝报文中的加入信息。

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

ipv4-acl-number：指定IPv4基本或高级ACL的编号，其中基本IPv4 ACL的取值范围为2000～2999，高级IPv4 ACL的取值范围为3000～3999。当指定的ACL不存在或ACL中未配置有效规则，则过滤掉所有的加入信息。

name ipv4-acl-name：指定IPv4基本或高级ACL的名称，为1～63个字符的字符串，不区分大小写，必须以英文字母a～z或A～Z开头。为避免混淆，ACL的名称不允许使用英文单词all。当指定的ACL不存在或ACL中未配置有效规则，则过滤掉所有的加入信息。

asm { ipv4-acl-number | name ipv4-acl-name }：过滤组地址在ASM范围内的加入信息，取值范围为2000～3999。如果未指定本参数、指定的ACL不存在或ACL中未配置有效规则，则过滤掉ASM范围内所有的加入信息。其中：

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

· name ipv4-acl-name：指定IPv4基本或者高级ACL的名称，为1～63个字符的字符串，不区分大小写，必须以英文字母a～z或A～Z开头。为避免混淆，ACL的名称不允许使用英文单词all。

ssm { ipv4-acl-number | name ipv4-acl-name }：过滤组地址在SSM范围内的加入信息，取值范围为2000～3999。如果未指定本参数、指定的ACL不存在或ACL中未配置有效规则，则过滤掉SSM范围内所有的加入信息。其中：

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

【使用指导】

此命令对PIM-DM不生效。

为了防止设备受到非法PIM加入/剪枝报文攻击，通过本命令可以配置过滤规则，限制PIM加入/剪枝报文中加入信息的合法源地址范围和组地址范围，丢弃不合法的加入信息，不建立对应的（*，G）或（S，G）表项。

对于IPv4基本ACL，该ACL规则中的source参数用来指定PIM加入/剪枝报文中加入信息的组播组地址范围，并且该规则中除source、fragment和time-range以外的其它可选参数都将被忽略。

对于IPv4高级ACL，该ACL规则中的source参数用来指定PIM加入/剪枝报文中加入信息的组播源地址范围（对于（*，G）信息，其组播源地址为0.0.0.0），destination参数用来指定加入信息的组播组地址范围，并且该规则中除source、destination、fragment和time-range以外的其它可选参数都将被忽略。

若ACL中指定了vpn-instance参数则该条规则不生效。

多次执行本命令，最后一次执行的命令生效。

【举例】

# 在接口Vlan-interface100上配置过滤规则，只允许接收源地址范围是10.10.0.0/16，组地址范围是225.1.0.0/16的加入信息。

<Sysname> system-view

[Sysname] acl advanced 3005

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

[Sysname-acl-ipv4-adv-3005] quit

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim join-policy ssm 3005

1.1.43 pim neighbor-policy

pim neighbor-policy命令用来配置合法Hello报文的源地址范围。

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

【命令】

pim neighbor-policy { ipv4-acl-number | name ipv4-acl-name }

undo pim neighbor-policy

【缺省情况】

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

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

ipv4-acl-number：指定IPv4基本ACL的编号，取值范围为2000～2999。当指定的ACL编号不存在或ACL中未配置有效规则，则过滤所有的Hello报文源地址，即认为所有收到的Hello报文都是非法的。

name ipv4-acl-name：指定IPv4基本或者高级ACL的名称，为1～63个字符的字符串，不区分大小写，必须以英文字母a～z或A～Z开头。为避免混淆，ACL的名称不允许使用英文单词all。当指定的ACL名称不存在或ACL中未配置有效规则，则过滤所有的Hello报文源地址，即认为所有收到的Hello报文都是非法的。

仅Release 6616及以上版本支持name ipv4-acl-name参数。

【使用指导】

配置合法Hello报文的源地址范围可以防止Hello报文欺骗。

该ACL规则中的source参数用来指定合法Hello报文的源地址范围，只要Hello报文的源地址匹配该规则，该规则便生效。该规则中除source、fragment和time-range以外的其它可选参数都将被忽略。

若ACL中指定了vpn-instance参数则该条规则不生效。

多次执行本命令，最后一次执行的命令生效。

【举例】

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

<Sysname> system-view

[Sysname] acl basic 2000

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

[Sysname-acl-ipv4-basic-2000] quit

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim neighbor-policy 2000

1.1.44 pim non-stop-routing

pim non-stop-routing命令用来开启PIM协议的NSR功能。

undo pim non-stop-routing命令用来关闭PIM协议的NSR功能。

【命令】

pim non-stop-routing

undo pim non-stop-routing

【缺省情况】

PIM协议的NSR功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【举例】

# 开启PIM协议的NSR功能。

<Sysname> system-view

[Sysname] pim non-stop-routing

1.1.45 pim passive

pim passive命令用来在接口上开启PIM消极模式。

undo pim passive命令用来在接口上关闭PIM消极模式。

【命令】

pim passive

undo pim passive

【缺省情况】

接口上的PIM消极模式处于关闭状态。

【视图】

接口视图

【缺省用户角色】

network-admin

【使用指导】

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

【举例】

# 使能公网实例中的IP组播路由，在接口Vlan-interface100上使能PIM-DM，并开启PIM消极模式。

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim dm

[Sysname-Vlan-interface100] pim passive

1.1.46 pim require-genid

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

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

【命令】

pim require-genid

undo pim require-genid

【缺省情况】

接受无Generation ID的Hello报文。

【视图】

接口视图

【缺省用户角色】

network-admin

【举例】

# 配置接口Vlan-interface100拒绝无Generation ID的Hello报文。

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim require-genid

1.1.47 pim sm

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

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

【命令】

pim sm

undo pim sm

【缺省情况】

PIM-SM处于关闭状态。

【视图】

接口视图

【缺省用户角色】

network-admin

【使用指导】

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

【举例】

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

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim sm

【相关命令】

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

1.1.48 pim state-refresh-capable

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

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

【命令】

pim state-refresh-capable

undo pim state-refresh-capable

【缺省情况】

状态刷新能力处于开启状态。

【视图】

接口视图

【缺省用户角色】

network-admin

【举例】

# 在接口Vlan-interface100上关闭状态刷新能力。

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] undo pim state-refresh-capable

【相关命令】

· state-refresh-interval (PIM view)

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

· state-refresh-ttl (PIM view)

1.1.49 pim timer graft-retry

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

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

【命令】

pim timer graft-retry interval

undo pim timer graft-retry

【缺省情况】

嫁接报文的重传时间为3秒。

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

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

【举例】

# 在接口Vlan-interface100上配置嫁接报文的重传时间为80秒。

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim timer graft-retry 80

1.1.50 pim timer hello

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

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

【命令】

pim timer hello interval

undo pim timer hello

【缺省情况】

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

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

【举例】

# 在接口Vlan-interface100上配置发送Hello报文的时间间隔为40秒。

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim timer hello 40

【相关命令】

· timer hello (PIM view)

1.1.51 pim timer join-prune

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

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

【命令】

pim timer join-prune interval

undo pim timer join-prune

【缺省情况】

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

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

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

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

【举例】

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

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim timer join-prune 80

【相关命令】

· pim holdtime join-prune

· timer join-prune (PIM view)

1.1.52 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秒。

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

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

【举例】

# 在接口Vlan-interface100上配置触发Hello报文的最大延迟时间为3秒。

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim triggered-hello-delay 3

1.1.53 pim triggered-hello enable

pim triggered-hello enable命令用来配置设备在端口链路状态发生变化时立刻发送Generation ID变化的Hello报文，以及时更新组播转发表项。

undo pim triggered-hello enable命令用来取消在端口链路状态发生变化时立刻发送Generation ID变化的Hello报文。

【命令】

pim triggered-hello enable { port-down | port-up } *

undo pim triggered-hello enable [ port-down | port-up ]

【缺省情况】

设备不会因为端口链路状态发生变化而立刻发送Generation ID变化的Hello报文。

【视图】

VLAN接口视图

【缺省用户角色】

network-admin

【参数】

port-down：指定端口状态变为down时，立刻发送Generation ID变化的Hello报文。

port-up：指定端口状态变为up时，立刻发送Generation ID变化的Hello报文。

【使用指导】

为了提高可靠性，组播转发路径中的下游设备通过同一VLAN内的多个二层接口接入上游设备。当上游设备上的二层端口链路状态发生故障或者故障恢复时，下游设备需要切换到新的端口或者回切到该端口接入设备。在这些情况下，下游设备通常不会立即发送PIM加入报文，导致组播数据不能及时切换到变更后的路径上。执行本命令后，设备上指定VLAN接口对应VLAN内的端口链路状态变化时，设备主动发送Generation ID变化的Hello报文，以触发下游设备立即发送PIM加入报文，更新组播转发表项，将组播数据流迅速切换到新的转发路径上。

执行undo pim triggered-hello enable命令时，如果没有指定任何参数，则表示端口状态变为down和up时，都不会立刻发送Generation ID变化的Hello报文。

【举例】

# 配置设备在端口链路状态发生变化时立刻发送Generation ID变化的Hello报文。

<Sysname> system-view

[Sysname] interface vlan-interface 10

[Sysname-Vlan-interface10] pim triggered-hello enable port-down port-up

1.1.54 register-policy (PIM view)

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

【命令】

undo register-policy

【缺省情况】

不存在注册报文的过滤策略，所有注册报文都是合法的。

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

ipv4-acl-number：指定IPv4高级ACL的编号，取值范围为3000～3999。当指定的ACL不存在或ACL中未配置有效规则，则过滤所有的注册报文。

name ipv4-acl-name：指定IPv4基本或者高级ACL的名称，为1～63个字符的字符串，不区分大小写，必须以英文字母a～z或A～Z开头。为避免混淆，ACL的名称不允许使用英文单词all。当指定的ACL不存在或ACL中未配置有效规则，则过滤所有的注册报文。

仅Release 6616及以上版本支持name ipv4-acl-name参数。

【使用指导】

若指定的ACL名称为高级ACL名称，该ACL规则中的source参数用来指定注册报文中的组播源地址范围，destination参数用来指定组播组地址范围，只有source和destination参数均匹配该规则，该规则才生效。该规则中除source、destination、fragment和time-range以外的其它可选参数都将被忽略。

当配置基本ACL名称时，该ACL规则中的source参数用来指定注册报文中的组播源地址范围。

只要注册报文中的组播源地址匹配该规则，该规则便生效。并且该规则中除source、fragment和time-range以外的其它可选参数都将被忽略。

若ACL中指定了vpn-instance参数则该条规则不生效。

多次执行本命令，最后一次执行的命令生效。

【举例】

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

<Sysname> system-view

[Sysname] acl advanced 3000

[Sysname-acl-ipv4-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-ipv4-adv-3000] quit

[Sysname] pim

[Sysname-pim] register-policy 3000

1.1.55 register-suppression-timeout (PIM view)

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

【命令】

undo register-suppression-timeout

【缺省情况】

注册抑制时间为60秒。

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

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

【举例】

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

<Sysname> system-view

[Sysname] pim

[Sysname-pim] register-suppression-timeout 70

1.1.56 register-whole-checksum (PIM view)

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

【命令】

undo register-whole-checksum

【缺省情况】

仅根据注册报文头来计算校验和。

【视图】

PIM视图

【缺省用户角色】

network-admin

【举例】

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

<Sysname> system-view

[Sysname] pim

[Sysname-pim] register-whole-checksum

1.1.57 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的告警功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

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

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

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

【使用指导】

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

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

【举例】

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

<Sysname> system-view

[Sysname] undo snmp-agent trap enable pim

1.1.58 source-lifetime (PIM view)

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

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

【命令】

source-lifetime time

undo source-lifetime

【缺省情况】

组播源的生存时间为210秒。

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

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

【举例】

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

<Sysname> system-view

[Sysname] pim

[Sysname-pim] source-lifetime 200

1.1.59 source-policy (PIM view)

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

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

【命令】

source-policy ipv4-acl-number

undo source-policy

【缺省情况】

不存在组播数据过滤器，不对组播数据进行过滤。

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

对于IPv4基本ACL，该ACL规则中的source参数用来指定组播数据报文的源地址范围，并且该规则中除source、fragment和time-range以外的其它可选参数都将被忽略。

对于IPv4高级ACL，该ACL规则中的source参数用来指定组播数据报文中的组播源地址范围，destination参数用来指定组播组地址范围，并且该规则中除source、destination、fragment和time-range以外的其它可选参数都将被忽略。

若ACL中指定了vpn-instance参数则该条规则不生效。

多次执行本命令，最后一次执行的命令生效。

【举例】

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

<Sysname> system-view

[Sysname] acl basic 2000

[Sysname-acl-ipv4-basic-2000] rule permit source 10.10.1.2 0

[Sysname-acl-ipv4-basic-2000] rule deny source 10.10.1.1 0

[Sysname-acl-ipv4-basic-2000] quit

[Sysname] pim

[Sysname-pim] source-policy 2000

1.1.60 spt-switch-threshold (PIM view)

spt-switch-threshold命令用来配置发起SPT切换的条件。

undo spt-switch-threshold命令用来删除指定的发起SPT切换的条件。

【命令】

spt-switch-threshold { immediacy | infinity } [ group-policy ipv4-acl-number ]

undo spt-switch-threshold [ immediacy | infinity ] [ group-policy ipv4-acl-number ]

【缺省情况】

设备收到第一个组播数据包后便立即向SPT切换。

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

immediacy：表示立即发起SPT切换。

infinity：表示永不发起SPT切换。

group-policy ipv4-acl-number：表示组策略列表中的一项，与该组策略匹配的组播组将应用本配置。ipv4-acl-number表示IPv4基本ACL的编号，取值范围为2000～2999。如果未指定本参数、指定的ACL不存在或ACL中未配置有效规则，则本配置将应用于所有组播组。

【使用指导】

该ACL规则中的source参数用来指定组播组地址范围，并且该规则中除source、fragment和time-range以外的其它可选参数都将被忽略。

若ACL中指定了vpn-instance参数则该条规则不生效。

由于某些设备无法将组播报文封装在注册报文中发给RP，因此在可能成为RP的设备上不建议配置永不发起SPT切换，以免导致组播报文转发失败。

【举例】

# 在接收者侧DR的公网实例中配置永不发起SPT切换。

<Sysname> system-view

[Sysname] pim

[Sysname-pim] spt-switch-threshold infinity

1.1.61 ssm-policy (PIM view)

ssm-policy命令用来配置SSM组播组的范围。

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

【命令】

ssm-policy { ipv4-acl-number | name ipv4-acl-name }

undo ssm-policy

【缺省情况】

SSM组播组的范围为232.0.0.0/8。

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

ipv4-acl-number：指定基本ACL的编号，取值范围为2000～2999。当指定的ACL不存在或ACL中未配置有效规则，则过滤掉所有SSM组播组地址。

name ipv4-acl-name：指定IPv4基本或者高级ACL的名称，为1～63个字符的字符串，不区分大小写，必须以英文字母a～z或A～Z开头。为避免混淆，ACL的名称不允许使用英文单词all。当指定的ACL不存在或ACL中未配置有效规则，则过滤掉所有SSM组播组地址。

仅Release 6616及以上版本支持name ipv4-acl-name参数。

【使用指导】

通过本命令可以定义允许或拒绝的组播组的地址范围：如果匹配通过，则组播运行模式为PIM-SSM，否则为PIM-SM。

该ACL规则中的source参数用来指定SSM组播组范围，只要SSM组播组地址匹配该规则，该规则便生效。该规则中除source、fragment和time-range以外的其它可选参数都将被忽略。

若ACL中指定了vpn-instance参数则该条规则不生效。

多次执行本命令，最后一次执行的命令生效。

【举例】

# 配置SSM组播组的范围232.1.0.0/16。

<Sysname> system-view

[Sysname] acl basic 2000

[Sysname-acl-ipv4-basic-2000] rule permit source 232.1.0.0 0.0.255.255

[Sysname-acl-ipv4-basic-2000] quit

[Sysname] pim

[Sysname-pim] ssm-policy 2000

1.1.62 state-refresh-interval (PIM view)

state-refresh-interval命令用来配置发送状态刷新报文的时间间隔。

undo state-refresh-interval命令用来恢复缺省情况。

【命令】

state-refresh-interval interval

undo state-refresh-interval

【缺省情况】

发送状态刷新报文的时间间隔为60秒。

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

interval：指定发送状态刷新报文的时间间隔，取值范围为1～255，单位为秒。

【举例】

# 在公网实例中配置发送状态刷新报文的时间间隔为70秒。

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-interval 70

【相关命令】

· pim state-refresh-capable

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

· state-refresh-ttl (PIM view)

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

state-refresh-rate-limit命令用来配置接收新状态刷新报文的等待时间。

undo state-refresh-rate-limit命令用来恢复缺省情况。

【命令】

state-refresh-rate-limit time

undo state-refresh-rate-limit

【缺省情况】

接收新状态刷新报文的等待时间为30秒。

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

time：指定接收新状态刷新报文的等待时间，取值范围为1～65535，单位为秒。

【举例】

# 在公网实例中配置接收新状态刷新报文的等待时间为45秒。

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-rate-limit 45

【相关命令】

· pim state-refresh-capable

· state-refresh-interval (PIM view)

· state-refresh-ttl (PIM view)

1.1.64 state-refresh-ttl (PIM view)

state-refresh-ttl命令用来配置状态刷新报文的TTL值。

undo state-refresh-ttl命令用来恢复缺省情况。

【命令】

state-refresh-ttl ttl-value

undo state-refresh-ttl

【缺省情况】

状态刷新报文的TTL值为255。

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

ttl-value：指定状态刷新报文的TTL值，取值范围为1～255。

【举例】

# 在公网实例中配置状态刷新报文的TTL值为45。

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-ttl 45

【相关命令】

· pim state-refresh-capable

· state-refresh-interval (PIM view)

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

1.1.65 static-rp (PIM view)

static-rp命令用来配置静态RP。

undo static-rp命令用来删除静态RP。

【命令】

static-rp rp-address [{ ipv4-acl-number | name ipv4-acl-number } | bidir | preferred ] *

undo static-rp rp-address

【缺省情况】

不存在静态RP。

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

rp-address：指定静态RP的IP地址。该地址必须是实际存在且合法的单播IP地址，不能配置为127.0.0.0/8网段的地址；但对于服务于双向PIM的静态RP来说，允许将其IP地址指定为一个实际不存在的IP地址。

ipv4-acl-number：指定IPv4基本ACL的编号，取值范围为2000～2999。如果指定了本参数，该静态RP将只为能够通过该过滤规则的组播组服务；如果未指定本参数、指定的ACL不存在或ACL中未配置有效规则，则该静态RP将为所有组播组服务。

name ipv4-acl-name：指定IPv4 基本或者ACL的名称，为1～63个字符的字符串，不区分大小写，必须以英文字母a～z或A～Z开头。为避免混淆，ACL的名称不允许使用英文单词all。如果指定了本参数，该静态RP将只为能够通过该过滤规则的组播组服务；如果未指定本参数、指定的ACL不存在或ACL中未配置有效规则，则该静态RP将为所有组播组服务。

仅Release 6616及以上版本支持name ipv4-acl-name参数。

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

preferred：表示当网络中同时存在动态RP和静态RP时，优先选择静态RP，只有当静态RP失效时，动态RP才能生效。如果未指定本参数，则表示优先选择动态RP，只有当未配置动态RP或动态RP失效时，静态RP才能生效。

【使用指导】

作为静态RP的接口不必使能PIM。

该ACL规则中的source参数用来指定静态RP所服务的组播组范围，只要静态RP所服务的组播组地址匹配该规则，该规则便生效。该规则中除source、fragment和time-range以外的其它可选参数都将被忽略。

若ACL中指定了vpn-instance参数则该条规则不生效。

当某个静态RP引用的ACL规则发生变化时，需要为所有组播组重新选举RP。

多次执行本命令，可以配置多个静态RP。但是，如果配置时所指定的静态RP地址或ACL规则相同，则最后一次执行的命令生效；如果存在多个静态RP服务于同一组播组的情况，则选择IP地址最大的静态RP为该组服务。

【举例】

# 在公网实例中配置IP地址为11.110.0.6的接口为静态RP，为组播组225.1.1.0/24提供服务，并优先选择静态RP。

<Sysname> system-view

[Sysname] acl basic 2001

[Sysname-acl-ipv4-basic-2001] rule permit source 225.1.1.0 0.0.0.255

[Sysname-acl-ipv4-basic-2001] quit

[Sysname] pim

[Sysname-pim] static-rp 11.110.0.6 2001 preferred

【相关命令】

· display pim rp-info

1.1.66 timer hello (PIM view)

timer hello命令用来全局配置发送Hello报文的时间间隔。

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

【命令】

timer hello interval

undo timer hello

【缺省情况】

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

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

【举例】

# 在公网实例中全局配置发送Hello报文的时间间隔为40秒。

<Sysname> system-view

[Sysname] pim

[Sysname-pim] timer hello 40

【相关命令】

· pim timer hello

1.1.67 timer join-prune (PIM view)

timer join-prune命令用来全局配置发送加入/剪枝报文的时间间隔。

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

【命令】

timer join-prune interval

undo timer join-prune

【缺省情况】

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

【视图】

PIM视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

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

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

【举例】

# 在公网实例中全局配置发送加入/剪枝报文的时间间隔为80秒。

<Sysname> system-view

[Sysname] pim

[Sysname-pim] timer join-prune 80

【相关命令】

· holdtime join-prune (PIM view)

· pim timer join-prune

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!

热门推荐

热门推荐

H3C服务器

HPE服务器

热门推荐

H3C存储

HPE存储

热门推荐

商用台式机

商用笔记本

商用显示器

配件

热门推荐

热门推荐

智能终端

技术解决方案

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

专业安全服务

安全运营服务

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

技术支持

自助服务

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

公司刊物

加入我们

国家/地区

06-IP组播命令参考

目录

06-PIM命令

1.1 PIM配置命令

1.1.2 auto-rp enable (PIM view)

1.1.4 bidir-rp-limit (PIM view)

1.1.5 bsm-fragment enable (PIM view)

1.1.7 bsr-policy (PIM view)

1.1.8 c-bsr (PIM view)

1.1.9 c-bsr holdtime (PIM view)

1.1.10 c-bsr interval (PIM view)

1.1.11 c-rp (PIM view)

1.1.12 crp-policy (PIM view)

1.1.13 display interface register-tunnel

1.1.19 display pim neighbor

1.1.22 display pim statistics

1.1.24 hello-option dr-priority (PIM view)

1.1.25 hello-option holdtime (PIM view)

1.1.26 hello-option lan-delay (PIM view)

1.1.27 hello-option neighbor-tracking (PIM view)

1.1.28 hello-option override-interval (PIM view)

1.1.29 holdtime join-prune (PIM view)

1.1.30 jp-pkt-size (PIM view)

1.1.45 pim passive

1.1.54 register-policy (PIM view)

1.1.56 register-whole-checksum (PIM view)

1.1.58 source-lifetime (PIM view)

1.1.59 source-policy (PIM view)

1.1.60 spt-switch-threshold (PIM view)

1.1.62 state-refresh-interval (PIM view)

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

1.1.64 state-refresh-ttl (PIM view)

1.1.65 static-rp (PIM view)

1.1.66 timer hello (PIM view)

1.1.67 timer join-prune (PIM view)