display ip source binding [ static | [ vpn-instance vpn-instance-name ] [ dhcp-relay | dhcp-server | dot1x ] ] [ ip-address ip-address ] [ mac-address mac-address ] [ vlan vlan-id ] [ interface interface-type interface-number ] [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

static: Displays static IPv4SG bindings.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. To display dynamic IPv4SG bindings for the public network, do not specify a VPN instance.

dhcp-relay: Specifies IPv4SG bindings generated based on DHCP relay agent.

dhcp-server: Specifies IPv4SG bindings generated based on DHCP server.

dot1x: Specifies IPv4SG bindings generated based on 802.1X. To display dynamic IPv4SG bindings generated based on the 802.1X module, you must also specify the slot through which 802.1X users access the network.

ip-address ip-address: Specifies an IPv4 address.

mac-address mac-address: Specifies a MAC address in H-H-H format.

vlan vlan-id: Specifies a VLAN ID in the range of 1 to 4094.

interface interface-type interface-number: Specifies an interface by its type and number.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays IPv4SG bindings for the active MPU.

Examples

# Display all IPSG bindings on the public network.

<Sysname> display ip source binding

Total entries found: 5

IP Address MAC Address Interface VLAN Type

10.1.0.8 040a-0000-1000 GE1/0/2 N/A DHCP relay

10.1.0.9 040a-0000-2000 GE1/0/2 N/A Static

Table 1 Command output

Field	Description
Total entries found	Total number of IPv4SG bindings.
IP Address	IPv4 address in the IPv4SG binding. If no IP address is bound in the binding, this field displays N/A.
MAC Address	MAC address in the IPv4SG binding. If no MAC address is bound in the binding, this field displays N/A.
Interface	Interface of the binding. This field displays N/A for a global IPv4SG binding.
VLAN	VLAN information in the IPv4SG binding. If the binding contains no VLAN information, this field displays N/A.
Type	IPSG binding type: · Static—Manually configured by using the ip source binding command. Static bindings are for packet filtering in IPSG or used by other modules to provide security services. · DHCP relay—Dynamically generated based on DHCP relay agent. The binding is for packet filtering in IPSG. · DHCP server—Dynamically generated based on DHCP server. The binding is used by other modules to provide security services.

Related commands

ip source binding

ip verify source

display ip source binding statistics

Use display ip source binding statistics to display statistics about local and remote IPv4SG bindings that routing protocols synchronize.

Syntax

display ip source binding statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

You can use this command to monitor the numbers of local and remote IPv4SG bindings that routing protocols synchronize in realtime. Based on the statistics, you can determine whether the maximum number of IPSG bindings is reached and whether attackers exist on the network.

This command displays the statistics only in the most recent hour.

Examples

# Display statistics about local and remote IPv4SG bindings that routing protocols synchronize.

<Sysname> display ip source binding statistics

Time Remote entry count Local entry count

Current 2000 5200

1 min ago 1351 5135

2 min ago 711 5071

3 min ago 708 4774

…

59 min ago 656 1365

60 min ago 607 1300

Table 2 Command output

Field	Description
Time	Time when the statistics were collected.
Remote entry count	Total number of remote IPv4SG bindings that were synchronized by routing protocols.
Local entry count	Total number of local IPv4SG bindings that can be synchronized by routing protocols.

display ip source binding-local

Use display ip source binding-local to display local IPv4SG bindings that can be synchronized by routing protocols.

Syntax

display ip source binding-local [ interface interface-type interface-number ] [ dhcp-relay ] [ ip-address ip-address ] [ mac-address mac-address ] [ vlan vlan-id ] [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its type and number.

dhcp-relay: Specifies dynamic IPv4SG bindings generated based on the DHCP relay module.

ip-address ip-address: Specifies an IP address.

mac-address mac-address: Specifies a MAC address, in the H-H-H format.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays local IPv4SG bindings that can be synchronized by routing protocols on the active MPU.

Usage guidelines

If you do not specify any parameters, this command displays all local IPv4SG bindings that can be synchronized by routing protocols.

Examples

# Display local IPv4SG bindings that can be synchronized by routing protocols.

<Sysname> display ip source binding-local

Total entries found: 1

IP address MAC address Interface VLAN Type

10.1.0.5 040a-0000-4000 Vlan1 1 DHCP relay

Table 3 Command output

Field	Description
Total entries found	Number of matching local IPv4SG bindings that can be synchronized by routing protocols.
IP address	IPv4 address in the IPv4SG binding. If no IP address is bound in the binding, this field displays N/A.
MAC address	MAC address in the IPv4SG binding. If no MAC address is bound in the binding, this field displays N/A.
Interface	Interface in the binding. This field displays N/A for a global IPv4SG binding.
VLAN	VLAN information in the IPv4SG binding. If the binding contains no VLAN information, this field displays N/A.
Type	Type of the IPv4SG binding. DHCP relay indicates that this binding was dynamically generated based on DHCP relay agent. This binding can be for packet filtering in IPSG.

display ip source binding-remote

Use display ip source binding-remote to display remote IPv4SG bindings synchronized by routing protocols.

Syntax

display ip source binding-remote [ router-id router-id ] [ dhcp-relay ] [ ip-address ip-address ] [ mac-address mac-address ] [ vlan vlan-id ] [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

router-id router-id: Specifies a remote device from which the device synchronizes IPv4SG bindings. The argument represents the router ID of the remote device, in IP address format.

dhcp-relay: Specifies dynamic IPv4SG bindings generated based on the DHCP relay module.

ip-address ip-address: Specifies an IP address.

mac-address mac-address: Specifies a MAC address, in the H-H-H format.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays remote IPv4SG bindings synchronized by routing protocols on the active MPU.

Usage guidelines

If you do not specify any parameters, this command displays all remote IPv4SG bindings synchronized by routing protocols.

Examples

# Display remote IPv4SG bindings synchronized by routing protocols.

<Sysname> display ip source binding-remote

Total entries found: 1

IP address MAC address Router ID VLAN Type

10.1.0.5 040a-0000-4000 1.1.1.1 1 DHCP relay

Table 4 Command output

Field	Description
Total entries found	Number of matching remote IPv4SG bindings that were synchronized by routing protocols.
IP address	IPv4 address in the IPv4SG binding. If no IP address is bound in the binding, this field displays N/A.
MAC address	MAC address in the IPv4SG binding. If no MAC address is bound in the binding, this field displays N/A.
Router ID	Interface in the binding. This field displays N/A for a global IPv4SG binding.
VLAN	VLAN information in the IPv4SG binding. If the binding contains no VLAN information, this field displays N/A.
Type	Type of the IPv4SG binding. DHCP relay indicates that this binding was dynamically generated based on DHCP relay agent.

display ipv6 source binding

Use display ipv6 source binding to display IPv6SG address bindings.

Syntax

display ipv6 source binding [ static | [ vpn-instance vpn-instance-name ] [ dhcpv6-relay ] ] [ ip-address ipv6-address ] [ mac-address mac-address ] [ vlan vlan-id ] [ interface interface-type interface-number ] [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

static: Displays static IPv6SG address bindings.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. To display dynamic IPv6SG address bindings for the public network, do not specify a VPN instance.

dhcpv6-relay: Specifies IPv6SG bindings generated based on DHCPv6 relay agent.

ip-address ipv6-address: Specifies an IPv6 address.

mac-address mac-address: Specifies a MAC address in H-H-H format.

vlan vlan-id: Specifies a VLAN ID in the range of 1 to 4094.

interface interface-type interface-number: Specifies an interface by its type and number.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays IPv6SG address bindings for the active MPU.

Examples

# Display all IPv6SG address bindings on the public network.

<Sysname> display ipv6 source binding

Total entries found: 2

IPv6 Address MAC Address Interface VLAN Type

200::1 000f-2202-0436 GE1/0/1 N/A Static

Table 5 Command output

Field	Description
Total entries found	Total number of IPv6SG address bindings.
IPv6 Address	IPv6 address in the IPv6SG address binding. If no IPv6 address is bound in the binding, this field displays N/A.
MAC Address	MAC address in the IPv6SG address binding. If no MAC address is bound in the binding, this field displays N/A.
Interface	Interface of the IPv6SG address binding. This field displays N/A for a global IPv6SG binding.
VLAN	VLAN information in the IPv6SG address binding. If the binding contains no VLAN information, this field displays N/A.
Type	Type of the IPv6SG address binding: · Static—Manually configured by using the ipv6 source binding command. Static bindings are for packet filtering in IPv6SG or used by other modules to provide security services. · DHCPv6 relay—Dynamically generated based on DHCPv6 relay agent. The binding is for packet filtering in IPv6SG.

Related commands

ipv6 source binding

ipv6 verify source

display ipv6 source binding statistics

Use display ipv6 source binding statistics to display statistics about local and remote IPv6SG bindings that routing protocols synchronize.

Syntax

display ipv6 source binding statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

You can use this command to monitor the numbers of local and remote IPv6SG bindings that routing protocols synchronize in realtime. Based on these statistics, you can determine whether the maximum number of IPSG bindings is reached and whether attackers exist on the network.

This command displays the statistics only in the most recent hour.

Examples

# Display statistics about local and remote IPv6SG bindings that routing protocols synchronize.

<Sysname> display ipv6 source binding statistics

Time Remote entry count Local entry count

Current 2000 5200

1 min ago 1351 5135

2 min ago 711 5071

3 min ago 708 4774

…

59 min ago 656 1365

60 min ago 607 1300

Table 6 Command output

Field	Description
Time	Time when the statistics were collected.
Remote entry count	Total number of remote IPv6SG bindings that were synchronized by routing protocols.
Local entry count	Total number of local IPv6SG bindings that can be synchronized by routing protocols.

display ipv6 source binding-local

Use display ipv6 source binding-local to display local IPv6SG bindings that can be synchronized by routing protocols.

Syntax

display ipv6 source binding-local [ interface interface-type interface-number ] [ dhcpv6-relay ] [ ip-address ipv6-address ] [ mac-address mac-address ] [ vlan vlan-id ] [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its type and number.

dhcpv6-relay: Specifies dynamic IPv6SG bindings generated based on the DHCPv6 relay module.

ip-address ipv6-address: Specifies an IPv6 address.

mac-address mac-address: Specifies a MAC address, in the H-H-H format.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays local IPv6SG bindings that can be synchronized by routing protocols on the active MPU.

Usage guidelines

If you do not specify any parameters, this command displays all local IPv6SG bindings that can be synchronized by routing protocols.

Examples

# Display local IPv6SG bindings that can be synchronized by routing protocols.

<Sysname> display ipv6 source binding-local

Total entries found: 2

IPv6 address MAC address Interface VLAN Type

100::1 04ef-7010-1000 Vlan10 10 DHCPv6 relay

Table 7 Command output

Field	Description
Total entries found	Number of matching local IPv6SG bindings that can be synchronized by routing protocols.
IPv6 address	IPv6 address in the IPv6SG binding. If no IP address is bound in the binding, this field displays N/A.
MAC address	MAC address in the IPv6SG binding. If no MAC address is bound in the binding, this field displays N/A.
Interface	Interface in the binding. This field displays N/A for a global IPv6SG binding.
VLAN	VLAN information in the IPv6SG binding. If the binding contains no VLAN information, this field displays N/A.
Type	Type of the IPv6SG binding. DHCP relay—Dynamically generated based on DHCP relay agent. This binding is for packet filtering in IPSG.

display ipv6 source binding-remote

Use display ipv6 source binding-remote to display remote IPv6SG bindings synchronized by routing protocols.

Syntax

display ipv6 source binding-remote [ router-id router-id ] [ dhcpv6-relay ] [ ip-address ipv6-address ] [ mac-address mac-address ] [ vlan vlan-id ] [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

router-id router-id: Specifies a remote device from which the device synchronizes IPv6SG bindings. The router-id argument represents the router ID of the remote device, in IP address format.

dhcpv6-relay: Specifies dynamic IPv6SG bindings generated based on the DHCPv6 relay module.

ip-address ipv6-address: Specifies an IPv6 address.

mac-address mac-address: Specifies a MAC address, in the H-H-H format.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays remote IPv6SG bindings synchronized by routing protocols on the active MPU.

Usage guidelines

If you do not specify any parameters, this command displays all remote IPv6SG bindings synchronized by routing protocols.

Examples

# Display remote IPv6SG bindings synchronized by routing protocols.

<Sysname> display ipv6 source binding-remote

Total entries found: 2

IPv6 address MAC address Router ID VLAN Type

100::1 04ef-7010-1000 5.5.5.5 10 DHCPv6 relay

Table 8 Command output

Field	Description
Total entries found	Number of matching remote IPv6SG bindings that were synchronized by routing protocols.
IPv6 address	IPv6 address in the IPv6SG binding. If no IP address is bound in the binding, this field displays N/A.
MAC address	MAC address in the IPv6SG binding. If no MAC address is bound in the binding, this field displays N/A.
Router ID	Interface in the binding. This field displays N/A for a global IPv6SG binding.
VLAN	VLAN information in the IPv6SG binding. If the binding contains no VLAN information, this field displays N/A.
Type	Type of the IPv6SG binding. DHCP relay—Dynamically generated based on DHCP relay agent.

ip source binding (interface view)

Use ip source binding to configure a static IPv4SG binding on an interface.

Use undo ip source binding to delete the static IPv4SG bindings configured on an interface.

Syntax

ip source binding { ip-address ip-address | ip-address ip-address mac-address mac-address | mac-address mac-address }

undo ip source binding { all | ip-address ip-address | ip-address ip-address mac-address mac-address | mac-address mac-address }

Default

No static IPv4SG bindings exist on an interface.

Views

Layer 3 Ethernet interface view

Layer 3 Ethernet subinterface view

Predefined user roles

network-admin

Parameters

all: Removes all static IPv4SG bindings on the interface.

ip-address ip-address: Specifies an IPv4 address for the static binding. The IPv4 address must be a class A, B, or C address, and cannot be 127.x.x.x or 0.0.0.0.

mac-address mac-address: Specifies a MAC address for the static binding. The MAC address must be in H-H-H format, and cannot be all 0s, all Fs (a broadcast MAC address), or a multicast MAC address.

Usage guidelines

Static IPv4SG bindings on an interface filter incoming IPv4 packets on the interface.

Examples

# Configure a static IPv4SG binding on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ip source binding ip-address 192.168.0.1 mac-address 0001-0001-0001

Related commands

display ip source binding

ip source binding (system view)

Use ip source binding to configure a global static IPv4SG binding.

Use undo ip source binding to delete one or all global static IPv4SG bindings.

Syntax

ip source binding ip-address ip-address mac-address mac-address

undo ip source binding { all | ip-address ip-address mac-address mac-address }

Default

No global static IPv4SG bindings exist.

Views

System view

Predefined user roles

network-admin

Parameters

ip-address ip-address: Specifies the IPv4 address for the static binding. The IPv4 address must be a class A, B, or C address, and cannot be 127.x.x.x or 0.0.0.0.

mac-address mac-address: Specifies the MAC address for the static binding. The MAC address is in the format H-H-H but cannot be all 0s, all Fs (a broadcast MAC address), or a multicast MAC address.

all: Removes all global static IPv4SG bindings.

Usage guidelines

A global static IPv4SG binding takes effect on all interfaces.

The maximum number of global static IPv4SG bindings that can be configured varies by device model.

Examples

# Configure a global static IPv4SG binding.

<Sysname> system-view

[Sysname] ip source binding ip-address 192.168.0.1 mac-address 0001-0001-0001

Related commands

display ip source binding

ip source binding (interface view)

ip verify source

Use ip verify source to enable IPv4SG on an interface.

Use undo ip verify source to disable IPv4SG on an interface.

Syntax

ip verify source { ip-address | ip-address mac-address | mac-address }

undo ip verify source

Default

The IPv4SG feature is disabled on an interface.

Views

Layer 3 Ethernet interface view

Layer 3 Ethernet subinterface view

Predefined user roles

network-admin

Parameters

ip-address: Filters incoming packets by source IPv4 addresses.

ip-address mac-address: Filters incoming packets by source IPv4 addresses and source MAC addresses.

mac-address: Filters incoming packets by source MAC addresses.

Usage guidelines

After you enable IPv4SG on an interface, this feature uses static and dynamic IPv4SG bindings to match incoming packets on the interface. Packets that match an IPv4SG binding are forwarded and packets that do not match any IPv4SG binding are discarded.

The matching criterion specified by this command applies only to dynamic IPSG. Static IPv4SG uses static bindings configured by using the ip source binding command.

You cannot enable dynamic IPv4SG on a service loopback interface.

You can configure IPv4SG on an interface multiple times, the most recent configuration takes effect.

If you re-execute this command to modify the matching criterion, the new criterion applies only to packets of the access users that come online after the command execution.

Examples

# Enable IPv4SG on Ethernet interface GigabitEthernet 1/0/1 and verify the source IPv4 address and MAC address for dynamic IPSG.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ip verify source ip-address mac-address

# Enable IPv4SG on Ethernet interface GigabitEthernet 1/0/2 and verify the source MAC address for dynamic IPSG.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/2

[Sysname-GigabitEthernet1/0/2] ip verify source mac-address

Related commands

display ip source binding

ipv6 source binding (interface view)

Use ipv6 source binding to configure a static IPv6SG binding.

Use undo ipv6 source binding to delete the static IPv6SG bindings configured on an interface.

Syntax

ipv6 source binding { ip-address ipv6-address | ip-address ipv6-address mac-address mac-address | mac-address mac-address }

undo ipv6 source binding { all | ip-address ipv6-address | ip-address ipv6-address mac-address mac-address | mac-address mac-address }

Default

No static IPv6SG bindings exist on an interface.

Views

Layer 3 Ethernet interface view

Layer 3 Ethernet subinterface view

Predefined user roles

network-admin

Parameters

all: Removes all the static IPv6SG bindings on the interface.

ip-address ipv6-address: Specifies an IPv6 address for the static binding. The IPv6 address cannot be an all-zero address, a multicast address, or a loopback address.

mac-address mac-address: Specifies a MAC address for the static binding. The MAC address must be in H-H-H format, and cannot be all 0s, all Fs (a broadcast MAC address), or a multicast MAC address.

Usage guidelines

Static IPv6SG bindings on an interface filter incoming IPv6 packets.

Examples

# Configure a static IPv6SG binding on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 source binding ip-address 2001::1 mac-address 0002-0002-0002

Related commands

display ipv6 source binding

ipv6 source binding (system view)

Use ipv6 source binding to configure a global static IPv6SG binding.

Use undo ipv6 source binding to delete one or all global static IPv6SG bindings.

Syntax

ipv6 source binding ip-address ipv6-address mac-address mac-address

undo ipv6 source binding { all | ip-address ipv6-address mac-address mac-address }

Default

No global static IPv6SG bindings exist.

Views

System view

Predefined user roles

network-admin

Parameters

ipv6-address ipv6-address: Specifies the IPv6 address for the static binding. The IPv6 address cannot be an all-zero address, a multicast address, or a loopback address.

mac-address mac-address: Specifies the MAC address for the static binding. The MAC address must be in H-H-H format, and cannot be all 0s, all Fs (a broadcast MAC address), or a multicast MAC address.

all: Removes all global static IPv6SG bindings.

Usage guidelines

A global static IPv6SG binding takes effect on all interfaces.

The maximum number of global static IPv6SG bindings that can be configured varies by device model.

Examples

# Configure a global static IPv6SG binding.

<Sysname> system-view

[Sysname] ipv6 source binding ipv6-address 2001::1 mac-address 0002-0002-0002

Related commands

display ipv6 source binding

display ipv6 source binding pd

ipv6 source binding (interface view)

ipv6 verify source

Use ipv6 verify source to enable IPv6SG on an interface.

Use undo ipv6 verify source to disable IPv6SG on an interface.

Syntax

ipv6 verify source { ip-address | ip-address mac-address | mac-address }

undo ipv6 verify source

Default

The IPv6SG feature is disabled on an interface.

Views

Layer 3 Ethernet interface view

Layer 3 Ethernet subinterface view

Predefined user roles

network-admin

Parameters

ip-address: Filters incoming packets by source IPv6 addresses.

ip-address mac-address: Filters incoming packets by source IPv6 addresses and source MAC addresses.

mac-address: Filters incoming packets by source MAC addresses.

Usage guidelines

After you enable IPv6SG on an interface, this feature uses static and dynamic IPv6SG bindings to match incoming packets on the interface. Packets that match an IPv6SG binding are forwarded and packets that do not match any IPv6SG binding are discarded.

The matching criterion specified by this command applies only to dynamic IPv6SG. Static IPv6SG uses static bindings configured by using the ipv6 source binding command.

You can configure IPv6SG on an interface multiple times, the most recent configuration takes effect.

If you re-execute this command to modify the matching criterion, the new criterion applies only to packets of the access users that come online after the command execution.

Examples

# Enable IPv6SG on Ethernet interface GigabitEthernet 1/0/1 and verify the source IPv6 address and MAC address for dynamic IPv6SG.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 verify source ip-address mac-address

Related commands

display ipv6 source binding

display ipv6 source binding pd

19-Security Command Reference

IP source guard commands

display ip source binding

display ipv6 source binding

ip source binding (system view)

ipv6 source binding (interface view)

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us