Layer 3 IGMP Multicast Commands
This chapter describes the commands for Internet Group Management Protocol (IGMP) including the IGMP proxy service.
clear ip igmp
Use this command to clear all IGMP local-memberships on all interfaces. This command applies to interfaces configured for IGMP Layer-3 multicast protocols, or IGMP Proxy.
Command Syntax
clear ip igmp
clear ip igmp group *
clear ip igmp group A.B.C.D
clear ip igmp group A.B.C.D IFNAME
clear ip igmp interface IFNAME
clear ip igmp (vrf NAME|)
clear ip igmp (vrf NAME|) group *
clear ip igmp (vrf NAME|) group A.B.C.D
clear ip igmp (vrf NAME|) group A.B.C.D IFNAME
clear ip igmp (vrf NAME|) interface IFNAME
Parameters
*
Clears all groups on all interfaces.
A.B.C.D
Specify the group address’s local-membership to be cleared from all interfaces.
interface
Specify an interface. All groups learned from this interface are deleted.
IFNAME
Specify name of the interface.
vrf
Specify the VRF name.
group
Deletes IGMP group cache entries.
interface
Specify name of the interface; all groups learned from this interface are deleted.
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#clear ip igmp
#clear ip igmp group *
#clear ip igmp group 224.1.1.1
#clear ip igmp interface eth1
#clear ip igmp vrf VRF_A
#clear ip igmp vrf new group *
#clear ip igmp vrf new interface eth1
debug ip igmp
Use this command to enable debugging of all IGMP, or a specific component of IGMP. This command applies to interfaces configured for IGMP Layer-3 multicast protocols.
Use the no parameter with this command to disable all IGMP debugging, or select a specific IGMP component.
Command Syntax
debug ip igmp all
debug ip igmp decode
debug ip igmp encode
debug ip igmp events
debug ip igmp fsm
debug ip igmp tib
debug ip igmp (vrf NAME|) all
debug ip igmp (vrf NAME|) decode
debug ip igmp (vrf NAME|) encode
debug ip igmp (vrf NAME|) events
debug ip igmp (vrf NAME|) fsm
debug ip igmp (vrf NAME|) tib
no debug ip igmp all
no debug ip igmp decode
no debug ip igmp encode
no debug ip igmp events
no debug ip igmp fsm
no debug ip igmp tib
no debug ip igmp (vrf NAME|) all
no debug ip igmp (vrf NAME|) decode
no debug ip igmp (vrf NAME|) encode
no debug ip igmp (vrf NAME|) events
no debug ip igmp (vrf NAME|) fsm
no debug ip igmp (vrf NAME|) tib
Parameters
all
Debug all IGMP.
decode
Debug IGMP decoding.
encode
Debug IGMP encoding.
events
Debug IGMP events.
fsm
Debug IGMP Finite State Machine (FSM).
tib
Debug IGMP Tree Information Base (TIB).
vrf
Debug VPN Routing/Forwarding instance.
Command Mode
Privileged Exec mode and Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#debug ip igmp all
ip igmp
Use this command to enable the IGMP operation on an interface. This command enables IGMP operation in stand-alone mode, and can be used to learn local-membership information prior to enabling a multicast routing protocol on the interface. This command will has no effect on interfaces configured for IGMP proxy.
Use the no parameter with this command to return all IGMP related configuration to the default (including IGMP proxy service).
Command Syntax
ip igmp
no ip igmp
Parameters
None
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface xe1
(config-if)#ip igmp
ip igmp access-group
Use this command to control the multicast local-membership groups learned on an interface. This command applies to interfaces configured for IGMP Layer-3 multicast protocols, IGMP proxy.
Use the no parameter with this command to disable this access control.
Command Syntax
ip igmp access-group WORD
no ip igmp access-group WORD
Parameters
WORD
Standard IP access-list name.
Default
No access list configured
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
In the following example, hosts serviced by Ethernet interface 0 can only join the group 225.2.2.2:
#configure terminal
(config)#access-list 1 permit 225.2.2.2 0.0.0.0
(config)#interface xe1
(config-if)#ip igmp access-group xyz
(config-if)#exit
ip igmp immediate-leave
In IGMP version 2, use this command to minimize the leave latency of IGMP memberships. This command is used when only one receiver host is connected to each interface. This command applies to interfaces configured for IGMP Layer-3 multicast protocols, IGMP Proxy.
To disable this feature, use the no parameter with this command.
Command Syntax
ip igmp immediate-leave group-list WORD
no ip igmp immediate-leave
Parameters
group-list
Standard access-list name or number that defines multicast groups in which the immediate leave feature is enabled.
WORD
Standard IP access-list name.
Default
Disabled
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
The following example shows how to enable the immediate-leave feature on an interface for a specific range of multicast groups. In this example, the router assumes that the group access-list consists of groups that have only one host membership at a time per interface:
#configure terminal
(config)#interface xe1
(config-if)#ip igmp immediate-leave group-list xyz
(config-if)#exit
(config)#access-list 34 permit 225.192.20.0 0.0.0.255
ip igmp join-group
Use this command to configure a join multicast group.
Use the no parameter with this command to delete group membership entry.
Command Syntax
ip igmp join-group A.B.C.D {(source (A.B.C.D)|)}
no ip igmp join-group A.B.C.D {(source (A.B.C.D)|)}
Parameters
A.B.C.D
Standard IP multicast group address to be configured as a group member.
source
Static source to be joined.
A.B.C.D
Standard IP source address to be configured as a source from where multicast packets originate.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface xe1
(config-if)#ip igmp join-group 225.1.1.1 source 1.1.1.2
(config-if)#no ip igmp join-group 225.1.1.1 source 1.1.1.2
ip igmp last-member-query-count
Use this command to set the last-member query-count value. This command applies to interfaces configured for IGMP Layer-3 multicast protocols and IGMP Proxy.
Use the no parameter with this command to return to the default value on an interface.
Command Syntax
ip igmp last-member-query-count <2-7>
no ip igmp last-member-query-count
Parameter
<2-7>
Specify the last member query count value.
Default
The default last member query count value is 2.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface xe1
(config-if)#ip igmp last-member-query-count 3
ip igmp last-member-query-interval
Use this command to configure the frequency at which the router sends IGMP group-specific host query messages. This command applies to interfaces configured for IGMP Layer-3 multicast protocols and IGMP Proxy.
Use the no parameter with this command to set this frequency to the default value.
Command Syntax
ip igmp last-member-query-interval <1000-25500>
no ip igmp last-member-query-interval
Parameter
<1000-25500>
Frequency (in milliseconds) at which IGMP group-specific host query messages are sent.
Default
1000 milliseconds
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following example changes the IGMP group-specific host query message interval to 2 seconds:
#configure terminal
(config)#interface xe1
(config-if)#ip igmp last-member-query-interval 2000
ip igmp limit
Use this command to set the maximum number of group membership states, at either the router level or at the interface level. Once the specified number of group memberships is reached, all further local-memberships are ignored. Optionally, an exception access-list can be configured to specify the group-address(es) to be excluded from being subject to the limit.
This command applies to interfaces configured for IGMP Layer-3 multicast protocols and IGMP Proxy. The limit applies, individually, to each of its constituent interfaces.
Use the no parameter with this command to unset the limit and any specified exception access-list.
Command Syntax
ip igmp limit (<1-2097152> (except WORD |)
ip igmp (vrf NAME) limit(<1-2097152> (except WORD |)
no ip igmp limit
no ip igmp (vrf NAME|) limit
Parameters
vrf
Specify the VRF name.
<1-2097152>
Maximum number of group membership states.
except
Number or name that defines multicast groups that are exempted from being subject to configured limit.
WORD
Standard IP access-list name.
Command Mode
Configure mode and Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
The following example configures an IGMP limit of 100 group-membership states across all interfaces on which IGMP is enabled, and excludes group 224.1.1.1 from this limitation:
#configure terminal
(config)#access-list 1 permit 224.1.1.1 0.0.0.0
(config)#ip igmp limit 100 except xyz
The following example configures an IGMP limit of 100 group-membership states on eth1:
#configure terminal
(config)#interface xe1
(config-if)#ip igmp limit 100
ip igmp mroute-proxy
Use this command to specify the IGMP Proxy service (upstream host-side) interface with which to be associated. IGMP router-side protocol operation is enabled only when the specified upstream proxy-service interface is functional.
Note: This command should not be used when configuring interfaces enabled for IGMP in association with a multicast routing protocol, otherwise the behavior will be undefined.
Use the no parameter with this command to remove the association with the proxy-service interface.
Command Syntax
ip igmp mroute-proxy IFNAME
no ip igmp mroute-proxy
Parameter
IFNAME
Specify an interface name.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following example configures the eth1 interface as the upstream proxy-service interface for the downstream router-side interface, eth1.
#configure terminal
(config)#interface xe1
(config-if)#ip igmp mroute-proxy xe1
ip igmp offlink
Use this command to configure off-link for IGMP.
Use the no parameter with this command to remove this configuration.
Command Syntax
ip igmp offlink
no ip igmp offlink
Parameter
None
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface eth1
(config-if)#ip igmp offlink
(config-if)#no ip igmp offlink
ip igmp proxy-service
Use this command to designate an interface to be the IGMP proxy-service (upstream host-side) interface, thus enabling IGMP host-side protocol operation on this interface. All associated downstream router-side interfaces will have their memberships consolidated on this interface, according to IGMP host-side functionality.
Note: This command should not be used when configuring interfaces enabled for IGMP in association with a multicast-routing protocol, otherwise the behavior will be undefined.
Use the no parameter with this command to remove the designation of the interface as an upstream proxy-service interface.
Command Syntax
ip igmp proxy-service
no ip igmp proxy-service
Parameter
None
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following example designates the eth1 interface as the upstream proxy-service interface.
#configure terminal
(config)#interface eth1
(config-if)#ip igmp proxy-service
ip igmp proxy unsolicited-report-interval
Use this command to set an unsolicited report interval for an interface designated as an IGMP proxy (upstream host-side).
Use the no parameter with this command to remove the unsolicited report interval from the interface.
Command Syntax
ip igmp proxy unsolicited-report-interval <1000-25500>
no ip igmp proxy unsolicited-report-interval
Parameter
<1000-25500>
Specify an unsolicited report interval value in milliseconds.
Default
1000 milliseconds
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface xe1
(config-if)#ip igmp proxy unsolicited-report-interval 1234
(config-if)#no ip igmp proxy unsolicited-report-interval
ip igmp querier-timeout
Use this command to set the timeout period before the router takes over as the querier for the interface after the previous querier has stopped querying. This command applies to interfaces configured for IGMP Layer-3 multicast protocols and IGMP Proxy.
To restore the default value, use the no parameter with this command.
Command Syntax
ip igmp querier-timeout <60-300>
no ip igmp querier-timeout
Parameter
<60-300>
Number of seconds that the router waits after the previous querier has stopped querying before it takes over as the querier.
Default
255 seconds
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following example configures the router to wait 120 seconds from the time it received the last query before it takes over as the querier for the interface:
#configure terminal
(config)#interface xe1
(config-if)#ip igmp querier-timeout 120
ip igmp query-interval
Use this command to set the frequency of sending IGMP host query messages. This command applies to interfaces configured for IGMP Layer-3 multicast protocols and IGMP Proxy.
To return to the default frequency, use the no parameter with this command.
Note: Querier timeout changes by changing query interval.
Command Syntax
ip igmp query-interval <1-18000>
no ip igmp query-interval
Parameter
<1-18000>
Frequency (in seconds) at which IGMP host query messages are sent.
Default
Default query interval is 125 seconds.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following example changes the frequency of sending IGMP host-query messages to 2 minutes:
#configure terminal
(config)#interface xe1
(config-if)#ip igmp query-interval 120
ip igmp query-max-response-time
Use this command to set the maximum response time advertised in IGMP queries. This command applies to interfaces configured for IGMP Layer-3 multicast protocols and IGMP Proxy.
Use the no parameter with this command to restore the default value.
Command Syntax
ip igmp query-max-response-time <1-240>
no ip igmp query-max-response-time
Parameter
<1-240>
Maximum response time (in seconds) advertised in IGMP queries.
Default
10 seconds
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following example configures a maximum response time of 8 seconds:
#configure terminal
(config)#interface xe1
(config-if)#ip igmp query-max-response-time 8
ip igmp ra-option
Use this command to configure strict RA (Router Advertisement) validation for IGMP.
Use the no parameter with this command to restore the default value.
Command Syntax
ip igmp ra-option
no ip igmp ra-option
Parameter
None
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following example configures a maximum response time of 8 seconds:
#configure terminal
(config)#interface xe1
(config-if)#ip igmp ra-option
(config-if)#no ip igmp ra-option
ip igmp robustness-variable
Use this command to set the robustness variable value on an interface. This command applies to interfaces configured for IGMP Layer-3 multicast protocols and IGMP Proxy.
To return to the default value on an interface, use the no parameter with this command.
Command Syntax
ip igmp robustness-variable <2-7>
no ip igmp robustness-variable
Parameter
<2-7>
Specify the robustness variable value.
Default
Default robustness variable value is 2.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface xe1
(config-if)#ip igmp robustness-variable 3
ip igmp ssm-map enable
Use this command to enable SSM mapping on the router. This command applies to interfaces configured for IGMP Layer-3 multicast protocols and IGMP Proxy.
Use the no parameter with this command to disable SSM mapping.
Command Syntax
ip igmp ssm-map enable
ip igmp (vrf NAME|) ssm-map enable
no ip igmp ssm-map enable
no ip igmp (vrf NAME|) ssm-map enable
Parameter
vrf
Specify the VRF name.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
This example shows how to configure SSM mapping on the router.
#configure terminal
(config)#ip igmp ssm-map enable
ip igmp ssm-map static
Use this command to specify the static mode of defining SSM mapping. SSM mapping statically assigns sources to IGMPv1 and IGMPv2 groups to translate such (*,G) groups’ memberships to (S,G) memberships for use with PIM-SSM. This command applies to interfaces configured for IGMP Layer-3 multicast protocols and IGMP Proxy.
Use the no parameter with this command to remove the SSM map association.
Command Syntax
ip igmp ssm-map static WORD A.B.C.D
ip igmp (vrf NAME|) ssm-map static WORD A.B.C.D
no ip igmp (vrf NAME|) ssm-map static WORD A.B.C.D
no ip igmp ssm-map static WORD A.B.C.D
Parameters
vrf
Specify the VRF name.
WORD
Standard IP access-list name.
A.B.C.D
Source address to use for static map group.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
This example shows how to configure an SSM static mapping for group-address 224.1.1.1
Note: access-list can only be a permit type access-list
#configure terminal
(config)# ip igmp ssm-map static xyz 1.2.3.4
(config)# access-list 1 permit 224.1.1.1 0.0.0.255
ip igmp static-group
Use this command to statically configure group membership entries on an interface. To statically add only a group membership, do not specify any parameters. This command applies to IGMP operation on a specific interface to statically add group and/or source records; on a VLAN interface to statically add group and/or source records.
Use the no parameter with this command to delete static group membership entries.
Command Syntax
ip igmp static-group A.B.C.D (source (A.B.C.D|ssm-map)|)
no ip igmp static-group A.B.C.D (source (A.B.C.D|ssm-map)|)
Parameters
A.B.C.D
Standard IP Multicast group address to be configured as a static group member.
source
Static source to be joined.
A.B.C.D
Standard IP source address to be configured as a static source from where multicast packets originate.
ssm-map
Mode of defining SSM mapping. SSM mapping statically assigns sources to IGMPv1 and IGMPv2 groups to translate these (*, G) groups' memberships to (S, G) memberships for use with PIM-SSM.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
The following examples show how to statically add group and/or source records for IGMP:
#configure terminal
(config)#interface xe1
(config-if)#ip igmp static-group 226.1.2.3
#configure terminal
(config)#interface xe1
(config-if)#ip igmp static-group 226.1.2.4 source 1.2.3.4
#configure terminal
(config)#interface xe1
(config-if)#ip igmp static-group 226.1.2.5 source ssm-map
ip igmp startup-query-count
Use this command to set a startup query count for IGMP.
Use the no parameter with this command to return to the default version.
Command Syntax
ip igmp startup-query-count <2-10>
no ip igmp startup-query-count
Parameters
<2-10>
Specify a startup query count value.
Default
The default value 2.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface xe1
(config-if)#ip igmp startup-query-count 2
(config-if)#no ip igmp startup-query-count
ip igmp startup-query-interval
Use this command to set a query interval value for IGMP.
Use the no parameter with this command to return to the default version.
Command Syntax
ip igmp startup-query-interval <1-18000>
no ip igmp startup-query-interval
Parameters
<1-18000>
Specify a startup query interval value in seconds.
Default
The default value 31 seconds.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface xe1
(config-if)#ip igmp startup-query-interval 1
(config-if)#no ip igmp startup-query-interval
ip igmp version
Use this command to set the current IGMP protocol version on an interface. This command applies to interfaces configured for IGMP Layer-3 multicast protocols and IGMP Proxy.
Use the no parameter with this command to return to the default version.
Command Syntax
ip igmp version <1-3>
no ip igmp version
Parameters
<1-3>
Specify IGMP protocol version number.
Default
The default IGMP protocol version number is 3.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface xe1
(config-if)#ip igmp version 2
show debugging ip igmp
Use this command to display the status of the debugging of the IGMP system, or a specific VRF in the IGMP system.
Command Syntax
show debugging ip igmp
show debugging ip igmp (vrf NAME|)
Parameters
vrf
Specify the VRF name.
Command Mode
Exec and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#show debugging ip igmp
IGMP Debugging status:
IGMP Decoder debugging is on
IGMP Encoder debugging is on
IGMP Events debugging is on
IGMP FSM debugging is on
IGMP Tree-Info-Base (TIB) debugging is on
show ip igmp groups
Use this command to display the multicast groups with receivers connected to the router and learned through IGMP.
Command Syntax
show ip igmp groups (detail|)
show ip igmp groups A.B.C.D (detail|)
show ip igmp groups IFNAME (detail|)
show ip igmp groups IFNAME A.B.C.D (detail|)
show ip igmp (vrf NAME|) groups (detail|)
show ip igmp (vrf NAME|) groups A.B.C.D (detail|)
show ip igmp (vrf NAME|) groups IFNAME (detail|)
show ip igmp (vrf NAME|) groups IFNAME A.B.C.D (detail|)
Parameters
vrf
Specify the VRF name.
A.B.C.D
Address of multicast group.
IFNAME
Name of the interface.
detail
IGMPv3 source information.
Command Mode
Exec and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
The following command displays local-membership information for all interfaces:
rtr1#show ip igmp groups detail
IGMP Connected Group Membership Details
Flags: (M - SSM Mapping, R - Remote, L - Local,
SG - Static Group, SS - Static Source)
Interface: eth1
Group: 224.1.1.1
Flags: L
Uptime: 00:00:04
Group mode: Exclude (Expires: 00:04:15, Static)
Last reporter: 3.3.3.3
Group source list: (R - Remote, M - SSM Mapping, S - Static, L - Local)
Include Source List :
Source Address Uptime v3 Exp Fwd Flags
2.2.2.2 00:00:04 stopped Yes L
Table 1-3 shows the flags codes displayed at the start of a group entry.
Table 1-3: Flags
Flag | Meaning |
|---|
M | Source Specific Multicast |
R | Remote multicast |
L | Local multicast |
SG | Static Group |
SS | Static Source |
Table 1-4 explains the output fields.
Table 1-4: show ip igmp groups output
Entry | Description |
|---|
Interface | The interface on which multicast is operating. |
Group | The Multicast group, identified by a multicast IP address. |
Flags | Flag on this interface – in this case, the flag indicates that the multicast is Local. See Table 1-3. |
Uptime | The amount of time that the multicast connection has been up. |
Group mode | The group mode is determined by interactions between IGMP router database entries, which is beyond the scope of this document. For a detailed description of these interactions, see RFC 3376. |
Last reporter | The IPv4 address of the last host to send multicast information. |
Group source list | A list of flags that indicate the state of the multicast connections. See Table 1-3. |
Include Source List | A table containing parameters about the multicast session: • Source Address – The IP address of the Source(s) connected to the multicast hosts. • Uptime – The multicast session’s uptime. • v3 Exp – Tells whether IGMPv3 Explicit Tracking is running or not. • Fwd – Whether IGMP information is being forwarded by this device. |
show ip igmp interface
Use this command to display the state of IGMP, IGMP Proxy service for a specified interface, or all interfaces.
Command Syntax
show ip igmp interface (IFNAME|)
show ip igmp (vrf NAME|) interface (IFNAME|)
Parameters
vrf
Specify the VRF name.
interface
Specify the interface parameter.
IFNAME
Specify the name of the interface.
Command Mode
Exec and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following command displays the IGMP interface status on all interfaces enabled for IGMP.
#show ip igmp interface
Interface vlan1.1 (Index 4294967295)
IGMP Active, Non-Querier, Version 3 (default)
IGMP querying router is 0.0.0.0
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|
#
Table 1-5 explains the output fields.
Table 1-5: show ip igmp interface
Entry | Description |
|---|
Interface | Interface type and number |
IGMP Active | IGMP status – whether Active or Inactive; whether this interface is a querier; IGMP version (v1, v2, or v3). |
IGMP querying router | IP address of the designated router for this LAN segment. |
IGMP query interval | Interval at which the Cisco IOS software sends Protocol Independent Multicast (PIM) router query messages. |
IGMP querier timeout | An interval of time that the software uses when deciding to take over as the querier. |
IGMP max query response time | An interval of time that is advertised as the maximum response time that is advertised in IGMP queries. |
Last member query response interval | This interval is the maximum amount of time between query messages that the querier will wait before sending messages that indicate that the multicast session has ended. |
Group Membership interval | A group membership interval timer is maintained for each dynamic multicast group added to a downstream interface in the table. The timer is refreshed when a membership report for a multicast group is received. If the timer expires, the multicast group is removed from the table. |
show ip igmp proxy
Use this command to display the state of IGMP Proxy services for a specified interface or for all interfaces.
Command Syntax
show ip igmp proxy groups (detail|)
show ip igmp proxy groups A.B.C.D (detail|)
show ip igmp proxy groups IFNAME (detail|)
show ip igmp proxy groups IFNAME A.B.C.D (detail|)
show ip igmp (vrf NAME|) proxy groups (detail|)
show ip igmp (vrf NAME|) proxy groups A.B.C.D (detail|)
show ip igmp (vrf NAME|) proxy groups IFNAME (detail|)
show ip igmp (vrf NAME|) proxy groups IFNAME A.B.C.D (detail|)
Parameters
vrf
Specify the VRF name.
groups
IGMP proxy group membership information.
A.B.C.D
Address of multicast group.
IFNAME
The name of the VLAN interface.
detail
IGMPv3 source information
Command Mode
Exec and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show ip igmp proxy
Interface eth2 (Index 4)
Administrative status: enabled
Operational status: up
Upstream interface is eth1
Number of multicast groups: 1
#show ip igmp proxy groups
IGMP Connected Proxy Group Membership
Group Address Interface State Member state
224.0.1.3 eth1 Active Delay
Table 1-6 explains the output fields.
Table 1-6: show ip igmp proxy output
Entry | Description |
|---|
Interface | Interface and Index of the interface. |
Administrative status | Depends on the interface states – Enabled only if both host and downstream interfaces are up. Otherwise, Disabled if only one interface is up. |
Operational status | Depends on Administrative status – either Up or Down depending on Administrative status of corresponding interfaces. |
Upstream interface | As stated. |
Number of multicast groups | The number of multicast groups supported by this proxy. |
Table 1-7 explains the output fields.
Table 1-7: show ip igmp proxy groups output
Entry | Description |
|---|
Group Address | Multicast address associated with each group. |
Interface | Interface name, such as eth1, xe3/1, etc.. |
State | The state of the proxy group – can be either Active or Inactive. |
Member state | The state of the proxy group member – can be either Idle or Delay, Idle is the default state. |
show ip igmp ssm-map
Use this command to display IGMP SSM-map data.
Command Syntax
show ip igmp ssm-map
show ip igmp ssm-map A.B.C.D
show ip igmp (vrf NAME|) ssm-map
show ip igmp (vrf NAME|) ssm-map A.B.C.D
Parameters
vrf
Specify the VRF name.
A.B.C.D
Address of multicast group.
Command Mode
Exec and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#sh ip igmp ssm-map
SSM Mapping : Enabled
Database : Static mappings configured
show running-config interface igmp
Use this command to show the running system status and configuration for IGMP.
Command Syntax
show running-config interface IFNAME ip igmp
Parameters
IFNAME
Interface name.
Command Mode
Privileged Exec mode and Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show running-config interface eth1 ip igmp
!
interface eth1
!