display igmp routing-table

Function

The display igmp routing-table command displays information about the IGMP routing table.

Format

display igmp [ vpn-instance vpn-instance-name | all-instance ] routing-table [ group-address [ mask { group-mask | group-mask-length } ] | source-address [ mask { source-mask | source-mask-length } ] ] ^* [ static ] [ outgoing-interface-number [ number ] ]

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Specifies the name of a VPN instance.	The value is a string of 1 to 31 case-sensitive characters.
all-instance	Indicates all instances.	-
group-address	Specifies a multicast group address. It is used to specify a multicast group and display its routing table.	The address is in dotted decimal notation, ranging from 224.0.0.0 to 239.255.255.255.
mask	Indicates the mask of a multicast group address or a multicast source address. mask uniquely identifies a multicast group address.	-
group-mask	Specifies the mask of a multicast group address.	It is in dotted decimal notation.
group-mask-length	Specifies the mask length of a multicast group address.	It is an integer ranging from 4 to 32.
source-address	Specifies a multicast source address. It is used to specify a multicast source and display its routing table.	The address is in dotted decimal notation.
source-mask	Specifies the mask of a multicast source address.	It is in dotted decimal notation.
source-mask-length	Specifies the mask length of a multicast source address.	It is an integer ranging from 0 to 32.
static	Displays the IGMP routing table of the multicast group to which an interface is statically joined.	-
outgoing-interface-number	Displays the number of the outgoing interfaces of IGMP routing entries.	-
number	Specifies the number of outgoing interfaces.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If you need to know information about an IGMP routing table, run the display igmp routing-table command. You can specify different parameters in this command to view specific routing information. This command helps you to search for specific routes and locate faults.

There are two types of IGMP routing entries: (S, G) entries and (*, G) entries. In an (S, G) entry, S indicates a multicast source address, and G indicates a multicast group address. In a (*, G) entry, * indicates any multicast source, and G indicates a multicast group address. Both types of entries contain downstream interface lists. The downstream interfaces connect to the receivers of multicast data.

When the display igmp routing-table command is used, note the following:

If neither vpn-instance nor all-instance is specified, only the IGMP routing entries in the public network instance are displayed.
If group-address is specified, only the IGMP routing entries related to the specified multicast group are displayed.
If source-address is specified, only the IGMP routing entries related to the specified multicast source are displayed.
If static is specified, only the IGMP routing entries generated when the interfaces are statically joined to multicast groups are displayed.
If outgoing-interface-number is specified, the number of the outgoing interfaces of IGMP routing entries is displayed.
If number is specified, only information about a specified number of outgoing interfaces is displayed.

Example

# Display the entry about the specified multicast group in the IGMP routing table of the public network instance.

<sysname> display igmp routing-table
Routing table of VPN-Instance: public net
 Total 1 entry

 00001. (*, 225.1.1.1)
       List of 1 downstream interface
        GigabitEthernet0/0/0 (10.0.0.1),
                   Protocol: IGMP

**Table 1** Description of the display igmp routing-table command output
Item	Description
Routing table of VPN-Instance	Indicates the VPN instance to which the IGMP routing table belongs.
Total 1 entry	Indicates the total number of IGMP routing entries.
00001. (*, 225.1.1.1)	Indicates No. 00001 (*, G) entry.
List of 1 downstream interface	Indicates the number of downstream interfaces.
GigabitEthernet0/0/0 (10.0.0.1)	Indicates the interface number (IP address).
Protocol	Indicates that the protocol is IGMP or static multicast groups are used. IGMP: After you run the igmp enable command to enable IGMP, the field is displayed as IGMP. static: After you run the igmp static-group command to configure static multicast groups, the field is displayed as static.

# Display the number of outgoing interfaces of IGMP routing entries in the public network instance.

<sysname> display igmp routing-table outgoing-interface-number
Routing table of VPN-Instance: public net
 Total 2 entries

 00001. (*, 225.1.1.1)
       List of 2048 downstream interfaces

 00002. (*, 225.1.1.2)
       List of 2048 downstream interfaces

**Table 2** Description of the display igmp routing-table outgoing-interface-number command output
Item	Description
Total 2 entries	Indicates the number of IGMP routing entries.
List of 2048 downstream interfaces	Indicates the number of downstream interfaces of IGMP routing entries.

# Display the number of outgoing interfaces of IGMP static routing entries in the public network instance.

<sysname> display igmp routing-table static outgoing-interface-number

Static routing table of VPN-Instance: public net

 Total 1 entry

 00001. (192.168.1.1, 225.1.1.2)
       List of 1 downstream interface

**Table 3** Description of the display igmp routing-table static outgoing-interface-number command output
Item	Description
Static routing table of VPN-Instance	Indicates the VPN instance to which information about the IGMP static routing entries belongs.
00001. (192.168.1.1, 225.1.1.2)	Indicates the (S, G) entry ID.
List of 1 downstream interface	Indicates the number of outgoing interfaces of IGMP static routing entries.