Function
This command is used to query the information about the multicast user. To
query information such as which multicast users are online or which multicast
users are blocked, run this command.
Format
To query the information about the blocked users:
display igmp user block { all | smart-vlan vlanid | slot frameid/slotid }
To query a list of users with the forbidden, preview, or watch right:
display igmp user program { ip ip-addr vlan vlanid [ sourceip ip-addr ] | name name } {forbidden | preview | watch }
To query the information about a specified multicast user:
display igmp user { port frameid/slotid/portid [ gemport gemport-id ] | slot frameid/slotid } | smart-vlan vlanid | all | number }
display igmp user service-port index
To query the information about a specified online multicast user:
display igmp user online { all | smart-vlan vlanid | slot frameid/slotid | active-program { ip ip-addr vlan vlanid [ sourceip ip-addr ] | name name } }
To query the information about the right profile bound to a specified multicast user:
display igmp user { profile-name profile-name | profile-index profile-index }
display igmp user block { all | smart-vlan vlanid | slot frameid/slotid }
To query a list of users with the forbidden, preview, or watch right:
display igmp user program { ip ip-addr vlan vlanid [ sourceip ip-addr ] | name name } {forbidden | preview | watch }
To query the information about a specified multicast user:
display igmp user { port frameid/slotid/portid [ gemport gemport-id ] | slot frameid/slotid } | smart-vlan vlanid | all | number }
display igmp user service-port index
To query the information about a specified online multicast user:
display igmp user online { all | smart-vlan vlanid | slot frameid/slotid | active-program { ip ip-addr vlan vlanid [ sourceip ip-addr ] | name name } }
To query the information about the right profile bound to a specified multicast user:
display igmp user { profile-name profile-name | profile-index profile-index }
Parameters
| Parameter | Description | Value |
|---|---|---|
| block | Indicates the blocked multicast user. To query the information about the blocked multicast user, use this parameter. | - |
| all | Indicates the information about all multicast users. | - |
| smart-vlan vlanid | Indicates the VLAN ID. This VLAN ID corresponds to the service VLAN ID of the service port that is created by running the service-port(profile mode) command. To query the information about all multicast users in a specified service VLAN, use this parameter. | Numeral type. Range: 1-4093. |
| service-port index | Indicates the service port ID. To query the information about the multicast user corresponding to a service port, use this parameter. | |
| slot frameid/slotid | Indicates the subrack ID and slot ID. Enter a slash (/) between the subrack and slot IDs. To query the information about the multicast user of a specified board, use this parameter. | Please see Differences Between Shelves. |
| program | Indicates the program information. To query the information about the multicast user that meets the condition based on the program attribute, use this parameter. | - |
| ip ip-addr | Indicates the IP address of the program. It is used with the vlan vlanid parameter to uniquely specify a program in a multicast VLAN (MVLAN). | Dotted decimal notation. Range: 224.0.1.0-239.255.255.255. |
| vlan vlanid | Indicates the MVLAN ID. It is used with the ip ip-addr parameter to uniquely specify a program in an MVLAN. | Numeral type. Range: 1-4093. |
| sourceip ip-addr |
Indicates the multicast source IP address. When "IP address + MVLAN
+ Multicast source IP address" is used to identify a multicast program, use this
parameter.
NOTE:
|
IPv4 address format. Dotted decimal notation. |
| name name | Indicates the program name. To query the information about the multicast user that meets the condition based on the program name, use this parameter. | Character string type, a string of 1-16 characters. |
| forbidden |
Indicates the forbidden right. To query the information about the
authorized multicast user that is forbidden to watch a specified program, use
this parameter.
NOTE:
When a user is bound to multiple right profiles, use the right priority to
check whether the user has the right. Run the igmp right-priority command to set
the right priority (watch, preview, forbid, and idle) of a user in the right
profile.
|
- |
| preview |
Indicates the preview right. To query the information about the
authorized multicast user that has the right to preview a specified program, use
this parameter.
NOTE:
When a user is bound to multiple right profiles, use the right priority to
check whether the user has the right. Run the igmp right-priority command to set
the right priority (watch, preview, forbid, and idle) of a user in the right
profile.
|
- |
| watch |
Indicates the watch right. To query the information about the
authorized multicast user that has the right to watch a specified program, use
this parameter.
NOTE:
When a user is bound to multiple right profiles, use the right priority to
check whether the user has the right. Run the igmp right-priority command to set
the right priority (watch, preview, forbid, and idle) of a user in the right
profile.
|
- |
| online | Indicates the online multicast user. To query the information about an online user, use this parameter. | - |
| active-program | Indicates the program that is being watched. To query the information about the multicast user that is watching a specified program, use this parameter. | - |
| port frameid/slotid/portid | Indicates the subrack ID, slot ID, and port ID. Enter a slash (/) between the subrack, slot, and port IDs. To query the information about the multicast user of a specified port, use this parameter. | Please see Differences Between Shelves. |
| gemport gemport-id | GEM port number. GEM ports of each PON port are numbered in a centralized way. GEM ports 0-127 are reserved for the private use of OMCI and GEM ports 4000-4095 serve as channels for special use. To specify a multicast user corresponding to the ONT of the PON port, use this parameter. | Numeral type. Range: 128-3999. |
| profile-index index | Indicates the right profile index. To query the information about the multicast user that is bound to the right profile with a specified index, use this parameter. | Numeral type. Range: 0-1999. |
| number | Indicates the number of multicast users. To query the number of multicast users, use this parameter. The system displays the total number of multicast users and the number of online multicast users. | - |
| profile-name name | Indicates the name of the right profile. To query the information about the multicast user that is bound to the right profile with a specified name, use this parameter. | Character string type, a string of 1-16 characters. |
Modes
Privilege mode, BTV mode, MVLAN mode
Level
Operator level
Usage Guidelines
- Run the config command to enter the global config mode, and then run the btv command to enter the BTV mode.
- Run the config command to enter the global config mode, and then run the multicast-vlan command to enter the MVLAN mode. Or, in the BTV mode, run the multicast-vlan command to enter the MVLAN mode.
- In the case of an IPv6 address, only the last 15 characters are displayed.
- If a distributed board is not in the normal state, you cannot query the result on the board using the display igmp user program command.
Example
To query the information about all multicast users, do as follows:
huawei#display igmp user all
Command is being executed. Please wait...
------------------------------------------------------------------------------
User port Bind State Auth Quick IGMP Video Log Available
profiles leave flow ID flow ID switch programs
------------------------------------------------------------------------------
0/3/0 - offline no-auth MAC-based 10 10 enable 8
------------------------------------------------------------------------------
Total: 1
To query the information about all online multicast users, do as follows:huawei(config)#display igmp user online all
Command is being executed. Please wait...
------------------------------------------------------------------------------
User port Bind State Auth Quick IGMP Video Log Available
profiles leave flow ID flow ID switch programs
------------------------------------------------------------------------------
0/1/7 - online no-auth MAC-based 1 1 enable 32
------------------------------------------------------------------------------
Total: 1
To query the details of the multicast user of service port 500, do as
follows:huawei#display igmp user service-port 500
User : 0/3/0/500
State : online
Authentication : auth
Quick leave : MAC-based
IGMP flow ID : 500
Video flow ID : 500
Log switch : enable
Bind profiles : 2
IGMP version : IGMP v3
Current version : IGMP v3
IGMP IPv6 version : IGMP IPv6 v2
Current IGMP IPv6 version : IGMP IPv6 v2
Available programs : 10
Global leave : disable
User max bandwidth : no-limit
Used bandwidth(kbps) : 0
Used bandwidth
to max bandwidth(%) : -
Total video bandwidth : -
Mcast video bandwidth : -
Reserved unicast
bandwidth(kbps) : 5000
Information of latest watched video
----------------------------------------------------------
Time : 2011-03-15 02:02:38+08:00
VLAN : 8
Group address : 228.0.0.1
Source address : 2.0.0.1
----------------------------------------------------------
Bound profile list
---------------------------------------------
Index Profile name Program number
---------------------------------------------
0 profile0 2
1 Profile1 8
---------------------------------------------
Total: 2
Active program list
---------------------------------------------------------------------------
Program name VLAN IP/MAC State Start time
---------------------------------------------------------------------------
PROGRAM-0 8 228.0.0.1 watching 2011-03-15
16:02:38+08:00
PROGRAM-1 8 228.0.0.2 watching 2011-03-15
16:02:38+08:00
PROGRAM-2 8 228.0.0.3 watching 2011-03-15
16:02:38+08:00
PROGRAM-3 8 228.0.0.4 watching 2011-03-15
16:02:38+08:00
PROGRAM-4 8 228.0.0.5 watching 2011-03-15
16:02:38+08:00
PROGRAM-5 8 228.0.0.6 watching 2011-03-15
16:02:38+08:00
PROGRAM-6 8 228.0.0.7 watching 2011-03-15
16:02:38+08:00
PROGRAM-7 8 228.0.0.8 watching 2011-03-15
16:02:38+08:00
PROGRAM-8 8 228.0.0.9 watching 2011-03-15
16:02:38+08:00
PROGRAM-9 8 228.0.0.10 watching 2011-03-15
16:02:38+08:00
---------------------------------------------------------------------------
Total: 10
System Response
- The system displays the queried result when the command runs successfully.
More blog:
