display ip address-set

Function

The display ip address-set command displays address objects or address groups.

The display ip address-set verbose command displays detailed information about specified address objects or address groups.

The display ip address-set address command displays information about the address object or address group that contains a specified IPv4 address, IPv6 address, or MAC address.

Format

display ip address-set { all | type { object | group } } [ vpn-instance vpn-instance-name | public ]

display ip address-set verbose address-set-name { item | reference } [ type { object | group } ] [ vpn-instance vpn-instance-name | public ]

display ip address-set address { ipv4-address | ipv6-address | mac-address }

Parameters

Parameter	Description	Value
all	Displays information about all address sets.	-
type	Displays information about address sets based on types.	-
object	Displays information about the address sets whose types are object.	-
group	Displays information about the address sets whose types are group.	-
vpn-instance vpn-instance-name	Specifies the name of a VPN instance. If this parameter is specified, rename the address set of the specified VPN instance.	It is the name of an existing VPN instance.
public	Displays information about the address sets that belong to the public VPN instance.	-
address-set-name	Specifies the name of an address set whose detailed information is to be displayed.	It is the name of an existing address object or address group.
item	Displays information about items in the address set.	-
reference	Displays information about the address set being referred to by other features.	-
address ipv4-address	Displays information about the address object or address group that contains a specified IPv4 address.	The value is in dotted decimal notation.
address ipv6-address	Displays information about the address object or address group that contains a specified IPv6 address.	The value is a 32-bit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
address mac-address	Displays information about the address object or address group that contains a specified MAC address. All models except USG6680E and USG6712E/6716E support this parameter.	The MAC address can be in one of the following formats: H-H-H (An H is a 4-bit hexadecimal number, such as 00e0 and fc01. If an H contains less than four bits, it means that the first bits contained in the H are 0s. For example, if an H is e0, it is equal to 00e0.) XX:XX:XX:XX:XX:XX (An X is a 1-bit hexadecimal number.) XX-XX-XX-XX-XX-XX (X is a 1-bit hexadecimal number.)

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display information about all addresses and address sets.

<sysname> display ip address-set all
Object address-set maximum number(s): 30000                                     
Group address-set maximum number(s): 1024                                        
Address-set total number(s): 4                                                  
Address-set item total number(s): 10                                            
Address-set reference total number(s): 2                                        
                                                                                
Address-set: addr_group_0001                                                    
Type: group                                                                     
Item number(s): 2                                                               
Reference number(s): 0                                                          
                                                                                
Address-set: addr_group_0002                                                    
Type: group                                                                     
Item number(s): 0                                                               
Reference number(s): 1                                                          
                                                                                
Address-set: addr_0001                                                          
Type: object                                                                    
Item number(s): 5                                                               
Reference number(s): 0                                                          
                                                                                
Address-set: addr_0002                                                          
Type: object                                                                    
Item number(s): 3                                                               
Reference number(s): 1

# Display detailed information about items in address set addset.

<sysname> display ip address-set verbose addset item
Address-set: addset
Type: group
Item number(s): 1
Reference number(s): 0
Item(s):
 address 0 range 10.1.1.1 10.1.1.10

# Display detailed information about address set abc being referenced.

<sysname> display ip address-set verbose abc reference
Address-set: abc
Type: group
Item number(s): 0
Reference number(s): 1
Reference(s) by acl: 
Reference(s) by address-set: 
Reference(s) by policy: 
POLICY NAME          CONDITION TYPE          RULE NAME 
------------------------------------------------------------------------------- 
sec-policy           source-address          1 
-------------------------------------------------------------------------------

**Table 1** Description of the **display ip address-set** command output
Item	Description
Object address-set maximum number(s)	Maximum number of address objects
Group address-set maximum number(s)	Maximum number of address groups
Address-set total number(s)	Total number of address objects and address groups.
Address-set item total number(s)	Total number of members in address objects and address groups.
Address-set reference total number(s)	Total number of references of address objects and address groups.
Address-set	Name of an address object or address group
Type	Type: group: indicates an address group object: indicates an address object
Item number(s)	Number of items in the address object or address group
Reference number(s)	Number of the address object or address group being referenced
Item(s)	Detailed information about items in the address object or address group

# Display information about the address object or address group that contains IP address 2.2.2.2.

<sysname> display ip address-set address 2.2.2.2
NAME            TYPE                              ITEM            REF        VPN-INSTANCE                                                       
------------------------------------------------------------------------------------------                                                                      
g2              group                             1               0                                                                 
bin             object                            2               0                                                                 
------------------------------------------------------------------------------------------

**Table 2** Description of the **display ip address-set address** command output
Item	Description
NAME	Name of an address object or address group
TYPE	Type: group: indicates an address group object: indicates an address object
ITEM	Number of items in the address object or address group
REF	Number of the address object or address group being referenced
VPN-INSTANCE	VPN instance to which an address object or address group belongs