interface-type interface-number: Specifies an interface by its type and number. This configuration can take effect only if PIM-SM is enabled on the interface.

hash-length: Hash mask length, 30 by default. If you do not include this keyword in your command, the corresponding global setting will be used.

priority: Priority of the C-BSR, 0 by default. If you do not include this keyword in your command, the corresponding global setting will be used. A larger value of this argument means a higher priority.

Description

Use the c-bsr command to configure the specified interface as a C-BSR.

Use the undo c-bsr command to remove the related C-BSR configuration.

No C-BSR is configured by default.

Note that any interface serving as a C-BSR must be PIM-SM enabled.

Related commands: pim sm, c-bsr priority, c-rp.

Examples

# Configure VLAN-interface 4 to be a C-BSR.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr vlan-interface 4

1.1.4 c-bsr admin-scope

Syntax

c-bsr admin-scope

undo c-bsr admin-scope

View

PIM view

Default Level

2: System level

Parameters

None

Description

Use the c-bsr admin-scope command to enable administrative scoping.

Use the undo c-bsr admin-scope command to disable administrative scoping.

By default, administrative scoping is disabled, namely only one BSR can exist in each PIM-SM domain.

Related commands: c-bsr, c-bsr group, c-bsr global.

Examples

# Enable administrative scoping.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr admin-scope

1.1.5 c-bsr global

Syntax

c-bsr global [ hash-length hash-length | priority priority ] *

undo c-bsr global

View

PIM view

Default Level

2: System level

Parameters

hash-length: Hash mask length in the global scope zone. If you do not include this keyword in your command, the corresponding global setting will be used.

priority: Priority of the C-BSR in the global scope zone. If you do not include this keyword in your command, the corresponding global setting will be used. A larger value of this argument means a higher priority.

Description

Use the c-bsr global command to configure a C-BSR for the global scope zone.

Use the undo c-bsr global command to remove the C-BSR configuration for the global scope zone.

By default, no C-BSRs are configured for the global scope zone.

Related commands: c-bsr group, c-bsr hash-length, c-bsr priority.

Examples

# Configure the device to be a C-BSR for the global scope zone, with the priority of 1.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr global priority 1

1.1.6 c-bsr group

Syntax

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

undo c-bsr group group-address

View

PIM view

Default Level

2: System level

Parameters

group-address: Multicast group address.

mask: Mask of the multicast group address.

mask-length: Mask length of the multicast group address.

hash-length: Hash mask length in the admin-scope region corresponding to the specified multicast group. If you do not include this keyword in your command, the corresponding global setting will be used.

priority: Priority of the C-BSR in the admin-scope region corresponding to a multicast group. If you do not include this keyword in your command, the corresponding global setting will be used. A larger value of this argument means a higher priority.

Description

Use the c-bsr group command to configure a C-BSR for the admin-scope region associated with the specified group.

Use the undo c-bsr group command to remove the C-BSR configuration for the admin-scope region associated with the specified group.

By default, no C-BSRs are configured for admin-scope regions.

Related commands: c-bsr global, c-bsr admin-scope, c-bsr hash-length, c-bsr priority.

Examples

# Configure the device to be a C-BSR in the admin-scope region associated with the multicast group address 239.0.0.0/8, with the priority of 10.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr group 239.0.0.0 255.0.0.0 priority 10

1.1.7 c-bsr hash-length

Syntax

c-bsr hash-length hash-length

undo c-bsr hash-length

View

PIM view

Default Level

2: System level

Parameters

hash-length: Hash mask length.

Description

Use the c-bsr hash-length command to configure the global Hash mask length.

Use the undo c-bsr hash-length command to restore the system default.

By default, the Hash mask length is 30.

Related commands: c-bsr, c-bsr global, c-bsr group.

Examples

# Set the global Hash mask length to 16.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr hash-length 16

1.1.8 c-bsr holdtime

Syntax

c-bsr holdtime interval

undo c-bsr holdtime

View

PIM view

Default Level

2: System level

Parameters

interval: Bootstrap timeout in seconds.

Description

Use the c-bsr holdtime command to configure the bootstrap timeout time, namely the length of time a C-BSR waits before it must receive a bootstrap message from the BSR.

Use the undo c-bsr holdtime command to restore the default setting.

By default, the bootstrap timeout value is determined by this formula: Bootstrap timeout = Bootstrap interval × 2 + 10.

& Note:

The default bootstrap interval is 60 seconds, so the default bootstrap timeout = 60 × 2 + 10 = 130 (seconds).

Related commands: c-bsr and c-bsr interval.

Examples

# Set the bootstrap timeout time to 150 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr holdtime 150

1.1.9 c-bsr interval

Syntax

c-bsr interval interval

undo c-bsr interval

View

PIM view

Default Level

2: System level

Parameters

interval: Bootstrap interval in seconds.

Description

Use the c-bsr interval command to configure the bootstrap interval, namely the interval at which the BSR sends bootstrap messages.

Use the undo c-bsr interval command to restore the default setting.

By default, the bootstrap interval value is determined by this formula: Bootstrap interval = (Bootstrap timeout – 10) / 2.

& Note:

The default bootstrap timeout is 130 seconds, so the default bootstrap interval = (130 – 10) / 2 = 60 (seconds).

Related commands: c-bsr, c-bsr holdtime.

Examples

# Set the bootstrap interval to 30 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr interval 30

1.1.10 c-bsr priority

Syntax

c-bsr priority priority

undo c-bsr priority

View

PIM view

Default Level

2: System level

Parameters

priority: Priority of the C-BSR. A larger value of this argument means a higher priority.

Description

Use the c-bsr priority command to configure the global C-BSR priority.

Use the undo c-bsr priority command to restore the default setting.

By default, the C-BSR priority is 0.

Related commands: c-bsr, c-bsr global, c-bsr group.

Examples

# Set the global C-BSR priority to 5.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr priority 5

1.1.11 c-rp

Syntax

c-rp interface-type interface-number [ group-policy acl-number | priority priority | holdtime hold-interval | advertisement-interval adv-interval ] *

undo c-rp interface-type interface-number

View

PIM view

Default Level

2: System level

Parameters

interface-type interface-number: Specifies an interface, the IP address of which will be advertised as a C-RP address.

acl-number: Basic ACL number. This ACL defines a range of multicast groups the C-RP is going to serve, rather than defining a filtering rule. Any group range matching the permit statement in the ACL will be advertised as an RP served group, while configurations matching other statements like deny will not take effect.

priority: Priority of the C-RP, defaulting to 0. A larger value of this argument means a lower priority.

hold-interval: C-RP timeout time, in seconds. The default value is 150 seconds. If you do not provide this argument in your command, the corresponding global setting will be used.

adv-interval: C-RP-Adv interval in seconds. The default value is 60 seconds. If you do not provide this argument in your command, the corresponding global setting will be used.

Description

Use the c-rp command to configure the specified interface a C-RP.

Use the undo c-rp command to remove the related C-RP configuration.

No C-RPs are configured by default.

Note that:

l Any interface serving as a C-RP must be PIM-SM enabled.

l If you do not specify a group range for the C-RP, the C-RP will serve all multicast groups.

l If you wish a device to be a C-RP for multiple group ranges, you need to include these multiple group ranges in multiple rules in the ACL corresponding to the group-policy keyword.

l If you carry out this command repeatedly on the same interface, the last configuration will take effect.

Related commands: c-bsr.

Examples

# Configure VLAN-interface 100 to be a C-RP for multicast groups 225.1.0.0/16 and 226.2.0.0/16, with a priority of 10.

<Sysname> system-view

[Sysname] acl number 2069

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

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

[Sysname-acl-basic-2069] quit

[Sysname] pim

[Sysname-pim] c-rp vlan-interface 100 group-policy 2069 priority 10

1.1.12 c-rp advertisement-interval

Syntax

c-rp advertisement-interval interval

undo c-rp advertisement-interval

View

PIM view

Default Level

2: System level

Parameters

interval: C-RP-Adv interval in seconds.

Description

Use the c-rp advertisement-interval command to configure the interval at which C-RP-Adv messages are sent.

Use the undo c-rp advertisement-interval command to restore the default setting.

By default, the C-RP-Adv interval is 60 seconds.

Related commands: c-rp.

Examples

# Set the global C-RP-Adv interval to 30 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-rp advertisement-interval 30

1.1.13 c-rp holdtime

Syntax

c-rp holdtime interval

undo c-rp holdtime

View

PIM view

Default Level

2: System level

Parameters

interval: C-RP timeout in seconds.

Description

Use the c-rp holdtime command to configure the global C-RP timeout time, namely the length of time the BSR waits before it must receive a C-RP-Adv message from C-RPs.

Use the undo c-rp holdtime command to restore the default setting.

By default, the C-RP timeout time is 150 seconds.

Because a non-BSR router refreshes its C-RP timeout time through BSR bootstrap messages, to prevent loss of C-RP information in BSR bootstrap messages, make sure that the C-RP timeout time is not smaller than the interval at which the BSR sends bootstrap messages. The recommended C-RP timeout setting is 2.5 times the bootstrap interval or longer.

Related commands: c-rp, c-bsr interval.

Examples

# Set the global C-RP timeout time to 200 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-rp holdtime 200

1.1.14 crp-policy

Syntax

crp-policy acl-number

undo crp-policy

View

PIM view

Default Level

2: System level

Parameters

acl-number: Advanced ACL number. When the ACL is defined, the source keyword in the rule command specifies the address of a C-RP and the destination keyword specifies the address range of the multicast groups that the C-RP will serve.

Description

Use the crp-policy command to configure a legal C-RP address range and the range of served multicast groups, so as to guard against C-RP spoofing.

Use the undo crp-policy command to remove the restrictions in C-RP address ranges and the ranges of served multicast groups.

By default, there are no restrictions on C-RP address ranges and the address ranges of served groups, namely all received C-RP messages are accepted.

Examples

# Configure a C-RP address range and a range of served multicast groups so that only routers in the address range of 1.1.1.1/32 can be C-RPs and these C-RPs can serve only multicast groups in the address range of 225.1.0.0/16.

<Sysname> system-view

[Sysname] acl number 3100

[Sysname-acl-adv-3100] rule permit ip source 1.1.1.1 0 destination 225.1.0.0 0.0.255.255

[Sysname-acl-adv-3100] quit

[Sysname] pim

[Sysname-pim] crp-policy 3100

1.1.15 debugging pim

Syntax

debugging pim { all | event [ advanced-acl-number ] | routing-table [ advanced-acl-number ] | neighbor [ basic-acl-number ] [ receive | send ] | assert [ advanced-acl-number ] [ receive | send ] | rp [ receive | send ] | join-prune [ advanced-acl-number ] [ receive | send ] | register [ advanced-acl-number ] | msdp [ advanced-acl-number ] | state-refresh [ advanced-acl-number ] [ receive | send ] }

undo debugging pim { all | event | routing-table | neighbor [ receive | send ] | assert [ receive | send ] | state-refresh [ receive | send ] | rp [ receive | send ] | join-prune [ receive | send ] | register | msdp }

View

User view

Default Level

1: Monitor level

Parameters

all: All types of PIM debugging.

event: PIM event debugging.

advanced-acl-number: Advanced ACL number.

routing-table: PIM Debugging for routing table state changes.

neighbor: PIM neighbor debugging.

basic-acl-number: Basic ACL number.

receive: PIM debugging for received messages.

send: PIM debugging for sent messages.

assert: PIM debugging for assert messages. Currently, S9500 series routing switches do not support this parameter.

rp: Specifies PIM RP debugging.

join-prune: Specifies PIM debugging for join-prune messages.

register: Specifies PIM debugging for register messages.

msdp: Specifies PIM-MSDP interaction debugging.

state-refresh: Specifies PIM state-refresh debugging.

Description

Use the debugging pim command to enable PIM debugging.

Use the undo debugging pim command to disable PIM debugging.

By default, PIM debugging is disabled.

Table 1-1 debugging pim event command output description

Field	Description
unsupported PIM version	PIM version not supported
PIM packet too short	The PIM message length is too short
checksum error	Checksum error
non-pim interface	A PIM message is received on a non-PIM-enabled interface.
unsupported type	PIM messages of the specified type are not supported
Socket set option error	Failed to set socket option
Packet send error	Failed to send PIM message
Source address is one of the interfaces address	The source address is the address of the local interface
Source address address is invalid	The source address is invalid
Invalid source mask	Incorrect source address mask
Active event received	A source-active event was received.
Inactive event received	A source-inactive event was received.
Clear event received	A clear-entry event was received.
Wrong IIF	Incorrect incoming interface
NoInfo	The downstream state machine is in the Noinfo state.
PPending	The downstream state machine is in the Prune Pending state.
Pruned	The PIM-DM downstream state machine is in the Pruned state.
Joined	The PIM-SM downstream state machine is in the Joined state.
Forwarding	The PIM-DM upstream state machine is in the Forward state.
Pruned	The PIM-DM upstream state machine is in the Pruned state.
AckPending	The PIM-DM upstream state machine is in the Ack Pending state.
Joined	The PIM-SM (S, G) or (*, G) upstream state machine is in the Joined state.
NotJoined	The PIM-SM (S, G) or (*, G) upstream state machine is in the Not Joined state.
PruneTmp	The PIM-SM (S, G, RPT) downstream state machine is in the Prune Tmp state.
PPendingTmp	The PIM-SM (S, G, RPT) downstream state machine is in the Prune Pending Tmp state.
PPT Expired	The prune pending timer timed out.
RPF_Interface changed	The RPF interface changed.
Genid changed	The neighbor generation ID changed.
PT Expired	The prune timer timed out.
Failed to pass MSF	Failed to pass multicast source filtering
NotOriginator	The originator state machine is in the Not Originator state.
Originator	The originator state machine is in the Originator state.
SAT Expired	The source-alive timer timed out.
Join suppressed	The device received a join message to the upstream neighbor on the incoming interface and suppressed its own join message
Override it	The device received a prune message to the upstream neighbor on the incoming interface and sent a join message
ET Expired	The PIM-SM downstream interface aging timer timed out.
register downstream	Registering the outgoing interface
Mcast-Boundary-Changed	Multicast boundary change event

Table 1-2 debugging pim join-assert command output description

Field	Description
JP	Join/prune message
GFT	Graft message
GAK	Graft-ack message
receiving	Message received
sending	Message sent
unknown address	Unknown address, address decoding failed
bad group address, mask or family	Incorrect group address, mask or family
Bad source address, mask or family	Incorrect source address, mask or family
Upstream	Upstream neighbor information in the message
Groups	Number of groups in the message
Group: addr/mask --- m joins n prunes	Group information in the message: group address/mask length --- m joins and n prunes
Join: addr/mask flag	Join: source address/ mask flag
Message truncated. Ignoring message	The message was dropped due to invalid message length
Unable to decode address	Address decoding failed
Upstream neighbor is not this router. Ignoring	The message was dropped because the upstream neighbor is not this device.
group boundary detected for address1 on address2	address1 is within the multicast boundary configured on the interface corresponding to address2
Group address1 ignored in message on address2	address1 is within the multicast boundary configured on the interface corresponding to address2, and this group is ignored
Message from unknown neighbor	A message was received from an unknown neighbor.
Join/Prune received for non-local neighbor	A join/prune message for a non-local upstream neighbor was received
Override timer expires	The prune override timer timed out.

Table 1-3 debugging pim neighbor command output description

Field	Description
HEL	PIM hello message
hello packet	PIM hello message
receiving	Message received
sending	Message sent
on interfacename	Interface on which the message was received or sent
Option: m, length: n	PIM hello message option: option value, option length: length value
Holdtime:	Holdtime field of the PIM hello message
Tbit	Tbit option
Lan delay	LAN delay option
Override interval	Override interval option
DR priority	DR priority option
Genid	Generation ID option
Version	Version field of the state refresh option
Refresh interval	State refresh interval field
Reserved	Reserved field of the state refresh option
Secondary address(es)	Address in the address list option
Unknown option value	Unknown option
without SR capability	No state refresh capability
Elected as DR on interface interfacename	Elected as the DR for the network attached to interfacename
Unelected as DR on interface interfacename	No longer the DR for the network attached to interfacename
PIM Neighbor address on interface interfacename timed out	Neighbor address on interfacename timed out

Table 1-4 debugging pim register command output description

Field	Description
REG	Register message
RSP	Register-stop message
Register Stop	Register stopped
receiving	Message received
sending	Message sent
Border bit	Boundary bit
Null bit	Null bit
src	Source address of the IP packet
dst	Destination address of the IP packet
Non-DR interface	Non-DR interface
probe	Probe message
ignored	Message dropped

Table 1-5 debugging pim routing-table command output description

Field	Description
Creating	Creating entries
Deleting	Deleting entries
mrt	Multicast routing table
Add oil	Adding outgoing interfaces
Del oil	Deleting outgoing interfaces
Null iif	Null incoming interface
Adding iif	Adding incoming interfaces
Deleting iif	Deleting incoming interfaces
RP is not found	RP is not found

Table 1-6 debugging pim rp command output description

Field	Description
receiving	Message received
sending	Message sent
auto-RP announce	auto-RP announce message
auto-RP discovery	auto-RP discovery message
C-RP	Candidate RP
CRP	Candidate RP
BSR	Bootstrap router
prefix count	Prefix count field in the C-RP advertisement message
priority	Priority field in the C-RP advertisement message
holdtime	Holdtime field in the C-RP advertisement message
Admin Scope Zone	admin-scope region
Bad BSR address	Incorrect BSR address
frag	Fragment tag field in the BSR bootstrap message
pri	Priority field in the BSR bootstrap message
hash mask len	Hash mask length field in the BSR bootstrap message
Group address/length: frags m, C-RP's n	The frags filed corresponding to address/length in the BSR bootstrap message is set to m. The number of C-RPs is n.
address pri: m, holdtime: n	The priority of C-RP address in the BSR bootstrap message is m and holdtime is n
Auto-RP discovery packet: RP agent address, RP count m, Holdtime n	An auto-RP discovery message was received: RP agent is address; RP count is m; and holdtime is n
delete RP-Set	Deleting an RP set
too short length	Message length is too short.
wrong RP agent address	Incorrect RP agent address
wrong RP address	Incorrect RP address
bad group address	Incorrect group address
bad group mask length	Incorrect group mask
bad BSR address	Incorrect BSR address
bad BSR address family	Incorrect BSR address family
bad BSR hash mask length	Incorrect BSR hash mask length
bad scope zone mask	Incorrect admin-scope mask
Unknown group address family	Incorrect group address family
not directly connected source	Address of a source not directly connected
unknown neighbor	Unknown neighbor
ACL	Access control list
Bad frag-rp-count field	Incorrect frag-rp-count field in the BSR bootstrap message
Bad frag-rp field length	Incorrect total length of frag-rp fields in the BSR bootstrap message
BSR mechanism	BSR mechanism independent of administrative scoping
Upstream to BSR	Upstream to the BSR
no BSR is available	No available BSR.
add register vif	Adding a register virtual interface
Remove register vif	Removing a register virtual interface
Expiring CRP	Aged C-RP
Lose the ASBSR election	Device lost the BSR election for the admin-scope region
Lose the BSR election	Lose the BSR election
locally scoped	Node-local or link-local scope
RP changed	The RP changed.
pending state	The BSR changed to the pending state.
Update the BSR's state to elected	The BSR changed to the elected state.
RPF Failure	RPF check failed.
admin scope multicast address	Address in the admin-scope range

Table 1-7 debugging pim state refresh command output description

Field	Description
SRM	State refresh message
sending	Message sent
receiving	Message received
Message truncated	Message length is invalid
bad group address	Incorrect group address
Invalid group mask length	Incorrect group mask length
Group address	Group address
Source address	Source address
Originator address	Address of the state refresh message originator
preference	Preference field of the message
metric	Metric field of the message
mask length	Mask length field of the message
ttl	TTL value of the message
prune indicator	Prune indicator flag bit
prune now	Prune now indicator flag bit
assert override	Assert override flag bit

Examples

# Enable debugging for PIM events.

<Sysname> debugging pim event

*Mar 26 14:18:10:635 2007 Sysname PIM/7/EVENT: PIM-SM: Downstream (*, 229.0.0.1) on interface Vlan-interface10 (10.1.1.2) FSM transited from Joined to PPending. Prune Received (S151270)

// A prune message was received. The downstream state machine of the outgoing interface VLAN-interface 10 (10.1.1.2) of the PIM-SM entry (*, 229.0.0.1) transferred from Joined to Prune Pending.

*Mar 26 14:18:12:635 2007 Sysname PIM/7/EVENT: PIM-SM: Downstream (*, 229.0.0.1) on interface Vlan-interface10 (10.1.1.2) FSM transited from PPending to NoInfo. PPT Expired (S15760)

// Since the Prune Pending timer timed out, the downstream state machine of the outgoing interface VLAN-interface 10 (10.1.1.2) of the PIM-SM entry (*, 229.0.0.1) transferred from Prune Pending to NoInfo.

1.1.16 display pim bsr-info

Syntax

display pim bsr-info

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display pim bsr-info command to view the BSR information in the PIM-SM domain and the locally configured C-RP information in effect.

Related commands: c-bsr and c-rp.

Examples

# View the BSR information in the current PIM-SM domain and the locally configured C-RP information in effect.

<Sysname> display pim bsr-info

Elected BSR Address: 12.12.12.9

Priority: 0

Hash mask length: 30

State: Accept Preferred

Scope: Not scoped

Uptime: 00:01:16

Next BSR message scheduled at: 00:01:54

Candidate BSR Address: 12.1.1.1

Priority: 0

Hash mask length: 30

State: Candidate

Scope: Not scoped

Candidate RP: 12.12.12.9(LoopBack1)

Priority: 0

HoldTime: 150

Advertisement Interval: 60

Next advertisement scheduled at: 00:00:48

Table 1-8 display pim bsr-info command output description

Field	Description
Elected BSR Address	Address of the elected BSR
Candidate BSR Address	Address of a candidate BSR
Priority	BSR priority
Hash mask length	Hash mask length
State	BSR state
Scope	Scope of the BSR
Uptime	Length of time for which this BSR has been up
Next BSR message scheduled at	Length of time in which the BSR will expire
Candidate RP	Address of the C-RP
Priority	Priority of the C-RP
HoldTime	Timeout time of the C-RP
Advertisement Interval	Interval at which the C-RP sends advertisement messages
Next advertisement scheduled at	Length of time in which the C-RP will send the next advertisement message

1.1.17 display pim claimed-route

Syntax

display pim claimed-route [ source-address ]

View

Any view

Default Level

1: Monitor level

Parameters

source-address: Multicast source address persistent to which the unicast route information is to be displayed. If you do not provide this argument, this command will display the information about all unicast routes used by PIM.

Description

Use the display pim claimed-route command to view the information of unicast routes used by PIM.

If an (S, G) is marked SPT, this (S, G) entry uses a unicast route.

Examples

# View the information of all unicast routes used by PIM.

<Sysname> display pim claimed-route

RPF information about: 172.168.0.0

RPF interface: Vlan-interface22, RPF neighbor: 172.168.0.2

Referenced route/mask: 172.168.0.0/24

Referenced route type: unicast (direct)

RPF-route selecting rule: preference-preferred

The (S,G) or (*,G) list dependent on this route entry

(172.168.0.12, 227.0.0.1)

Table 1-9 display pim claimed-route command output description

Field	Description
RPF interface:	RPF interface type and number
RPF neighbor:	IP address of the RPF neighbor
Referenced route/mask:	Address/mask of the referenced route
Referenced route type:	Type of the referenced route
RPF-route selecting rule:	Rule of RPF route selection
The (S,G) or (*,G) list dependent on this route entry	(S, G) or (*, G) entries based on this RPF route

1.1.18 display pim control-message counters

Syntax

display pim control-message counters [ message-type { probe | register | register-stop } | [ interface interface-type interface-number | message-type { assert | bsr | crp | graft | graft-ack | hello | join-prune | state-refresh } ] * ]

View

Any view

Default Level

1: Monitor level

Parameters

probe: Displays the number of null register messages.

register: Displays the number of register messages.

register-stop: Displays the number of register-stop messages.

interface interface-type interface-number: Displays the number of PIM control messages on the specified interface.

assert: Assert message. Currently, S9500 series routing switches do not support this parameter.

bsr: Bootstrap message.

crp: C-RP-Adv message.

graft: Graft message.

graft-ack: Graft-ack message

hello: Hello message

join-prune: Join/prune message

state-refresh: State refresh message.

Description

Use the display pim control-message counters command to view the statistics information of PIM control messages.

& Note:

Register messages, register-stop messages, and probe messages are for global statistics, so you cannot view the statistics of these messages on the specified interface.

Examples

# View the statistics information of all types of PIM control messages on all interfaces.

<Sysname> display pim control-message counters

PIM global control-message counters:

Received Sent Invalid

Probe 10 5 0

PIM control-message counters for interface: Pos4/1/1

Received Sent Invalid

Assert 0 0 0

Graft 20 37 2

Graft-Ack 25 20 1

Hello 1232 453 0

Join/Prune 15 30 21

State-Refresh 8 7 1

BSR 3243 589 1

CRP 53 32 0

Table 1-10 Description on the fields of display pim control-message counters

Field	Description
Received	Number of messages received
Sent	Number of messages sent
Invalid	Number of invalid messages
Register	Register messages
Register-Stop	Register-stop messages
Probe	Null register messages
Assert	Assert messages
Graft	Graft messages
Graft-Ack	Graft-ack messages
Hello	Hello messages
Join/Prune	Join/prune messages
State Refresh	State refresh messages
BSR	Bootstrap messages
CRP	C-RP-Adv messages

1.1.19 display pim grafts

Syntax

display pim grafts

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display pim grafts command to view the information about unacknowledged graft messages.

Examples

# View the information about unacknowledged graft messages.

<Sysname> display pim grafts

Source Group Age RetransmitIn

192.168.10.1 224.1.1.1 00:00:24 00:00:02

Table 1-11 display pim grafts command output description

Field	Description
Source	Multicast source address in the graft message
Group	Multicast group address in the graft message
Age	Time in which the graft message will get aged out, in hours:minutes:seconds
RetransmitIn	Time in which the graft message will be retransmitted, in hours:minutes:seconds

1.1.20 display pim interface

Syntax

display pim interface [ interface-type interface-number ] [ verbose ]

View

Any view

Default Level

1: Monitor level

Parameters

interface-type interface-number: Displays the PIM information on a particular interface.

verbose: Displays the detailed PIM information.

Description

Use the display pim interface command to view the PIM information on the specified interface or all interfaces.

Examples

# View the PIM information on all interfaces.

<Sysname> display pim interface

Interface NbrCnt HelloInt DR-Pri DR-Address

Vlan10 0 30 1 10.1.1.1

Vlan12 1 30 1 12.1.1.2

Table 1-12 display pim interface command output description

Field	Description
Interface	Interface name
NbrCnt	Number of PIM neighbors
HelloInt	Hello interval
DR-Pri	Priority for DR election
DR-Address	DR IP address

1.1.21 display pim join-prune

Syntax

display pim join-prune mode { sm [ flags flag-value ] | ssm } [ interface interface-type interface-number | neighbor neighbor-address ] * [ verbose ]

View

Any view

Default Level

1: Monitor level

Parameters

mode: Displays the information of joint/prune messages to send in the specified PIM mode. PIM modes include sm and ssm, which represent PIM-SM and PIM-SSM respectively.

flags flag-value: Displays PIM routing entries containing the specified flag. Values and meanings of flag-value are as follows:

l rpt: Specifies routing entries on the RPT.

l spt: Specifies routing entries on the SPT.

l wc: Specifies wildcard routing entries.

interface-type interface-number: Displays the information of joint/prune messages to send on the specified interface.

neighbor-address: Displays the information of joint/prune messages to send to the specified PIM neighbor.

verbose: Displays the detailed information of joint/prune messages to send.

Description

Use the display pim join-prune command to view the information about the join/prune messages to send.

Examples

# View the information of joint/prune messages to send in the PIM-SM mode.

<Sysname> display pim join-prune mode sm

Expiry Time: 14 sec

Upstream nbr: 12.1.1.1 (Vlan-interface12)

0 (*, G) join(s), 1 (S, G) join(s), 0 (S, G, rpt) prune(s)

Expiry Time: 46 sec

Upstream nbr: 12.1.1.1 (Vlan-interface12)

1 (*, G) join(s), 0 (S, G) join(s), 0 (S, G, rpt) prune(s)

---------------------------------------------------------------------------

Total (*, G) join(s): 1, (S, G) join(s): 1, (S, G, rpt) prune(s): 0

Table 1-13 display pim join-prune command output description

Field	Description
Expiry Time:	Expiry time of sending join/prune messages
Upstream nbr:	IP address of the upstream PIM neighbor and the interface connecting to it
(*, G) join(s)	Number of (*, G) joins to send
(S, G) join(s)	Number of (S, G) joins to send
(S, G, rpt) prune(s)	Number of (S, G, rpt) prunes

1.1.22 display pim neighbor

Syntax

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

View

Any view

Default Level

1: Monitor level

Parameters

interface-type interface-number: Displays the PIM neighbor information on a particular interface.

neighbor-address: Displays the information of a particular PIM neighbor.

verbose: Displays the detailed PIM neighbor information.

Description

Use the display pim neighbor command to view the PIM neighbor information.

Examples

# View the information of all PIM neighbors.

<Sysname> display pim neighbor

Total Number of Neighbors = 1

Neighbor Interface Uptime Expires Dr-Priority

12.1.1.1 Vlan12 00:07:28 00:01:33 1

Table 1-14 display pim neighbor command output description

Field	Description
Total Number of Neighbors	Total number of PIM neighbors
Neighbor	Ip address of the PIM neighbor
Interface	Interface connecting the PIM neighbor
Uptime	Length of time for which the PIM neighbor has been up, in hours:minutes:seconds
Expires	Length of time in which the PIM neighbor will expire, in hours:minutes:seconds
Dr-Priority	Designated router priority

1.1.23 display pim routing-table

Syntax

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

View

Any view

Default Level

1: Monitor level

Parameters

group-address: Multicast group address.

mask: Mask of the multicast group/source address, 255.255.255.255 by default.

mask-length: Mask length of the multicast group/source address, 32 by default.

source-address: Multicast source address.

incoming-interface: Displays routing entries that contain the specified interface as the incoming interface

interface-type interface-number: Specifies an interface by its type and number.

register: Specifies the register interface. This keyword is valid only if mode-type is not specified or is sm.

outgoing-interface: Displays routing entries of which the outgoing interface is the specified interface.

include: Displays routing entries of which the outgoing interface list includes the specified interface.

exclude: Displays routing entries of which the outgoing interface list does not includes the specified interface.

match: Displays routing entries of which the outgoing interface list includes only the specified interface.

mode mode-type: Specifies a PIM mode, where mode-type can have the following values:

l dm: Specifies PIM-DM

l sm: Specifies PIM-SM

l ssm: Specifies PIM-SSM

flags flag-value: Displays routing entries containing the specified flag(s). The values of flag-value and their meanings are as follows:

l 2msdp: Specifies routing entries to be contained in the next SA message to notify an MSDP peer.

l act: Specifies multicast routing entries to which actual data has arrived

l del: Specifies multicast routing entries scheduled to be deleted

l ext: Specifies routing entries containing outgoing interfaces contributed by other multicast routing protocols

l loc: Specifies multicast routing entries on devices directly connecting to the same subnet with the multicast source

l msdp: Specifies to routing entries learned from MSDP SA messages

l niif: Specifies multicast routing entries containing unknown incoming interfaces

l nonbr: Specifies routing entries with PIM neighbor searching failure

l rpt: Specifies routing entries on RPT branches where (S, G) prunes have been sent to the RP.

l spt: Specifies routing entries on the SPT.

l swt: Specifies routing entries in the process of RPT-to-SPT switchover.

l wc: Specifies wildcard routing entries.

fsm: Displays the detailed information of the finite state machine (FSM).

Description

Use the display pim routing-table command to view PIM routing table information.

Related commands: display multicast routing-table (Multicast Routing and Forwarding Commands in the IP Multicast Volume).

Examples

# View the content of the PIM routing table.

<Sysname> display pim routing-table

Total 4 (*, G) entries; 1 (S, G) entry

(*, 225.1.1.1)

RP: 12.1.1.2 (local)

Protocol: pim-sm, Flag: WC

UpTime: 00:16:19

Upstream interface: Register

Upstream neighbor: NULL

RPF prime neighbor: NULL

Downstream interface(s) information:

Total number of downstreams: 1

1: LoopBack0

Protocol: static, UpTime: 00:16:19, Expires: -

(10.1.1.3, 225.1.1.1)

RP: 12.1.1.2 (local)

Protocol: pim-sm, Flag: SPT 2MSDP ACT

UpTime: 00:07:16

Upstream interface: Vlan-interface12

Upstream neighbor: 12.1.1.1

RPF prime neighbor: 12.1.1.1

Downstream interface(s) information:

Total number of downstreams: 1

1: LoopBack0

Protocol: pim-sm, UpTime: - , Expires: -

(*, 239.192.0.1)

RP: 12.1.1.2 (local)

Protocol: pim-sm, Flag: WC

UpTime: 00:06:53

Upstream interface: Register

Upstream neighbor: NULL

RPF prime neighbor: NULL

Downstream interface(s) information:

Total number of downstreams: 1

1: Vlan-interface245

Protocol: igmp, UpTime: 00:06:52, Expires: -

(*, 239.192.245.1)

RP: 12.1.1.1

Protocol: pim-sm, Flag: WC

UpTime: 00:06:45

Upstream interface: Vlan-interface12

Upstream neighbor: 12.1.1.1

RPF prime neighbor: 12.1.1.1

Downstream interface(s) information:

Total number of downstreams: 1

1: Vlan-interface245

Protocol: igmp, UpTime: 00:06:45, Expires: -

(*, 239.255.255.250)

RP: 12.1.1.2 (local)

Protocol: pim-sm, Flag: WC

UpTime: 00:06:53

Upstream interface: Register

Upstream neighbor: NULL

RPF prime neighbor: NULL

Downstream interface(s) information:

Total number of downstreams: 1

1: Vlan-interface245

Protocol: igmp, UpTime: 00:06:53, Expires: -

Table 1-15 display pim routing-table command output description

Field	Description
Total 4 (*, G) entry; 1 (S, G) entry	Number of (S, G) and (*, G) entries in the PIM routing table
(10.1.1.3, 225.1.1.1)	An (S, G) entry in the PIM routing table
(*, 239.192.0.1)	A (*, G) entry in the PIM routing table
Protocol	PIM mode, PIM-SM or PIM-DM
Flag	Flag of an (S, G) or (, G) entry in the PIM routing table, WC: Indicates a (, G) entry For more information, see the description of the flags flag-value parameter
Uptime	Length of time for which the (S, G) or (*, G) entry has existed, in hours:minutes:seconds
Upstream interface	Upstream (incoming) interface of the (S, G) or (*, G) entry
Upstream neighbor	Upstream neighbor of the (S, G) or (*, G) entry
RPF prime neighbor	RPF neighbor of the (S, G) or (, G) entry l For a (, G) entry, if this device is the RP, the RPF neighbor of this (*, G) entry is NULL l For a (S, G) entry, if this device directly connects to the multicast source, the RPF neighbor of this (S, G) entry is NULL
Downstream interface(s) information	Information of the downstream interface(s), including: l Number of downstream interfaces l Downstream interface name l Type of the multicast protocol enabled on the downstream interface(s) l Uptime of the downstream interface(s) l Expiry time of the downstream interface(s)

1.1.24 display pim rp-info

Syntax

display pim rp-info [ group-address ]

View

Any view

Default Level

1: Monitor level

Parameters

group-address: Address of the multicast group of which the RP information is to be displayed. If you do not provide a group address, this command will display the RP information corresponding to all multicast groups.

Description

Use the display pim rp-info command to view the RP information.

Note that:

l The RP information includes the information of RPs dynamically found by the BSR mechanism and static RPs.

l Because a non-BSR router refreshes its local RP-Set only based on the received BSR bootstrap messages, the system does not delete an RP even if its expiry time is 0. Instead, the system waits for the next bootstrap message from the BSR: if the bootstrap message does not contain information of the RP, the system will delete it.

Examples

# View the RP information corresponding to the multicast group 224.0.1.1.

<Sysname> display pim rp-info 224.0.1.1

BSR RP Address is: 2.2.2.2

Priority: 0

HoldTime: 150

Uptime: 03:01:10

Expires: 00:02:30

RP mapping for this group is: 2.2.2.2

# View the RP information corresponding to all multicast groups.

<Sysname> display pim rp-info

PIM-SM BSR RP information:

Group/MaskLen: 224.0.0.0/4

RP: 2.2.2.2

Priority: 0

HoldTime: 150

Uptime: 03:01:36

Expires: 00:02:29

Table 1-16 display pim rp-info command output description

Field	Description
BSR RP Address is	IP address of the RP
Group/MaskLen	The multicast group served by the RP
RP	IP address of the RP
Priority	RP priority
HoldTime	RP timeout time
Uptime	Length of time for which the RP has been up, in hours:minutes:seconds
Expires	Length of time in which the RP will expire, in hours:minutes:seconds
RP mapping for this group is:	The IP address of the RP serving the current multicast group

1.1.25 hello-option dr-priority

Syntax

hello-option dr-priority priority

undo hello-option dr-priority

View

PIM view

Default Level

2: System level

Parameters

priority: Router priority for DR election. A larger value of this argument means a higher priority.

Description

Use the hello-option dr-priority command to configure the global value of the router priority for DR election.

Use the undo hello-option dr-priority command to restore the default setting.

By default, the router priority for DR election is 1.

Related commands: pim hello-option dr-priority.

Examples

# Set the router priority for DR election to 3.

<Sysname> system-view

[Sysname] pim

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

1.1.26 hello-option holdtime

Syntax

hello-option holdtime interval

undo hello-option holdtime

View

PIM view

Default Level

2: System level

Parameters

interval: PIM neighbor timeout time in seconds.

Description

Use the hello-option holdtime command to configure the PIM neighbor timeout time.

Use the undo hello-option holdtime command to restore the default setting.

By default, the PIM neighbor timeout time is 105 seconds.

This command is effective for both PIM-DM and PIM-SM.

Related commands: pim hello-option holdtime.

Examples

# Set the global value of the PIM neighbor timeout time to 120 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option holdtime 120

1.1.27 hello-option lan-delay

Syntax

hello-option lan-delay interval

undo hello-option lan-delay

View

PIM view

Default Level

2: System level

Parameters

interval: Prune delay in milliseconds.

Description

Use the hello-option lan-delay command to configure the global value of prune delay time.

Use the undo hello-option lan-delay command to restore the default setting.

By default, the prune delay to 500 milliseconds.

Related commands: hello-option override-interval, pim hello-option override-interval, pim hello-option lan-delay.

Examples

# Set the prune delay to 200 milliseconds globally.

<Sysname> system-view

[Sysname] pim

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

1.1.28 hello-option neighbor-tracking

Syntax

hello-option neighbor-tracking

undo hello-option neighbor-tracking

View

PIM view

Default Level

2: System level

Parameters

None

Description

Use the hello-option neighbor-tracking command to globally disable join suppression, namely enable neighbor tracking.

Use the undo hello-option neighbor-tracking command to enable join suppression.

By default, join suppression is enabled, namely neighbor tracking is disabled.

This command is effective for both PIM-DM and PIM-SM.

Related commands: pim hello-option neighbor-tracking.

Examples

# Disable join suppression globally.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option neighbor-tracking

1.1.29 hello-option override-interval

Syntax

hello-option override-interval interval

undo hello-option override-interval

View

PIM view

Default Level

2: System level

Parameters

interval: Prune override interval in milliseconds.

Description

Use the hello-option override-interval command to configure the global value of the prune override interval.

Use the undo hello-option override-interval command to restore the default setting.

By default, the prune override interval is 2,500 milliseconds.

This command is effective for both PIM-DM and PIM-SM.

Related commands: hello-option lan-delay, pim hello-option lan-delay, pim hello-option override-interval.

Examples

# Set the prune override interval to 2,000 milliseconds globally.

<Sysname> system-view

[Sysname] pim

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

1.1.30 holdtime join-prune

Syntax

holdtime join-prune interval

undo holdtime join-prune

View

PIM view

Default Level

2: System level

Parameters

interval: Join/prune timeout time in seconds.

Description

Use the holdtime join-prune command to configure the global value of the join/prune timeout time.

Use the undo holdtime join-prune command to restore the default setting.

By default, the join/prune timeout time is 210 seconds.

Related commands: pim holdtime join-prune.

Examples

# Set the global value of the join/prune timeout time to 280 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] holdtime join-prune 280

1.1.31 jp-pkt-size

Syntax

jp-pkt-size packet-size

undo jp-pkt-size

View

PIM view

Default Level

2: System level

Parameters

packet-size: Maximum size of join/prune messages in bytes.

Description

Use the jp-pkt-size command to configure the maximum size of join/prune messages.

Use the undo jp-pkt-size command to restore the default setting.

By default, the maximum size of join/prune messages is 8,100 bytes.

Related commands: jp-queue-size.

Examples

# Set the maximum size of join/prune messages to 1,500 bytes.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] jp-pkt-size 1500

1.1.32 jp-queue-size

Syntax

jp-queue-size queue-size

undo jp-queue-size

View

PIM view

Default Level

2: System level

Parameters

queue-size: Maximum number of (S, G) entries in a join/prune message.

Description

Use the jp-queue-size command to configure the maximum number of (S, G) entries in a join/prune message.

Use the undo jp-queue-size command to restore the default setting.

By default, a join/prune messages contains a maximum of 1,020 (S, G) entries.

When you use this command, you need to take into account the (S, G) join/prune timeout time on the upstream device. If you configure a small queue size, the outgoing interface of the corresponding entry may have been pruned due to timeout before the last join/prune message in a queue reaches the upstream device.

Related commands: jp-pkt-size, holdtime join-prune, pim holdtime join-prune.

Examples

# Configure a join/prune messages to contain a maximum of 2,000 (S, G) entries.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] jp-queue-size 2000

1.1.33 pim

Syntax

pim

undo pim

View

System view

Default Level

2: System level

Parameters

None

Description

Use the pim command to enter PIM view.

Use the undo pim command to remove all configurations performed in PIM view and return to system view.

IP multicast must be enabled on the device before this command can take effect.

Related commands: multicast routing-enable in Multicast Routing and Forwarding Commands of the IP Multicast Volume.

Examples

# Enable IP multicast routing and enter PIM view.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] pim

[Sysname-pim]

1.1.34 pim bsr-boundary

Syntax

pim bsr-boundary

undo pim bsr-boundary

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

None

Description

Use the pim bsr-boundary command to configure a PIM-SM domain border, namely a PIM bootstrap message boundary..

Use the undo pim bsr-boundary command to remove the configured PIM-SM domain border.

By default, no PIM-SM domain border is configured.

Related commands: c-bsr, and multicast boundary in Multicast Routing and Forwarding Commands of the IP Multicast Volume.

Examples

# Configure VLAN-interface 100 as a PIM-SM domain border.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim bsr-boundary

1.1.35 pim dm

Syntax

pim dm

undo pim dm

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

None

Description

Use the pim dm command to enable PIM-DM.

Use the undo pim dm command to disable PIM-DM.

By default, PIM-DM is disabled.

Caution:

l After PIM-DM is enabled on a VLAN interface, IGMP snooping cannot be enabled in the VLAN corresponding to the VLAN interface, and vice versa.

l Multicast groups within the SSM group address range cannot be used for PIM-DM.

l This command can take effect only after IP multicast routing is enabled.

Related commands: pim sm, ssm-policy.

Examples

# Enable PIM-DM on VLAN-interface 4.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface vlan-interface 4

[Sysname-Vlan-interface4] pim dm

1.1.36 pim hello-option dr-priority

Syntax

pim hello-option dr-priority priority

undo pim hello-option dr-priority

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

priority: Router priority for DR election. A larger value of this argument means a higher priority.

Description

Use the pim hello-option dr-priority command to configure the router priority for DR election on the current interface.

Use the undo pim hello-option dr-priority command to restore the default setting.

By default, the router priority for DR election is 1.

This command is the same as the hello-option dr-priority command for PIM view, with the exception of the view in which it is carried out. Configurations performed in PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in PIM view are used only if the corresponding configurations have not been carried out in interface view.

Related commands: hello-option dr-priority.

Examples

# Set the router priority for DR election to 3 on VLAN-interface 4.

<Sysname> system-view

[Sysname] interface vlan-interface 4

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

1.1.37 pim hello-option holdtime

Syntax

pim hello-option holdtime interval

undo pim hello-option holdtime

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

interval: PIM neighbor timeout time in seconds.

Description

Use the pim hello-option holdtime command to configure the PIM neighbor timeout time on the current interface.

Use the undo pim hello-option holdtime command to restore the default setting.

By default, the PIM neighbor timeout time is 105 seconds.

This command is the same as the hello-option holdtime command for PIM view, with the exception of the view in which it is carried out. Configurations performed in PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in PIM view are used only if the corresponding configurations have not been carried out in interface view.

Related commands: hello-option holdtime.

Examples

# Set the PIM neighbor timeout time to 120 seconds on VLAN-interface 4.

<Sysname> system-view

[Sysname] interface vlan-interface 4

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

1.1.38 pim hello-option lan-delay

Syntax

pim hello-option lan-delay interval

undo pim hello-option lan-delay

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

interval: Prune delay in milliseconds.

Description

Use the pim hello-option lan-delay command to configure the prune delay time on the current interface.

Use the undo pim hello-option lan-delay command to restore the default setting.

By default, the prune delay to 500 milliseconds.

This command is the same as the hello-option lan-delay command for PIM view, with the exception of the view in which it is carried out. Configurations performed in PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in PIM view are used only if the corresponding configurations have not been carried out in interface view.

Related commands: pim hello-option override-interval, hello-option override-interval, hello-option lan-delay.

Examples

# Set the prune delay time to 200 milliseconds on VLAN-interface 4.

<Sysname> system-view

[Sysname] interface vlan-interface 4

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

1.1.39 pim hello-option neighbor-tracking

Syntax

pim hello-option neighbor-tracking

undo pim hello-option neighbor-tracking

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

None

Description

Use the pim hello-option neighbor-tracking command to disable join suppression, namely enable neighbor tracking, on the current interface.

Use the undo pim hello-option neighbor-tracking command to enable join suppression.

By default, join suppression is enabled, namely neighbor tracking is disabled.

This command is the same as the hello-option neighbor-tracking command for PIM view, with the exception of the view in which it is carried out. Configurations performed in PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in PIM view are used only if the corresponding configurations have not been carried out in interface view.

Related commands: hello-option neighbor-tracking.

Examples

# Disable join suppression on VLAN-interface 4.

<Sysname> system-view

[Sysname] interface vlan-interface 4

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

1.1.40 pim hello-option override-interval

Syntax

pim hello-option override-interval interval

undo pim hello-option override-interval

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

interval: Prune override interval in milliseconds.

Description

Use the pim hello-option override-interval command to configure the prune override interval on the current interface.

Use the undo pim hello-option override-interval command to restore the default setting.

By default, the prune override interval is 2,500 milliseconds.

This command is the same as the hello-option override-interval command for PIM view, with the exception of the view in which it is carried out. Configurations performed in PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in PIM view are used only if the corresponding configurations have not been carried out in interface view.

Related commands: pim hello-option lan-delay, hello-option lan-delay, hello-option override-interval.

Examples

# Set the prune override interval to 2,000 milliseconds on VLAN-interface 4.

<Sysname> system-view

[Sysname] interface vlan-interface 4

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

1.1.41 pim holdtime join-prune

Syntax

pim holdtime join-prune interval

undo pim holdtime join-prune

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

interval: Join/prune timeout time in seconds, with an effective range of 1 to 65,535.

Description

Use the pim holdtime join-prune command to configure the join/prune timeout time on the interface.

Use the undo pim holdtime join-prune command to restore the default setting.

By default, the join/prune timeout time is 210 seconds.

This command is the same as the holdtime join-prune command for PIM view, with the exception of the view in which it is carried out. Configurations performed in PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in PIM view are used only if the corresponding configurations have not been carried out in interface view.

Related commands: holdtime join-prune.

Examples

# Set the join/prune timeout time to 280 seconds on VLAN-interface 4.

<Sysname> system-view

[Sysname] interface vlan-interface 4

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

1.1.42 pim require-genid

Syntax

pim require-genid

undo pim require-genid

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

None

Description

Use the pim require-genid command enable rejection of hello messages without Generation_ID.

Use the undo pim require-genid command to restore the default configuration.

By default, hello messages without Generation_ID are accepted.

Examples

# Enable VLAN-interface 4 to reject hello messages without Generation_ID.

<Sysname> system-view

[Sysname] interface vlan-interface 4

[Sysname-Vlan-interface4] pim require-genid

1.1.43 pim sm

Syntax

pim sm

undo pim sm

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

None

Description

Use the pim sm command to enable PIM-SM.

Use the undo pim sm command to disable PIM-SM.

By default, PIM-SM is disabled.

Caution:

l After PIM-SM is enabled on a VLAN interface, IGMP snooping cannot be enabled in the VLAN corresponding to the VLAN interface, and vice versa.

l This command can take effect only after IP multicast routing is enabled.

Related commands: pim dm, ssm-policy.

Examples

# Enable PIM-SM on VLAN-interface 4.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface vlan-interface 4

[Sysname-Vlan-interface4] pim sm

1.1.44 pim state-refresh-capable

Syntax

pim state-refresh-capable

undo pim state-refresh-capable

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

None

Description

Use the pim state-refresh-capable command to enable the state fresh feature on the interface.

Use the undo pim state-refresh-capable command to disable the state fresh feature.

By default, the state refresh feature is enabled.

Related commands: state-refresh-interval, state-refresh-rate-limit, state-refresh-ttl.

Examples

# Disable state refresh on VLAN-interface 4.

<Sysname> system-view

[Sysname] interface vlan-interface 4

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

1.1.45 pim timer graft-retry

Syntax

pim timer graft-retry interval

undo pim timer graft-retry

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

interval: Graft retry period in seconds.

Description

Use the pim timer graft-retry command to configure the graft retry period.

Use the undo pim timer graft-retry command to restore the default setting.

By default, the graft retry period is 3 seconds.

Examples

# Set the graft retry period to 80 seconds on VLAN-interface 4.

<Sysname> system-view

[Sysname] interface vlan-interface 4

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

1.1.46 pim timer hello

Syntax

pim timer hello interval

undo pim timer hello

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

interval: Hello interval in seconds.

Description

Use the pim timer hello command to configure on the current interface the interval at which hello messages are sent.

Use the undo pim timer hello command to restore the default setting.

By default, hello messages are sent at the interval of 30 seconds.

This command is the same as the timer hello command for PIM view, with the exception of the view in which it is carried out. Configurations performed in PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in PIM view are used only if the corresponding configurations have not been carried out in interface view.

Related commands: timer hello.

Examples

# Set the hello interval to 40 seconds on VLAN-interface 4.

<Sysname> system-view

[Sysname] interface vlan-interface 4

[Sysname-Vlan-interface4] pim timer hello 40

1.1.47 pim timer join-prune

Syntax

pim timer join-prune interval

undo pim timer join-prune

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

interval: Join/prune interval in seconds.

Description

Use the pim timer join-prune command to configure on the current interface the interval at which join/prune messages are sent.

Use the undo pim timer join-prune command to restore the default setting.

By default, the join/prune interval is 60 seconds.

This command is the same as the timer join-prune command for PIM view, with the exception of the view in which it is carried out. Configurations performed in PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in PIM view are used only if the corresponding configurations have not been carried out in interface view.

Related commands: timer join-prune.

Examples

# Set the join/prune interval to 80 seconds on VLAN-interface 4.

<Sysname> system-view

[Sysname] interface vlan-interface 4

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

1.1.48 pim triggered-hello-delay

Syntax

pim triggered-hello-delay interval

undo pim trigged-hello-delay

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

interval: Maximum delay in seconds between hello messages.

Description

Use the pim triggered-hello-delay command to configure the maximum delay between hello messages.

Use the undo pim triggered-hello-delay command to restore the default setting.

By default, the maximum delay between hello messages is 5 seconds.

Examples

# Set the maximum delay between hello messages to 3 seconds on VLAN-interface 4.

<Sysname> system-view

[Sysname] interface vlan-interface 4

[Sysname-Vlan-interface4] pim trigged-hello-delay 3

1.1.49 probe-interval

Syntax

probe-interval interval

undo probe-interval

View

PIM view

Default Level

2: System level

Parameters

interval: Probe time in seconds.

Description

Use the probe-interval command to configure the probe time, namely the interval at which the source-side DR sends null register messages before the register suppression timer expires.

Use the undo probe-interval command to restore the default setting.

By default, the probe time is 5 seconds.

Related commands: register-suppression-timeout.

Examples

# Set the probe time to 6 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] probe-interval 6

1.1.50 register-whole-checksum

Syntax

register-whole-checksum

undo register-whole-checksum

View

PIM view

Default Level

2: System level

Parameters

None

Description

Use the register-whole-checksum command to configure the router to calculate the checksum based on the entire register messages.

Use the undo register-whole-checksum command to restore the default configuration.

By default, the checksum is calculated based on the header in the register message.

Related commands: register-policy, register-suppression-timeout.

Examples

# Configure the router to calculate the checksum based on the entire register messages.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] register-whole-checksum

1.1.51 register-policy

Syntax

register-policy acl-number

undo register-policy

View

PIM view

Default Level

2: System level

Parameters

acl-number: Advanced ACL number. Only register messages that match the permit statement of the ACL can be accepted by the RP.

Description

Use the register-policy command to configure an ACL rule to filter register messages.

Use the undo register-policy command to remove the configured register filtering rule.

By default, no register filtering rule is configured.

Caution:

If you specify an undefined advanced ACL, the RP will reject all register messages.

Related commands: register-suppression-timeout.

Examples

# Configure the RP to accept only those register messages for multicast traffic from multicast sources in the range of 10.10.0.0/16 to multicast groups in the range of 225.1.0.0/16.

<Sysname> system-view

[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.52 register-suppression-timeout

Syntax

register-suppression-timeout interval

undo register-suppression-timeout

View

PIM view

Default Level

2: System level

Parameters

interval: Register suppression time in seconds.

Description

Use the register-suppression-timeout command to configure the register suppression time.

Use the undo register-suppression-timeout command to restore the default setting.

By default, the register suppression time is 60 seconds.

Related commands: probe-interval, register-policy.

Examples

# Set the register suppression time to 70 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] register-suppression-timeout 70

1.1.53 reset pim control-message counters

Syntax

reset pim control-message counters [ interface interface-type interface-number ]

View

User view

Default Level

1: Monitor level

Parameters

interface interface-type interface-number: Specifies an interface on which the PIM control message counter is to be reset. If no interface is specified, this command will clear the statistics information of PIM control messages on all interfaces.

Description

Use the reset pim control-message counters command to reset PIM control message counters.

Examples

# Reset PIM control message counters on all interfaces.

<Sysname> reset pim control-message counters

1.1.54 source-lifetime

Syntax

source-lifetime interval

undo source-lifetime

View

PIM view

Default Level

2: System level

Parameters

interval: Multicast source lifetime in seconds.

Description

Use the source-lifetime command to configure the multicast source lifetime.

Use the undo source-lifetime command to restore the default setting.

By default, the lifetime of a multicast source is 210 seconds.

Examples

# Set the multicast source lifetime to 200 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] source-lifetime 200

1.1.55 source-policy

Syntax

source-policy acl-number

undo source-policy

View

PIM view

Default Level

2: System level

Parameters

acl-number: Basic or advanced ACL number.

Description

Use the source-policy command to configure a multicast data filter.

Use the undo source-policy command to remove the configured multicast data filter.

By default, no multicast data filter is configured.

Note that:

l If you specify a basic ACL, the device filters all the received multicast packets based on the source address, and discards packets that fail the source address match.

l If you specify an advanced ACL, the device filters all the received multicast packets based on the source and group addresses, and discards packets that fail the match.

l If this command is executed repeatedly, the last configuration will take effect.

Examples

# Configure the router to accept multicast packets originated from 10.10.1.2 and discard multicast packets originated from 10.10.1.1.

<Sysname> system-view

[Sysname] acl number 2001

[Sysname-acl-basic-2001] rule permit source 10.10.1.2 0

[Sysname-acl-basic-2001] rule deny source 10.10.1.1 0

[Sysname-acl-basic-2001] quit

[Sysname] pim

[Sysname-pim] source-policy 2001

1.1.56 spt-switch-threshold

Syntax

spt-switch-threshold infinity [ group-policy acl-number [ order order-value ] ]

undo spt-switch-threshold [ group-policy acl-number ]

View

PIM view

Default Level

2: System level

Parameters

group-policy acl-number: Disables RPT-to-SPT switchover for multicast groups that match the specified multicast policy. In this option, acl-number refers to a basic ACL number, in the range of 2000 to 2999. If you do not include this option in your command, this command will take effect for all multicast groups.

order order-value: Specifies the order of the ACL in the group-policy list, where order-value has an effective range of 1 to (the largest order value in the existing group-policy list + 1), but the value range should not include the original order value of the ACL in the group-policy list. If you have assigned an order-value to a certain ACL, do not specify the same order-value for another ACL; otherwise the system will give error information. If you do not specify an order-value, the order value of the ACL will remain the same in the group-policy list.

Description

Use the spt-switch-threshold infinity command to disable RPT-to-SPT switchover.

Use the undo spt-switch-threshold command to restore the default configuration.

By default, the S9500 series routing switch switches to the SPT immediately after it receives the first multicast packet from the RPT.

Note that:

l To adjust the order of an existing ACL in the group-policy list, you can use the acl-number argument to specify this ACL and set its order-value. This will insert the ACL to the position of order-value in the group-policy list. The order of the other existing ACLs in the group-policy list will remain unchanged.

l To use an ACL that does not exist in the group-policy list, you can use the acl-number argument to specify an ACL and set its order-value. This will insert the ACL to the position of order-value in the group-policy list. If you do not include the order order-value option in your command, the ACL will be appended to the end of the group-policy list.

l If you use this command multiple times on the same multicast group, the first traffic rate configuration matched in sequence will take effect.

l To avoid forwarding failure, do not disable RPT-to-SPT switchover on a switch that may become an RP (namely, a static RP or a C-RP).

Examples

# Disable RPT-to-SPT switchover on a switch.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] spt-switch-threshold infinity

1.1.57 ssm-policy

Syntax

ssm-policy acl-number

undo ssm-policy

View

PIM view

Default Level

2: System level

Parameters

acl-number: Basic ACL number.

Description

Use the ssm-policy command to configure the SSM group range.

Use the undo ssm-policy command to restore the system default.

By default, the SSM group range is 232.0.0.0/8.

This command allows you to define an address range of permitted or denied multicast groups. If the match succeeds, the multicast mode will be PIM-SSM; otherwise the multicast mode will be PIM-SM.

Examples

# Configure the SSM group range to be 232.1.0.0/16 in the PIM-SSM domain.

<Sysname> system-view

[Sysname] acl number 2000

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

[Sysname-acl-basic-2000] quit

[Sysname] pim

[Sysname-pim] ssm-policy 2000

1.1.58 state-refresh-interval

Syntax

state-refresh-interval interval

undo state-refresh-interval

View

PIM view

Default Level

2: System level

Parameters

interval: State refresh interval in seconds.

Description

Use the state-refresh-interval command to configure the interval between state refresh messages.

Use the undo state-refresh-interval command to restore the default setting.

By default, the state refresh interval is 60 seconds.

Related commands: pim state-refresh-capable, state-refresh-rate-limit, state-refresh-ttl.

Examples

# Set the state refresh interval to 70 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-interval 70

1.1.59 state-refresh-rate-limit

Syntax

state-refresh-rate-limit interval

undo state-refresh-rate-limit

View

PIM view

Default Level

2: System level

Parameters

interval: Time to wait before receiving a new refresh message.

Description

Use the state-refresh-rate-limit command to configure the time the router must wait before receiving a new state refresh message.

Use the undo state-refresh-rate-limit command to restore the default setting.

By default, the device waits 30 seconds before receiving a new state refresh message.

Related commands: pim state-refresh-capable, state-refresh-interval, state-refresh-ttl.

Examples

Configure the device to wait 45 seconds before receiving a new state refresh message.

<Sysname> system-view

[Sysname] pim

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

1.1.60 state-refresh-ttl

Syntax

state-refresh-ttl ttl-value

undo state-refresh-ttl

View

PIM view

Default Level

2: System level

Parameters

ttl-value: Time-to-live (TTL) value of state refresh messages.

Description

Use the state-refresh-ttl command to configure the TTL value of state refresh messages.

Use the undo state-refresh-ttl command to restore the default setting.

By default, the TTL value of state refresh messages is 255.

Related commands: pim state-refresh-capable, state-refresh-interval, state-refresh-rate-limit.

Examples

# Configure the device to send PIM state refresh messages with a TTL of 45.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-ttl 45

1.1.61 static-rp

Syntax

static-rp rp-address [ acl-number ] [ preferred ]

undo static-rp rp-address

View

PIM view

Default Level

2: System level

Parameters

rp-address: IP address of the static RP to be configured. This address must be a legal unicast IP address.

acl-number: Basic ACL number. If you provide this argument, the configured static RP will serve only those groups that pass the ACL filtering; otherwise, the configured static RP will serve the all-system group 224.0.0.0/4.

preferred: Specifies to give priority to the static RP if the static RP conflicts with the dynamic RP. If you do not include the preferred keyword in your command, the dynamic RP will be given priority, and the static RP takes effect on if no dynamic RP exists in the network or when the dynamic RP fails.

Description

Use the static-rp command to configure a static RP.

Use the undo static-rp command to configure a static RP.

By default, no static RP is configured.

Note that:

l PIM-SM or PIM-DM cannot be enabled on an interface that serves as a static RP.

l When the ACL rule applied on a static RP changes, a new RP must be elected for all the multicast groups.

l You can configure multiple static RPs by using this command repeatedly. However, if you carry out this command multiple times and specify the same static RP address or reference the same ACL rule, the last configuration will override the previous one. If multiple static RPs have been configured for the same multicast group, the one with the highest IP address will be chosen to serve the multicast group.

l You can configure up to 50 static RPs on the same device.

Related commands: display pim rp-info, auto-rp enable.

Examples

# Configure the interface with the IP address 11.110.0.6 to be a static RP that serves the multicast groups defined in ACL 2001, and give priority to this static RP in the case of static/dynamic RP conflict.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] static-rp 11.110.0.6 2001 preferred

1.1.62 timer hello

Syntax

timer hello interval

undo timer hello

View

PIM view

Default Level

2: System level

Parameters

interval: Hello interval in seconds.

Description

Use the timer hello command to configure the hello interval globally.

Use the undo timer hello command to restore the default setting.

By default, hello messages are sent at the interval of 30 seconds.

Examples

# Set the global hello interval to 40 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] timer hello 40

1.1.63 timer join-prune

Syntax

timer join-prune interval

undo timer join-prune

View

PIM view

Default Level

2: System level

Parameters

interval: Join/prune interval in seconds.

Description

Use the timer join-prune command to configure the join/prune interval globally.

Use the undo timer join-prune command to restore the default setting.

By default, the join/prune interval is 60 seconds.

Related commands: pim timer join-prune.

Examples

# Set the global join/prune interval to 80 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] timer join-prune 80

H3C S9500 Command Manual-Release2132[V2.03]-04 IP Multicast Volume

1.1 PIM Configuration Commands

1.1.3 c-bsr

1.1.4 c-bsr admin-scope

1.1.5 c-bsr global

1.1.6 c-bsr group

1.1.7 c-bsr hash-length

1.1.8 c-bsr holdtime

1.1.9 c-bsr interval

1.1.10 c-bsr priority

1.1.11 c-rp

1.1.21 display pim join-prune

1.1.23 display pim routing-table

1.1.24 display pim rp-info

1.1.25 hello-option dr-priority

1.1.26 hello-option holdtime

1.1.27 hello-option lan-delay

1.1.28 hello-option neighbor-tracking

1.1.29 hello-option override-interval

1.1.30 holdtime join-prune

1.1.31 jp-pkt-size

1.1.32 jp-queue-size

1.1.35 pim dm

1.1.36 pim hello-option dr-priority

1.1.37 pim hello-option holdtime

1.1.38 pim hello-option lan-delay

1.1.39 pim hello-option neighbor-tracking

1.1.40 pim hello-option override-interval

1.1.41 pim holdtime join-prune

1.1.43 pim sm

1.1.44 pim state-refresh-capable

1.1.46 pim timer hello

1.1.47 pim timer join-prune

1.1.49 probe-interval

1.1.52 register-suppression-timeout

1.1.53 reset pim control-message counters

1.1.56 spt-switch-threshold

1.1.58 state-refresh-interval

1.1.59 state-refresh-rate-limit

1.1.60 state-refresh-ttl

1.1.61 static-rp

1.1.62 timer hello

1.1.63 timer join-prune

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us