07-IP Multicast Command Reference

HomeSupportResource CenterRoutersH3C SR8800 Series RoutersH3C SR8800Technical DocumentsCommandCommand ReferenceH3C SR8800 Command Reference-Release3347-6W10307-IP Multicast Command Reference
15-IPv6 PIM Commands
Title Size Download
15-IPv6 PIM Commands 315.61 KB

Contents

IPv6 PIM configuration commands 1

bidir-pim enable (IPv6 PIM view) 1

bsm-fragment enable (IPv6 PIM view) 1

bsr-policy (IPv6 PIM view) 2

c-bsr (IPv6 PIM view) 3

c-bsr admin-scope (IPv6 PIM view) 3

c-bsr hash-length (IPv6 PIM view) 4

c-bsr holdtime (IPv6 PIM view) 4

c-bsr interval (IPv6 PIM view) 5

c-bsr priority (IPv6 PIM view) 6

c-bsr scope· 6

c-rp (IPv6 PIM view) 7

c-rp advertisement-interval (IPv6 PIM view) 8

c-rp holdtime (IPv6 PIM view) 9

crp-policy (IPv6 PIM view) 10

display pim ipv6 bsr-info· 10

display pim ipv6 claimed-route· 12

display pim ipv6 control-message counters 13

display pim ipv6 df-info· 15

display pim ipv6 grafts 16

display pim ipv6 interface· 17

display pim ipv6 join-prune· 19

display pim ipv6 neighbor 20

display pim ipv6 routing-table· 22

display pim ipv6 rp-info· 25

embedded-rp· 26

hello-option dr-priority (IPv6 PIM view) 27

hello-option holdtime (IPv6 PIM view) 28

hello-option lan-delay (IPv6 PIM view) 29

hello-option neighbor-tracking (IPv6 PIM view) 29

hello-option override-interval (IPv6 PIM view) 30

holdtime assert (IPv6 PIM view) 30

holdtime join-prune (IPv6 PIM view) 31

jp-pkt-size (IPv6 PIM view) 31

jp-queue-size (IPv6 PIM view) 32

pim ipv6· 33

pim ipv6 bfd enable· 33

pim ipv6 bsr-boundary· 34

pim ipv6 dm·· 35

pim ipv6 hello-option dr-priority· 35

pim ipv6 hello-option holdtime· 36

pim ipv6 hello-option lan-delay· 37

pim ipv6 hello-option neighbor-tracking· 37

pim ipv6 hello-option override-interval 38

pim ipv6 holdtime assert 38

pim ipv6 holdtime join-prune· 39

pim ipv6 neighbor-policy· 39

pim ipv6 require-genid· 40

pim ipv6 sm·· 41

pim ipv6 state-refresh-capable· 41

pim ipv6 timer graft-retry· 42

pim ipv6 timer hello· 42

pim ipv6 timer join-prune· 43

pim ipv6 triggered-hello-delay· 44

probe-interval (IPv6 PIM view) 44

prune delay (IPv6 PIM view) 45

register-policy (IPv6 PIM view) 45

register-suppression-timeout (IPv6 PIM view) 46

register-whole-checksum (IPv6 PIM view) 47

reset pim ipv6 control-message counters 47

source-lifetime (IPv6 PIM view) 48

source-policy (IPv6 PIM view) 48

spt-switch-threshold (IPv6 PIM view) 49

ssm-policy (IPv6 PIM view) 50

state-refresh-hoplimit 51

state-refresh-interval (IPv6 PIM view) 51

state-refresh-rate-limit (IPv6 PIM view) 52

static-rp (IPv6 PIM view) 52

timer hello (IPv6 PIM view) 53

timer join-prune (IPv6 PIM view) 54

 


bidir-pim enable (IPv6 PIM view)

Syntax

bidir-pim enable

undo bidir-pim enable

View

IPv6 PIM view

Default level

2: System level

Parameters

None

Description

Use the bidir-pim enable command to enable IPv6 BIDIR-PIM.

Use the undo bidir-pim enable command to disable IPv6 BIDIR-PIM.

The router supports this feature only when it works in SPE mode. For more information about the system working mode, see Fundamentals Configuration Guide.

By default, IPv6 BIDIR-PIM is disabled.

This command is effective only after IPv6 multicast routing is enabled.

Related commands: multicast ipv6 routing-enable and pim ipv6.

Examples

# Enable IPv6 multicast routing, enter IPv6 PIM view, and enable IPv6 BIDIR-PIM.

<Sysname> system-view

[Sysname] multicast ipv6 routing-enable

[Sysname] pim ipv6

[Sysname-pim6] bidir-pim enable

bsm-fragment enable (IPv6 PIM view)

Syntax

bsm-fragment enable

undo bsm-fragment enable

View

IPv6 PIM view

Default level

2: System level

Parameters

None

Description

Use the bsm-fragment enable command to enable bootstrap message (BSM) semantic fragmentation.

Use the undo bsm-fragment enable command to disable BSM semantic fragmentation.

By default, BSM semantic fragmentation is enabled.

The BSM semantic fragmentation function should be disabled if devices not supporting this function exist in the IPv6 PIM-SM domain.

Related commands: c-bsr admin-scope.

Examples

# Disable BSM semantic fragmentation on the public network.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] undo bsm-fragment enable

bsr-policy (IPv6 PIM view)

Syntax

bsr-policy acl6-number

undo bsr-policy

View

IPv6 PIM view

Default level

2: System level

Parameters

acl6-number: Basic IPv6 ACL number, in the range of 2000 to 2999. When an IPv6 ACL is defined, the source keyword in the rule command specifies a legal BSR source IPv6 address range.

Description

Use the bsr-policy command to configure a legal BSR address range to guard against BSR spoofing.

Use the undo bsr-policy command to remove the restriction of the BSR address range.

By default, there are no restrictions on the BSR address range, namely all the BSR messages received from any source are regarded to be valid.

Examples

# Configure a legal BSR address range so that only routers on the segment 2001::2/64 can become the BSR.

<Sysname> system-view

[Sysname] acl ipv6 number 2000

[Sysname-acl6-basic-2000] rule permit source 2001::2 64

[Sysname-acl6-basic-2000] quit

[Sysname] pim ipv6

[Sysname-pim6] bsr-policy 2000

c-bsr (IPv6 PIM view)

Syntax

c-bsr ipv6-address [ hash-length [ priority ] ]

undo c-bsr

View

IPv6 PIM view

Default level

2: System level

Parameters

ipv6-address: IPv6 address of the interface that is to act as a C-BSR.

hash-length: Hash mask length, in the range of 0 to 128. 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 range of 0 to 255. A larger value means a higher priority. If you do not include this keyword in your command, the corresponding global setting will be used.

Description

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

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

No C-BSR is configured by default.

IPv6 PIM-SM must be enabled on the interface to be configured as a C-BSR.

Related commands: c-bsr hash-length, c-bsr priority, c-rp, and pim ipv6 sm.

Examples

# Configure the interface with an IPv6 address of 1101::1 as a C-BSR.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] c-bsr 1101::1

c-bsr admin-scope (IPv6 PIM view)

Syntax

c-bsr admin-scope

undo c-bsr admin-scope

View

IPv6 PIM view

Default level

2: System level

Parameters

None

Description

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

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

IPv6 administrative scoping is disabled by default.

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

Examples

# Enable IPv6 administrative scoping.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] c-bsr admin-scope

c-bsr hash-length (IPv6 PIM view)

Syntax

c-bsr hash-length hash-length

undo c-bsr hash-length

View

IPv6 PIM view

Default level

2: System level

Parameters

hash-length: Hash mask length, in the range of 0 to 128.

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 default.

By default, the Hash mask length is 126.

Related commands: c-bsr.

Examples

# Set the global Hash mask length to 16.

<Sysname> system-view

[Sysname] pim ipv6

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

c-bsr holdtime (IPv6 PIM view)

Syntax

c-bsr holdtime interval

undo c-bsr holdtime

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: BS timeout in seconds, in the range of 1 to 2,147,483,647.

Description

Use the c-bsr holdtime command to configure the BS timeout, namely the length of time for which the C-BSRs wait for a bootstrap message from the BSR.

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

By default, the BS timeout value is determined by this formula: BS timeout = BS period × 2 + 10.

 

 

NOTE:

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

 

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

Examples

# Set the BS timeout to 150 seconds.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] c-bsr holdtime 150

c-bsr interval (IPv6 PIM view)

Syntax

c-bsr interval interval

undo c-bsr interval

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: BS period in seconds, with an effective range of 10 to 2,147,483,647.

Description

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

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

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

 

 

NOTE:

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

 

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

Examples

# Set the BS period to 30 seconds.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] c-bsr interval 30

c-bsr priority (IPv6 PIM view)

Syntax

c-bsr priority priority

undo c-bsr priority

View

IPv6 PIM view

Default level

2: System level

Parameters

priority: Priority of the C-BSR, in the range of 0 to 255. A larger value 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.

By default, the C-BSR priority is 64.

Related commands: c-bsr.

Examples

# Set the global C-BSR priority to 5.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] c-bsr priority 5

c-bsr scope

Syntax

c-bsr scope { scope-id | admin-local | global | organization-local | site-local } [ hash-length hash-length | priority priority ] *

undo c-bsr scope { scope-id | admin-local | global | organization-local | site-local }

View

IPv6 PIM view

Default level

2: System level

Parameters

scope-id: Specifies the value of the Scope field, in the range of 3 to 15.

admin-local: Specifies the scope field value as admin-local, which has a scope value of 4.

global: Specifies the scope field value as global, which has a scope value of 14.

organization-local: Specifies the scope field value as organization-local, which has a scope value of 8.

site-local: Specifies the scope field value as site-local, which has a scope value of 5.

hash-length: Specifies the hash mask length of the IPv6 admin-scope zone indicated by the Scope value, in the range of 0 to 128. If you do not include this argument in your command, the corresponding global setting will be used.

priority: Priority of the C-BSR in the IPv6 admin-scope zone indicated by the Scope value, in the range of 0 to 255. A larger value means a higher priority. If you do not include this argument in your command, the corresponding global setting will be used.

Description

Use the c-bsr scope command to configure the C-BSR in the IPv6 admin-scope zone.

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

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

Examples

# Configure the C-BSR of the IPv6 admin-scope zone with the Scope value being 14 and set the C-BSR priority to 10.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] c-bsr scope global priority 10

c-rp (IPv6 PIM view)

Syntax

c-rp ipv6-address [ { group-policy acl6-number | scope scope-id } | priority priority | holdtime hold-interval | advertisement-interval adv-interval ] * [ bidir ]

undo c-rp ipv6-address

View

IPv6 PIM view

Default level

2: System level

Parameters

ipv6-address: IPv6 address of the interface that is to act as a C-RP.

acl6-number: Basic IPv6 ACL number, in the range of 2000 to 2999. This IPv6 ACL defines a range of IPv6 multicast groups the C-RP is going to serve, rather than defining a filtering rule. Any IPv6 multicast group range that matches 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.

scope-id: Specifies the value of the Scope field, in the range of 3 to 15.

priority: Priority of the C-RP, in the range of 0 to 255 and defaulting to 192. A larger value means a lower priority.

hold-interval: C-RP timeout time, in seconds. The value ranges from 1 to 65,535. If you do not include this argument in your command, the corresponding global setting will be used.

adv-interval: C-RP-Adv interval in seconds, with an effective range of 1 to 65,535. If you do not include this argument in your command, the corresponding global setting will be used.

bidir: Configures the C-RP to serve multicast groups in the bidirectional PIM mode. If you do not specify this argument, the C-RP serves multicast groups in the IPv6 PIM-SM mode.

Description

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

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

No C-RPs are configured by default.

IPv6 PIM-SM must be enabled on the interface to be configured as a C-RP.

If you do not specify an IPv6 multicast group range for the C-RP, the C-RP will serve all IPv6 multicast groups in the IPv6 non-scoped zone, or it will serve IPv6 multicast groups in the IPv6 global admin-scope zone if IPv6 administrative scoping is configured.

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

If you execute this command repeatedly on the same interface, the last configuration takes effect.

Related commands: c-bsr.

Examples

# Configure the interface with the IPv6 address of 2001::1 to be a C-RP for IPv6 multicast group FF0E:0:1391::/96, with a priority of 10.

<Sysname> system-view

[Sysname] acl ipv6 number 2000

[Sysname-acl6-basic-2000] rule permit source ff0e:0:1391:: 96

[Sysname-acl6-basic-2000] quit

[Sysname] pim ipv6

[Sysname-pim6] c-rp 2001::1 group-policy 2000 priority 10

c-rp advertisement-interval (IPv6 PIM view)

Syntax

c-rp advertisement-interval interval

undo c-rp advertisement-interval

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: C-RP-Adv interval in seconds, with an effective range of 1 to 65,535.

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.

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 ipv6

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

c-rp holdtime (IPv6 PIM view)

Syntax

c-rp holdtime interval

undo c-rp holdtime

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: C-RP timeout in seconds, with an effective range of 1 to 65,535.

Description

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

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

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 the 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 BS period or longer.

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

Examples

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

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] c-rp holdtime 200

crp-policy (IPv6 PIM view)

Syntax

crp-policy acl6-number

undo crp-policy

View

IPv6 PIM view

Default level

2: System level

Parameters

acl6-number: Advanced IPv6 ACL number, in the range of 3000 to 3999. When the IPv6 ACL is defined, the source keyword in the rule command specifies the IPv6 address of a C-RP and the destination keyword specifies the IPv6 address range of the IPv6 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 IPv6 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 IPv6 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 assumed to be legal.

The crp-policy command filters the IPv6 multicast group ranges advertised by C-RPs based on the group prefixes. For example, if the IPv6 multicast group range advertised by a C-RP is FF0E:0:1::/96 while the legal IPv6 multicast group range defined by the crp-policy command is FF0E:0:1::/120, the IPv6 multicast groups in the range of FF0E:0:1::/96 are allowed to pass.

Related commands: c-rp.

Examples

# Configure a C-RP address range so that only routers in the address range of 2001::2/64 can be C-RPs.

<Sysname> system-view

[Sysname] acl ipv6 number 3000

[Sysname-acl6-adv-3000] rule permit ipv6 source 2001::2 64

[Sysname-acl6-adv-3000] quit

[Sysname] pim ipv6

[Sysname-pim6] crp-policy 3000

display pim ipv6 bsr-info

Syntax

display pim ipv6 bsr-info [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

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

Related commands: c-bsr and c-rp.

Examples

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

<Sysname> display pim ipv6 bsr-info

 Elected BSR Address: 2004::2

     Priority: 64

     Hash mask length: 126

     State: Elected

     Scope: 14

     Uptime: 00:01:10

     Next BSR message scheduled at: 00:00:48

 Candidate BSR Address: 2004::2

     Priority: 64

     Hash mask length: 126

     State: Elected

     Scope: 14

 Candidate RP: 2001::1(LoopBack1)

     Priority: 192

     HoldTime: 130

     Advertisement Interval: 60

     Next advertisement scheduled at: 00:00:48

 Candidate RP: 2002::1(GigabitEthernet2/1/1)

     Priority: 192

     HoldTime: 90

     Advertisement Interval: 50

     Next advertisement scheduled at: 00:00:28

 Candidate RP: 2003::1(GigabitEthernet2/1/2)

     Priority: 0

     HoldTime: 80

     Advertisement Interval: 60

     Next advertisement scheduled at: 00:00:48

Table 1 Output description

Field

Description

Elected BSR Address

IPv6 address of the elected BSR

Candidate BSR Address

Address of the candidate BSR

Priority

BSR priority

Hash mask length

Hash mask length

State

BSR state

Scope

IPv6 admin-scope zone of the BSR

Uptime

Length of time since this BSR was elected

Next BSR message scheduled at

Remaining time of this BSR

Candidate RP

Address of the C-RP

Priority

Priority of the C-RP

HoldTime

Timeout time of the C-RP

Advertisement Interval

Interval between C-RP-Adv messages

Next BSR message scheduled at

Remaining time before the C-RP will send the next C-RP-Adv message

 

display pim ipv6 claimed-route

Syntax

display pim ipv6 claimed-route [ ipv6-source-address ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

ipv6-source-address: Displays the information of the IPv6 unicast route to a particular IPv6 multicast source. If you do not provide this argument, this command displays information about all IPv6 unicast routes used by IPv6 PIM.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

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

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

Examples

# Display the information of all IPv6 unicast routes used by IPv6 PIM.

<Sysname> display pim ipv6 claimed-route

 RPF information about: 2001::2

     RPF interface: GigabitEthernet2/1/1, RPF neighbor: FE80::A01:100:1

     Referenced prefix/prefix length: 2001::/64

     Referenced route type: igp

     RPF-route selecting rule: preference-preferred

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

     (2001::2, FF03::101)

Table 2 Output description

Field

Description

RPF information about: 2001::2

Information of the RPF route to the IPv6 multicast source 2001::2

RPF interface

RPF interface type and number

RPF neighbor

IPv6 address of the RPF neighbor

Referenced prefix/prefix length

Address/mask of the reference route

Referenced route type

Type of the referenced route:

·       igp: IGP IPv6 unicast route

·       egp: EGP IPv6 unicast route

·       unicast (direct): Direct IPv6 unicast route

·       unicast: Other IPv6 unicast route (such as IPv6 static unicast route)

·       mbgp: IPv6 MBGP 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) entry list dependent on this RPF route

 

display pim ipv6 control-message counters

Syntax

display pim ipv6 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 } ] * ] [ | { begin | exclude | include } regular-expression ]

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-type interface-number: Displays the number of IPv6 PIM control messages on the specified interface.

assert: Displays the number of assert messages.

bsr: Displays the number of bootstrap messages.

crp: Displays the number of C-RP-Adv messages.

graft: Displays the number of graft messages.

graft-ack: Displays the number of graft-ack messages.

hello: Displays the number of hello messages.

join-prune: Displays the number of join/prune messages.

state-refresh: Displays the number of state refresh messages.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display pim ipv6 control-message counters command to display statistics for IPv6 PIM control messages.

Examples

# Display statistics for all IPv6 PIM control messages on all interfaces.

<Sysname> display pim ipv6 control-message counters

 PIM global control-message counters:

                  Received         Sent             Invalid

 Register         20               37               2

 Register-Stop    25               20               1

 Probe            10               5                0

 

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

                  Received         Sent             Invalid

 Assert           10               5                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

 C-RP             53               32               0

Table 3 Output description

Field

Description

PIM global control-message counters

Statistics of IPv6 PIM global control messages

PIM control-message counters for interface

Interface for which the IPv6 PIM control messages were counted

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

C-RP

C-RP-Adv messages

 

display pim ipv6 df-info

Syntax

display pim ipv6 df-info [ rp-address ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

rp-address: Specifies the RP address of IPv6 BIDIR-PIM.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays the lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display pim ipv6 df-info command to display the DF information of IPv6 BIDIR-PIM.

Examples

# Display the DF information of IPv6 BIDIR-PIM.

<Sysname> display pim ipv6 df-info

 

RP Address: 3:3:3::1                                                            

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

  GE3/2/1             Lose    0          0          00:00:14  FE80::223:89FF:  

                                                              FE57:BCD1        

  GE3/2/5             Win     10         1          00:00:05  FE80::223:89FF:  

                                                              FE7C:CB38 (local)

  RPR7                Win     10         1          00:00:05  FE80::223:89FF:  

                                                              FE7C:CB00 (local)

Table 4 Output description

Field

Description

RP Address

IPv6 BIDIR-PIM RP address

Interface

Interface type and number

State

DF election state, which can be Win or Loss

DF-Pref

Route priority of DF

DF-Metric

Route metric of DF

DF-Uptime

Existence duration of DF

DF-Address

IPv6 address of DF, where local indicates a local IPv6 address

 

display pim ipv6 grafts

Syntax

display pim ipv6 grafts [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

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

Examples

# Display the information about unacknowledged graft messages.

<Sysname> display pim ipv6 grafts

 Source             Group             Age           RetransmitIn

 1004::2            ff03::101         00:00:24      00:00:02

Table 5 Output description

Field

Description

Source

IPv6 multicast source address in the graft message

Group

IPv6 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

 

display pim ipv6 interface

Syntax

display pim ipv6 interface [ interface-type interface-number ] [ verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

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

verbose: Displays the detailed PIM information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

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

Examples

# Display the detailed IPv6 PIM information on GigabitEthernet 2/1/1.

<Sysname> display pim ipv6 interface GigabitEthernet 2/1/1 verbose

 Interface: GigabitEthernet2/1/1, FE80::200:5EFF:FE04:8700

     PIM version: 2

     PIM mode: Sparse

     PIM DR: FE80::200:AFF:FE01:101

     PIM DR Priority (configured): 1

     PIM neighbor count: 1

     PIM hello interval: 30 s

     PIM LAN delay (negotiated): 500 ms

     PIM LAN delay (configured): 500 ms

     PIM override interval (negotiated): 2500 ms

     PIM override interval (configured): 2500 ms

     PIM neighbor tracking (negotiated): disabled

     PIM neighbor tracking (configured): disabled

     PIM generation ID: 0xF5712241

     PIM require generation ID: disabled

     PIM hello hold interval: 105 s

     PIM assert hold interval: 180 s

     PIM triggered hello delay: 5 s

     PIM J/P interval: 60 s

     PIM J/P hold interval: 210 s

     PIM BSR domain border: disabled

     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

Table 6 Output description

Field

Description

Interface

Interface name and its IPv6 address

PIM version

IPv6 PIM version

PIM mode

IPv6 PIM mode, dense or sparse

PIM DR

IPv6 address of the DR

PIM DR Priority (configured)

Priority for DR election

PIM neighbor count

Total number of IPv6 PIM neighbors

PIM hello interval

Interval between IPv6 PIM hello messages

PIM LAN delay (negotiated)

Negotiated prune message delay

PIM LAN delay (configured)

Configured prune message delay

PIM override interval (negotiated)

Negotiated prune override interval

PIM override interval (configured)

Configured prune override interval

PIM neighbor tracking (negotiated)

Negotiated neighbor tracking status (enabled/disabled)

PIM neighbor tracking (configured)

Configured neighbor tracking status (enabled/disabled)

PIM generation ID

Generation_ID value

PIM require generation ID

Rejection of Hello messages without Generation_ID (enabled/disabled)

PIM hello hold interval

IPv6 PIM neighbor timeout time

PIM assert hold interval

Assert timeout time

PIM triggered hello delay

Maximum delay of sending hello messages

PIM J/P interval

Join/prune interval

PIM J/P hold interval

Join/prune timeout time

PIM BSR domain border

Status of PIM domain border configuration (enabled/disabled)

Number of routers on network not using DR priority

Number of routers not using the DR priority field on the subnet where the interface resides

Number of routers on network not using LAN delay

Number of routers not using the LAN delay field on the subnet where the interface resides

Number of routers on network not using neighbor tracking

Number of routers not using neighbor tracking on the subnet where the interface resides

 

display pim ipv6 join-prune

Syntax

display pim ipv6 join-prune mode { sm [ flags flag-value ] | ssm } [ interface interface-type interface-number | neighbor ipv6-neighbor-address ] * [ verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

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

flags flag-value: Specifies to display IPv6 PIM routing entries containing the specified flag(s).Values and meanings of flag-value are as follows:

·           rpt: Specifies routing entries on the RPT.

·           spt: Specifies routing entries on the SPT.

·           wc: Specifies wildcard routing entries.

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

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

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

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

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

Examples

# Display the information of join/prune messages to send in the IPv6 PIM-SM mode.

<Sysname> display pim ipv6 join-prune mode sm

 

 Expiry Time: 50 sec

 Upstream nbr: FE80::2E0:FCFF:FE03:1004 (GigabitEthernet2/1/2)

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

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

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

Table 7 Output description

Field

Description

Expiry Time:

Expiry time of sending join/prune messages

Upstream nbr:

IPv6 address of the upstream IPv6 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

 

display pim ipv6 neighbor

Syntax

display pim ipv6 neighbor [ interface interface-type interface-number | ipv6-neighbor-address | verbose ] * [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

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

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

verbose: Displays the detailed IPv6 PIM neighbor information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display pim ipv6 neighbor command to display the IPv6 PIM neighbor information.

Examples

# Display the information of all IPv6 PIM neighbors.

<Sysname> display pim ipv6 neighbor

 Total Number of Neighbors = 2

 

 Neighbor         Interface           Uptime   Expires  Dr-Priority  Mode

 FE80::A01:101:1  GE2/1/1              02:50:49 00:01:31 1            B

 FE80::A01:102:1  GE2/1/2              02:49:39 00:01:42 1            B

# Display the detailed information of the IPv6 PIM neighbor whose IPv6 address is FE80::A01:101:1.

<Sysname> display pim ipv6 neighbor fe80::a01:101:1 verbose

Neighbor: FE80::A01:101:1

     Interface: GigabitEthernet3/1/2

     Uptime: 00:00:10

     Expiry time: 00:00:30

     DR Priority: 1

     Generation ID: 0x2ACEFE15

     Holdtime: 105 s

     LAN delay: 500 ms

     Override interval: 2500 ms

     State refresh interval: 60 s

     Neighbor tracking: Disabled

     Bidirectional PIM: Enabled

Neighbor Secondary Address(es):

     1::1

 

Table 8 Output description

Field

Description

Total Number of Neighbors

Total number of IPv6 PIM neighbors

Neighbor

IPv6 address of the PIM neighbor (link-local address)

Interface

Interface connecting the IPv6 PIM neighbor

Uptime

Length of time since the IPv6 PIM neighbor was discovered

Expires/Expiry time

Remaining time of the IPv6 PIM neighbor; “never” means that the IPv6 PIM neighbor is always up and reachable

Dr-Priority/DR Priority

IPv6 PIM neighbor priority

Mode

Mode of the IPv6 PIM neighbor, where B means IPv6 BIDIR-PIM mode, and if nothing is displayed, it means non-IPv6 BIDIR-PIM mode

Generation ID

Generation ID of the IPv6 PIM neighbor (a random value indicating status change of the IPv6 PIM neighbor)

Holdtime

Lifetime of the IPv6 PIM neighbor; “forever” means that the IPv6 PIM neighbor is always up and reachable

LAN delay

Prune message delay

Override interval

Prune override interval

State refresh interval

Interval for sending state refresh messages

Displayed only when the IPv6 PIM neighbor works in IPv6 PIM_DM mode and state refresh capability is enabled.

Neighbor tracking

Neighbor tracking status (enabled/disabled)

Bidirectional PIM

IPv6 BIDIR-PIM status (enabled/disabled)

Neighbor Secondary Address(es)

Secondary IPv6 address of the PIM neighbor (non-link-local address)

 

display pim ipv6 routing-table

Syntax

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

View

Any view

Default level

1: Monitor level

Parameters

ipv6-group-address: Displays the routing entries for the specified IPv6 multicast group. The IPv6 multicast group address is in the range of FFxy::/16, where x and y represent any hexadecimal number between 0 and F, inclusive.

ipv6-source-address: Displays the routing entries containing the specified IPv6 multicast source.

prefix-length: Prefix length of the IPv6 multicast group/source address prefix. For an IPv6 multicast group address, the effective range is 8 to 128 and the default value is 128; for an IPv6 multicast source address, the effective range is 0 to 128 and the default value is 128.

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 that contain the specified interface as the outgoing 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 excludes the specified interface.

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

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

·           dm: Specifies IPv6 PIM-DM.

·           sm: Specifies IPv6 PIM-SM.

·           ssm: Specifies IPv6 PIM-SSM.

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

·           act: Specifies IPv6 multicast routing entries to which actual data has arrived.

·           bidir: Specifies IPv6 multicast routing entries created by IPv6 BIDIR-PIM.

·           del: Specifies IPv6 multicast routing entries scheduled to be deleted.

·           exprune: Specifies multicast routing entries containing outgoing interfaces pruned by other IPv6 multicast routing protocols.

·           ext: Specifies IPv6 routing entries containing outgoing interfaces contributed by other IPv6 multicast routing protocols.

·           loc: Specifies IPv6 multicast routing entries on routers directly connected to the same subnet with the IPv6 multicast source.

·           niif: Specifies IPv6 multicast routing entries containing unknown incoming interfaces.

·           nonbr: Specifies routing entries with IPv6 PIM neighbor searching failure.

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

·           spt: Specifies routing entries on the SPT.

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

·           wc: Specifies wildcard routing entries.

fsm: Displays the detailed information of the state machine.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

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

Related commands: display ipv6 multicast routing-table.

Examples

# Display the content of the IPv6 PIM routing table.

<Sysname> display pim ipv6 routing-table

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

 

 (2001::2, FFE3::101)

     RP: FE80::A01:100:1

     Protocol: pim-sm, Flag: SPT LOC ACT

     UpTime: 02:54:43

     Upstream interface: GigabitEthernet3/1/1

         Upstream neighbor: NULL

         RPF prime neighbor: NULL

     Downstream interface(s) information:

     Total number of downstreams: 1

         1: GigabitEthernet3/1/2

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

# Display the state machine information of the IPv6 PIM routing table.

<Sysname> display pim ipv6 routing-table fsm

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

 

 Abbreviations for FSM states:

     NI - no info, J - joined, NJ - not joined, P - pruned,

     NP - not pruned, PP - prune pending, W - winner, L - loser,

     F - forwarding, AP - ack pending, DR - designated router,

     NDR - non-designated router, RCV - downstream receivers

 

 (2001::2, FFE3::101)

     RP: FE80::A01:100:1

     Protocol: pim-sm, Flag: SPT LOC ACT

     UpTime: 02:54:43

     Upstream interface: GigabitEthernet3/1/1

         Upstream neighbor: NULL

         RPF prime neighbor: NULL

         Join/Prune FSM: [SPT: J] [RPT: NP]

     Downstream interface(s) information:

     Total number of downstreams: 1

         1: GigabitEthernet3/1/2

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

             DR state: [DR]

             Join/Prune FSM: [NI]

             Assert FSM: [NI]

 

     FSM information for non-downstream interfaces: None

Table 9 Output description

Field

Description

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

Number of (S, G) and (*, G) entries in the IPv6 PIM routing table

(2001::2, FFE3::101)

An (S, G) entry in the IPv6 PIM routing table

RP

IP address of the RP

Protocol

IPv6 PIM mode

Flag

Flag of the (S, G) or (*, G) entry in the IPv6 PIM routing table:

·       ACT: Indicates that the entry has been used for routing data.

·       BIDIR: Indicates that the entry was created by IPv6 BIDIR-PIM.

·       DEL: Indicates that the entry is to be removed.

·       EXPRUNE: Indicates that some outgoing interfaces are pruned by other IPv6 multicast routing protocols.

·       EXT: Indicates that the entry contains outgoing interfaces provided by other IPv6 multicast routing protocols.

·       LOC: Indicates that the entry is on a router directly connected to the same subnet with the IPv6 multicast source.

·       NIIF: Indicates that the entry contains unknown incoming interfaces.

·       NONBR: Indicates that the entry has an IPv6 PIM neighbor searching failure.

·       RPT: Indicates that the entry is on a RPT branch where (S, G) prunes have been sent to the RP.

·       SPT: Indicates that the entry is on the SPT.

·       SWT: Indicates that the entry is in the process of RPT-to-SPT switchover.

·       WC: Indicates a wildcard routing entry.

Uptime

Length of time since the (S, G) or (*, G) entry was installed

Upstream interface

Name of the upstream 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

·       For a (*, G) entry, if this router is the RP, the RPF neighbor of this (*, G) entry is NULL.

·       For a (S, G) entry, if this router directly connects to the IPv6 multicast source, the RPF neighbor of this (S, G) entry is NULL.

Downstream interface(s) information

Information of the downstream interface(s), including:

·       Number of downstream interfaces

·       Downstream interface name

·       Protocol type configured on the downstream interface

·       Uptime of the downstream interface(s)

·       Expiry time of the downstream interface(s)

 

display pim ipv6 rp-info

Syntax

display pim ipv6 rp-info [ ipv6-group-address ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

ipv6-group-address: Specifies an IPv6 multicast group by its address, in the range of FFxy::/16 (excluding FFx0::/16, FFx1::/16, FFx2::/16 and FF0y::), where x and y represent any hexadecimal number between 0 and F, inclusive. If you do not provide a group address, this command displays RP information for all IPv6 multicast groups.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

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

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

Examples

# Display the RP information corresponding to the IPv6 multicast group FF0E::101.

<Sysname> display pim ipv6 rp-info ff0e::101

 PIM-SM BSR RP information:

 prefix/prefix length: FF0E::101/64 [B]

     RP: 2004::2

     Priority: 192

     HoldTime: 130

     Uptime: 00:05:19

     Expires: 00:02:11

Table 10 Output description

Field

Description

prefix/prefix length

The IPv6 multicast group served by the RP

[B]

The RP serves multicast groups in the IPv6 bidirectional PIM mode. Without this field displayed, the RP serves multicast groups in the IPv6 PIM-SM mode.

RP

IPv6 address of the RP

Priority

RP priority

HoldTime

Timeout time of the RP

Uptime

Length of time since the RP was elected

Expires

Remaining time of the RP

 

embedded-rp

Syntax

embedded-rp [ acl6-number ]

undo embedded-rp [ acl6-number ]

View

IPv6 PIM view

Default level

2: System level

Parameters

acl6-number: Basic IPv6 ACL number, in the range of 2000 to 2999.

Description

Use the embedded-rp command to enable embedded RP.

Use the undo embedded-rp command to disable embedded RP or restore the default.

By default, embedded RP is enabled for IPv6 multicast groups in the default embedded RP address scopes.

 

 

NOTE:

The default embedded RP address scopes are FF7x::/12 and FFFx::/12. Here “x” refers to any legal address scope. For more information about the scope field, see IP Multicast Configuration Guide.

 

When you use the embedded-rp command without specifying acl6-number, the embedded RP feature will be enabled for all the IPv6 multicast groups in the default embedded RP address scopes. If you specify acl6-number, the embedded RP feature will be enabled for only those IPv6 multicast groups that are within the default embedded RP address scopes and pass the IPv6 ACL check.

When you use the undo embedded-rp command without specifying acl6-number, the embedded RP feature will be disabled for all the IPv6 multicast groups. If you specify acl6-number, this command restores the system default.

Examples

# Enable embedded RP for only those IPv6 multicast groups in the address scope FF7E:140:20::101/64.

<Sysname> system-view

[Sysname] acl ipv6 number 2000

[Sysname-acl6-basic-2000] rule permit source ff7e:140:20::101 64

[Sysname-acl6-basic-2000] quit

[Sysname] pim ipv6

[Sysname-pim6] embedded-rp 2000

hello-option dr-priority (IPv6 PIM view)

Syntax

hello-option dr-priority priority

undo hello-option dr-priority

View

IPv6 PIM view

Default level

2: System level

Parameters

priority: Router priority for DR election, in the range of 0 to 4294967295. A larger value 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.

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

Related commands: pim ipv6 hello-option dr-priority.

Examples

# Set the router priority for DR election to 3.

<Sysname> system-view

[Sysname] pim ipv6

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

hello-option holdtime (IPv6 PIM view)

Syntax

hello-option holdtime interval

undo hello-option holdtime

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: IPv6 PIM neighbor timeout time in seconds, with an effective range of 1 to 65,535. 65,535 makes the IPv6 PIM neighbor always reachable.

Description

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

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

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

Related commands: pim ipv6 hello-option holdtime.

Examples

# Set the IPv6 PIM neighbor timeout time to 120 seconds globally.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] hello-option holdtime 120

hello-option lan-delay (IPv6 PIM view)

Syntax

hello-option lan-delay interval

undo hello-option lan-delay

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: LAN-delay time in milliseconds, with an effective range of 1 to 32,767.

Description

Use the hello-option lan-delay command to configure the global value of the LAN-delay time, namely the length of time the device waits before forwarding a received prune message.

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

By default, the LAN-delay time is 500 milliseconds.

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

Examples

# Set the LAN-delay to 200 milliseconds globally.

<Sysname> system-view

[Sysname] pim ipv6

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

hello-option neighbor-tracking (IPv6 PIM view)

Syntax

hello-option neighbor-tracking

undo hello-option neighbor-tracking

View

IPv6 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.

Related commands: pim ipv6 hello-option neighbor-tracking.

Examples

# Disable join suppression globally.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] hello-option neighbor-tracking

hello-option override-interval (IPv6 PIM view)

Syntax

hello-option override-interval interval

undo hello-option override-interval

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: Prune override interval in milliseconds, with an effective range of 1 to 65,535.

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.

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

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

Examples

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

<Sysname> system-view

[Sysname] pim ipv6

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

holdtime assert (IPv6 PIM view)

Syntax

holdtime assert interval

undo holdtime assert

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: Assert timeout time in seconds, with an effective range of 7 to 2,147,483,647.

Description

Use the holdtime assert command to configure the global value of the assert timeout time.

Use the undo holdtime assert command to restore the default.

By default, the assert timeout time is 180 seconds.

Related commands: holdtime join-prune, pim ipv6 holdtime assert, and pim ipv6 holdtime join-prune.

Examples

# Set the global value of the assert timeout time to 100 seconds.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] holdtime assert 100

holdtime join-prune (IPv6 PIM view)

Syntax

holdtime join-prune interval

undo holdtime join-prune

View

IPv6 PIM 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 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.

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

Related commands: holdtime assert, pim ipv6 holdtime assert, and pim ipv6 holdtime join-prune.

Examples

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

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] holdtime join-prune 280

jp-pkt-size (IPv6 PIM view)

Syntax

jp-pkt-size packet-size

undo jp-pkt-size

View

IPv6 PIM view

Default level

2: System level

Parameters

packet-size: Maximum size of join/prune messages in bytes, with an effective range of 100 to 64000.

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.

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 ipv6

[Sysname-pim6] jp-pkt-size 1500

jp-queue-size (IPv6 PIM view)

Syntax

jp-queue-size queue-size

undo jp-queue-size

View

IPv6 PIM view

Default level

2: System level

Parameters

queue-size: Maximum number of (S, G) entries in a join/prune message, in the range of 1 to 4,096.

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.

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

When you use this command, take the following into account:

·           The size of the forwarding table. In a network that does not support packet fragmentation, if you configure a large queue-size, a join/prune message may contain a large number of groups, causing the message length to exceed the MTU of the network. As a result, the products that do not support fragmentation will drop the join/prune message.

·           The (S, G) join/prune state hold 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: holdtime join-prune, jp-pkt-size, and 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 ipv6

[Sysname-pim6] jp-queue-size 2000

pim ipv6

Syntax

pim ipv6

undo pim ipv6

View

System view

Default level

2: System level

Parameters

None

Description

Use the pim ipv6 command to enter IPv6 PIM view.

Use the undo pim ipv6 command to remove all configurations performed in IPv6 PIM view.

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

Related commands: multicast ipv6 routing-enable.

Examples

# Enable IPv6 multicast routing and enter IPv6 PIM view.

<Sysname> system-view

[Sysname] multicast ipv6 routing-enable

[Sysname] pim ipv6

[Sysname-pim6]

pim ipv6 bfd enable

Syntax

pim ipv6 bfd enable

undo pim ipv6 bfd enable

View

Interface view

Default level

2: System level

Parameters

None

Description

Use the pim ipv6 bfd enable command to enable IPv6 PIM to work with Bidirectional Forwarding Detection (BFD).

Use the undo pim ipv6 bfd enable command to disable this feature.

By default, this feature is disabled.

You must enable IPv6 PIM-DM or IPv6 PIM-SM on an interface before you configure this feature on the interface. Otherwise, this feature is not effective.

Related commands: pim ipv6 dm and  pim ipv6 sm.

Examples

# Enable IPv6 multicast routing on the public network, enable  IPv6 PIM-SM on interface GigabitEthernet 3/1/1, and enable  IPv6 PIM to work with BFD on the interface.

<Sysname> system-view

[Sysname] multicast ipv6 routing-enable

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/1] pim ipv6 sm

[Sysname-GigabitEthernet3/1/1] pim ipv6 bfd enable

pim ipv6 bsr-boundary

Syntax

pim ipv6 bsr-boundary

undo pim ipv6 bsr-boundary

View

Interface view

Default level

2: System level

Parameters

None

Description

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

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

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

Related commands: c-bsr and multicast ipv6 boundary.

Examples

# Configure GigabitEthernet 2/1/1 as a PIM domain border.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

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

pim ipv6 dm

Syntax

pim ipv6 dm

undo pim ipv6 dm

View

Interface view

Default level

2: System level

Parameters

None

Description

Use the pim ipv6 dm command to enable IPv6 PIM-DM.

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

By default, IPv6 PIM-DM is disabled.

This command can take effect only after IPv6 multicast routing is enabled on the device.

IPv6 PIM-DM cannot be used for IPv6 multicast groups in the IPv6 SSM group range.

Related commands: multicast ipv6 routing-enable, pim ipv6 sm, and ssm-policy.

Examples

# Enable IPv6 multicast routing, and enable IPv6 PIM-DM on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] multicast ipv6 routing-enable

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] pim ipv6 dm

pim ipv6 hello-option dr-priority

Syntax

pim ipv6 hello-option dr-priority priority

undo pim ipv6 hello-option dr-priority

View

Interface view

Default level

2: System level

Parameters

priority: Router priority for DR election, in the range of 0 to 4294967295. A larger value means a higher priority.

Description

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

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

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

Related commands: hello-option dr-priority.

Examples

# Set the router priority for DR election to 3 on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

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

pim ipv6 hello-option holdtime

Syntax

pim ipv6 hello-option holdtime interval

undo pim ipv6 hello-option holdtime

View

Interface view

Default level

2: System level

Parameters

interval: IPv6 PIM neighbor timeout time in seconds, with an effective range of 1 to 65,535. 65,535 makes the IPv6 PIM neighbor always reachable.

Description

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

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

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

Related commands: hello-option holdtime.

Examples

# Set the IPv6 PIM neighbor timeout time to 120 seconds on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

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

pim ipv6 hello-option lan-delay

Syntax

pim ipv6 hello-option lan-delay interval

undo pim ipv6 hello-option lan-delay

View

Interface view

Default level

2: System level

Parameters

interval: LAN-delay time in milliseconds, with an effective range of 1 to 32,767.

Description

Use the pim ipv6 hello-option lan-delay command to configure the LAN-delay time, namely the device waits before forwarding a received prune message, on the current interface.

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

By default, the LAN-delay time is 500 milliseconds.

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

Examples

# Set the LAN-delay time to 200 milliseconds on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

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

pim ipv6 hello-option neighbor-tracking

Syntax

pim ipv6 hello-option neighbor-tracking

undo pim ipv6 hello-option neighbor-tracking

View

Interface view

Default level

2: System level

Parameters

None

Description

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

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

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

Related commands: hello-option neighbor-tracking.

Examples

# Disable join suppression on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

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

pim ipv6 hello-option override-interval

Syntax

pim ipv6 hello-option override-interval interval

undo pim ipv6 hello-option override-interval

View

Interface view

Default level

2: System level

Parameters

interval: Prune override interval in milliseconds, with an effective range of 1 to 65,535.

Description

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

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

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

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

Examples

# Set the prune override interval to 2,000 milliseconds on GigabitEthernet2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet2/1/1

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

pim ipv6 holdtime assert

Syntax

pim ipv6 holdtime assert interval

undo pim ipv6 holdtime assert

View

Interface view

Default level

2: System level

Parameters

interval: Assert timeout time in seconds, with an effective range of 7 to 2,147,483,647.

Description

Use the pim ipv6 holdtime assert command to configure the assert timeout time on the current interface.

Use the undo pim ipv6 holdtime assert command to restore the default.

By default, the assert timeout time is 180 seconds.

Related commands: holdtime assert, holdtime join-prune, and pim ipv6 holdtime join-prune.

Examples

# Set the assert timeout time to 100 seconds on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] pim ipv6 holdtime assert 100

pim ipv6 holdtime join-prune

Syntax

pim ipv6 holdtime join-prune interval

undo pim ipv6 holdtime join-prune

View

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 ipv6 holdtime join-prune command to configure the join/prune timeout time on the interface.

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

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

Related commands: holdtime assert, holdtime join-prune, and pim ipv6 holdtime assert.

Examples

# Set the join/prune timeout time to 280 seconds on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

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

pim ipv6 neighbor-policy

Syntax

pim ipv6 neighbor-policy acl6-number

undo pim ipv6 neighbor-policy

View

Interface view

Default level

2: System level

Parameters

acl6-number: Basic IPv6 ACL number, in the range of 2000 to 2999. When the IPv6 ACL is defined, the source keyword in the rule command specifies a legal source address range for hello messages.

Description

Use the pim ipv6 neighbor-policy command to configure a legal source address range for hello messages to guard against hello message spoofing.

Use the undo pim ipv6 neighbor-policy command to restore the default.

By default, no source address range for hello messages is configured, that is, all the received hello messages are considered legal.

Examples

# Configure a legal source address range for hello messages on GigabitEthernet 3/1/1 so that only the routers on the FE80:101::101/64 subnet can become PIM neighbors of this router.

<Sysname> system-view

[Sysname] acl ipv6 number 2000

[Sysname-acl6-basic-2000] rule permit source fe80:101::101 64

[Sysname-acl6-basic-2000] quit

[Sysname] interface Gigabitethernet 3/1/1

[Sysname-GigabitEthernet3/1/1] pim ipv6 neighbor-policy 2000

pim ipv6 require-genid

Syntax

pim ipv6 require-genid

undo pim ipv6 require-genid

View

Interface view

Default level

2: System level

Parameters

None

Description

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

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

By default, hello messages without Generation_ID are accepted.

Examples

# Configure GigabitEthernet 2/1/1 to reject hello messages without Generation_ID.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

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

pim ipv6 sm

Syntax

pim ipv6 sm

undo pim ipv6 sm

View

Interface view

Default level

2: System level

Parameters

None

Description

Use the pim ipv6 sm command to enable IPv6 PIM-SM.

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

By default, IPv6 PIM-SM is disabled.

This command can take effect only after IPv6 multicast routing is enabled on the device.

Related commands: multicast ipv6 routing-enable and pim ipv6 dm.

Examples

# Enable IPv6 multicast routing, and enable IPv6 PIM-SM on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] multicast ipv6 routing-enable

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] pim ipv6 sm

pim ipv6 state-refresh-capable

Syntax

pim ipv6 state-refresh-capable

undo pim ipv6 state-refresh-capable

View

Interface view

Default level

2: System level

Parameters

None

Description

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

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

By default, the state refresh feature is enabled.

Related commands: state-refresh-hoplimit, state-refresh-interval, and state-refresh-rate-limit.

Examples

# Disable state refresh on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

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

pim ipv6 timer graft-retry

Syntax

pim ipv6 timer graft-retry interval

undo pim ipv6 timer graft-retry

View

Interface view

Default level

2: System level

Parameters

interval: Graft retry period in seconds, with an effective range of 1 to 65,535.

Description

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

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

By default, the graft retry period is 3 seconds.

Examples

# Set the graft retry period to 80 seconds on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

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

pim ipv6 timer hello

Syntax

pim ipv6 timer hello interval

undo pim ipv6 timer hello

View

Interface view

Default level

2: System level

Parameters

interval: Hello interval in seconds, with an effective range of 1 to 2,147,483,647.

Description

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

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

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

Related commands: timer hello.

Examples

# Set the hello interval to 40 seconds on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

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

pim ipv6 timer join-prune

Syntax

pim ipv6 timer join-prune interval

undo pim ipv6 timer join-prune

View

Interface view

Default level

2: System level

Parameters

interval: Join/prune interval in seconds, with an effective range of 1 to 2,147,483,647.

Description

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

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

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

Related commands: timer join-prune.

Examples

# Set the join/prune interval to 80 seconds on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

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

pim ipv6 triggered-hello-delay

Syntax

pim ipv6 triggered-hello-delay interval

undo pim ipv6 trigged-hello-delay

View

Interface view

Default level

2: System level

Parameters

interval: Maximum delay in seconds between hello messages, with an effective range of 1 to 60.

Description

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

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

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

Examples

# Set the maximum delay between hello messages to 3 seconds on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] pim ipv6 trigged-hello-delay 3

probe-interval (IPv6 PIM view)

Syntax

probe-interval interval

undo probe-interval

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: Register probe time in seconds, with an effective range of 1 to 1799.

Description

Use the probe-interval command to configure the register probe time.

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

By default, the register probe time is 5 seconds.

Related commands: register-suppression-timeout.

Examples

# Set the register probe time to 6 seconds.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] probe-interval 6

prune delay (IPv6 PIM view)

Syntax

prune delay interval

undo prune delay

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: Prune delay time in the range 1 to 128 seconds.

Description

Use the prune delay command to configure the prune delay time, namely the length of time the device waits between receiving a prune message and taking a prune action.

Use the undo prune delay command to restore the default.

The prune delay time equals the prune pending time, 3 seconds by default.

Examples

# Set the prune delay time to 75 seconds on the public network.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] prune delay 75

register-policy (IPv6 PIM view)

Syntax

register-policy acl6-number

undo register-policy

View

IPv6 PIM view

Default level

2: System level

Parameters

acl6-number: Advanced IPv6 ACL number, in the range of 3000 to 3999. Only register messages that match the permit statement of the IPv6 ACL can be accepted by the RP.

Description

Use the register-policy command to configure an IPv6 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.

Related commands: register-suppression-timeout.

Examples

# Configure a register filtering policy on the RP so that the RP accepts only those register messages for multicast traffic from IPv6 multicast sources on the subnet 3:1::/64 to the IPv6 multicast groups on the subnet FF0E:13::/64.

<Sysname> system-view

[Sysname] acl ipv6 number 3000

[Sysname-acl6-adv-3000] rule permit ipv6 source 3:1:: 64 destination ff0e:13:: 64

[Sysname-acl6-adv-3000] quit

[Sysname] pim ipv6

[Sysname-pim6] register-policy 3000

register-suppression-timeout (IPv6 PIM view)

Syntax

register-suppression-timeout interval

undo register-suppression-timeout

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: Register suppression time in seconds, in the range of 1 to 65535.

Description

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

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

By default, the register suppression time is 60 seconds.

Related commands: probe-interval and register-policy.

Examples

# Set the register suppression time to 70 seconds.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] register-suppression-timeout 70

register-whole-checksum (IPv6 PIM view)

Syntax

register-whole-checksum

undo register-whole-checksum

View

IPv6 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 message.

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

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

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

Examples

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

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] register-whole-checksum

reset pim ipv6 control-message counters

Syntax

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

View

User view

Default level

1: Monitor level

Parameters

interface-type interface-number: Specifies to reset the IPv6 PIM control message counter on a particular interface. If no interface is specified, this command clears statistics for IPv6 PIM control messages on all interfaces.

Description

Use the reset pim ipv6 control-message counters command to clear statistics for IPv6 PIM control messages.

Examples

# Clear statistics for IPv6 PIM control messages on all interfaces.

<Sysname> reset pim ipv6 control-message counters

source-lifetime (IPv6 PIM view)

Syntax

source-lifetime interval

undo source-lifetime

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: IPv6 multicast source lifetime in seconds, with an effective range of 1 to 31,536,000.

Description

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

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

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

Examples

# Set the IPv6 multicast source lifetime to 200 seconds.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] source-lifetime 200

source-policy (IPv6 PIM view)

Syntax

source-policy acl6-number

undo source-policy

View

IPv6 PIM view

Default level

2: System level

Parameters

acl6-number: Basic or advanced IPv6 ACL number, in the range of 2000 to 3999.

Description

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

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

By default, no IPv6 multicast data filter is configured.

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

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

If this command is executed repeatedly, the last configuration takes effect.

Examples

# Configure the router to accept IPv6 multicast packets originated from 3121::1 and discard IPv6 multicast packets originated from 3121::2.

<Sysname> system-view

[Sysname] acl ipv6 number 2000

[Sysname-acl6-basic-2000] rule permit source 3121::1 128

[Sysname-acl6-basic-2000] rule deny source 3121::2 128

[Sysname-acl6-basic-2000] quit

[Sysname] pim ipv6

[Sysname-pim6] source-policy 2000

[Sysname-pim6] quit

spt-switch-threshold (IPv6 PIM view)

Syntax

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

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

View

IPv6 PIM view

Default level

2: System level

Parameters

infinity: Disables SPT switchover.

group-policy acl6-number: Specifies a basic IPv6 ACL number, in the range of 2000 to 2999. If you do not include this option in your command, the configuration will apply on all IPv6 multicast groups.

order order-value: Specifies the order of the IPv6 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 IPv6 ACL in the group-policy list. If you have assigned an order-value to a certain IPv6 ACL, do not specify the same order-value for another IPv6 ACL; otherwise the system will give error information. If you do not specify an order-value, the order value of the IPv6 ACL will remain the same in the group-policy list.

Description

Use the spt-switch-threshold command to configure the SPT switchover parameters.

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

By default, the device switches to the SPT immediately after it receives the first IPv6 multicast packet.

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

To use an IPv6 ACL that does not exist in the group-policy list, you can use the acl6-number argument to specify an IPv6 ACL and set its order-value. This will insert the IPv6 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.

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

Once an IPv6 multicast forwarding entry is created on the source-side DR, it stops forwarding subsequent IPv6 multicast packets in register messages even if a register outgoing interface is available. Therefore, to avoid forwarding failure, do not include the infinity keyword in this command on a static RP or a C-RP.

Examples

# Disable SPT switchover on a device that will never become an RP.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] spt-switch-threshold infinity

ssm-policy (IPv6 PIM view)

Syntax

ssm-policy acl6-number

undo ssm-policy

View

IPv6 PIM view

Default level

2: System level

Parameters

acl6-number: Basic IPv6 ACL number, in the range of 2000 to 2999.

Description

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

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

By default, the IPv6 SSM group range is FF3x::/32. Here x refers to any legal scope.

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

Examples

# Configure the IPv6 SSM group range to be FF3E:0:8192::/96.

<Sysname> system-view

[Sysname] acl ipv6 number 2000

[Sysname-acl6-basic-2000] rule permit source ff3e:0:8192:: 96

[Sysname-acl6-basic-2000] quit

[Sysname] pim ipv6

[Sysname-pim6] ssm-policy 2000

state-refresh-hoplimit

Syntax

state-refresh-hoplimit hoplimit-value

undo state-refresh-hoplimit

View

IPv6 PIM view

Default level

2: System level

Parameters

hoplimit-value: Hop limit value of state refresh messages, in the range of 1 to 255.

Description

Use the state-refresh-hoplimit command to configure the hop limit value of state refresh messages.

Use the undo state-refresh-hoplimit command to restore the default.

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

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

Examples

# Set the hop limit value of state refresh messages to 45.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] state-refresh-hoplimit 45

state-refresh-interval (IPv6 PIM view)

Syntax

state-refresh-interval interval

undo state-refresh-interval

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: State refresh interval in seconds, with an effective range of 1 to 255.

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.

By default, the state refresh interval is 60 seconds.

Related commands: pim ipv6 state-refresh-capable, state-refresh-hoplimit, and state-refresh-rate-limit.

Examples

# Set the state refresh interval to 70 seconds.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] state-refresh-interval 70

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

Syntax

state-refresh-rate-limit interval

undo state-refresh-rate-limit

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: Time to wait before receiving a new refresh message, in seconds and with an effective range of 1 to 65535.

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.

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

Related commands: pim ipv6 state-refresh-capable, state-refresh-hoplimit, and state-refresh-interval.

Examples

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

<Sysname> system-view

[Sysname] pim ipv6

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

static-rp (IPv6 PIM view)

Syntax

static-rp ipv6-rp-address [ acl6-number ] [ preferred ]

undo static-rp ipv6-rp-address

View

IPv6 PIM view

Default level

2: System level

Parameters

ipv6-rp-address: IPv6 address of the static RP to be configured. This address must be a real, legal, globally scoped IPv6 unicast address. For a static RP serving IPv6 BIDIR-PIM, you can specify a virtual IPv6 address.

acl6-number: Basic IPv6 ACL number, in the range of 2000 to 2999. If you provide this argument, the configured static RP will serve only those IPv6 multicast groups that pass the filtering; otherwise, the configured static RP will serve the all IPv6 multicast groups.

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.

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

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

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

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

Related commands: display pim ipv6 rp-info.

Examples

# Configure the interface with an IPv6 address of 2001::2 as a static RP.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] static-rp 2001::2

timer hello (IPv6 PIM view)

Syntax

timer hello interval

undo timer hello

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: Hello interval in seconds, with an effective range of 1 to 2,147,483,647.

Description

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

Use the undo timer hello command to restore the default.

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

Related commands: pim ipv6 timer hello.

Examples

# Set the global hello interval to 40 seconds.

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] timer hello 40

timer join-prune (IPv6 PIM view)

Syntax

timer join-prune interval

undo timer join-prune

View

IPv6 PIM view

Default level

2: System level

Parameters

interval: Join/prune interval in seconds, with an effective range of 1 to 2,147,483,647.

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.

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

Related commands: pim ipv6 timer join-prune.

Examples

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

<Sysname> system-view

[Sysname] pim ipv6

[Sysname-pim6] timer join-prune 80