- Table of Contents
-
- 08-IP Multicast Command Reference
- 00-Preface
- 01-IGMP Snooping Commands
- 02-PIM Snooping Commands
- 03-Multicast VLAN Commands
- 04-Multicast Routing and Forwarding Commands
- 05-IGMP Commands
- 06-PIM Commands
- 07-MSDP Commands
- 08-MBGP Commands
- 09-Multicast VPN Commands
- 10-MLD Snooping Commands
- 11-IPv6 PIM Snooping Commands
- 12-IPv6 Multicast VLAN Commands
- 13-IPv6 Multicast Routing and Forwarding Commands
- 14-MLD Commands
- 15-IPv6 PIM Commands
- 16-IPv6 MBGP Commands
- Related Documents
-
Title | Size | Download |
---|---|---|
15-IPv6 PIM Commands | 304.08 KB |
Contents
IPv6 PIM configuration commands
bsm-fragment enable (IPv6 PIM view)
c-bsr admin-scope (IPv6 PIM view)
c-bsr hash-length (IPv6 PIM view)
c-bsr holdtime (IPv6 PIM view)
c-bsr interval (IPv6 PIM view)
c-bsr priority (IPv6 PIM view)
c-rp advertisement-interval (IPv6 PIM view)
display pim ipv6 claimed-route
display pim ipv6 control-message counters
display pim ipv6 routing-table
hello-option dr-priority (IPv6 PIM view)
hello-option holdtime (IPv6 PIM view)
hello-option lan-delay (IPv6 PIM view)
hello-option neighbor-tracking (IPv6 PIM view)
hello-option override-interval (IPv6 PIM view)
holdtime assert (IPv6 PIM view)
holdtime join-prune (IPv6 PIM view)
pim ipv6 hello-option dr-priority
pim ipv6 hello-option holdtime
pim ipv6 hello-option lan-delay
pim ipv6 hello-option neighbor-tracking
pim ipv6 hello-option override-interval
pim ipv6 state-refresh-capable
pim ipv6 triggered-hello-delay
probe-interval (IPv6 PIM view)
register-policy (IPv6 PIM view)
register-suppression-timeout (IPv6 PIM view)
register-whole-checksum (IPv6 PIM view)
reset pim ipv6 control-message counters
source-lifetime (IPv6 PIM view)
spt-switch-threshold (IPv6 PIM view)
state-refresh-interval (IPv6 PIM view)
state-refresh-rate-limit (IPv6 PIM view)
timer join-prune (IPv6 PIM view)
The term "router" in this document refers to both routers and Layer 3 switches.
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 bsm-fragment enable to enable bootstrap message (BSM) semantic fragmentation.
Use undo bsm-fragment enable 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: Specifies a basic IPv6 ACL number in the range of 2000 to 2999. When an ACL is defined, the source keyword in the rule command specifies a legal BSR source IPv6 address range.
Description
Use bsr-policy to configure a legal BSR address range to guard against BSR spoofing.
Use undo bsr-policy to remove the restriction of the BSR address range.
By default, no restrictions are defined for the BSR address range. The BSR messages from any source are regarded to be eligible.
Examples
# Configure a legal BSR address range so that only devices 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: Specifies an IPv6 address of the interface that will act as a C-BSR.
hash-length: Specifies a hash mask length in the range of 0 to 128. If this argument is not specified, the corresponding global setting is used.
priority: Specifies the priority of the C-BSR, in the range of 0 to 255. A larger value represents a higher priority. If this argument is not specified, the corresponding global setting is used.
Description
Use c-bsr to configure the specified interface a C-BSR.
Use undo c-bsr 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 c-bsr admin-scope to enable IPv6 administrative scoping.
Use undo c-bsr admin-scope 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: Specifies a hash mask length in the range of 0 to 128.
Description
Use c-bsr hash-length to configure the global hash mask length.
Use undo c-bsr hash-length 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: Specifies a BS timeout value in seconds, in the range of 1 to 2147483647.
Description
Use c-bsr holdtime to configure the BS timeout (length of time that the C-BSRs wait for a bootstrap message from the BSR).
Use undo c-bsr holdtime to restore the default.
By default, the BS timeout value is determined by this formula: BS timeout = BS period × 2 + 10.
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: Specifies a BS period in seconds, in the range of 10 to 2147483647.
Description
Use c-bsr interval to configure the BS period (interval at which the BSR sends bootstrap messages).
Use undo c-bsr interval to restore the default.
By default, the BS period value is determined by this formula: BS period = (BS timeout – 10) / 2.
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: Specifies the priority of the C-BSR, in the range of 0 to 255. A larger value represents a higher priority.
Description
Use c-bsr priority to configure the global C-BSR priority.
Use undo c-bsr priority 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 this argument is not specified, the corresponding global setting is used.
priority: Specifies the 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 represents a higher priority. If this argument is not specified, the corresponding global setting is used.
Description
Use c-bsr scope to configure the C-BSR in the IPv6 admin-scope zone.
Use undo c-bsr scope to remove the C-BSR configuration.
Related commands: c-bsr admin-scope, c-bsr hash-length, and c-bsr priority.
Examples
# Configure local device as 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: Specifies the IPv6 address of the interface that will act as a C-RP.
acl6-number: Specifies a basic IPv6 ACL number in the range of 2000 to 2999. This ACL defines a range of IPv6 multicast groups to which the C-RP is designated, rather than defining a filtering rule. Any IPv6 multicast group range that matches the permit statement in the ACL will be advertised as a group range to which the C-RP is designated, but the configuration 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: Specifies the priority of the C-RP, in the range of 0 to 255. The default is 192. A larger value represents a lower priority.
hold-interval: Specifies a C-RP timeout time in seconds, in the range of 1 to 65535. If this argument is not specified, the corresponding global setting is used.
adv-interval: Specifies a C-RP-Adv interval in seconds, in the range of 1 to 65535. If this argument is not specified, the corresponding global setting is used.
bidir: Specifies the bidirectional PIM mode. If this argument is not specified, the IPv6 PIM mode is IPv6 PIM-SM. This keyword is not supported.
Description
Use c-rp to configure the specified interface as a C-RP.
Use undo c-rp 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 the IPv6 multicast group range for the C-RP is not specified, the C-RP provides services for all IPv6 multicast groups in the IPv6 non-scoped zone, or it provides services for IPv6 multicast groups in the IPv6 global admin-scope zone if IPv6 administrative scoping is configured.
If you want a device to be a C-RP for multiple group ranges, you need to include these group ranges in multiple rules in the ACL corresponding to the group-policy keyword.
If you execute this command multiple times on the same interface, the most recent 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: Specifies a C-RP-Adv interval in seconds, in the range of 1 to 65535.
Description
Use c-rp advertisement-interval to configure the interval at which C-RP-Adv messages are sent.
Use undo c-rp advertisement-interval 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: Specifies a C-RP timeout in seconds, in the range of 1 to 65535.
Description
Use c-rp holdtime to configure the global C-RP timeout time (length of time that the BSR waits for a C-RP-Adv message from C-RPs).
Use undo c-rp holdtime 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 bootstrap messages, to prevent loss of C-RP information in bootstrap messages, make sure that the C-RP timeout time is not smaller than the interval at which the BSR sends bootstrap messages. H3C recommends that you set the C-RP timeout to 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: Specifies an advanced IPv6 ACL number in the range of 3000 to 3999. When the 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 to which the C-RP is designated.
Description
Use crp-policy to configure a legal C-RP address range and the IPv6 multicast group ranges to which the C-RP is designated. This command guards against C-RP spoofing.
Use undo crp-policy to remove the restrictions in C-RP address ranges and the IPv6 multicast group ranges to which the C-RP is designated.
By default, no restrictions are defined for C-RP address ranges and the IPv6 multicast group range to which the C-RP is designated. All received C-RP messages are regarded 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 and 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 policy so that only devices in the IPv6 address range of 2001::2/64 can be C-RPs that provide services for IPv6 multicast groups in the address range of FF03::101/64.
<Sysname> system-view
[Sysname] acl ipv6 number 3000
[Sysname-acl6-adv-3000] rule permit ipv6 source 2001::2 64 destination ff03::101 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 display pim ipv6 bsr-info 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: 64
HoldTime: 130
Advertisement Interval: 60
Next advertisement scheduled at: 00:00:48
Candidate RP: 2002::1(Vlan-interface100)
Priority: 200
HoldTime: 90
Advertisement Interval: 50
Next advertisement scheduled at: 00:00:28
Candidate RP: 2003::1(Vlan-interface200)
Priority: 192
HoldTime: 80
Advertisement Interval: 60
Next advertisement scheduled at: 00:00:48
Table 1 Command output
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 |
Scope 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 this argument is not specified, this command will display the 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 display pim ipv6 claimed-route 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: Vlan-interface100, 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 Command output
Field |
Description |
RPF information about: 2001::2 |
Information of the RPF route to 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 display pim ipv6 control-message counters 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: Vlan-interface100
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 Command output
Field |
Description |
PIM global control-message counters |
Statistics of IPv6 PIM global control messages. |
PIM control-message counters for interface |
Interface for which 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 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 display pim ipv6 grafts to display information about unacknowledged IPv6 PIM-DM graft messages.
Examples
# Display information about unacknowledged IPv6 PIM-DM graft messages.
<Sysname> display pim ipv6 grafts
Source Group Age RetransmitIn
1004::2 ff03::101 00:00:24 00:00:02
Table 4 Command output
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 display pim ipv6 interface to display the IPv6 PIM information on the specified interface or all interfaces.
Examples
# Display detailed IPv6 PIM information on VLAN-interface 100.
<Sysname> display pim ipv6 interface Vlan-interface 100 verbose
Interface: Vlan-interface100, 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 5 Command output
Field |
Description |
Interface |
Interface name and its IPv6 address. |
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 |
Whether the function of dropping Hello messages without Generation_ID is enabled. |
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.
· sm: Specifies IPv6 PIM-SM.
· ssm: Specifies IPv6 PIM-SSM.
flags flag-value: Displays IPv6 PIM routing entries containing the specified flag or flags.
· 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 detailed information about 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 display pim ipv6 join-prune to display information about the join/prune messages to send.
Examples
# Display information about 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 (Vlan-interface100)
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 6 Command output
Field |
Description |
Expiry Time: |
Expiration 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 IPv6 PIM neighbor information on a particular interface.
ipv6-neighbor-address: Displays the information of a particular IPv6 PIM neighbor.
verbose: Displays 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 display pim ipv6 neighbor 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
FE80::A01:101:1 Vlan100 02:50:49 00:01:31 1
FE80::A01:102:1 Vlan200 02:49:39 00:01:42 1
# Display detailed information about the IPv6 PIM neighbor whose IPv6 address is FE80::A01:101:1.
<Sysname> display pim ipv6 neighbor fe80::a01:101:1 verbose
Neighbor: FE80::2E0:FCFF:FE00:3F00
Interface: Vlan-interface10
Uptime: 00:00:06
Expiry time: 00:01:40
DR Priority: 1
Generation ID: 0x0A59D8F9
Holdtime: 105 s
LAN delay: 500 ms
Override interval: 2500 ms
State refresh interval: 60 s
Neighbor tracking: Disabled
Neighbor Secondary Address(es):
10::1
Table 7 Command output
Field |
Description |
Total Number of Neighbors |
Total number of IPv6 PIM neighbors. |
Neighbor |
Primary 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. If the IPv6 PIM neighbor is always up and reachable, this field displays never. |
Dr-Priority/DR Priority |
Priority of the IPv6 PIM neighbor. |
Generation ID |
Generation ID of the IPv6 PIM neighbor. (A random value indicating status change of the IPv6 PIM neighbor.) |
Holdtime |
Holdtime of the IPv6 PIM neighbor. If the IPv6 PIM neighbor is always up and reachable, this field displays forever. |
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 operates in IPv6 PIM_DM mode and state refresh capability is enabled. |
Neighbor tracking |
Neighbor tracking 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: Specifies an IPv6 multicast group address in the range of FFxy::/16, where x and y represent any hexadecimal number from 0 to F.
ipv6-source-address: Specifies an IPv6 multicast source address.
prefix-length: Specifies the address prefix length. The default is 128. For an IPv6 multicast group address, the value range for this argument is 8 to 128. For an IPv6 multicast source address, the value range for this argument is 0 to 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.
· 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 or flags. The values for the flag-value argument and their meanings are as follows:
· act: Specifies IPv6 multicast routing entries that have been used for routing data.
· 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 provided by other IPv6 multicast routing protocols.
· loc: Specifies IPv6 multicast routing entries on that devices that directly connect to the same subnet as 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 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 display pim ipv6 routing-table 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/0/1
Upstream neighbor: NULL
RPF prime neighbor: NULL
Downstream interface(s) information:
Total number of downstreams: 1
1: GigabitEthernet3/0/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/0/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/0/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 8 Command output
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) |
(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—The entry has been used for routing data. · DEL—That the entry will be removed. · EXPRUNE—Some outgoing interfaces are pruned by other IPv6 multicast routing protocols. · EXT—The entry contains outgoing interfaces provided by other IPv6 multicast routing protocols. · LOC—The entry is on a device directly connected to the same subnet with the IPv6 multicast source. · NIIF—The entry contains unknown incoming interfaces. · NONBR—That the entry has an IPv6 PIM neighbor searching failure. · RPT—The entry is on a RPT branch where (S, G) prunes have been sent to the RP. · SPT—The entry is on the SPT. · SWT—The entry is in the process of RPT-to-SPT switchover. · WC—Wildcard routing entry. |
Uptime |
Length of time since the (S, G) or (*, G) entry was installed. |
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: · For a (*, G) entry, if this router is the RP, the RPF neighbor of this (*, G) entry is NULL. · For an (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 interfaces: · Number of downstream interfaces. · Downstream interface name. · Protocol type configured on the downstream interface. · Uptime of the downstream interfaces. · Expiration time of the downstream interfaces. |
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 address in the range of FFxy::/16 (excluding FFx0::/16, FFx1::/16, FFx2::/16 and FF0y::), where x and y represent any hexadecimal number from 0 to F. If no group address is specified, this command displays the RP information corresponding to 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 display pim ipv6 rp-info 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 9 Command output
Field |
Description |
prefix/prefix length |
IPv6 multicast group to which the RP is designated. |
[B] |
The RP provides services for multicast groups in the IPv6 bidirectional PIM mode. Without this field displayed, the RP provides services for 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: Specifies a basic IPv6 ACL number in the range of 2000 to 2999.
Description
Use embedded-rp to enable embedded RP.
Use undo embedded-rp 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.
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 "Multicast overview."
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 the acl6-number argument is specified, 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 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 the acl6-number argument is specified, this command will restore the 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: Specifies the router priority for DR election, in the range of 0 to 4294967295. A larger value represents a higher priority.
Description
Use hello-option dr-priority to configure the global value of the router priority for DR election.
Use undo hello-option dr-priority 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: Specifies an IPv6 PIM neighbor timeout time in seconds, in the range of 1 to 65535. 65535 makes the IPv6 PIM neighbor always reachable.
Description
Use hello-option holdtime to configure the IPv6 PIM neighbor timeout time.
Use undo hello-option holdtime 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: Specifies a LAN-delay time in milliseconds, in the range of 1 to 32767.
Description
Use hello-option lan-delay to configure the global value of the LAN-delay time (period of time that the device waits before forwarding a received prune message).
Use undo hello-option lan-delay 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 hello-option neighbor-tracking to globally disable join suppression and enable neighbor tracking.
Use undo hello-option neighbor-tracking to enable join suppression.
By default, join suppression is enabled and 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: Specifies a prune override interval in milliseconds, in the range of 1 to 65535.
Description
Use hello-option override-interval to configure the global value of the prune override interval.
Use undo hello-option override-interval to restore the default.
By default, the prune override interval is 2500 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 2000 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: Specifies an assert timeout time in seconds, in the range of 7 to 2147483647.
Description
Use holdtime assert to configure the global value of the assert timeout time.
Use undo holdtime assert 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: Specifies a join/prune timeout time in seconds, in the range of 1 to 65535.
Description
Use holdtime join-prune to configure the global value of the join/prune timeout time.
Use undo holdtime join-prune 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: Specifies the maximum size of join/prune messages, in the range of 100 to 64000 bytes.
Description
Use jp-pkt-size to configure the maximum size of join/prune messages.
Use undo jp-pkt-size to restore the default.
By default, the maximum size of join/prune messages is 8100 bytes.
Related commands: jp-queue-size.
Examples
# Set the maximum size of join/prune messages to 1500 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: Specifies the maximum number of (S, G) entries in a join/prune message, in the range of 1 to 4096.
Description
Use jp-queue-size to configure the maximum number of (S, G) entries in a join/prune message.
Use undo jp-queue-size to restore the default.
By default, a join/prune messages contains a maximum of 1020 (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 might 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 might 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 ipv6 holdtime join-prune.
Examples
# Configure a join/prune messages to contain a maximum of 2000 (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 pim ipv6 to enter IPv6 PIM view.
Use undo pim ipv6 to remove all configurations 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 pim ipv6 bfd enable to enable BFD for IPv6 PIM.
Use undo pim ipv6 bfd enable 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 does not take effect.
Related commands: pim ipv6 dm and pim ipv6 sm.
Examples
# Enable IPv6 multicast routing on the public network, enable IPv6 PIM-SM on interface VLAN-interface 100, and enable BFD for IPv6 PIM on the interface.
<Sysname> system-view
[Sysname] multicast ipv6 routing-enable
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 sm
[Sysname-Vlan-interface100] 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 pim ipv6 bsr-boundary to configure an IPv6 PIM domain border (a bootstrap message boundary).
Use undo pim ipv6 bsr-boundary to remove the configured IPv6 PIM domain border.
By default, no PIM domain border is configured.
Related commands: c-bsr and multicast ipv6 boundary.
Examples
# Configure VLAN-interface 100 as a PIM domain border.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] 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 pim ipv6 dm to enable IPv6 PIM-DM.
Use undo pim ipv6 dm 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 VLAN-interface 100.
<Sysname> system-view
[Sysname] multicast ipv6 routing-enable
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] 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: Specifies the router priority for DR election, in the range of 0 to 4294967295. A larger value represents a higher priority.
Description
Use pim ipv6 hello-option dr-priority to configure the router priority for DR election on the current interface.
Use undo pim ipv6 hello-option dr-priority 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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] 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: Specifies an IPv6 PIM neighbor timeout time in seconds, in the range of 1 to 65535. 65535 makes the PIM neighbor always reachable.
Description
Use pim ipv6 hello-option holdtime to configure the PIM neighbor timeout time on the current interface.
Use undo pim ipv6 hello-option holdtime 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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] 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: Specifies a LAN-delay time in milliseconds, in the range of 1 to 32767.
Description
Use pim ipv6 hello-option lan-delay to configure the LAN-delay time (time that the device waits before forwarding a received prune message) on the current interface.
Use undo pim ipv6 hello-option lan-delay 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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] 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 pim ipv6 hello-option neighbor-tracking to disable join suppression and enable neighbor tracking on the current interface.
Use undo pim ipv6 hello-option neighbor-tracking to enable join suppression.
By default, join suppression is enabled and neighbor tracking is disabled.
Related commands: hello-option neighbor-tracking.
Examples
# Disable join suppression on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] 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: Specifies a prune override interval in milliseconds, in the range of 1 to 65535.
Description
Use pim ipv6 hello-option override-interval to configure the prune override interval on the current interface.
Use undo pim ipv6 hello-option override-interval to restore the default.
By default, the prune override interval is 2500 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 2000 milliseconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] 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: Specifies an assert timeout time in seconds, in the range of 7 to 2147483647.
Description
Use pim ipv6 holdtime assert to configure the assert timeout time on the current interface.
Use undo pim ipv6 holdtime assert 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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] 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: Specifies a join/prune timeout time in seconds, in the range of 1 to 65535.
Description
Use pim ipv6 holdtime join-prune to configure the join/prune timeout time on the interface.
Use undo pim ipv6 holdtime join-prune 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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] 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: Specifies a basic IPv6 ACL number in the range of 2000 to 2999. When the ACL is defined, the source keyword in the rule command specifies a legal source address range for hello messages.
Description
Use pim ipv6 neighbor-policy to configure a legal source address range for hello messages to guard against hello message spoofing.
Use undo pim ipv6 neighbor-policy to restore the default.
By default, no source address range for hello messages is configured. All the received hello messages are considered legal.
Examples
# Configure a legal source address range for hello messages on VLAN-interface 100 so that only the devices on the FE80:101::101/64 subnet can become PIM neighbors of this switch.
<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 vlan-interface 100
[Sysname-Vlan-interface100] 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 pim ipv6 require-genid to enable rejection of hello messages without Generation_ID.
Use undo pim ipv6 require-genid to restore the default.
By default, hello messages without Generation_ID are accepted.
Examples
# Enable VLAN-interface 100 to reject hello messages without Generation_ID.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] 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 pim ipv6 sm to enable IPv6 PIM-SM.
Use undo pim ipv6 sm 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 VLAN-interface 100.
<Sysname> system-view
[Sysname] multicast ipv6 routing-enable
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] 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 pim ipv6 state-refresh-capable to enable the state fresh feature on the interface.
Use undo pim ipv6 state-refresh-capable 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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] 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: Specifies a graft retry period in seconds, in the range of 1 to 65535.
Description
Use pim ipv6 timer graft-retry to configure the graft retry period.
Use undo pim ipv6 timer graft-retry to restore the default.
By default, the graft retry period is 3 seconds.
Examples
# Set the graft retry period to 80 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] 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: Specifies a hello interval in seconds, in the range of 1 to 2147483647.
Description
Use pim ipv6 timer hello to configure on the current interface the interval at which hello messages are sent.
Use undo pim ipv6 timer hello 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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] 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: Specifies a join/prune interval in seconds, in the range of 1 to 2147483647.
Description
Use pim ipv6 timer join-prune to configure on the current interface the interval at which join/prune messages are sent.
Use undo pim ipv6 timer join-prune 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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 timer join-prune 80
pim ipv6 triggered-hello-delay
Syntax
pim ipv6 triggered-hello-delay interval
undo pim ipv6 triggered-hello-delay
View
Interface view
Default level
2: System level
Parameters
interval: Specifies the maximum delay in seconds between hello messages, in the range of 1 to 60.
Description
Use pim ipv6 triggered-hello-delay to configure the maximum delay between hello messages.
Use undo pim ipv6 triggered-hello-delay 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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 triggered-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: Specifies a register probe time in seconds, in the range of 1 to 1799.
Description
Use probe-interval to configure the register probe time.
Use undo probe-interval 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: Specifies a prune delay time in the range of 1 to 128 seconds.
Description
Use prune delay to configure the prune delay time (length of time that the device waits between receiving a prune message and taking a prune action).
Use undo prune delay to restore the default.
By default, the prune delay time is 3 seconds, which equals the prune pending time.
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: Specifies an advanced IPv6 ACL number in the range of 3000 to 3999. Only register messages that match the permit statement of the ACL can be accepted by the RP.
Description
Use register-policy to configure an ACL rule to filter register messages.
Use undo register-policy 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 will accept only those register messages from IPv6 multicast sources on the 3:1::/64 subnet for IPv6 multicast groups on the FF0E:13::/64 subnet.
<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: Specifies a register suppression time in seconds, in the range of 1 to 65535.
Description
Use register-suppression-timeout to configure the register suppression time.
Use undo register-suppression-timeout 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 register-whole-checksum to configure the router to calculate the checksum based on the entire register message.
Use undo register-whole-checksum 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 resets IPv6 PIM control message counters on all interfaces.
Description
Use reset pim ipv6 control-message counters to reset IPv6 PIM control message counters.
Examples
# Reset IPv6 PIM control message counters 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: Specifies an IPv6 multicast source lifetime in seconds, in the range of 1 to 31536000.
Description
Use source-lifetime to configure the IPv6 multicast source lifetime.
Use undo source-lifetime 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: Specifies a basic or advanced IPv6 ACL number in the range of 2000 to 3999.
Description
Use source-policy to configure an IPv6 multicast data filter.
Use undo source-policy 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 you execute this command multiple times, the most recent 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 [ infinity ] [ 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 this option is not specified, the configuration will apply on all IPv6 multicast groups.
order order-value: Specifies the order of the ACL in the group-policy list. The value range for the order-value argument is 1 to the largest order value in the existing group-policy list plus 1, but it 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 the argument is not specified, the order value of the ACL will remain the same in the group-policy list.
Description
Use spt-switch-threshold to configure the SPT switchover parameters.
Use undo spt-switch-threshold to restore the default.
By default, the device switches to the SPT immediately after it receives the first IPv6 multicast packet.
|
CAUTION: If the switch is an RP, disabling switchover to SPT might cause multicast traffic forwarding failures on the source-side DR. When disabling switchover to SPT, be sure you fully understand its impact on your network. |
To adjust the order of an ACL that already exists in the group-policy list, you can use the acl6-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.
To use an ACL that does not exist in the group-policy list, you can use the acl6-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.
If you use this command multiple times on the same IPv6 multicast group, the first traffic rate configuration matched in sequence will take effect.
Examples
# Disable SPT switchover on a switch 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: Specifies a basic IPv6 ACL number in the range of 2000 to 2999.
Description
Use ssm-policy to configure the IPv6 SSM group range.
Use undo ssm-policy 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: Specifies the hop limit value of state refresh messages, in the range of 1 to 255.
Description
Use state-refresh-hoplimit to configure the hop limit value of state refresh messages.
Use undo state-refresh-hoplimit 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: Specifies a state refresh interval in seconds, in the range of 1 to 255.
Description
Use state-refresh-interval to configure the interval between state refresh messages.
Use undo state-refresh-interval 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: Specifies a time to wait before receiving a new refresh message, in the range of 1 to 65535 seconds.
Description
Use state-refresh-rate-limit to configure the time the router must wait before receiving a new state refresh message.
Use undo state-refresh-rate-limit 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: Specifies the IPv6 address of the static RP to be configured. This address must be a real, valid, globally scoped IPv6 unicast address. For a static RP that provides services for IPv6 BIDIR-PIM, you can specify a virtual IPv6 address.
acl6-number: Specifies a basic IPv6 ACL number in the range of 2000 to 2999. If this argument is specified, the configured static RP provides services for only those IPv6 multicast groups that pass the filtering. Otherwise, the configured static RP provides services for the all IPv6 multicast groups.
preferred: Specifies to give priority to the static RP if the static RP conflicts with the dynamic RP. If the preferred keyword is not specified, the dynamic RP will be given priority, and the static RP takes effect only if no dynamic RP exists in the network or when the dynamic RP fails.
Description
Use static-rp to configure a static RP.
Use undo static-rp 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 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 multiple times. However, if you execute this command multiple times and specify the same static RP address or reference the same ACL rule, the most recent configuration takes effect. If multiple static RPs have been configured for the same IPv6 multicast group, the one with the highest IPv6 address will be chosen to provide services for 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 to provide services for the IPv6 multicast groups in the address range of FF03::101/64 defined in basic IPv6 ACL 2001, and give priority to this static RP in the case of static/dynamic RP conflict.
<Sysname> system-view
[Sysname] acl ipv6 number 2001
[Sysname-acl6-basic-2001] rule permit source ff03::101 64
[Sysname-acl6-basic-2001] quit
[Sysname] pim ipv6
[Sysname-pim6] static-rp 2001::2 2001 preferred
timer hello (IPv6 PIM view)
Syntax
timer hello interval
undo timer hello
View
IPv6 PIM view
Default level
2: System level
Parameters
interval: Specifies a hello interval in seconds, in the range of 1 to 2147483647.
Description
Use timer hello to configure the hello interval globally.
Use undo timer hello 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: Specifies a join/prune interval in seconds, in the range of 1 to 2147483647.
Description
Use timer join-prune to configure the join/prune interval globally.
Use undo timer join-prune 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