8.2. IGMP Commands

Command Purpose

Use this command to apply an access-list to the igmp interface.

To remove this setting, use the no form of this command.

Prerequisites

Command Syntax

ip igmp access-group LIST

no ip igmp access-group

Command Mode

Interface Configuration

Default

Access-group is not configured on any igmp interface by default.

Usage

No matter the source ip or the destination ip in ACE should take effect respectively. If ACE’s action is deny, then the packet should be ignored; otherwise, if it matches one whose action is permit, then it should be processed regularly.

Examples

This example shows how to apply the access-list acl1 to the interface vlan1:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# ip igmp access-group acl1

This example shows how to remove the access-list acl1 on the interface:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# no ip igmp access-group

Related Commands

show ip igmp interface

Command Purpose

Use this command to apply an access-list to configure which groups support immediate-leave per interface.

To remove this setting, use the no form of this command.

Prerequisites

Command Syntax

ip igmp immediate-leave group-list LIST

no ip igmp immediate-leave

Command Mode

Interface Configuration

Default

Access-group is not configured on any igmp interface by default.

Usage

No matter the source ip or the destination ip in ACE should take effect respectively. If ACE’s action is deny, then the packet should be ignored; Otherwise if it matches one whose action is permit, then it should be processed regularly.

Examples

This example shows how to apply an access-list to configure which groups support immediately-leave on interface vlan1:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# ip igmp immediate-leave group-list acl1

This example shows how to remove the access-list acl1 on the interface:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# ip igmp immediate-leave group-list 1

Related Commands

show ip igmp interface

Command Purpose

Use this command to set the value of last member query count.

To reset it to default value, use the no form of this command.

Prerequisites

Command Syntax

ip igmp last-member-query-count COUNT

no ip igmp last-member-query-count

Command Mode

Interface Configuration

Default

2

Usage

None

Examples

This example shows how to set the value of last member query count to 5:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# ip igmp last-member-query-count 5

This example shows how to reset the value of last member query count to default value:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# no ip igmp last-member-query-count

Related Commands

show ip igmp interface

ip igmp last-member-query-interval

Command Purpose

Use this command to set the value of last member query interval.

To reset it to default value, use the no form of this command.

Prerequisites

Command Syntax

ip igmp last-member-query-interval INTERVAL

no ip igmp last-member-query-interval

Command Mode

Interface Configuration

Default

1000ms

Usage

None

Examples

This example shows how to set the last member query interval value to 10000ms:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# ip igmp last-member-query-interval 10000

This example shows how to reset the last member query interval value to default value:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# no ip igmp last-member-query-interval

Related Commands

show ip igmp interface

ip igmp last-member-query-count

Command Purpose

Use this command to set the max num of groups allowed.

To reset it to default value, use the no form of this command.

Prerequisites

Command Syntax

ip igmp limit NUMBER except LIST

no ip igmp limit

Command Mode

Global Config & Interface Configuration

Default

2048

Usage

Max number of groups is 2048 by default,in Global Config mode, use this command to set number of groups for all ports, in interface configuration mode, use this command to set number of groups for one ports

Examples

This example shows how to set the max num of groups allowed to 1000 globally:

Switch# configure terminal
Switch(config)# ip igmp limit 1000

This example shows how to reset the max num of groups to default value:

Switch# configure terminal
Switch(config)# no ip igmp limit

Related Commands

show ip igmp interface

Command Purpose

Use this command to set the mroute-proxy port on this interface.

To remove it, use the no form of this command.

Prerequisites

Command Syntax

ip igmp mroute-proxy IFNAME

no ip igmp mroute-proxy

Command Mode

Interface Configuration

Default

None

Usage

This command is used to set the mroute-proxy port on the interface. Only one mroute-proxy port can be set on the interface. When set it again, the new setting will overwrite the old one.

Examples

This example shows how to set the mroute-proxy port to eth-0-1 on this interface:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# ip igmp mroute-proxy eth-0-1

This example shows how to remove the mroute-proxy port on this interface:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# no ip igmp mroute-proxy

Related Commands

ip igmp proxy-service

Command Purpose

Use this command to enable igmp mroute proxy service on the interface.

To disable it, use the no form of this command.

Prerequisites

Command Syntax

ip igmp proxy-service

no ip igmp proxy-service

Command Mode

Interface Configuration

Default

None

Usage

This command is used with command ip igmp mroute-proxy and to set the upstream interface of the igmp group.

Examples

This example shows how to enable igmp mroute proxy service on this interface:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# ip igmp proxy-service

This example shows how to disable igmp mroute proxy service:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# no ip igmp proxy-service

Related Commands

ip igmp mroute-proxy

Command Purpose

Use this command to set the igmp previous querier timeout value.

To reset it to default value, use the no form of this command.

Prerequisites

Command Syntax

ip igmp querier-timeout INTERVAL

no ip igmp querier-timeout

Command Mode

Interface Configuration

Default

255s

Usage

None

Examples

This example shows how to set the igmp previous querier timeout value to 100 seconds:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# ip igmp querier-timeout 100

This example shows how to reset the igmp previous querier timeout value to default value:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# no ip igmp querier-timeout

Related Commands

ip igmp query-interval

ip igmp query-max-response-time

Command Purpose

Use this command to set the igmp query interval.

To reset it to default value, use the no form of this command.

Prerequisites

Command Syntax

ip igmp query-interval INTERVAL

no ip igmp query-interval

Command Mode

Interface Configuration

Default

125s

Usage

None

Examples

This example shows how to set the igmp query interval to 300 seconds:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# ip igmp query-interval 300

This example shows how to reset the igmp query interval to default value:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# no ip igmp query-interval

Related Commands

ip igmp querier-timeout

ip igmp query-max-response-time

Command Purpose

Use this command to set the igmp query max response time.

To reset it to default value, use the no form of this command.

Prerequisites

Command Syntax

ip igmp query-max-response-time INTERVAL

no ip query-max-response-time

Command Mode

Interface Configuration

Default

10 seconds

Usage

Query max response time must be less than igmp query interval.

Examples

This example shows how to set the igmp query max response time to 20 seconds:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# ip igmp query-max-response-time 20

This example shows how to reset the igmp query max response time to default value:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# no ip igmp query-max-response-time

Related Commands

ip igmp querier-timeout

ip igmp query-interval

Command Purpose

Use this command to set the igmp querier robustness variable value.

To reset it to default value, use the no form of this command.

Prerequisites

Command Syntax

ip igmp robustness-variable VALUE

no ip robustness-variable

Command Mode

Interface Configuration

Default

2

Usage

None

Examples

This example shows how to set the igmp querier robustness variable value to 6:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# ip igmp robustness-variable 6

This example shows how to reset the igmp querier robustness variable value to default value:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# no ip igmp robustness-variable

Related Commands

show ip igmp interface

Command Purpose

Use this command to set the igmp version on interface.

To reset it to default value, use the no form of this command.

Prerequisites

Command Syntax

ip igmp version VER

no ip igmp version

Command Mode

Interface Configuration

Default

2

Usage

None

Examples

This example shows how to set the igmp version 1 on the interface:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# ip igmp version 1

This example shows how to reset the igmp version to default value:

Switch# configure terminal
Switch(config)# interface vlan 1
Switch(config-if)# no ip igmp version

Related Commands

show ip igmp interface

Command Purpose

Use this command to configure the static multicast group on interface.

To delete static group, use the no form of this command.

Prerequisites

Command Syntax

ip igmp static-group GRP_ADDR ( source SRC_ADDR | )

no ip igmp static-group GRP_ADDR ( source SRC_ADDR | )

Command Mode

Interface Configuration

Default

None

Usage

None

Examples

This example shows how to configure the static IGMP group on interface:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip igmp static-group 226.1.2.3
Switch(config-if)# ip igmp static-group 226.1.2.4 source 1.2.3.4

This example shows how to delete static igmp group on interface:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ip igmp static-group 226.1.2.3

Related Commands

show ip igmp groups

Command Purpose

Use this command to enable igmp ssm mapping.

To disable ssm mapping, use the no form of this command.

Prerequisites

Command Syntax

ip igmp ssm-map enable

no ip igmp ssm-map enable

Command Mode

Global Config

Default

Disable

Usage

None

Examples

This example shows how to enable igmp ssm mapping:

Switch# configure terminal
Switch(config)# ip igmp ssm-map enable

This example shows how to disable igmp ssm mapping:

Switch# configure terminal
Switch(config)# no ip igmp ssm-map enable

Related Commands

None

Command Purpose

Use this command to set igmp ssm mapping.

To cancel ssm mapping setting, use the no form of this command.

Prerequisites

Command Syntax

ip igmp ssm-map static LIST SRC_ADDR

no ip igmp ssm-map static LIST SRC_ADDR

Command Mode

Global Config

Default

None

Usage

None

Examples

This example shows how to set igmp ssm mapping:

Switch# configure terminal
Switch(config)# ip igmp ssm-map static ipacl 192.168.1.1

This example shows how to unset igmp ssm mapping:

Switch# configure terminal
Switch(config)# no ip igmp ssm-map static ipacl 192.168.1.1

Related Commands

None

Command Purpose

Use this command to clear igmp groups.

Prerequisites

Command Syntax

clear ip igmp group ( * | GRP_ADDR | )

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to clear igmp group all:

Switch# clear ip igmp
Switch# clear ip igmp group *

This example shows how to clear igmp specified group:

Switch# clear ip igmp group 228.1.1.1

Related Commands

show ip igmp groups

Command Purpose

Use this command to clear igmp groups on specified interface.

Prerequisites

Command Syntax

clear ip igmp interface IFNAME

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to clear igmp group on specified interface:

Switch# clear ip igmp interface eth-0-1

Related Commands

show ip igmp groups

Command Purpose

Use this command to show the information about igmp groups.

Prerequisites

Command Syntax

show ip igmp groups GRP_ADDR ( detail | )

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to display the detail information about igmp groups:

Switch# show ip igmp groups detail

Interface:      eth-0-1
Group:          227.0.0.1
Uptime:         00:00:33
Group mode:     Exclude (Expires: 00:04:18)
Last reporter:  10.0.1.100
Source list is empty

Related Commands

None

Command Purpose

Use this command to show the information about igmp groups on interface.

Prerequisites

Command Syntax

show ip igmp groups IFNAME ( GRP_ADDR | ) ( detail | )

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to display the information about igmp groups on interface eth-0-1:

Switch# show ip igmp groups eth-0-1

IGMP Connected Group Membership
Group Address    Interface            Uptime   Expires  Last Reporter
227.0.0.1        eth-0-1              00:01:11 00:04:16 10.0.1.100

Related Commands

None

Command Purpose

Use this command to show igmp group number.

Prerequisites

Command Syntax

show ip igmp groups ( IFNAME | ) count

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to display the igmp group number on interface eth-0-1:

Switch# show ip igmp groups eth-0-1 count 

Dynamic multicast groups count: 1
Static multicast groups count: 0
Total multicast groups count: 1

Related Commands

None

Command Purpose

Use this command to show the information about igmp on interface.

Prerequisites

Command Syntax

show ip igmp interface ( IFNAME | )

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to display the information about igmp on interface eth-0-1:

Switch# show ip igmp interface eth-0-1

Interface eth-0-1 (Index 1)
 IGMP Enabled, Active, Querier, Version 2 (default)
 Internet address is 10.0.1.1
 IGMP interface limit is 8192
 IGMP interface has 1 group-record states
 IGMP activity: 97 joins, 0 leaves
 IGMP query interval is 125 seconds
 IGMP querier timeout is 255 seconds
 IGMP max query response time is 10 seconds
 Last member query response interval is 1000 milliseconds
 Group Membership interval is 260 seconds
 Last memeber query count is 2
 Robustness Variable is 2

Related Commands

None