07-Multicast Protocol Command

Table of Contents

Chapter 1 Multicast Common Configuration Commands. 1-1

1.1 Multicast Common Configuration Commands. 1-1

1.1.1 debugging multicast forwarding. 1-1

1.1.2 debugging multicast kernel-routing. 1-1

1.1.3 debugging multicast status-forwarding. 1-2

1.1.4 display multicast forwarding-table. 1-3

1.1.5 display multicast routing-table. 1-3

1.1.6 display multicast routing-table static. 1-5

1.1.7 display multicast rpf-info. 1-6

1.1.8 mtracert 1-6

1.1.9 multicast minimum-ttl 1-8

1.1.10 multicast packet-boundary. 1-9

1.1.11 multicast route-limit 1-9

1.1.12 multicast routing-enable. 1-10

1.1.13 reset multicast forwarding-table. 1-11

1.1.14 reset multicast routing-table. 1-12

Chapter 2 IGMP Configuration Commands. 2-1

2.1 IGMP Configuration Commands. 2-1

2.1.1 debugging igmp. 2-1

2.1.2 display igmp group. 2-1

2.1.3 display igmp interface. 2-3

2.1.4 display igmp local 2-4

2.1.5 igmp enable. 2-4

2.1.6 igmp group-limit 2-5

2.1.7 igmp group-policy. 2-6

2.1.8 igmp host-join. 2-7

2.1.9 igmp lastmember-queryinterval 2-7

2.1.10 igmp max-response-time. 2-8

2.1.11 igmp proxy. 2-9

2.1.12 igmp robust-count 2-10

2.1.13 igmp timer other-querier-present 2-11

2.1.14 igmp timer query. 2-12

2.1.15 igmp version. 2-12

2.1.16 reset igmp group. 2-13

Chapter 3 PIM Configuration Commands. 3-1

3.1 PIM Configuration Commands. 3-1

3.1.1 bsr-policy. 3-1

3.1.2 c-bsr 3-2

3.1.3 c-rp. 3-3

3.1.4 crp-policy. 3-4

3.1.5 debugging pim common. 3-5

3.1.6 debugging pim dm.. 3-6

3.1.7 debugging pim sm.. 3-7

3.1.8 display pim bsr-info. 3-7

3.1.9 display pim interface. 3-8

3.1.10 display pim neighbor 3-9

3.1.11 display pim routing-table. 3-9

3.1.12 display pim rp-info. 3-11

3.1.13 pim.. 3-12

3.1.14 pim bsr-boundary. 3-12

3.1.15 pim dm.. 3-13

3.1.16 pim neighbor-limit 3-13

3.1.17 pim neighbor-policy. 3-14

3.1.18 pim sm.. 3-15

3.1.19 pim timer hello. 3-15

3.1.20 register-policy. 3-16

3.1.21 reset pim neighbor 3-17

3.1.22 reset pim routing-table. 3-17

3.1.23 source-policy. 3-19

3.1.24 spt-switch-threshold. 3-20

3.1.25 static-rp. 3-21

Chapter 4 MSDP Configuration Commands. 4-1

4.1 MSDP Configuration Commands. 4-1

4.1.1 cache-sa-enable. 4-1

4.1.2 debugging msdp. 4-1

4.1.3 display msdp brief 4-2

4.1.4 display msdp peer-status. 4-3

4.1.5 display msdp sa-cache. 4-4

4.1.6 display msdp sa-count 4-5

4.1.7 import-source. 4-5

4.1.8 msdp. 4-6

4.1.9 msdp-tracert 4-7

4.1.10 originating-rp. 4-9

4.1.11 peer 4-10

4.1.12 peer description. 4-11

4.1.13 peer mesh-group. 4-11

4.1.14 peer minimum-ttl 4-12

4.1.15 peer request-sa-enable. 4-13

4.1.16 peer sa-cache-maximum.. 4-13

4.1.17 peer sa-policy. 4-14

4.1.18 peer sa-request-policy. 4-15

4.1.19 reset msdp peer 4-16

4.1.20 reset msdp sa-cache. 4-16

4.1.21 reset msdp statistics. 4-17

4.1.22 shutdown. 4-17

4.1.23 static-rpf-peer 4-18

4.1.24 timer retry. 4-19

Chapter 5 MBGP Multicast Extension Configuration Commands. 5-1

5.1 MBGP Multicast Extension Configuration Commands. 5-1

5.1.1 aggregate. 5-1

5.1.2 debugging bgp mp-update. 5-2

5.1.3 display bgp multicast group. 5-2

5.1.4 display bgp multicast network. 5-3

5.1.5 display bgp multicast peer 5-3

5.1.6 display bgp multicast routing. 5-4

5.1.7 display bgp multicast routing as-path-acl 5-4

5.1.8 display bgp multicast routing cidr 5-5

5.1.9 display bgp multicast routing community. 5-5

5.1.10 display bgp multicast routing community-list 5-6

5.1.11 display bgp multicast routing different-origin-as. 5-6

5.1.12 display bgp multicast routing peer 5-7

5.1.13 display bgp multicast routing regular-expression. 5-7

5.1.14 display bgp multicast routing statistic. 5-8

5.1.15 import-route. 5-8

5.1.16 ipv4-family multicast 5-9

5.1.17 network. 5-10

5.1.18 peer advertise-community. 5-10

5.1.19 peer allow-as-loop. 5-11

5.1.20 peer as-path-acl 5-12

5.1.21 peer enable. 5-13

5.1.22 peer filter-policy. 5-13

5.1.23 peer ip-prefix. 5-14

5.1.24 peer next-hop-local 5-15

5.1.25 peer public-as-only. 5-16

5.1.26 peer reflect-client 5-16

5.1.27 peer route-policy. 5-17

Chapter 6 Multicast Static Route Configuration Commands. 6-1

6.1 Multicast Static Route Configuration Commands. 6-1

6.1.1 delete rpf-route-static all 6-1

6.1.2 display multicast routing-table static. 6-1

6.1.3 display multicast routing-table static config. 6-2

6.1.4 ip rpf-longest-match. 6-3

6.1.5 ip rpf-route-static. 6-3

 


Chapter 1  Multicast Common Configuration Commands

1.1  Multicast Common Configuration Commands

1.1.1  debugging multicast forwarding

Syntax

debugging multicast forwarding

undo debugging multicast forwarding

View

User view

Parameter

None

Description

Use the debugging multicast forwarding command to enable multicast packet forwarding debugging functions.

Use the undo debugging multicast forwarding command to disable the debugging functions.

By default, the debugging function is disabled.

Example

# Enable multicast packet forwarding debugging functions.

<H3C> debugging multicast forwarding

1.1.2  debugging multicast kernel-routing

Syntax

debugging multicast kernel-routing

undo debugging multicast kernel-routing

View

User view

Parameter

None

Description

Use the debugging multicast kernel-routing command to enable multicast kernel routing debugging functions.

Use the undo debugging multicast kernel-routing command to disable the debugging functions.

By default, the multicast kernel routing debugging function is disabled.

Example

# Enable multicast kernel routing debugging functions.

<H3C> debugging multicast kernel-routing

1.1.3  debugging multicast status-forwarding

Syntax

debugging multicast status-forwarding

undo debugging multicast status-forwarding

View

User view

Parameter

None

Description

Use the debugging multicast status-forwarding command to enable multicast forwarding status debugging functions.

Use the undo debugging multicast status-forwarding command to disable the debugging functions.

By default, the multicast status debugging function is disabled.

Example

# Enable multicast forwarding status debugging functions.

<H3C> debugging multicast status-forwarding

1.1.4  display multicast forwarding-table

Syntax

display multicast forwarding-table [ group-address [ mask { mask | mask-length } ] | source-address [ mask { mask | mask-length } ] | incoming-interface { interface-type interface-number | register } ] *

View

Any view

Parameter

group-address: Multicast group address, used to specify a multicast group, ranging from 224.0.0.0 to 239.255.255.255.

mask: Mask.

mask-length: Length of mask. Because “1”s in 32-bit mask are required to be continuous, the mask in dotted decimal notation format can be replaced by mask-length (mask-length is the number of continuous “1”s in the mask).

source-address: Unicast IP address of the multicast source.

incoming-interface: Incoming interface of the multicast forwarding entry.

register: Register interface of PIM-SM.

Description

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

source-address and group-address of multicast forwarding table are displayed in hexadecimal notation format and its incoming and outgoing port numbers are displayed by virtual port number. This information can be viewed via display pim interface command.

Related command: display multicast routing-table.

Example

# Display the multicast forwarding table information.

<H3C> display multicast forwarding-table

1.1.5  display multicast routing-table

Syntax

display multicast routing-table [ group-address [ mask { mask | mask-length } ] | source-address [ mask { mask | mask-length } ] | incoming-interface { interface-type interface-number | register } ]*

View

Any view

Parameter

group-address: Multicast group address, used to specify a multicast group and display the corresponding routing table information of the group. The value ranges from 224.0.0.0 to 239.255.255.255.

source-address: Unicast IP address of the multicast source.

mask: Mask.

mask-length: Length of mask. Because “1” in 32-bit mask is required to be continuous, the mask in dotted decimal notation format can be replaced by mask-length (mask-length is the number of continuous “1”s in the mask).

incoming-interface: Incoming interface of the multicast route entry.

register: Register interface of PIM-SM.

Description

Use the display multicast routing-table command to view the information of IP multicast routing table.

This command displays the multicast routing table information, while the display multicast forwarding-table command displays the multicast forwarding table information.

The entry (S, G) in the multicast routing table, i.e., (multicast source, multicast group) acts as the independent entry in the table. Each entry has a unique Upstream, indicating the interface through which RPF goes to the multicast source. Each entry has also a Downstream List, indicating which interfaces need multicast forwarding. The related information about (S, G) includes:

l           proto: the multicast protocol number which possesses the (S, G) (in hexadecimal notation format).

l           Flags: all kinds of flags, such as RPT 0x1, WC 0x2, SPT 0x4, NEG CACHE 0x8 and JOIN SUPP 0x10. All the flags are marked by binary “bit”. In which, RPT indicates the (S, G) is in the shared tree status. WC is the abbreviation of wildcard. SPT indicates the shortest path tree. NEG CACHE indicates the cache record that the downstream interface list is null. JOIN SUPP indicates the prune suppression status.

Example

# Display the corresponding route entry information of multicast group in the multicast routing table.

<H3C> display multicast routing-table

Multicast Routing Table

Total 1 entry

 

(10.10.1.2, 225.1.1.1)

    UpTime: 00:01:28, Timeout in 278 sec

    Upstream interface: Ethernet0/0/0(10.10.1.20)

    Downstream interface list:

      LoopBack0(20.20.20.30), Protocol 0x1: IGMP

1.1.6  display multicast routing-table static

Syntax

display multicast routing-table static [ config ] [ source-address [ mask | mask-length ] ]

View

Any view

Parameter

config: When this parameter is chosen, all the routing information configured will be displayed. If this parameter is not chosen, only effective routing information is displayed.

source-address: IP address of the multicast source.

mask: Mask.

mask-length: Length of mask. Because “1”s in 32-bit mask are required to be continuous, the mask in dotted decimal notation format can be replaced by mask-length (mask-length is the number of continuous “1”s in the mask).

Description

Use the display multicast routing-table static command to view the configuration information of static multicast route.

Example

# Display the configuration information of static multicast route.

<H3C> display multicast routing-table static

100.10.0.0/16

   RPF interface = 10.10.1.20(Ethernet0/0/0),  RPF neighbor = 10.10.1.20

   Matched routing protocol = <none>, route-policy = <none>, preference = 1

   Running config = ip rpf-route-static 100.10.0.0 16 Ethernet0/0/0 preference 1

1.1.7  display multicast rpf-info

Syntax

display multicast rpf-info source-address

View

Any view

Parameter

source-address: IP address of the multicast source.

Description

Use the display multicast rpf-info command to view the Reverse Path Forwarding (RPF) routing information for specified multicast source.

Example

# Display all the RPF routing information.

<H3C> display multicast rpf-info 192.193.194.192

Multicast source's RPF route information about 192.193.194.192

  RPF interface: InLoopBack0, RPF neighbor: 127.0.0.1

  Referenced route/mask: 192.193.194.192/32

  Referenced route type: unicast (DIRECT)

  RPF-route selecting rule: preference-preferred

1.1.8  mtracert

Syntax

mtracert source-address [ last-hop-address ] [ group-address ]

View

Any view

Parameter

source-address: Address of the multicast source.

last-hop-address: Unicast address, which is the starting address of path tracing. This address must be an interface address of a hop router. By default, it is a physical interface address of the local router.

group-address: Address of multicast group. By default, the value is 0.0.0.0.

Description

Use the mtracert command to trace the network path from the multicast source to the destination receiver along Multicast Distribution Tree, according to either the multicast kernel routing table or RPF rule to the source. This command can help to locate the faults, such as information loss and configuration error.

The trace mode to the group address of 0.0.0.0 is called weak trace mode.

Example

# Trace the path reversely from the local hop router 18.110.0.1 to the multicast source 10.10.1.2 in weak trace mode.

<H3C> mtracert 10.10.1.2

 Type Ctrl+C to abort

 Mtrace from 10.10.1.2 to 18.110.0.1 via RPF

 Querying full reverse path...

 -1 18.110.0.1

   Incoming Interface Address: 18.110.0.1

   Previous-Hop Router Address: 18.110.0.2

   Input packet count on incoming interface: 0

   Output packet count on outgoing interface: 0

   Total number of packets for this source-group pair: 0

   Protocol: PIM

   Forwarding TTL: 0

   Forwarding Code: No error

 -2 18.110.0.2

   Incoming Interface Address: 11.110.0.2

   Previous-Hop Router Address: 11.110.0.4

   Input packet count on incoming interface: 0

   Output packet count on outgoing interface: 0

   Total number of packets for this source-group pair: 0

   Protocol: PIM

   Forwarding TTL: 0

   Forwarding Code: No error

 -3 11.110.0.4

   Incoming Interface Address: 10.10.1.3

   Previous-Hop Router Address: 0.0.0.0

   Input packet count on incoming interface: 0

   Output packet count on outgoing interface: 0

   Total number of packets for this source-group pair: 0

   Protocol: PIM

   Forwarding TTL: 0

   Forwarding Code: No error

# Trace reversely the path information of multicast group 225.1.1.1 from the multicast source 10.10.1.3 to the destination address 12.110.0.2.

<H3C> mtracert 10.10.1.3 12.110.0.2 225.1.1.1

 Type Ctrl+C to abort

 Mtrace from 10.10.1.3 to 12.110.0.2 via group 225.1.1.1

 Querying full reverse path...

 -1 12.110.0.2

   Incoming Interface Address: 11.110.0.2

   Previous-Hop Router Address: 11.110.0.4

   Input packet count on incoming interface: 316

   Output packet count on outgoing interface: 135

   Total number of packets for this source-group pair: 4

   Protocol: PIM

   Forwarding TTL: 0

   Forwarding Code: No error

 -2 11.110.0.4

   Incoming Interface Address: 127.0.0.5

   Previous-Hop Router Address: 0.0.0.0

   Input packet count on incoming interface: 0

   Output packet count on outgoing interface: 0

   Total number of packets for this source-group pair: 4

   Protocol: Unknown

   Forwarding TTL: 0

   Forwarding Code: No error

1.1.9  multicast minimum-ttl

Syntax

multicast minimum-ttl ttl-value

undo multicast minimum-ttl

View

Interface view

Parameter

ttl-value: The minimum TTL value, ranging from 0 to 255.

Description

Use the multicast minimum-ttl command to configure the minimum TTL value for multicast forwarding.

Use the undo multicast minimum-ttl command to remove the minimum TTL value configured.

By default, no minimum TTL value for multicast forwarding is configured.

Example

# Configure the minimum TTL value for multicast forwarding to 8.

[H3C-Ethernet1/0/1] multicast minimum-ttl 8

1.1.10  multicast packet-boundary

Syntax

multicast packet-boundary acl-number

undo multicast packet-boundary

View

Interface view

Parameter

acl-number: Number of basic or advanced ACL, ranging from 2000 to 3999.

Description

Use the multicast packet-boundary command to configure a multicast forwarding boundary.

Use the undo multicast packet-boundary command to remove the multicast forwarding boundary configured.

By default, no multicast forwarding boundary is configured.

You can set boundary conditions for multicast packets on an interface via basic or advanced Access Control List (ACL). Packets denied by the ACL will be discarded. The source address of a multicast packet can be filtered through the basic ACL. Both the source address and the destination address (source group address) of a multicast packet can be filtered through the advanced ACL.

Example

# Set boundary conditions for multicast packets through the basic ACL 2001.

[H3C-Ethernet1/0/1] multicast packet-boundary 2001

1.1.11  multicast route-limit

Syntax

multicast route-limit limit

View

System view

Parameter

limit: Limit of multicast routing table capacity, ranging from 0 to MAX_MROUTE_LIMIT. In which, MAX_MROUTE_LIMIT differs with the different router types.

Description

Use the multicast route-limit command to limit the multicast routing table capacity. If the capacity exceeds the limit, the router will discard protocols and data packets of the newly-added (S, G).

By default, the limit of multicast routing table capacity is MAX_MROUTE_LIMIT.

If the number of route entries in the routing table has exceeded the configured number when configuring the command, the previous route entry in the routing table will not be deleted. The system will prompt “The number of current route entries is more than that configured.”

If this command is executed repeatedly, the new configuration will overwrite the previous one.

Example

# Limit the multicast routing table capacity to 1000.

[H3C] multicast route-limit 1000

1.1.12  multicast routing-enable

Syntax

multicast routing-enable

undo multicast routing-enable

View

System view

Parameter

None

Description

Use the multicast routing-enable command to enable IP multicast routing.

Use the undo multicast routing-enable command to disable IP multicast routing.

By default, IP multicast routing is disabled.

the system will not forward any multicast packet when IP multicast routing is disabled.

Related command: pim dm and pim sm.

Example

# Enable IP multicast routing.

<H3C> system-view

[H3C] multicast routing-enable

1.1.13  reset multicast forwarding-table

Syntax

reset multicast forwarding-table [ statistics ] { all | { group-address [ mask { group-mask | group-mask-length } ] | source-address [ mask { source-mask | source-mask-length } ] | { incoming-interface interface-type interface-number } | { slot slot-number } } * }

View

User view

Parameter

statistics: If this parameter is used, the statistics of MFC forwarding entries will be cleared. Otherwise, the MFC forwarding entries will be cleared.

all: All the MFC forwarding entries.

group-address: Address of the specified group.

group-mask: Address mask of the specified group.

group-mask-length: Address mask length of the specified group.

source-address: Address of the specified source.

source-mask: Address mask of the specified source.

source-mask-length: Address mask length of the specified source.

incoming-interface: Incoming interface of the specified forwarding entry.

interface-type interface-number: Interface type and interface number.

slot-number: Number of the slot where the interface board resides. This parameter is only present in the distributed router.

Description

Use the reset multicast forwarding-table command to clear MFC forwarding entries or the statistics of MFC forwarding entries.

The sequence of group-address and source-address can be reversed, but the input group-address and source-address must be valid. Otherwise, the system will prompt input error.

Related command: reset pim routing-table, reset multicast routing-table, display multicast forwarding-table.

Example

# Clear the forwarding entry whose group address is 225.5.4.3 from the MFC forwarding table.

<H3C> reset multicast forwarding-table 225.5.4.3

# Clear the statistics of the forwarding entry whose group address is 225.5.4.3 from MFC forwarding table.

<H3C> reset multicast forwarding-table statistics 225.5.4.3

1.1.14  reset multicast routing-table

Syntax

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

View

User view

Parameter

all: All the route entries in multicast kernel routing table.

group-address: Address of the specified group.

group-mask: Address mask of the specified group.

group-mask-length: Address mask length of the specified group.

source-address: Address of the specified source.

source-mask: Address mask of the specified source.

source-mask-length: Address mask length of multicast source.

incoming-interface: Incoming interface of the specified route entry.

interface-type interface-number: Interface type and interface number.

Description

Use the reset multicast routing-table command to clear the route entry in the multicast kernel routing table and remove the corresponding forwarding entry in MFC.

The sequence of group-address and source-address can be reversed, but the input group-address and source-address must be valid. Otherwise, the system will prompt input error.

Related command: reset pim routing-table, reset multicast forwarding-table, display multicast forwarding-table.

Example

# Clear the route entry whose group address is 225.5.4.3 from the multicast kernel routing table.

<H3C> reset multicast routing-table 225.5.4.3

 


Chapter 2  IGMP Configuration Commands

2.1  IGMP Configuration Commands

2.1.1  debugging igmp

Syntax

debugging igmp { all | event | host | packet | timer }

undo debugging igmp { all | event | host | packet | timer }

View

User view

Parameter

all: All debugging information of IGMP.

event: Debugging for IGMP events.

host: Debugging for IGMP hosts.

packet: Debugging for IGMP messages.

timer: Debugging for IGMP timers.

Description

Use the debugging igmp command to enable IGMP debugging.

Use the undo debugging igmp command to disable IGMP debugging.

By default, IGMP debugging is disabled.

Example

# Enable all IGMP debugging functions

<H3C> debugging igmp all

2.1.2  display igmp group

Syntax

display igmp group [ group-address | interface interface-type interface-number | local ]

View

Any view

Parameter

group-address: Multicast group address.

interface-type interface-number: Interface type and interface number of the router, used to specify the interface.

local: Displays the information of the local interface which receives and sends multicast data.

verbose: Displays detailed IGMP group information. This option displays the information of multicast groups on subnets attached to IGMPv3-enabled interfaces only.

Description

Use the display igmp group command to view the member information of the IGMP multicast group.

You can specify to view the information of a group or the member information of the multicast group on an interface. The information displayed includes the multicast groups joined through IGMP and those joined statically through command lines by the downstream host.

Related command: igmp host-join.

Example

# Display the member information of the directly connected sub-network.

<H3C> display igmp group

LoopBack0 (20.20.20.20): Total 3 IGMP Groups reported:

  Group Address      Last Reporter   Uptime      Expires

  225.1.1.1           20.20.20.20     00:02:04    00:01:15

  225.1.1.3           20.20.20.20     00:02:04    00:01:15

  225.1.1.2           20.20.20.20     00:02:04    00:01:17

Table 2-1 Description on the fields of the display ip igmp group command

Item

Description

Group address

Multicast group address

Last Reporter

Report the last host which becomes the multicast group member

Uptime

The time since the multicast group is found (hour, minute, second)

Expires

The predicted time when the record will be removed from the IGMP group table (hour, minute, second)

 

2.1.3  display igmp interface

Syntax

display igmp interface [ interface-type interface-number ]

View

Any view

Parameter

interface-type interface-number: Interface type and interface number of the router, used to specify the interface. If the parameters are not specified, information about all the interfaces running IGMP will be displayed.

Description

Use the display igmp interface command to view the IGMP configuration and running information on an interface.

The information displayed through display igmp interface will be different according to the configuration of IGMP proxy on an interface.

l           If the interface is neither a proxy nor a client, the configuration of IGMP Proxy will not be displayed.

l           If the interface is a proxy, all the clients will be displayed.

l           If the interface is a client, the proxy will be displayed.

Example

# Display the IGMP configuration and running information on an interface.

<H3C> display igmp interface

Ethernet0/0/0 (10.10.1.20):

  IGMP is enabled

  Current IGMP version is 2

  Value of query interval for IGMP(in seconds): 60

  Value of other querier time out for IGMP(in seconds): 120

  Value of maximum query response time for IGMP(in seconds): 10

  Policy to accept IGMP reports: none

  Querier for IGMP: 10.10.1.10

  Total 2 IGMP groups reported

 

LoopBack0 (20.20.20.30):

  IGMP is enabled

  Current IGMP version is 2

  Value of query interval for IGMP(in seconds): 60

  Value of other querier time out for IGMP(in seconds): 120

  Value of maximum query response time for IGMP(in seconds): 10

  Policy to accept IGMP reports: none

  Querier for IGMP: 20.20.20.30 (this router)

  No IGMP group reported

2.1.4  display igmp local

Syntax

display igmp local

View

Any view

Parameter

local: Information of the local interface which receives and sends multicast data.

Description

Use the display igmp local command to view the IGMP configuration and running information of the local interface which receives and sends multicast data.

Example

# Display the IGMP configuration and running information of the local interface which receives and sends multicast data.

<H3C> display igmp local

Mcast_Out_IF (127.0.0.6):

  IGMP is enabled on interface

  Current IGMP version is 2

  No IGMP group reported

 

Mcast_In_IF (127.0.0.5):

  IGMP is disabled on interface

2.1.5  igmp enable

Syntax

igmp enable

undo igmp enable

View

Interface view

Parameter

None

Description

Use the igmp enable command to enable IGMP on an interface.

Use the undo igmp enable command to disable IGMP on an interface.

By default, IGMP is disabled on an interface.

Only after multicast is enabled, can this command take effect. After this command is configured, the configuration of other attributes of IGMP can be performed.

Related command: multicast routing-enable.

Example

# Enable IGMP on interface Ethernet0/0/0.

[H3C-Ethernet0/0/0] igmp enable

2.1.6  igmp group-limit

Syntax

igmp group-limit limit

undo igmp group-limit

View

Interface view

Parameter

limit: Number of IGMP groups, ranging from 0 to MAX_IF_IGMP_GROUP_LIMIT. The value of MAX_IF_IGMP_GROUP_LIMIT on routers is MAX_MROUTE_LIMIT, which differs with the different router types.

Description

Use the igmp group-limit command to limit the number of IGMP groups joined on the interface. If the number exceeds the limit, the router will not process the joined IGMP packet any more.

Use the undo igmp group-limit command to restore the default configuration.

By default, the maximum number of IGMP groups joined on the interface is 1024.

If the number of IGMP groups joined on the interface has exceeded the configuration value during configuration, the previously joined IGMP groups will not be deleted.

If this command is executed repeatedly, the new configuration will overwrite the previous one.

This command is not supported on an IGMPv3-enabled interface.

Example

# Limit the maximum number of IGMP groups joined on the interface Ethernet1/0/0 to 100.

[H3C-Ethernet1/0/0] igmp group-limit 100

2.1.7  igmp group-policy

Syntax

igmp group-policy acl-number [ 1 | 2 ]

undo igmp group-policy

View

Interface view

Parameter

acl-number: Number of basic IP ACL, defining the range of a multicast group. The value ranges from 2000 to 2999.

1: IGMP version 1.

2: IGMP version 2 (default).

Description

Use the igmp group-policy command to set the filter of multicast groups on an interface to control the accessing to the IP multicast groups.

Use the undo igmp group-policy command to remove the filter configured.

By default, no filter is configured, that is, a host can join any multicast group.

If you do not want the hosts on the network that the interface is on to join some multicast groups, you can use this command to limit the range of the multicast groups served by the interface.

Related command: igmp host-join.

Example

# Permit the hosts on the interface Ethernet1/0/0 to join multicast group 225.1.1.1 only.

[H3C] acl number 2005

[H3C-acl-basci-2005] rule permit source 225.1.1.1 0

[H3C-acl-basci-2005] quit

[H3C] interface ethernet 1/0/0

[H3C-Ethernet1/0/0] igmp group-policy 2005

2.1.8  igmp host-join

Syntax

igmp host-join group-address

undo igmp host-join group-address

View

Interface view

Parameter

group-address: Multicast address of the multicast group that an interface will join.

Description

Use the igmp host-join command to enable an interface of a router to join a multicast group.

Use the undo igmp host-join command to disable the configuration.

By default, an interface does not join any multicast group.

On one router, up to 1024 interfaces can be configured with igmp host-join command at best.

This command is not supported on an IGMPv3-enabled interface.

Related command: igmp group-policy.

Example

# Configure Ethernet1/0/0 to join the multicast group 255.0.0.1.

[H3C-Ethernet1/0/0] igmp host-join 225.0.0.1

2.1.9  igmp lastmember-queryinterval

Syntax

igmp lastmember-queryinterval seconds

undo igmp lastmember-queryinterval

View

Interface view

Parameter

seconds: Interval at which IGMP querier sends the IGMP group-specific query message when it receives IGMP Leave message from the host, in second. The value ranges from 1 to 5 seconds. By default, the value is 1 second.

Description

Use the igmp lastmember-queryinterval command to set the interval at which IGMP querier sends the IGMP group-specific query message when it receives IGMP Leave message from the host.

Use the undo igmp lastmember-queryinterval command to restore the default value.

On a multi-access network where multiple hosts and multicast routers are present, the query router (querier for short) takes charge of maintaining IGMP group membership on an interface. When an IGMPv2 or IGMPv3 host leaves a group, the host sends IGMP Leave message. When the IGMP querier receives the message, it must send robust-value IGMP group-specific query messages at the interval of seconds configured via igmp lastmember-queryinterval command (if the command is not configured, seconds is 1) and the robustness variable robust-value configured via igmp robust-count (if the command is not configured, robust-value is 2). If another host receives the IGMP group-specific query message from IGMP querier and is interested in the group, it will send an IGMP Membership Report message within the maximum response time carried in the message. If the IGMP querier receives an IGMP Membership Report message within the time robust-value x seconds, it will go on maintaining the group membership. If not, it will regard the group has timed out and stop maintaining the group membership.

As an IGMPv1 host does not send a Leave message when it leaves a group, this command is valid only when the IGMP querier is running IGMPv2 or IGMPv3.

Related command: igmp robust-count and display igmp interface.

Example

# Configure the query interval of the querier for the last group member on the interface Ethernet1/0/0 to 3 seconds.

[H3C-Ethernet1/0/0] igmp lastmember-queryinterval 3

2.1.10  igmp max-response-time

Syntax

igmp max-response-time seconds

undo igmp max-response-time

View

Interface view

Parameter

seconds: The maximum response time in the IGMP query message in second, ranging from 1 to 25. By default, the value is 10 seconds.

Description

Use the igmp max-response-time command to configure the maximum response time contained in the IGMP query message.

Use the undo igmp max-response-time command to restore the default value.

The maximum query response time determines the period for a router to detect quickly that there are no longer directly connected group members in a LAN.

Related command: display igmp group.

Example

# Configure the maximum response time to 8 seconds.

[H3C-Ethernet1/0/0] igmp max-response-time 8

2.1.11  igmp proxy

Syntax

igmp proxy interface-type interface-number

undo igmp proxy

View

Interface view

Parameter

interface-type: Proxy interface type.

interface-number: Proxy interface number.

Description

Use the igmp proxy command to specify an interface of a leaf network router as the IGMP proxy of another interface.

Use the undo igmp proxy command to remove the configuration.

By default, IGMP proxy function is disabled.

You must enable PIM on the interface before you configure the igmp proxy command. An interface cannot act as the IGMP proxy of two or more other interfaces at the same time.

If an interface is configured with IGMP proxy for multiple times, the last one overrides all the previous configurations.

This command is not supported on an IGMPv3-enabled interface.

Related command: pim neighbor-policy.

Example

# Configure the IGMP proxy of router Ethernet0/0/0 to Ethernet1/0/0.

[H3C-Ethernet0/0/0] igmp proxy ethernet 1/0/0

2.1.12  igmp robust-count

Syntax

igmp robust-count robust-value

undo igmp robust-count

View

Interface view

Parameter

robust-value:  IGMP robustness variable, indicating the times IGMP querier sends the IGMP group-specific query message when it receives IGMP Leave message from the host. The value ranges from 2 to 5. By default, the value is 2.

Description

Use the igmp robust-count command to set the times IGMP querier sends the IGMP group-specific query message when it receives IGMP Leave message from the host.