Table of Contents

Chapter 1 IPv6 Multicast Routing and Forwarding Configuration Commands. 1-1

1.1 IPv6 Multicast Routing and Forwarding Configuration Commands. 1-1

1.1.1 debugging mfib ipv6. 1-1

1.1.2 debugging mrm ipv6. 1-4

1.1.3 display multicast ipv6 boundary. 1-6

1.1.4 display multicast ipv6 forwarding-table. 1-7

1.1.5 display multicast ipv6 routing-table. 1-10

1.1.6 display multicast ipv6 rpf-info. 1-11

1.1.7 multicast ipv6 boundary. 1-12

1.1.8 multicast ipv6 forwarding-table downstream-limit 1-13

1.1.9 multicast ipv6 forwarding-table route-limit 1-14

1.1.10 multicast ipv6 load-splitting. 1-15

1.1.11 multicast ipv6 routing-enable. 1-16

1.1.12 reset multicast ipv6 forwarding-table. 1-16

1.1.13 reset multicast IPv6 routing-table. 1-17

 

Chapter 1  IPv6 Multicast Routing and Forwarding Configuration Commands

 

 

1.1  IPv6 Multicast Routing and Forwarding Configuration Commands

1.1.1  debugging mfib ipv6

Syntax

debugging mfib ipv6 { all | { driver | no-cache | packet | register | route | sync | upcall | wrong-iif } [ advanced-acl6-number ] } [ slot slot-id ]

undo debugging mfib ipv6 { all | { driver | no-cache | packet | register | route | sync | upcall | wrong-iif } [ advanced-acl6-number ] } [ slot slot-id ]

View

User view

Default Level

1: Monitor level

Parameters

all: Turns on/off all types of IPv6 MFIB debugging.

driver: Turns on/off IPv6 MFIB interface driver debugging.

no-cache: Turns on/off IPv6 MFIB unmatched packet debugging.

packet: Turns on/off IPv6 MFIB packet debugging.

register: Turns on/off IPv6 MFIB register message debugging.

route: Turns on/off IPv6 MFIB route debugging.

sync: Turns on/off IPv6 MFIB synchronization message debugging.

upcall: Turns on/off debugging for packets that IPv6 MFIB reports to IPv6 MRM.

wrong-iif: Turns on/off IPv6 MFIB debugging for incoming interface errors. Currently, S9500 series routing switches do not support this function.

advanced-acl6-number: Advanced IPv6 ACL number.

slot slot-id: Specifies the number of the slot where the interface card resides.

Description

Use the debugging mfib ipv6 command to turn on IPv6 MFIB debugging.

Use the undo debugging mfib ipv6 command to turn off IPv6 MFIB debugging.

By default, IPv6 MFIB debugging is off.

Table 1-1 debugging mfib ipv6 packet command output description

Field	Description
Receive packet	Received IPv6 packets
Drop packet	Dropped IPv6 packets
(sadd, gadd)	(S, G) entry
The TTL	TTL value of the IPv6 packet
Forward multicast packet	Forwarded IPv6 packets

 

Table 1-2 debugging mfib ipv6 route command output description

Field	Description
receive Add entry message from MRM	An Add entry message is received from IPv6 MRM.
receive Del entry message from MRM	A Del entry message is received from IPv6 MRM.
receive Set IIF message from MRM	A Set IIF message is received from IPv6 MRM.
receive Del OIF message from MRM	A Del OIF message is received from IPv6 MRM.
receive Add OIF message from MRM	An Add OIF message is received from IPv6 MRM.
The Following OIFs are added	The following OIFs are added.
(sadd, gadd)	(S, G) entry

 

Table 1-3 debugging mfib ipv6 sync command output description

Field	Description
added to updated list	An entry is added into the update list.
deleted from updated list	An entry is deleted from the updated list.
Encoded the ADD message	The ADD message is encapsulated.
Encoded the DEL message	The DEL message is encapsulated.
Encoded the MOD message	The MOD message is encapsulated.
(sadd, gadd)	(S, G) entry

 

Table 1-4 debugging mfib ipv6 no-cache command output description

Field	Description
Receive no cache report	An unmatched IPv6 packet is received.
No MFIB entry matches	No matching entries
(sadd, gadd)	(S, G) entry
Cache the packet	IPv6 packets are cached.

 

Table 1-5 debugging mfib ipv6 register command output description

Field	Description
Send register	An IPv6 register message is sent.
(sadd, gadd)	(S, G) entry
Dropping received register packet	An error IPv6 register messages is dropped.

 

Table 1-6 debugging mfib ipv6 upcall command output description

Field	Description
Send No cache up call	The corresponding message is sent to IPv6 MRM.
(sadd, gadd)	(S, G) entry

 

Table 1-7 debugging mfib ipv6 driver command output description

Field	Description
call driver	The driver interface is called.
Do not add to driver	Not adding entries to driver
downloaded to driver Failed	Failed to deliver to driver
(sadd, gadd)	(S, G) entry

 

Examples

# Enable debugging for packets that IPv6 MFIB reports to IPv6 MRM.

<Sysname> debugging mfib ipv6 upcall

*Jan 24 17:24:22:842 2006 Sysname MFIB/7/MFIB UPCALL:

IPv6 Send No cache up call (40::2, FF1E::101:101) to MRM.(A14624)

// IPv6 MFIB reports an unmatched packet to IPv6 MRM.

1.1.2  debugging mrm ipv6

Syntax

debugging mrm ipv6 { all | event | packet [ advanced-acl6-number ] | route [ advanced-acl6-number ] }

undo debugging mrm ipv6 { all | event | packet | route }

View

User view

Default Level

2: System level

Parameters

all: Turns on/off all types of debugging for IPv6 multicast routing management (MRM).

event: Turns on/off IPv6 MRM event debugging.

packet: Turns on/off IPv6 MRM packet debugging.

route: Turns on/off IPv6 MRM route debugging.

advanced-acl6-number: Advanced IPv6 ACL number.

Description

Use the debugging mrm ipv6 command to turn on IPv6 MRM debugging.

Use the undo debugging mrm ipv6 command to turn off IPv6 MRM debugging.

By default, IPv6 MRM debugging is off.

Table 1-8 debugging mrm ipv6 packet command output description

Field	Description
Received	Received IPv6 packets
MFIB information(NOCACHE) MFIB information(WRONGIF) MFIB information(ACTIVE) MFIB information(INACTIVE) MFIB information(SPT) MFIB information(CLEAR) MFIB information(REG-Timeout) Pim	Types of received IPv6 packets
(sadd, gadd)	(S, G) entry

 

Table 1-9 debugging mrm ipv6 route command output description

Field	Description
lost the route	A route is deleted.
a new route	A new route is added.
(sadd, gadd)	(S, G) entry

 

Table 1-10 debugging mrm ipv6 event command output description

Field	Description
register interest/unregistered interest	Register/deregister
(sadd, gadd)	(S, G) entry
failed	Operation failed.

 

Examples

# Enable IPv6 MRM route debugging.

<Sysname> debugging mrm ipv6 route

*Jan 24 17:24:22:842 2006 Sysname MRM/7/ROUTE:

IPv6 AUX_SG: get a new route for (100::1, FF3E::1)(C155471)

*Jan 24 17:24:24:842 2006 Sysname MRM/7/ROUTE:

IPv6 AUX_SG: 100::1 is reachable, move (100::1, FF3E::1) aux join from null list(C155484)

// The route to 100::1 is reachable.

*Jan 24 17:24:23:842 2006 Sysname MRM/7/ROUTE:

IPv6 Received a creation alert for (100::1, FF3E::1)(C181103)

// An IPv6 multicast forwarding entry creation alert is received..

1.1.3  display multicast ipv6 boundary

Syntax

display multicast ipv6 boundary [ ipv6-group-address [ prefix-length ] | interface interface-type interface-number ]

View

Any view

Default Level

1: Monitor level

Parameters

ipv6-group-address: Displays the multicast boundary information persistent to a particular IPv6 multicast group.

prefix-length: Prefix length of an IPv6 multicast group address, in the range of 8 to 128. The system default is 128.

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

Description

Use the display multicast ipv6 boundary command to view the IPv6 multicast boundary information.

Related commands: multicast ipv6 boundary.

Examples

# View the IPv6 multicast boundary information configured on all interfaces.

<Sysname> display multicast ipv6 boundary

IPv6 multicast boundary information

 Boundary                                                 Interface

 FF1E::/64                                                Vlan40

Table 1-11 display multicast ipv6 boundary command output description

Field	Description
Boundary	IPv6 multicast group corresponding to the IPv6 multicast boundary
Interface	IPv6 boundary interface corresponding to the IPv6 multicast boundary

 

1.1.4  display multicast ipv6 forwarding-table

Syntax

display multicast ipv6 forwarding-table [ ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | incoming-interface { interface-type interface-number | register } | outgoing-interface { { exclude | include | match } { interface-type interface-number | register } } | statistics | slot slot-id ] * [ port-info ]

View

Any view

Default Level

1: Monitor level

Parameters

ipv6-source-address: Specifies an IPv6 multicast source.

ipv6-group-address: Specifies an IPv6 multicast group.

prefix-length: Prefix length of an IPv6 multicast group address or an IPv6 multicast source address. For an IPv6 multicast group address, this argument has an effective value range of 8 to 128; for an IPv6 multicast source address, this argument has an effective value range of 0 to 128. The system default is 128 in both cases.

incoming-interface: Displays the routing entries whose incoming interface is the specified ones.

interface-type interface-number: Interface type and interface number. Currently, only VLAN interfaces are supported for the S9500 series routing switches.

register: Specifies the register interface.

outgoing-interface: Displays the forwarding entries whose outgoing interface is the specified one.

exclude: Displays the forwarding entries whose outgoing interface list excludes the specified interface.

include: Displays the forwarding entries whose outgoing interface list includes the specified interface.

match: Displays the forwarding entries whose outgoing interface list includes and includes only the specified interface.

statistics: Specifies to display the statistics information of IPv6 multicast forwarding table.

slot slot-id: Specifies the slot number of an interface card. If you do not provide this option, this command displays the multicast forwarding table information on the switching and routing processing unit (SRPU) only.

port-info: Displays Layer 2 port information.

Description

Use the display multicast ipv6 forwarding-table command to display information of the IPv6 multicast forwarding table.

Related commands: multicast ipv6 forwarding-table downstream-limit, multicast ipv6 forwarding-table route-limit, display multicast ipv6 routing-table.

Examples

# Display information of an IPv6 multicast forwarding table.

<Sysname> display multicast ipv6 forwarding-table

IPv6 Multicast Forwarding Table

Total 1 entry

 

Total 1 entry matched

 

00001. (2001::10, FF0E::101:101)

     MID: 406, Flags: 0x100000:0

     Uptime: 00:19:09, Timeout in: 00:03:23

     Incoming interface: Vlan-interface511

     List of 2 outgoing interfaces:

       1: Vlan-interface20

       2: Vlan-interface21

     Matched 96 packets(1545 bytes), Wrong If 0 packets

     Forwarded 75 packets(75 bytes)

Table 1-12 display multicast ipv6 forwarding-table command output description

Field	Description
Total 1 entry	Total number of (S, G) entries in the IPv6 multicast forwarding table
Total 1 entry matched	Total number of matched (S, G) entries in the IPv6 multicast forwarding table
00001	Sequence number the (S, G) entry
(2001::10, FF0E::101:101)	An (S, G) entry in the IPv6 multicast forwarding table
MID	(S, G) entry ID. Each (S, G) entry has a unique MID
Flags	Current state of the (S, G) entry. Different bits are used to indicate different states of the (S, G) entry, in the format of X:Y. Major values of X are described in Table 1-13. Y is 0, indicating that the (S, G) entry is stable.
Uptime	Length of time since the (S, G) entry was installed
Timeout in	Remaining time of the (S, G) entry
Incoming interface	Incoming interface of the (S, G) entry
List of 2 outgoing interfaces	Outgoing interface of the (S, G) entry
Matched 96 packets(1545 bytes), Wrong If 0 packets	Number of matched IPv6 packets (number of bytes), number of packets with incoming interface errors These values are for reference only.
Forwarded 75 packets(75 bytes)	Number of forwarded IPv6 multicast packets (number of bytes) These values are for reference only.

 

Table 1-13 Values and meanings of the X field

Value	Meaning
0x000001	Indicates that a register-stop message needs to be sent.
0x000002	Indicates whether the IPv6 multicast source corresponding to the (S, G) entry is active.
0x000004	Indicates a null forwarding entry.
0x000008	Indicates whether the RP is a border router or a border routing switch in an IPv6 PIM domain.
0x000010	Indicates a register outgoing interface is present
0x000400	Indicates a packet to be deleted
0x008000	Indicates that the (S,G) entry  is in smoothening process after active/standby switchover
0x010000	Indicates that the (S, G) entry has been updated during the smoothening process.
0x080000	Indicates that the (S, G) entry has been repeatedly updated and needs to be deleted before adding a new entry is added.
0x100000	Indicates that a (S, G) entry is added successfully

 

1.1.5  display multicast ipv6 routing-table

Syntax

display multicast ipv6 routing-table [ ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | incoming-interface { interface-type interface-number | register } | outgoing-interface { { exclude | include | match } { interface-type interface-number | register } } ] *

View

Any view

Default Level

1: Monitor level

Parameters

ipv6-source-address: IPv6 multicast source address.

ipv6-group-address: IPv6 multicast group address.

prefix-length: Prefix length of a multicast group address or an IPv6 multicast source address. For an IPv6 multicast group address, this argument has an effective value range of 8 to 128; for an IPv6 multicast source address, this argument has an effective value range of 0 to 128. The system default is 128 in both cases.

incoming-interface: Displays routing entries whose incoming interface is the specified one.

interface-type interface-number: Specifies an interface. Currently, only VLAN interfaces are supported for the S9500 series routing switches.

register: Specifies the register interface.

outgoing-interface: Displays routing entries whose outgoing interface is the specified ones.

exclude: Displays routing entries whose outgoing interface list excludes the specified interface.

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

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

Description

Use the display multicast ipv6 routing-table command to display the information of the IPv6 multicast routing table.

Related commands: display multicast ipv6 forwarding-table.

Examples

# Display the information of the IPv6 multicast routing table.

<Sysname> display multicast ipv6 routing-table

IPv6 multicast routing table

 Total 1 entry

 

 00001. (2001::2, FF1E::101:101)

       Uptime: 00:00:14

       Upstream Interface: Vlan-interface55

       List of 2 downstream interfaces

           1:  Vlan-interface66

           2:  Vlan-interface99

Table 1-14 display multicast ipv6 routing-table command output description

Field	Description
Total 1 entry	Total number of matched (S, G) entries in the IPv6 multicast routing table
00001	Sequence number the (S, G) entry
(2001::2, FF1E::101:101)	An (S, G) entry in the IPv6 multicast forwarding table
Uptime	Length of time since the (S, G) entry was installed.
Upstream Interface	Upstream interface of the (S, G) entry. IPv6 multicast packets for this (S, G) entry should arrive through this interface
List of 2 downstream interfaces	Downstream interface list. These interfaces need to forward multicast packets for this (S, G) entry.

 

1.1.6  display multicast ipv6 rpf-info

Syntax

display multicast ipv6 rpf-info ipv6-source-address [ ipv6-group-address ]

View

Any view

Default Level

1: Monitor level

Parameters

ipv6-source-address: Specify an IPv6 multicast source.

ipv6-group-address: Specifies an IPv6 multicast group.

Description

Use the display multicast ipv6 rpf-info command to display RPF information for an IPv6 multicast source.

Related commands: display multicast ipv6 routing-table and display multicast ipv6 forwarding-table.

Examples

# Display all RPF information for the multicast source 2001::101.

<Sysname> display multicast ipv6 rpf-info 2001::101

RPF information about source 2001::101

     RPF interface: Vlan-interface5

     Referenced route/prefix length: 2001::101/64

     Referenced route type: igp

     Route selection rule: preference-preferred

     Load splitting rule: disable

Table 1-15 display multicast ipv6 rpf-info command output description

Field	Description
RPF information about source 2001::101	RPF information of the IPv6 multicast source 2001::101
RPF interface	The RPF interface
Referenced route/prefix length	Referenced route and prefix length
Referenced route type	Type of the referenced route
Route-route selecting rule	RPF route selection rule: by the priority of the routing protocol or by the longest match of the destination address in the routing table.
Load splitting rule	Load sharing rule

 

1.1.7  multicast ipv6 boundary

Syntax

multicast ipv6 boundary ipv6-group-address prefix-length

undo multicast ipv6 boundary { ipv6-group-address prefix-length | all }

View

VLAN interface view

Default Level

2: System level

Parameters

ipv6-group-address: IPv6 multicast group address.

prefix-length: Prefix length of an IPv6 multicast group address.

all: Deletes all IPv6 multicast boundaries configured on the interface.

Description

Use the multicast ipv6 boundary command to configure a multicast forwarding boundary.

Use the undo multicast ipv6 boundary command to delete the specified multicast forwarding boundary or all IPv6 multicast forwarding boundaries.

By default, no multicast forwarding boundary is configured.

Note that:

l           A multicast forwarding boundary sets the boundary condition for the IPv6 multicast groups in the specified range. If the destination address of an IPv6 multicast packet matches the set boundary condition, the packet will not be forwarded.

l           If an interface needs to act as forwarding boundary for multiple IPv6 multicast groups, just carry out this command on the interface once for each group.

l           Assume that Set A and Set B are both multicast forwarding boundary sets to be configured, and that B is a subset of A. If A has been configured on an interface, it is not allowed to configure B on the interface; if B has been configured on the interface before A is configured, the previously configured B needs to be removed.

Related commands: display multicast ipv6 boundary.

Examples

# Configure VLAN-interface 100 to be the forwarding boundary for IPv6 multicast group FF35::101:101/16.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] multicast ipv6 boundary FF35::101:101 16

1.1.8  multicast ipv6 forwarding-table downstream-limit

Syntax

multicast ipv6 forwarding-table downstream-limit limit

undo multicast ipv6 forwarding-table downstream-limit

View

System view

Default Level

2: System level

Parameters

limit: Maximum number of downstream nodes for a single entry in the IPv6 multicast forwarding table.

Description

Use the multicast ipv6 forwarding-table downstream-limit command to configure the maximum number of downstream nodes for a single entry in the IPv6 multicast forwarding table.

Use the undo multicast ipv6 forwarding-table downstream-limit command to restore the default.

By default, the maximum number of downstream nodes for a single entry in the IPv6 multicast forwarding table is 128.

Related commands: display multicast ipv6 forwarding-table.

Examples

# Set the maximum number of downstream nodes for a single entry in the IPv6 multicast forwarding table to 120.

<Sysname> system-view

[Sysname] multicast ipv6 forwarding-table downstream-limit 120

1.1.9  multicast ipv6 forwarding-table route-limit

Syntax

multicast ipv6 forwarding-table route-limit limit

undo multicast ipv6 forwarding-table route-limit

View

System view

Default Level

2: System level

Parameters

limit: Maximum number of entries in the IPv6 multicast forwarding table.

Description

Use the multicast ipv6 forwarding-table route-limit command to configure the maximum number of entries in the IPv6 multicast forwarding table.

Use the undo multicast ipv6 forwarding-table route-limit command to restore the default.

By default, the maximum number of entries in the IPv6 multicast forwarding table is 256.

Related commands: display multicast ipv6 forwarding-table.

Examples

# Set the maximum number of entries in the IPv6 multicast forwarding table to 200.

<Sysname> system-view

[Sysname] multicast ipv6 forwarding-table route-limit 200

1.1.10  multicast ipv6 load-splitting

Syntax

multicast ipv6 load-splitting {source | source-group }

undo multicast ipv6 load-splitting

View

System view

Default Level

2: System level

Parameters

source: Specifies to implement IPv6 multicast load splitting on a per-source basis.

source-group: Specifies to implement IPv6 multicast load splitting on a per-source and per-group basis.

Description

Use the multicast load-splitting command to enable load splitting of IPv6 multicast traffic.

Use the undo multicast load-splitting command to disable load splitting of IPv6 multicast traffic.

By default, load splitting of IPv6 multicast traffic is disabled.

Examples

# Enable load splitting of IPv6 multicast traffic on a per-source basis.

<Sysname> system-view

[Sysname] multicast ipv6 load-splitting source

1.1.11  multicast ipv6 routing-enable

Syntax

multicast ipv6 routing-enable

undo multicast ipv6 routing-enable

View

System view

Default Level

2: System level

Parameters

None

Description

Use the multicast ipv6 routing-enable command to enable IPv6 multicast routing.

Use the undo multicast ipv6 routing-enable command to disable IPv6 multicast routing.

IPv6 multicast routing is disabled by default.

Note that:

l           You must enable IPv6 multicast routing before you can carry out other Layer 3 IPv6 multicast commands.

l           The device does not forward any IPv6 multicast packets before IPv6 multicast routing is enabled.

Examples

# Enable IPv6 multicast routing.

<Sysname> system-view

[Sysname] multicast ipv6 routing-enable

1.1.12  reset multicast ipv6 forwarding-table

Syntax

reset multicast ipv6 forwarding-table { { ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | incoming-interface { interface-type interface-number | register } } * | all }

View

User view

Default Level

2: System level

Parameters

ipv6-source-address: Specifies an IPv6 multicast source.

ipv6-group-address: Specifies an IPv6 multicast group.

prefix-length: Prefix length of an IPv6 multicast group or an IPv6 multicast source address. For an IPv6 multicast group address, this argument has an effective value range of 8 to 128; for an IPv6 multicast source address, this argument has an effective value range of 0 to 128. The system default is 128 in both cases.

incoming-interface: Clears IPv6 multicast forwarding entries of which the incoming interface is the specified one.

interface-type interface-number: Specifies an interface. Currently, only VLAN interfaces are supported for the S9500 series routing switches.

all: Clears all forwarding entries from the IPv6 multicast forwarding table.

Description

Use the reset multicast ipv6 forwarding-table command to clear forwarding entries from the IPv6 multicast forwarding table.

When a forwarding entry is deleted from the IPv6 multicast forwarding table, the corresponding routing entry is also deleted from the IPv6 multicast routing table.

Related commands: reset multicast IPv6 routing-table, display multicast ipv6 routing-table, display multicast ipv6 forwarding-table.

Examples

# Clear the IPv6 multicast forwarding entries related to the IPv6 multicast group FF1E::101:101 from the IPv6 multicast forwarding table.

<Sysname> reset multicast ipv6 forwarding-table ff1e::101:101

1.1.13  reset multicast IPv6 routing-table

Syntax

reset multicast ipv6 routing-table { { ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | incoming-interface { interface-type interface-number | register } } * | all }

View

User view

Default Level

1: Monitor level

Parameters

ipv6-source-address: Specifies an IPv6 multicast source.

ipv6-group-address: Specifies an IPv6 multicast group address.

prefix-length: Prefix length of an IPv6 multicast group address or an IPv6 multicast source address. For an IPv6 multicast group address, this argument has an effective value range of 8 to 128 for an IPv6 multicast source address, this argument has an effective value range of 0 to 128. The system default is 128 in both cases.

incoming-interface: Clears IPv6 multicast routing entries of which the incoming interface is the specified one.

interface-type interface-number: Specifies an interface. Currently, only VLAN interfaces are supported for the S9500 series routing switches.

register: Specifies a registration interface.

all: Clears all routing entries from the IPv6 multicast routing table.

Description

Use the reset multicast ipv6 routing-table command to clear IPv6 routing entries from the IPv6 multicast routing table.

When a routing entry is deleted from the IPv6 multicast routing table, the corresponding forwarding entry is also deleted from the IPv6 multicast forwarding table.

Related commands: reset multicast ipv6 forwarding-table, display multicast ipv6 forwarding-table, display multicast ipv6 routing-table.

Examples

# Clear the routing entries related to the IPv6 multicast group FF1E::101:101 from the IPv6 multicast routing table.

<Sysname> reset multicast ipv6 routing-table ff1e::101:101