display ucl-group ip domain

Function

The display ucl-group ip domain command displays information about IP addresses and domain names of static UCL groups.

This command is supported only on the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731S-H, S5731-S, S5731S-S, S6720-HI, S5732-H, S6730-H, S6730S-H, S6730-S, S6730S-S, S6720-EI, and S6720S-EI.

Format

display ucl-group ip ip-address { mask-length | ip-mask }

display ucl-group ip { group-index | name group-name | static | local-access-user | push | escape | all } [ verbose ]

display ucl-group domain domain-name domain-name

display ucl-group ip domain-ip [ verbose ]

Only the S5720-HI, S5730-HI, S5731-H, S5731S-H, S6720-HI, S5732-H, S6730-H, S6730S-H, and S6730S-HI support domain names in static UCL groups.

Parameters

Parameter	Description	Value
ip-address	Displays information about the static UCL group with a specified IP address.	The value must be the IP address of an existing static UCL group.
mask-length	Specifies the mask length of an IP address.	The value must be the IP address mask length of an existing static UCL group.
ip-mask	Specifies the mask of the IP address.	The value must be the IP address mask of an existing static UCL group.
group-index	Displays information about the static UCL group with a specified index.	The value must be the index of an existing static UCL group.
name group-name	Displays information about the static UCL group with a specified name.	The value must be the name of an existing static UCL group.
static	Displays information about static UCL groups.	-
local-access-user	Displays information about dynamic UCL groups.	-
push	Displays information about pushed UCL groups.	-
escape	Displays information about escape UCL groups.	-
all	Displays information about all static UCL groups.	-
domain-name domain-name	Displays information about the static UCL group with a specified domain name.	The value must be an existing domain name on the device.
domain-ip	Displays information about IP addresses generated based on domain names in UCL groups.	-
verbose	Displays detailed information about static UCL groups.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can view UCL groups' IP addresses that are manually added (using the ucl-group ip command) and dynamically generated when users go online and are granted UCL groups. When a user goes online successfully, the device grants a UCL group to the user and adds the user's IP address (with a 32-bit mask) to the UCL group. When the user goes offline or the user's IP address changes, the device deletes the corresponding IP address from the UCL group.

Example

# Display IP address information of all UCL groups.

<HUAWEI> display ucl-group ip all
L: local-access-user, P: push, S: static, D: domain, E: escape                                             
IP/Mask              ID    UCL group name                   Type                
--------------------------------------------------------------------------------
10.9.9.4/32          1     g1                               S                   
10.10.0.0/16         2     g2                               S                   
10.9.9.6/32          1     g1                               L                   
--------------------------------------------------------------------------------
Total : 3        Local-access-user : 1        Push : 0     Static : 2        Domain : 0        Escape : 0

# Display detailed information about all static UCL groups.

<HUAWEI> display ucl-group ip static verbose
--------------------------------------------------------------------------------                                                    
IP/Mask              : 10.9.9.4/32                                                                                                 
UCL group ID         : 1                                                                                                           
UCL group name       : g1                                                                                                           
Type                 : static                                                                                                       
Status on slot 0     : Success                                                                                                      
                                                                                                                                    
IP/Mask              : 10.10.0.0/16                                                                                                  
UCL group ID         : 2                                                                                                           
UCL group name       : g2                                                                                                           
Type                 : static                                                                                                       
Status on slot 0     : Success                                                                                                      
--------------------------------------------------------------------------------                                                    
Total : 2        Local-access-user : 0        Push : 0     Static : 2        Domain : 0        Escape : 0

# Display domain name information of static UCL groups.

<HUAWEI> display ucl-group domain domain-name example.com
Domain-name      : example.com
UCL group ID     : 1
UCL group name   : g1
------------------------------------------------------------
IP               : 10.9.9.10
IP               : 10.9.9.12
------------------------------------------------------------
Total : 2

# Display information about IP addresses generated based on domain names in all static UCL groups.

<HUAWEI> display ucl-group ip domain-ip
L: local-access-user, P: push, S: static, D: domain, E: escape
IP/Mask              ID    UCL group name                   Type
--------------------------------------------------------------------------------
9.9.9.4/32           1     g1                               D
9.9.9.5/32           1     g1                               D
10.10.0.0/16         2     g2                               D
--------------------------------------------------------------------------------
Total : 3  Local-access-user : 0   Push : 0  Static : 0   Domain : 3  Escape : 0

**Table 1** Description of the **display ucl-group ip** **domain** command output
Item	Description
IP/Mask	IP address and mask of a UCL group.
ID	UCL group index.
UCL group ID	UCL group index.
UCL group name	UCL group name.
Type	UCL group type: Static: static UCL group Local-access-user: UCL group to which local users belong Push: pushed UCL group Escape: escape UCL group Domain: domain name
Domain-name	Domain name.
Status on slot n	UCL group status in slot n.