display multicast-domain vpn-instance switch-group receive
Function
The display multicast-domain vpn-instance switch-group receive command displays the Switch-Group information received by a specified VPN instance.
Format
display multicast-domain vpn-instance vpn-instance-name switch-group receive brief
display multicast-domain vpn-instance vpn-instance-name switch-group receive [ active | group group-address | sender source-address | vpn-source-address [ mask { source-mask-length | source-mask } ] | vpn-group-address [ mask { group-mask-length | group-mask } ] ] *
Parameters
| Parameter | Description | Value |
|---|---|---|
| vpn-instance-name |
Specifies a VPN instance. vpn-instance-name specifies the name of a VPN instance. |
The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string. |
| brief |
Displays the abstract of the received Switch-Group information. |
- |
| active |
Displays the received information about the Switch-Group that joins the Switch-multicast distribution tree (MDT). |
- |
| group group-address |
Displays information about the Switch-Group related to a public network multicast group specified by group-address. group-address specifies the address of the multicast group. |
The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation. |
| sender source-address |
Displays information about the Switch-Group related to a public network multicast source specified by source-address. source-address specifies the address of the multicast source. |
The value is in dotted decimal notation. |
| vpn-source-address |
Displays information about the Switch-Group related to a VPN multicast source specified by vpn-source-address. |
The value is in dotted decimal notation. |
| mask |
Indicates the mask of the VPN multicast group or source address. |
- |
| source-mask-length |
Specifies the mask length of the VPN multicast source address. |
The value is an integer ranging from 0 to 32. |
| source-mask |
Specifies the mask of the VPN multicast source address. |
The value is in dotted decimal notation. |
| vpn-group-address |
Displays information about the Switch-Group related to a VPN multicast group specified by vpn-group-address. |
The value is in dotted decimal notation. |
| group-mask-length |
Specifies the mask length of the VPN multicast group address. |
The value is an integer ranging from 4 to 32. |
| group-mask |
Specifies the mask of the VPN multicast group address. |
The value is in dotted decimal notation. |
Usage Guidelines
Usage Scenario
The display multicast-domain vpn-instance switch-group receive command is used to display the Switch-Group information received by the local device.
Each VPN instance corresponds to one MD. If a VPN instance is specified by vpn-instance-name, an MD is specified accordingly. Therefore, the command can be used to display the information about the Switch-Group of a specified MD.- If brief is specified, the brief information about all Switch-Groups is displayed in an ascending order of the Switch-Group address.
- If active is specified, only the information about the Switch-Group that joins the Switch-MDT is displayed in an ascending order of the VPN (S, G) entry.
- If group is specified, only the information about the Switch-Group related to the public network multicast group is displayed.
- If sender is specified, only the information about the Switch-Group related to the public network multicast source is displayed.
- If vpn-source-address is specified, only the information about the Switch-Group related to the VPN multicast source is displayed.If vpn-group-address is specified, only the information about the Switch-Group related to the VPN multicast group is displayed.
Example
The actual command output varies according to the device. The command output here is only an example.
<HUAWEI> display multicast-domain vpn-instance VPN1 switch-group receive
MD switch-group information received by VPN-Instance: VPN1
Switch group: 226.1.1.0 ref count: 8, active count: 8
Sender: 172.16.1.1 active count: 8
(192.168.1.5, 239.1.1.1)
Up time: 01:20:20 expire time: 00:03:10 active
(192.168.1.5, 239.1.1.158)
Up time: 01:20:20 expire time: 00:03:10 active
(192.168.1.5, 239.1.2.12)
Up time: 01:20:20 expire time: 00:03:10 active
(192.168.1.5, 239.1.2.197)
Up time: 01:20:20 expire time: 00:03:10 active
(192.168.1.5, 239.1.3.62)
Up time: 01:20:20 expire time: 00:03:10 active
(192.168.1.2, 225.1.1.109)
Up time: 01:20:20 expire time: 00:03:10 active
(192.168.1.2, 225.1.4.80)
Up time: 01:20:20 expire time: 00:03:10 active
(192.168.1.2, 225.1.4.173)
Up time: 01:20:20 expire time: 00:03:10 active
| Item | Description |
|---|---|
| MD switch-group information received by VPN-Instance | VPN instance to which the MD Switch-Group belongs. |
| Switch group | Received Switch-Group address. |
| ref count | Number of VPN multicast groups joining the Switch-Group. |
| active count | Number of active VPN multicast groups (with receivers) joining the Switch-Group. |
| Up time | Creation time of switching messages in which the VPN multicast (S, G) entry is referenced by the Switch-group. |
| expire time | Timeout period of switching messages in which the VPN multicast (S, G) entry is referenced by the Switch-group. |
| Sender | BGP peer IP address of the PE that sends the Switch-Group information. |