interface-type interface-number: interface-type refers to the interface type, and interface-number refers to the interface number. Refer to the interface command in Port Command Manual for more information.

Description

Use the display ip interface command to display information about an interface.

Example

# Display the information about interface VLAN-interface 1.

<H3C> display ip interface vlan-interface 1

Vlan-interface1 current state : DOWN

Line protocol current state : DOWN

Internet Address is 1.1.1.1/8 Primary

Broadcast address : 1.255.255.255

The Maximum Transmit Unit : 1500 bytes

input packets : 0, bytes : 0, multicasts : 0

output packets : 0, bytes : 0, multicasts : 0

TTL invalid packet number: 0

ICMP packet input number: 0

Echo reply: 0

Unreachable: 0

Source quench: 0

Routing redirect: 0

Echo request: 0

Router advert: 0

Router solicit: 0

Time exceed: 0

IP header bad: 0

Timestamp request: 0

Timestamp reply: 0

Information request: 0

Information reply: 0

Netmask request: 0

Netmask reply: 0

Unknown type: 0

DHCP packet deal mode: global

Table 1-2 Description on the fields of the display ip interface command

Field	Description
Vlan-interface1 current state	Current state of the VLAN interface 1
Line protocol current state	Current state of the Line protocol
Internet Address	IP address
Broadcast address	Broadcast address
The Maximum Transmit Unit	Maximum transmission unit
input packets : 0, bytes : 0, multicasts : 0 output packets : 0, bytes : 0, multicasts : 0	The number of the input/output unicast packets, bytes and broadcast packets are all 0
TTL invalid packet number	The number of the received packets with invalid TTLs
ICMP packet input number Echo reply: Unreachable: Source quench: Routing redirect: Echo request: Router advert: Router solicit: Time exceed: IP header bad: Timestamp request: Timestamp reply: Information request: Information reply: Netmask request: Netmask reply: Unknown type:	Total received ICMP packets, including: Echo reply packets, unreachable packets, source quench packets, routing redirect packets, echo request packets, route advertisement packets, route solicitation packets, packets that exceed the time, packets with bad IP headers, timestamp request packets, timestamp reply packets, information request packets, information reply packets, netmask request packets, netmask reply packets and unknown packets.
DHCP packet deal mode	DHCP packet processing mode

1.1.3 ip address

Syntax

ip address ip-address { mask | mask-length } [ sub ]

undo ip address [ ip-address { mask | mask-length } [ sub ] ]

View

VLAN interface view, loopback interface view, or console view

Parameter

ip-address: IP address of VLAN interface in dotted decimal format.

mask: Corresponding subnet mask in dotted decimal format.

mask-length: Mask length. That is, the number of bits with a value of 1.

sub: Specifies the IP address to be configured to be the secondary IP address of the VLAN interface/loopback interface.

Description

Use the ip address command to assign an IP address and the corresponding subnet mask to the VLAN interface/loopback interface/console interface.

Use the undo ip address command to remove the IP address and the corresponding subnet mask assigned to the VLAN interface/loopback interface/console interface.

By default, a VLAN interface/loopback interface/console interface does not have an IP address configured.

Normally, a VLAN interface/loopback interface/console interface only needs to be configured with one IP address. But you can also assign up to 21 IP addresses to a VLAN interface/loopback interface/console interface to enable it to connect to multiple subnets. Of all the IP addresses assigned to a VLAN interface/loopback interface/console interface, one is the primary IP address, and the other are secondary IP addresses. The relationship between primary and secondary addresses is:

l When you configure a primary IP address for an interface already has a primary IP address configured, the newly configured one replaces the old one.

l If you execute the undo ip address command without providing any parameter, the switch removes both primary and secondary IP addresses of the interface. The undo ip address [ ip-address { mask | mask-length } command can be used to delete the primary IP address, while the undo ip address [ ip-address { mask | mask-length } sub command can be used to delete the secondary IP address.

& Note:

When you use the ip address command to configure IP addresses of VLAN interfaces, the system will prompts if you continue if the IP address you configure is in different network segment from the existing IP address. If you do continue, the IP address of the VLAN interface will be modified. In addition, if the ARP entries (including dynamic ARP entries and static ARP entries) in the original network segment match the new network segment, they will not be removed; otherwise, the ARP entries in the original network segment will be removed.

Related command: display ip interface.

Example

# Assign 129.12.0.1 to VLAN interface 1, with a subnet mask of 255.255.255.0.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface vlan-interface 1

[H3C-Vlan-interface1] ip address 129.12.0.1 255.255.255.0

# Assign 129.12.0.10 to Ethernet4/0/0, with a 24-bit subnet mask.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface M-Ethernet4/0/0

[H3C-M-Ethernet4/0/0] ip address 129.12.0.10 24

1.1.4 ip host

Syntax

ip host hostname ip-address

undo ip host hostname [ ip-address ]

View

System view

Parameter

hostname: Name of the host. It is a character string that consists of 1 to 20 characters, including letters, numbers, "_", or ",", and it must contain at least one letter.

ip-address: Host IP address (the corresponding IP address to the host name) in dotted decimal notation.

Description

Use the ip host command to configure the host name and the host IP address.

Use the undo ip host command to cancel the host name and the host IP address.

By default, host name and corresponding IP address are null.

Related command: display ip host.

Example

# Set Lanswtich1’s IP address to be 10.110.0.1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] ip host Lanswitch1 10.110.0.1

1.1.5 ip-protect enable

Syntax

ip-protect enable

undo ip-protect

View

VLAN interface view

Parameter

None

Description

Use the ip-protect enable command to enable IP address protection.

Use the undo ip-protect command to disable IP address protection.

After IP address protection is enabled, the current interface will no longer dynamically learn ARP mapping entries, and existing dynamic ARP mapping entries will be removed. At the same time, the switch will enable the MAC address auto filling function, so that the user can configure static ARP entries that have only IP address.

By default, IP address protection is disabled.

You can use the display this command to view the status of IP address protection (enabled/disabled) for the current VLAN interface.

Example

# Enable IP address protection for Vlan-interface 2.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C]interface Vlan-interface 2

[H3C-Vlan-interface2]ip-protect enable

Chapter 2 ARP Configuration Commands

2.1 ARP Configuration Commands

2.1.1 arp proxy enable

Syntax

arp proxy enable

undo arp proxy enable

View

VLAN view

Parameter

None

Description

Use the arp proxy enable command to enable ARP proxy function.

Use the undo arp proxy enable command to disable ARP proxy function.

By default, ARP proxy function is disabled.

You can configure these commands for a VLAN and sub-VLAN. If you enable ARP proxy for a VLAN, the device with ARP proxy function directly forwards received ARP requests in the VLAN. If you enable ARP proxy for a sub-VLAN, the device with ARP proxy function directly forwards received ARP requests in other sub-VLANs which belong to the same super-VLAN and also have the ARP proxy function enabled.

Related command: display arp proxy.

Example

# Enable ARP proxy function for VLAN 2.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] vlan 2

[H3C-vlan2] arp proxy enable

2.1.2 arp static

Syntax

arp static ip-address [ mac-address [ vlan-id { interface-type interface-number } ] [ vpn-instance vpn-instance-name ]

undo arp ip-address

View

System view

Parameter

ip-address: IP address of the ARP mapping entry.

mac-address: MAC address of the ARP mapping entry, whose format is H-H-H ( H indicates a hexadecimal number).

vlan-id: VLAN to which the static ARP entry belongs, in the range of 1 to 4094.

interface-type interface-number: The type and number of the port to which the static ARP entry belongs.

vpn-instance vpn-instance-name: VPN instance name in MPLS VPN.

Description

Use the arp static command to configure the static ARP mapping entries in an ARP mapping table.

Use the undo arp static command to delete a static ARP mapping entry from the ARP table.

By default, the mapping table of the system ARP is empty and the switch can obtain its address mapping by means of dynamic ARP.

The arp static command can be used to configure auto filling of ARP entries. When configuring an ARP entry, if you input on the IP address, the switch will automatically set the MAC address to 0. Such a mapping entry is auto-fill ARP mapping entry. When an auto-fill ARP entry is resolved, the switch can automatically fill it with the learned MAC address as the MAC address corresponding to the IP address in this mapping entry.

Note that:

l When the switch works normally, its static ARP mapping entries remain valid and work unless you perform operations that invalidate ARP entries, such as changing or removing VLAN interfaces, removing a VLAN, or removing an port from a VLAN. These operations will cause the corresponding ARP mapping entries to be automatically removed.

l The argument vlan-id must be the ID of an existing VLAN, and the Ethernet port specified behind this parameter must belong to the VLAN.

l The argument vpn-instance-name must be the VPN-instance name of an existing MPLS VPN.

l ARP mapping entries with port parameters can be configured on manually aggregated ports or static aggregated ports, but cannot be configured on LACP-enabled dynamic aggregated ports.

l If the mac-address of an ARP entry is a multicast MAC address, the system will assume this ARP entry to be multicast ARP entry.

l The MAC address auto filling function is enabled only when the IP address protection function is enabled on the interface.

l Once after the initial auto filling, the auto-fill ARP entry becomes a normal static ARP entry and cannot be filled again.

l Long static ARP can be configured only on manually aggregated ports, but not on static aggregated ported or dynamic aggregated ports.

Related commands: reset arp, display arp, debugging arp.

Example

# Configure the MAC address corresponding to the IP address 202.38.10.2 to 00e0-fc01-0000. This static ARP mapping entry is on Ethernet port Ethernet2/1/1, which belongs to VLAN1.

[H3C] arp static 202.38.0.10 00e0-fc01-0000 1 ethernet2/1/1

2.1.3 arp static multi-port

Syntax

arp static ip-address mac-address vlan-id multi-port interface-type interface-number [ vpn-instance vpn-instance-name ] ]

undo arp ip-address multi-port interface-type interface-number [ vpn-instance vpn-instance-name ]

View

System view

Parameter

ip-address: IP address of the ARP mapping entry.

mac-address: MAC address of the ARP mapping entry, in the format of H-H-H. For a multiple-outgoing-port ARP entry, this is a multicast MAC address.

vlan-id: ID of the VLAN of the static ARP entry, in the range of 1 to 4094.

interface-type: Port type.

interface-number: Port number.

For details about the above two parameters, refer to the interface command in port command manual.

vpn-instance-name: The VPN instance name of the VPN which the IP address belongs to.

Description

Use the arp static multi-port command to add a multicast ARP port. When you add the first port, the system generates a multicast ARP entry.

Use the undo arp multi-port command to remove a multicast ARP port. When you remove the last port, the system removes the multicast ARP entry.

The multicast ARP feature allows you to associate a common unicast route to a Layer 2 multicast group, that is, add multiple outgoing ports for an outgoing ARP packet so that the packet can be sent to multiple ports. As a result, a static multicast ARP entry is generated. In brief, a multicast ARP entry is a static ARP entry with a multicast MAC address, which may correspond to multiple ports.

By the multi-port keyword in this command, the switch decides that the port to be added is for a multicast ARP entry. Only one port can be added every time the command is executed. If the ARP entry does not exist, a new entry is generated. If the port has already been in the entry, no further processing is made.

Note that:

l You cannot configure multicast ARP for aggregation ports. Otherwise, the system will prompt error message.

l At present, the outgoing ports in the same multicast ARP entry cannot be in different boards.

You can add multiple ports one by one by setting the multicast static ARP entry. To view the configuration, use the display arp multi-port command.

Related commands: reset arp, display arp, debugging arp, arp static.

Example

# In an ARP entry, the IP address is 10.10.10.98, and the MAC address is 0150-0098-0098. Add the outgoing ports Ethernet 6/1/1, Ethernet 6/1/2 and Ethernet 6/1/3 to the ARP entry.

[H3C] arp static 10.10.10.98 0150-0098-0098 20 multi-port Ethernet 6/1/1

[H3C] arp static 10.10.10.98 0150-0098-0098 20 multi-port Ethernet 6/1/2

[H3C] arp static 10.10.10.98 0150-0098-0098 20 multi-port Ethernet 6/1/3

2.1.4 arp timer aging

Syntax

arp timer aging aging-time

undo arp timer aging

View

System view

Parameter

aging-time: Aging time of dynamic ARP aging timer, which is in the range of 1 to 1440 minutes. By default, the aging time is 20 minutes.

Description

Use the arp timer aging command to configure the dynamic ARP aging timer.

Use the undo arp timer aging command to restore the default dynamic ARP aging timer.

Related command: display arp timer aging.

Example

# Configure the dynamic ARP aging timer to 10 minutes.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] arp timer aging 10

2.1.5 debugging arp

Syntax

debugging arp { error | info | packet }

undo debugging arp { error | info | packet }

View

User view

Parameter

error: ARP error debugging.

info: ARP mapping table and information management debugging.

packet: ARP packet debugging.

Description

Use the debugging arp command to enable ARP debugging.

Use the undo debugging arp command to disable the corresponding ARP debugging.

By default, no ARP debugging is enabled.

Related command: arp static, display arp.

Example

# Enable ARP packet debugging.

<H3C> debugging arp packet

*0.771346-ARP-8-S1-arp_send:Send an ARP Packet, operation : 1, sender_eth_addr : 00e0-fc00-3500,sender_ip_addr : 10.110.91.159, target_eth_addr : 0000-0000-0000, target_ip_addr : 10.110.91.193

*0.771584-ARP-8-S1-arp_rcv:Receive an ARP Packet, operation : 2, sender_eth_addr : 0050-ba22-6fd7, sender_ip_addr : 10.110.91.193, target_eth_addr : 00e0-fc00-3500, target_ip_addr : 10.110.91.159

Table 2-1 Description on the fields of the debugging arp command

Field	Description
operation	Kind of ARP packets: 1 ARP request packet; 2 ARP reply packet
sender_eth_addr	Ethernet address of the sender
sender_ip_addr	IP address of the sender
target_eth_addr	Target Ethernet address. If the packet is a ARP request packet, the target IP address will be 0. It changes to the correct address when the target responds.
target_ip_addr	Target IP address

2.1.6 display arp

Syntax

display arp [ ip-address | [ dynamic | static ] [ | { begin | include | exclude } text ] ]

View

Any view

Parameter

dynamic: Displays the dynamic ARP entries in ARP mapping table.

static: Displays the static ARP entries in ARP mapping table.

ip-address: Displays ARP mapping entries according to specified IP address.

begin: Starts displaying from the first ARP entry that contains the specified character string “text”.

include: Displays only the ARP entries that contain the specified character string “text”.

exclude: Displays only the ARP entries that do not contain the specified character string “text”.

text: Character string. The ARP entries that contain this character string are displayed.

Description

Use the display arp command to view the ARP mapping table.

Related command: arp static, reset arp, debugging arp.

Example

# Display all the ARP entries.

<H3C> display arp | inc 2.2.1

Type: S-Static D-Dynamic

IP Address MAC Address VLAN ID Port Name Aging Type

2.2.2.231 0001-0001-0001 N/A N/A N/A S

2.2.1.2 0002-0002-0002 N/A N/A N/A S

-- 2 entries found ---

& Note:

Character of “.” in a regular expression is a wildcard. So, as for “2.2.2.231”, “2.2.1” matches its sub-string “2.231” and thus the ARP mapping entry with an IP address of 2.2.2.231 is displayed as a matched entry.

Table 2-2 Description on the fields of the display arp command

Field	Description
IP Address	IP address of the ARP mapping entry
MAC Address	MAC address of the ARP mapping entry
VLAN ID	ID of the VLAN to which the static ARP entry belongs
Port Name	Name of the port to which the static ARP entry belongs
Aging	Aging time of dynamic ARP entry in minutes
Type	Type of ARP entry

2.1.7 display arp multi-port

Syntax

display arp multi-port [ ip-address ]

View

Any view

Parameter

ip-address: IP address of an ARP mapping entry.

Description

Use the display arp multi-port command to display configuration information about multicast ARP. The multicast ARP (that is, multiple-port ARP) feature allows one ARP entry to correspond to multiple outgoing ports; it is used to send one packet to multiple ports simultaneously.

Related command: arp static.

Example

# Display configuration information about the multicast ARP entry with the IP address of 10.10.10.98.

<H3C> display arp multi-port 10.10.10.98

IP Address :10.10.10.98

Mac Address :0150-0098-0098

VLAN ID :20

ARP Port-List : Ethernet6/1/2 Ethernet6/1/3

Ethernet6/1/4 *Ethernet6/1/5

Ethernet6/1/6 Ethernet6/1/7

Ethernet6/1/8 Ethernet6/1/9

Ethernet6/1/1

VPN-Name :Public-ARP

When a “*” precedes a port, the port is in the Up state; otherwise, the port is in the Down state.

2.1.8 display arp proxy

Syntax

display arp proxy [ vlan vlan-id ]

View

Any view

Parameter

vlan-id: Specifies the VLAN ID.

Description

Use the display arp proxy command to display the state of the ARP proxy of a specified VLAN. An ARP proxy can be in enabled or disabled state.

Related command: arp proxy enable.

Example

# Display the state of the ARP proxy of VLAN 3.

<H3C> display arp proxy vlan 3

vlan 3

Proxy ARP status: disabled

2.1.9 display arp timer aging

Syntax

display arp timer aging

View

Any view

Parameter

None

Description

Use the display arp timer aging command to view the current setting of the dynamic ARP aging timer.

Related command: arp timer aging.

Example

# Display the current setting of the ARP aging timer.

<H3C> display arp timer aging

Current ARP aging time is 10 minute(s)

You can see that the ARP aging time is 10 minutes.

2.1.10 gratuitous-arp-learning enable

Syntax

gratuitous-arp-learning enable

undo gratuitous-arp-learning enable

View

System view

Parameter

None

Description

Use the gratuitous-arp-learning enable command to enable the gratuitous ARP packet learning function.

Use the undo gratuitous-arp-learning enable command to disable the gratuitous ARP packet learning function.

By default, the gratuitous ARP packet learning function is enabled.

By sending gratuitous ARP packets, a network device can:

l Determine whether or not IP address conflicts exist between it and other network devices.

l Trigger other network devices to update its hardware address stored in their caches.

Example

# Enable the gratuitous ARP packet learning function on the switch.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] gratuitous-arp-learning enable

2.1.11 reset arp

Syntax

reset arp [ dynamic | static | interface { interface-type interface-number } | all ]

View

User view

Parameter

dynamic: Clears the dynamic ARP mapping entries.

static: Clears the static ARP mapping entries

interface-type is port type and interface-number is port number. For details, refer to the description of interface command in the Port Command Manual.

all: Clears all the ARP mapping entries.

Description

Use the reset arp command to reset the ARP mapping entries.

Related command: arp static, display arp.

Example

# Reset the static ARP entries.

<H3C> reset arp static

Chapter 3 ARP Table Size Configuration Commands

3.1 ARP Table Size Configuration Commands

3.1.1 arp max-entry

Syntax

arp max-entry slot-num max-num

undo arp max-entry slot-num

View

System view

Parameter

slot-num: Slot number of the card.

max-num: Maximum number of ARP entries that can be supported by the specified card. This argument counts in K (1K = 1024) and ranges from 4K to 8K.

Description

Use the arp max-entry command to configure the maximum number of ARP entries that can be supported by a specified card in the system.

Use the undo arp max-entry command to cancel the configuration.

By default, each card supports up to 4K ARP entries.

If the system does not contain cards with their model names being suffixed with B, DA, DB or DC, you can configure the maximum number of ARP entries to be 4K, 5K, 6K, 7K or 8K for the card. Otherwise, you can only configure the maximum number to be 4K for the card.

Example

# Configure the maximum number of ARP entries that can be supported by the interface card in slot 12 to 8K (assuming that the system does not contain cards with their model name being suffixed with B, DA, DB or DC).

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C]arp max-entry 12 8

The configuration won't be enabled until the system is rebooted.

3.1.2 arp max-aggregation-entry

Syntax

arp max-aggregation-entry max-aggnum

undo arp max-aggregation-entry

View

System view

Parameter

max-aggnum: Maximum number of ARP entries for aggregation port (that is, aggregation ARP entries) supported by each card. This argument counts in K (1K = 1024).

Description

Use the arp max-aggregation-entry command to configure the maximum number of aggregation ARP entries that can be supported by each card of the switch.

Use the undo arp max-aggregation-entry command to restore the default maximum number of aggregation ARP entries supported by each card.

If the system does not contain cards whose model name are suffixed with B, DA, DB or DC, you can configure the maximum number of aggregation ARP entries to 0K, 1K, 3K, 7K or 8K. Otherwise, you can only configure the maximum number to 0K, 1K or 3K.

By default, each card supports up to 1K aggregation ARP entries.

Example

# Configure the maximum number of aggregation ARP entries that can be supported by each card of the switch to 8K (assuming that the system does not contain cards whose model name are suffixed with B, DA, DB or DC).

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C]arp max-aggregation-entry 8

The configuration won't be enables until the system is rebooted.

3.1.3 arp enable size

Syntax

arp enable size { 4 | 64 }

undo arp enable size

View

System view

Parameter

4: Configures the maximum number of ARP entries of the whole switch to 4K (1K = 1024).

64: Configure the maximum number of ARP entries of the whole switch to 64K.

Description

Use the arp enable size command to configure the maximum number of ARP entries that can be supported by the whole switch.

Use the undo arp enable size command to restore the default maximum number of ARP entries supported by the whole switch.

By default, the whole switch supports up to 4K ARP entries, each card supports up to 4K ARP entries, and each card supports up to 1K aggregation ARP entries.

Example

# Configure the maximum number of ARP entries of the whole switch to 64K.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] arp enable size 64

The configuration won't be enabled until the system is rebooted.

Caution:

l You must restart the system for each of the three configurations to take effect.

l Do not remove a card or change the place of a card from one slot to another before restarting the system. Otherwise, the configuration may fail to take effect.

l After the configurations, do not perform active/standby switchover before restarting the system. Otherwise, the configurations will not take effect even if you restart the system.

3.1.4 display arp max-entry

Syntax

display arp max-entry

View

Any view

Parameter

None

Description

Use the display arp max-entry command to display the current maximum numbers of ARP entries and the intending counterparts that will take effect after the switch restarts next time.

Example

# Display the current maximum numbers of ARP entries and the intending counterparts that will take effect after the switch restarts next time.

<H3C> display arp max-entry

The current max arp entry config information:

max arp entry config(Main Board): 65536

max link aggregation arp entry config: 0

max arp entry config of slot 0: 8192

……………

max arp entry config of slot 13: 8192

The next max arp entry config information:

max arp entry config(Main Board): 65536

max link aggregation arp entry config: 8192

max arp entry config of slot 0: 8192

………….

max arp entry config of slot 13: 8192

Chapter 4 DHCP Configuration Commands

4.1 General DHCP Configuration Commands

4.1.1 dhcp enable

Syntax

dhcp enable

undo dhcp enable

View

System view

Parameter

None

Description

Use the dhcp enable command to enable DHCP service.

Use the undo dhcp enable command to disable the DHCP service.

For both DHCP server and DHCP relay, you must enable DHCP service first before performing other DHCP configurations. The other related DHCP configurations take effect only after DHCP service is enabled.

Example

# Enable DHCP service.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp enable

4.1.2 dhcp select

Syntax

In VLAN interface view:

dhcp select { global | interface | relay }

undo dhcp select

In system view:

dhcp select { global | interface | relay } { interface vlan-interface vlan-id [ to vlan-interface vlan-id ] | all }

undo dhcp select { interface vlan-interface vlan-id [ to vlan-interface vlan-id ] | all }

View

VLAN interface view, system view

Parameter

global: Specifies to forward DHCP packets to local DHCP server and let the local server assign IP addresses in global address pools to DHCP clients.

interface: Specifies to forward DHCP packets to local DHCP server and let the local server assign IP addresses in VLAN interface address pool to DHCP clients.

relay: Specifies to forward DHCP packets to remote DHCP servers and let remote servers assign IP addresses to DHCP clients. In this case, the current switch operates as a DHCP relay.

interface vlan-interface vlan-id [ to vlan-interface vlan-id ]: Specifies a VLAN interface or a range of VLAN interfaces.

all: Specifies all the VLAN interfaces.

Caution:

The dhcp select interface command cannot be used together with the ip relay address or dhcp relay security address-check enable command.

Description

Use the dhcp select command to specify a method used by the switch to process the DHCP packets it received. You can use this command in VLAN interface view to specify a processing method of DHCP packets for current VLAN interface, or in system view to specify a processing method for multiple VLAN interfaces.

Use the undo dhcp select command to revert to the default processing mode of DHCP packets.

By default, the switch forwards the DHCP packets it received to the local DHCP server and let the local server assign IP addresses in global address pools to DHCP clients. (That is, the switch processes the DHCP packets in the global method.)

Example

# Specify to forward DHCP packets to the local DHCP server and let the local server assign IP addresses in global address pools to DHCP clients.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface vlan-interface 1

[H3C-Vlan-interface1] dhcp select global

4.1.3 dhcp server detect

Syntax

dhcp server detect

undo dhcp server detect

View

System view

Parameter

None

Description

Use the dhcp server detect command to enable fake DHCP server detection.

Use the undo dhcp server detect command to disable fake DHCP server detection.

Fake DHCP server detection is disabled by default.

Example

# Enable fake DHCP server detection.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server detect

4.2 DHCP Server Configuration Commands

4.2.1 debugging dhcp server

Syntax

debugging dhcp server { all | error | event | packet }

undo debugging dhcp server { all | error | event | packet }

View

User view

Parameter

all: Used to enable/disable all types of debugging for DHCP server.

error: Used to enable/disable error debugging for DHCP server errors, including those occur when a DHCP server processes DHCP packets or assigns IP addresses.

event: Used to enable/disable debugging for DHCP server events, including the assigning of IP addresses and timing out of ping packets.

packet: Specifies debugging for packets received/sent by DHCP servers, including DHCP packets and ping packets.

Description

Use the debugging dhcp server command to enable debugging for DHCP server.

Use the undo debugging dhcp server command to disable debugging for DHCP server.

Each type of debugging concerning DHCP servers is disabled by default.

Example

# Enable debugging for DHCP server events.

<H3C> debugging dhcp server event

4.2.2 display dhcp server forbidden-ip

Syntax

display dhcp server forbidden-ip

View

Any view

Parameter

None

Description

Use the display dhcp server forbidden-ip command to display forbidden IP addresses in the DHCP address pool.

Example

# Display forbidden IP addresses in the DHCP address pool.

<H3C> display dhcp server forbidden-ip

Forbidden IP Range from 3.3.3.1 to 3.3.3.1

Forbidden IP Range from 3.3.3.4 to 3.3.3.99

Forbidden IP Range from 3.3.3.101 to 3.3.3.254

Forbidden IP Range from 17.9.0.1 to 17.9.0.1

Forbidden IP Range from 17.9.0.3 to 17.9.0.5

Forbidden IP Range from 17.9.0.8 to 17.9.255.254

4.2.3 dhcp server dns-list

Syntax

In VLAN interface view:

dhcp server dns-list ip-address [ ip-address ]

undo dhcp server dns-list { ip-address | all }

In system view:

dhcp server dns-list ip-address [ ip-address ] { interface vlan-interface vlan-id [ to vlan-interface vlan-id ] | all }

undo dhcp server dns-list { ip-address | all } { interface vlan-interface vlan-id [ to vlan-interface vlan-id ] | all }

View

VLAN interface view, system view

Parameter

ip-address: IP address of a DHCP server. You can specify up to eight IP addresses (separated by spaces) in one command.

interface vlan-interface vlan-id [ to vlan-interface vlan-id ]: Specifies one VLAN interface, or a range of VLAN interfaces.

all: Specifies all VLAN interfaces or all configured IP addresses.

Description

Use the dhcp server dns-list command to configure one or more DNS server addresses for the DHCP address pool of current VLAN interface, or for the DHCP address pool(s) of the specified VLAN interface(s).

Use the undo dhcp server dns-list command to remove one or more DNS server addresses configured for the DHCP address pool of current VLAN interface, or for the DHCP address pool(s) of the specified VLAN interface(s).

By default, no DNS server address is configured.

With eight DNS server addresses already configured, if you add a new DNS server address by executing the dhcp server dns-list command, the newly configured one overwrites the oldest one.

Related command: dns-list.

Example

# Configure the DNS server address 1.1.1.254 for the DHCP address pool of VLAN interface 1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Vlan-interface 1

[H3C-Vlan-interface1] dhcp server dns-list 1.1.1.254

4.2.4 dhcp server domain-name

Syntax

In VLAN interface view:

dhcp server domain-name domain-name

undo dhcp server domain-name

In system view:

dhcp server domain-name domain-name { interface vlan-interface vlan-id [ to vlan-interface vlan-id ] | all }

undo dhcp server domain-name domain-name { interface vlan-interface vlan-id [ to vlan-interface vlan-id ] | all }

View

DHCP address pool view, VLAN interface view, system view

Parameter

domain-name: DHCP client domain name for DHCP address pool of specified VLAN interface, a string that is of 3 to 50 characters in length.

interface vlan-interface vlan-id [ to vlan-interface vlan-id ]: Specifies one VLAN interface, or a range of VLAN interfaces.

all: Specifies all VLAN interfaces.

Description

Use the dhcp server domain-name command to configure a DHCP client domain name for the DHCP address pool of the current VLAN interface, or for the DHCP address pool(s) of the specified VLAN interface(s).

Use the undo dhcp server domain-name command to remove the DHCP client domain name configured for the DHCP address pool of the current VLAN interface, or for the DHCP address pool(s) of the specified VLAN interface(s).

No DHCP client domain name is configured by default.

Related command: domain-name.

Example

# Configure the DHCP client domain name of the DHCP address pool of the current VLAN interface to vlan-interface1.com.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface vlan-interface 1

[H3C-Vlan-interface1] dhcp server domain-name vlan-interface1.com

4.2.5 dhcp server expired

Syntax

In VLAN interface view:

dhcp server expired { day day [ hour hour [ minute minute ] ] | unlimited }

undo dhcp server expired

In system view:

dhcp server expired { day day [ hour hour [ minute minute ] ] | unlimited } { interface vlan-interface vlan-id [ to vlan-interface vlan-id ] | all }

undo dhcp server expired { interface vlan-interface vlan-id [ to vlan-interface vlan-id ] | all }

View

VLAN interface view, system view

Parameter

day day: Sets the number of days. The day argument ranges from 0 to 365.

hour hour: Sets the number of hours. The hour argument ranges from 0 to 23.

minute minute: Sets the number of minutes. The minute argument ranges from 0 to 59.

unlimited: Sets an unlimited lease time.

interface vlan-interface vlan-id [ to vlan-interface vlan-id ]: Specifies one VLAN interface, or a range of VLAN interfaces.

all: Specifies all VLAN interfaces.

Description

Use the dhcp server expired command to set the IP address lease time for the DHCP address pool of current VLAN interface, or for the DHCP address pool(s) of the specified VLAN interface(s).

Use the undo dhcp server expired command to revert to the default IP address lease time for the DHCP address pool of current VLAN interface, or for the DHCP address pool(s) of the specified VLAN interface(s).

The default lease time is one day.

Related command: expired.

Example

# Set the IP address lease time of the DHCP address pool of VLAN interface 1 to unlimited.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface vlan-interface 1

[H3C-Vlan-interface1] dhcp server expired unlimited

4.2.6 dhcp server forbidden-ip

Syntax

dhcp server forbidden-ip low-ip-address [ high-ip-address ]

undo dhcp server forbidden-ip low-ip-address [ high-ip-address ]

View

System view

Parameter

low-ip-address: Minimum IP address in the forbidden IP address range.

high-ip-address: The highest IP address in the forbidden IP address range. Note that the value of this argument must be larger than (or equal to) that of the low-ip-address argument. If you do not provide this argument, then the forbidden IP address range contains only the IP address specified by the low-ip-address argument.

Description

Use the dhcp server forbidden-ip command to forbid a range of IP addresses to be automatically assigned to DHCP clients.

Use the undo dhcp server forbidden-ip command to cancel the forbiddance.

All IP addresses in a DHCP address pool can be automatically assigned by default.

Related command: dhcp server ip-pool, network, static-bind ip-address, and dhcp server static-bind.

Example

# Forbid the IP addresses from 10.110.1.1 to 10.110.1.63 to be automatically assigned.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server forbidden-ip 10.110.1.1 10.110.1.63

4.2.7 dhcp server ip-pool

Syntax

dhcp server ip-pool pool-name

undo dhcp server ip-pool pool-name

View

System view

Parameter

pool-name: Name of the address pool, a string that is of 1 to 64 characters in length. An address pool name uniquely identifies an address pool.

Description

Use the dhcp server ip-pool command to create a global DHCP address pool and enter the corresponding DHCP address pool view.

Use the undo dhcp server ip-pool command to remove a specified global DHCP address pool.

No global DHCP address pool is created by default.

Related command: dhcp enable.

Example

# Create a global DHCP address pool with a name of 0.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server ip-pool 0

[H3C-dhcp-0]

4.2.8 dhcp server nbns-list

Syntax

In VLAN interface view:

dhcp server nbns-list ip-address [ ip-address ]

undo dhcp server nbns-list { ip-address | all }

In system view:

dhcp server nbns-list ip-address [ ip-address ] { interface vlan-interface vlan-id [ to vlan-interface vlan-id ] | all }

undo dhcp server nbns-list { ip-address | all } { interface vlan-interface vlan-id [ to vlan-interface vlan-id ] | all }

View

VLAN interface view, system view

Parameter

ip-address: NetBIOS server IP address. You can specify up to eight IP addresses (separated by spaces) in one command.

interface vlan-interface vlan-id [ to vlan-interface vlan-id ]: Specifies one VLAN interface, or a range of VLAN interfaces.

all: Specifies all VLAN interfaces or all configured IP addresses.

Description

Use the dhcp server nbns-list command to configure one or more NetBIOS server IP addresses for the DHCP address pool of current VLAN interface, or for the DHCP address pool(s) of the specified VLAN interface(s).

Use the undo dhcp server nbns-list command to remove one or all NetBIOS server IP addresses configured for the DHCP address pool of current VLAN interface, or for the DHCP address pool(s) of the specified VLAN interface(s)..

By default, no NetBIOS server IP address is configured.

With eight NetBIOS server addresses already configured, if you add a new one by executing the dhcp server nbns-list command, the newly configured one overwrites the oldest one.

Related command: nbns-list, dhcp server netbios-type.

Example

# Configure the NetBIOS server with an IP address of 10.12.1.99 for the DHCP address pool of VLAN interface 1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface vlan-interface 1

[H3C-Vlan-interface1] dhcp server nbns-list 10.12.1.99

4.2.9 dhcp server netbios-type

Syntax

In VLAN interface view:

dhcp server netbios-type { b-node | h-node | m-node | p-node }

undo dhcp server netbios-type

In system view:

dhcp server netbios-type { b-node | h-node | m-node | p-node } { interface vlan-interface vlan-id [ to vlan-interface vlan-id ] | all }

undo dhcp server netbios-type { interface vlan-interface vlan-id [ to vlan-interface vlan-id ] | all }

View

VLAN interface view, system view

Parameter

b-node: Specifies b-node to be the NetBIOS node type. DHCP clients of this node type establish host name-to-IP address mapping by broadcasting. (b stands for broadcast.)

p-node: Specifies p-node to be the NetBIOS node type. DHCP clients of this node type establish host name-to-IP address mapping by communicating with NetBIOS server. (p stands for peer-to-peer.)

m-node: Specifies m-node to be the NetBIOS node type. DHCP clients of this node type are p nodes which take some broadcast features. (m stands for mixed.)

h-node: Specifies h-node to be the NetBIOS node type. DHCP clients of this node type are b nodes which take peer-to-peer mechanism. (h stands for hybrid.)

Description

Use the dhcp server netbios-type command to configure the NetBIOS node type for DHCP clients of DHCP address pool of current or specified VLAN interface.

Use the undo dhcp server netbios-type command to remove the NetBIOS node type configured for DHCP clients of DHCP address pool of current or specified VLAN interface.

The default DHCP client NetBIOS node type is h-node.

Related command: netbios-type, dhcp server nbns-list.

Example

# Configure p-node as the NetBIOS node type for DHCP clients of the DHCP address pool of VLAN interface 1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface vlan-interface 1

[H3C-Vlan-interface1] dhcp server netbios-type p-node

4.2.10 dhcp server option

Syntax

In VLAN interface view:

dhcp server option code { ascii ascii-string | hex hex-string | ip-address ip-address [ ip-address ] }

undo dhcp server option code

In system view:

dhcp server option code { ascii ascii-string | hex hex-string | ip-address ip-address [ ip-address ] } { interface vlan-interface vlan-id [ to vlan-interface vlan-id ] | all }

undo dhcp server option code { interface vlan-interface vlan-id [ to vlan-interface vlan-id ] | all }

View

VLAN interface view, system view

Parameter

code: Option code customized by user. This argument ranges from 2 to 254.

ascii ascii-string: Specifies a string comprising ASCII characters. The string can be of 1 to 63 characters in length.

hex hex-string: Specifies a numeric string containing 2 or 4 hexadecimal digits (hh or hhhh).

ip-address ip-address [ ip-address ]: Specifies one or more IP addresses. You can specify up to eight IP addresses (separated by spaces) in one command.

interface vlan-interface vlan-id [ to vlan-interface vlan-id ]: Specifies one or more VLAN interfaces.

all: Specifies all VLAN interfaces.

Description

Use the dhcp server option command to configure a custom DHCP option for the DHCP address pool of current VLAN interface, or for the DHCP address pool(s) of the specified VLAN interface(s).

Use the undo dhcp server option command to remove a custom DHCP option configured for the DHCP address pool of current VLAN interface, or for the DHCP address pool(s) of the specified VLAN interface(s).

If you execute the dhcp server option command multiple times, the new configurations overwrite the corresponding old ones.

Related command: option.

Example

# Configure a custom DHCP option for the DHCP address pool of VLAN interface 1, with the code argument of 100 and the hex-string argument of 0x11 and 0x22.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface vlan-interface 1

[H3C-Vlan-interface1] dhcp server option 100 hex 11 22

4.2.11 dhcp server ping

Syntax

dhcp server ping { packets number | timeout milliseconds }

undo dhcp server ping { packets | timeout }

View

System view

Parameter

packets number: Sets the maximum times to send ping packets. The number argument ranges from 0 to 10 and defaults to 2. Value of 0 specifies not to send any ping packet.

timeout milliseconds: Sets the maximum time to wait for a response to a ping packet. The milliseconds argument is in the unit of milliseconds; it ranges from 0 to 10000 and defaults to 500.

Description

Use the dhcp server ping command to set the maximum times to send ping packets or the maximum time for the DHCP server to wait for a response after sending a ping packet.

Use the undo dhcp server ping command to revert to the corresponding default setting.

Example

# Set the maximum times to send ping packets to 10.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server ping packets 10

# Set the maximum time to wait for a response to a ping packet to 600 milliseconds.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server ping timeout 600

4.2.12 dhcp server static-bind

Syntax

dhcp server static-bind ip-address ip-address mac-address mac-address

undo dhcp server static-bind { ip-address ip-address | mac-address mac-address }

View

VLAN interface view

Parameter

ip-address: IP address to be bound statically. Note that the IP address must be a valid IP address in the address pool of the current VLAN interface.

mac-address: MAC address for the IP address to be bound to.

Description

Use the dhcp server static-bind command to statically bind an IP address in the address pool of the current VLAN interface to a MAC address.

Use the undo dhcp server static-bind command to remove a statically bound IP address entry.

IP addresses in the address pool of a VLAN interface are not statically bound by default.

VLAN interface address pool only supports one-to-one MAC-IP binding.

Example

# Statically bind the IP address 10.1.1.1 to the MAC address 0000-e03f-0305.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface vlan-interface 1

[H3C-Vlan-interface1] dhcp server static-bind ip-address 10.1.1.1 mac-address 0000-e03f-0305

4.2.13 display dhcp server conflict

Syntax

display dhcp server conflict { all | ip ip-address }

View

Any view

Parameter

all: Specifies all IP addresses.

ip ip-address: Specifies an IP address.

Description

Use the display dhcp server conflict command to display the statistics about DHCP address conflicts.

Related command: reset dhcp server conflict.

Example

# Display the statistics about DHCP address conflicts.

<H3C> display dhcp server conflict all

Address Discover Time

10.110.1.2 Jan 11 2003 11:57: 7 PM

Table 4-1 Description on the fields of the display dhcp server conflict command

Field	Description
Address	The IP address that causes the conflict
Discover Time	The time when the conflict is discovered

4.2.14 display dhcp server expired

Syntax

display dhcp server expired { ip ip-address | pool [ pool-name ] | interface [ vlan-interface vlan-id ] | all }

View

Any view

Parameter

ip ip-address: Specifies an IP address.

pool [ pool-name ]: Specifies a global address pool. If you do not input a pool-name, all global address pools are included.

interface [ vlan-interface vlan-id ]: Specifies a VLAN interface address pool. If you do not input a vlan-id, all VLAN interface address pools are included.

all: Specifies all DHCP address pools.

Description

Use the display dhcp server expired command to display information about lease-expired addresses. If no available IP address exists in a DHCP address pool, the DHCP server assigns the lease-expired IP addresses in the pool to DHCP clients as needed.

Example

# Display information about lease-expired addresses.

<H3C> display dhcp server expired all

Global pool:

IP address Hardware address Lease expiration Type

Interface pool:

IP address Hardware address Lease expiration Type

Table 4-2 Description on the fields of the display dhcp server expired command

Field	Description
Global pool	The information followed is about expired IP addresses in global address pool(s)
Interface pool	The information followed is about lease-expired IP addresses in VLAN interface address pool(s)
IP address	Bound IP addresses
Hardware address	Bound MAC addresses
Lease expiration	The time when an IP address expires
Type	Binding type

4.2.15 display dhcp server free-ip

Syntax

display dhcp server free-ip

View

Any view

Parameter

None

Description

Use the display dhcp server free-ip command to display the ranges of available (unassigned) IP addresses in DHCP address pools.

Example

# Display the ranges of available (unassigned) IP addresses in DHCP address pools.

<H3C> display dhcp server free-ip

IP Range from 1.0.0.0 to 2.2.2.1

IP Range from 2.2.2.3 to 2.255.255.255

IP Range from 4.0.0.0 to 4.255.255.255

IP Range from 5.5.5.0 to 5.5.5.0

IP Range from 5.5.5.2 to 5.5.5.255

4.2.16 display dhcp server ip-in-use

Syntax

display dhcp server ip-in-use { ip ip-address | pool [ pool-name ] | interface [ vlan-interface vlan-id ] | all }

View

Any view

Parameter

ip ip-address: Specifies an IP address.

pool [ pool-name ]: Specifies a global address pool. If you do not input a pool-name, all global address pools are included.

interface [ vlan-interface vlan-id ]: Specifies a VLAN interface address pool. If you do not input a vlan-id, all VLAN interface address pools are included.

all: Specifies all DHCP address pools.

Description

Use the display dhcp server ip-in-use command to display information about IP address binding in DHCP address pool(s).

Related command: reset dhcp server ip-in-use.

Example

# Display information about IP address binding in all DHCP address pools.

<H3C> display dhcp server ip-in-use all

Global pool:

IP address Hardware address Lease expiration Type

2.2.2.2 44444-4444-4444 NOT Used Manual

Interface pool:

IP address Hardware address Lease expiration Type

5.5.5.1 0050-ba28-930a Jun 5 2003 10:56: 7 AM Auto:COMMITED

Table 4-3 Description on the fields of the display dhcp server ip-in-use command

Fields	Description
Global pool	The information followed is about bound IP addresses in global address pool(s)
Interface pool	The information followed is about bound IP addresses in VLAN interface address pool(s)
IP address	Bound IP addresses
Hardware address	Bound MAC addresses
Lease expiration	The time when an IP address expires
Type	Binding type

4.2.17 display dhcp server statistics

Syntax

display dhcp server statistics

View

Any view

Parameter

None

Description

Use the display dhcp server statistics command to display statistics information about the DHCP server.

Related command: reset dhcp server statistics.

Example

# Display statistics information about the DHCP server.

<H3C> display dhcp server statistics

Global Pool:

Pool Number: 5

Binding

Auto: 0

Manual: 1

Expire: 0

Interface Pool:

Pool Number: 1

Binding

Auto: 1

Manual: 0

Expire: 0

Boot Request: 6

Dhcp Discover: 1

Dhcp Request: 4

Dhcp Decline: 0

Dhcp Release: 1

Dhcp Inform: 0

Boot Reply: 4

Dhcp Offer: 1

Dhcp Ack: 3

Dhcp Nak: 0

Bad Messages: 0

Table 4-4 Description on the fields of the display dhcp server statistics command

Field	Description
Global Pool	The information followed is about the statistics of the global address pools
Interface Pool	The information followed is about the statistics of the address pools of VLAN interfaces
Pool Number	Number of address pools
Auto	Number of automatically bound IP addresses
Manual	Number of manually bound IP addresses
Expire	Number of expired IP addresses
Boot Request: 6 Dhcp Discover: 1 Dhcp Request: 4 Dhcp Decline: 0 Dhcp Release: 1 Dhcp Inform: 0	Total and categorized DHCP packets received by the DHCP server
Boot Reply: 4 Dhcp Offer: 1 Dhcp Ack: 3 Dhcp Nak: 0	Total and categorized DHCP packets sent by the DHCP server
Bad Messages	Number of bad DHCP packets

4.2.18 display dhcp server tree

Syntax

display dhcp server tree { pool [ pool-name ] | interface [ vlan-interface vlan-id ] | all }

View

Any view

Parameter

pool [ pool-name ]: Specifies a global address pool. If you do not specify a global address pool, all global address pools are included.

interface [ vlan-interface vlan-id ]: Specifies the address pool of a VLAN interface. If you do not specify a VALN interface, address pools of all VLAN interfaces are included.

all: Specifies all addresses pools.

Description

Use the display dhcp server tree command to display information about DHCP address pool hierarchy.

Example

# Display information about DHCP address pool hierarchy.

<H3C> display dhcp server tree all

Global pool:

Pool name: 5

network 10.10.1.0 mask 255.255.255.0

Child node:6

Sibling node:7

option 1 ip-address 255.0.0.0

expired 1 0 0

option 58 hex 00 00 A8 C0

option 59 hex 00 00 00 3C

Pool name: 6

static-bind ip-address 10.10.1.2 mask 255.0.0.0

static-bind mac-address 00e0-00fc-0001

Parent node:5

option 1 ip-address 255.255.0.

expired 1 0 0

option 58 hex 00 00 A8 C0

option 59 hex 00 00 00 3C

Pool name: 7

network 10.10.1.64 mask 255.255.255.192

PrevSibling node:5

option 1 ip-address 255.0.0.0

gateway-list 2.2.2.2

dns-list 1.1.1.1

domain-name 444444

nbns-list 3.3.3.3

expired 1 0 0

option 58 hex 00 00 A8 C0

option 59 hex 00 00 00 3C

Table 4-5 Description on the fields of the display dhcp server tree command

Field	Description
Global pool	The information followed is about global address pools
Interface pool	The information followed is about VLAN interface address pools
Pool Name	The name of an address pool
Network	Range of addresses available for assigning
static-bind ip-address 10.10.1.2 mask 255.0.0.0 static-bind mac-address 00e0-00fc-0001	An IP address and the corresponding MAC address statically bound to it
child node:6	The address pool named 6 is a child node of the one named 5 Based on the node position of the address pool named 5, the node type displayed here includes the following: Child node: Indicates the node to which the address pool named 6 corresponds is a child node of that of the address pool named 5. In this case, node 6 stands for a subnet of the network node 5 stands for Parent node: Indicates the node to which the address pool named 6 corresponds is the parent node of that of the address pool named 5. In this case, node 6 stands for the network segment Sibling node: Indicates the node to which the address pool named 6 corresponds is the next sibling node of that of the address pool named 5. Information about these address pools is displayed in the order they are established PrevSibling node: Indicates the node to which the address pool named 6 corresponds is the previous sibling node of that of the address pool named 5
Option	Customized DHCP options
expired	The valid period of the leased IP addresses in the address pool, including number of days, hours and minutes
gateway-list	The list of outbound gateways configured for the DHCP clients
dns-list	The list of DNS servers configured for the DHCP clients
domain-name	The domain name configured for the DHCP clients
nbns-list	The NetBIOS server configured for the DHCP clients

4.2.19 dns-list

Syntax

dns-list ip-address [ ip-address ]

undo dns-list { ip-address | all }

View

DHCP address pool view

Parameter

ip-address: IP address of a DNS server. You can specify up to eight IP addresses (separated by spaces) in one command.

all: Specifies all configured DNS server IP addresses.

Description

Use the dns-list command to configure one or more DNS server IP addresses for a global DHCP address pool.

Use the undo dns-list command to remove one or all DNS server IP addresses configured for a global DHCP address pool.

By default, no DNS server IP address is configured for a global DHCP address pool.

With eight DNS server addresses already configured, if you add a new one by executing the dns-list command, the new one overwrites the oldest one.

Related command: dhcp server dns-list, dhcp server ip-pool.

Example

# Configure a DNS server with an IP address of 1.1.1.254 for the global DHCP address pool 0.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server ip-pool 0

[H3C-dhcp-0] dns-list 1.1.1.254

4.2.20 domain-name

Syntax

domain-name domain-name

undo domain-name

View

DHCP address pool view

Parameter

domain-name: Domain name, a string that is of 3 to 50 characters in length.

Description

Use the domain-name command to configure a domain name for the DHCP clients of a global DHCP address pool.

Use the undo domain-name command to remove the domain name configured for the DHCP clients of a global DHCP address pool.

By default, no domain name is configured for the DHCP clients of a global DHCP address pool.

Related command: dhcp server ip-pool, dhcp server domain-name.

Example

# Configure a domain name (mydomain.com) for the DHCP clients of the global DHCP address pool 0.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server ip-pool 0

[H3C-dhcp-0] domain-name mydomain.com

4.2.21 expired

Syntax

expired { day day [ hour hour [ minute minute ] ] | unlimited }

undo expired

View

DHCP address pool view

Parameter

day day: Specifies the number of days. The day argument ranges from 0 to 365.

hour hour: Specifies the number of hours. The hour argument ranges from 0 to 23.

minute minute: Specifies the number of minutes. The minute argument ranges from 0 to 59.

unlimited: Specifies an unlimited lease time.

Description

Use the expired command to set the valid period for a global DHCP address pool.

Use the undo expired command to revert to the default valid period.

The default valid period is 1 day.

Related command: dhcp server ip-pool, dhcp server expired.

Example

# Set the IP address lease time of the global DHCP address pool 0 to one day plus two hours and three minutes.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server ip-pool 0

[H3C-dhcp-0] expired day 1 hour 2 minute 3

4.2.22 gateway-list

Syntax

gateway-list ip-address [ ip-address ]

undo gateway-list { ip-address | all }

View

DHCP address pool view

Parameter

ip-address: IP address of an outbound gateway. You can specify up to eight IP addresses (separated by spaces) in one command.

all: Specifies all outbound gateway IP addresses.

Description

Use the gateway-list command to configure one or more outbound gateway addresses for DHCP clients.

Use the undo gateway-list command to remove one or all outbound gateway addresses configured for DHCP clients.

By default, no outbound gateway address is configured for DHCP clients.

With eight outbound gateway addresses already configured, if you add a new outbound gateway address by executing the gateway-list command, the new one overwrites the oldest one.

Example

# Configure an outbound gateway with an IP address of 10.110.1.99 for DHCP clients of global DHCP address pool 0.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server ip-pool 0

[H3C-dhcp-0] gateway-list 10.110.1.99

4.2.23 nbns-list

Syntax

nbns-list ip-address [ ip-address ]

undo nbns-list { ip-address | all }

View

DHCP address pool view

Parameter

ip-address: IP address of a NetBIOS server. You can specify up to eight IP addresses (separated by spaces) in one command.

all: Specifies all configured NetBIOS server IP addresses.

Description

Use the nbns-list command to configure one or more NetBIOS server addresses for a global DHCP address pool.

Use the undo nbns-list command to remove one or all NetBIOS server addresses configured for a global DHCP address pool.

By default, no NetBIOS server address is configured for a global DHCP address pool.

With eight NetBIOS server addresses already configured, if you add a new NetBIOS server address by executing the nbns-list command, the new one overwrites the oldest one.

Related command: dhcp server ip-pool, dhcp server nbns-list, netbios-type.

Example

# Configure a NetBIOS server with an IP address of 10.12.1.99 for the global DHCP address pool named 0.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server ip-pool 0

[H3C-dhcp-0] nbns-list 10.12.1.99

4.2.24 netbios-type

Syntax

netbios-type { b-node | h-node | m-node | p-node }

undo netbios-type

View

DHCP address pool view

Parameter

b-node: Specifies the NetBIOS node type of DHCP clients to be b-node (b stands for broadcast). Nodes of this type establish their host name-to-IP address mappings by broadcasting.

p-node: Specifies the NetBIOS node type of DHCP clients to be p-node (p stands for peer-to-peer). Nodes of this type establish their host name-to-IP address mappings by communicating with NetBIOS server.

m-node: Specifies the NetBIOS node type of DHCP clients to be m-node (m stands for mixed). Nodes of this type are p nodes which take some broadcast features.

h-node: Specifies the NetBIOS node type of DHCP clients to be h-node (h stands for hybrid). Nodes of this type are b nodes which take peer-to-peer mechanism.

Description

Use the netbios-type command to configure the NetBIOS node type for DHCP clients of a global DHCP address pool.

Use the undo netbios-type command to remove NetBIOS node type configuration of a global DHCP address pool.

By default, the DHCP clients are of h-node type.

Related command: dhcp server ip-pool, dhcp server netbios-byte, nbns-list.

Example

# Configure the NetBIOS node type of DHCP clients of the global DHCP address pool 0 to b-node.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server ip-pool 0

[H3C-dhcp-0] netbios-type b-node

4.2.25 network

Syntax

network ip-address [ mask netmask ]

undo network

View

DHCP address pool view

Parameter

ip-address: Address range for dynamic IP address assigning.

mask netmask: Specifies the subnet mask of the address pool. If you do not provide this argument, the default subnet mask is used.

Description

Use the network command to configure an address range for dynamic IP address assignment.

Use the undo network command to remove the address range configured for dynamic IP address assignment.

By default, no IP address range is configured for dynamic IP address assignment.

Each DHCP address pool can be configured with only one address range. If you execute the network command multiple times, then only the last configured address range works.

Related command: dhcp server ip-pool, dhcp server forbidden-ip.

Example

# Configure 192.168.8.0/24 as the address range for the global DHCP address pool 0.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server ip-pool 0

[H3C-dhcp-0] network 192.168.8.0 mask 255.255.255.0

4.2.26 option

Syntax

option code { ascii ascii-string | hex hex-string | ip-address ip-address [ ip-address ] }

undo option code

View

DHCP address pool view

Parameter

code: Customized option value, a number ranging from 2 to 254.

ascii ascii-string: Specifies an ASCII string. The ascii-string argument is a string that is of 1 to 63 characters in length.

hex hex-string: Specifies a numeric string containing two or four hexadecimal digits (hh or hhhh).

ip-address ip-address [ ip-address ]: Specifies one or more IP addresses. You can specify up to eight IP addresses (separated by spaces) in one command.

Description

Use the option command to configure a custom DHCP option for a global DHCP address pool.

Use the undo option command to remove a custom DHCP option configured for the global DHCP address pool.

If you execute the option command multiple times, the new configurations overwrite the corresponding old ones

Related command: dhcp server ip-pool, dhcp server option.

Example

# Configure a custom option for the global DHCP address pool, with an option value of 100 and two hexadecimal numbers of 0x11 and 0x22.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server ip-pool 0

[H3C-dhcp-0] option 100 hex 11 22

4.2.27 reset dhcp server conflict

Syntax

reset dhcp server conflict { ip ip-address | all }

View

User view

Parameter

ip-address: Clears statistics about the specified IP address conflicts.

all: Clears all statistics about address conflicts.

Description

Use the reset dhcp server conflict command to clear statistics information about DHCP address conflicts.

Related command: display dhcp server conflict.

Example

# Clear all statistics information about DHCP address conflicts.

<H3C> reset dhcp server conflict all

4.2.28 reset dhcp server ip-in-use

Syntax

reset dhcp server ip-in-use{ all | interface [ vlan-interface vlan-id ] | ip ip-address | pool [ pool-name ] }

View

User view

Parameter

all: Specifies all binding entries.

ip-address: Specifies the binding entry that contains the specified IP address.

pool-name: Specifies a global DHCP address pool. If you do not provide this argument, then all global DHCP address pools are included.

vlan-id: Specifies a VLAN interface DHCP address pool. If you do not provide this argument, then all VLAN interface DHCP address pools are included.

Description

Use the reset dhcp server ip-in-use command to clear configuration about dynamically bound DHCP addresses.

Related command: display dhcp server ip-in-use.

Example

# Clear the binding entries that contain the IP address of 10.110.1.1.

<H3C> reset dhcp server ip-in-use ip 10.110.1.1

4.2.29 reset dhcp server statistics

Syntax

reset dhcp server statistics

View

User view

Parameter

None

Description

Use the reset dhcp server statistics command to clear statistics information about the DHCP servers, such as the number of DHCP address pools, the number of automatically bound, manually bound IP addresses and expired IP addresses, and the number of unrecognized packets, DHCP_Request packets and DHCP_ACK packets.

Related command: display dhcp server statistics.

Example

# Clear statistics information about the DHCP servers.

<H3C> reset dhcp server statistics

4.2.30 static-bind ip-address

Syntax

static-bind ip-address ip-address [ mask netmask ]

undo static-bind ip-address

View

DHCP address pool view

Parameter

ip-address: IP address to be bound.

mask netmask: Specifies the subnet mask of the IP address to be bound. If you do not provide the argument, the default subnet mask is used.

Description

Use the static-bind ip-address command to specify the IP address to be statically bound.

Use the undo static-bind ip-address command to free a statically bound IP address.

By default, no IP address is statically bound.

The static-bind ip-address command and the static-bind mac-address command must be coupled when you configure statically bound entries to specify the corresponding IP address bound to the MAC address specified by the static-bind mac-address command.

Related command: dhcp server ip-pool, static-bind mac-address.

Example

# Bind the PC with a MAC address of 0000-e03f-0305 to 10.1.1.1, whose subnet mask is 255.255.255.0.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server ip-pool 0

[H3C-dhcp-0] static-bind ip-address 10.1.1.1 mask 255.255.255.0

[H3C-dhcp-0] static-bind mac-address 0000-e03f-0305

4.2.31 static-bind mac-address

Syntax

static-bind mac-address mac-address

undo static-bind mac-address

View

DHCP address pool view

Parameter

mac-address: MAC address to be bound.

Description

Use the static-bind mac-address command to specify the MAC address to be statically bound.

Use the undo static-bind mac-address command to free a statically bound MAC address.

By default, no MAC address is statically bound.

The static-bind mac-address command and the static-bind ip-address command must be coupled when you configure statically bound entries to specify the corresponding MAC address bound to the IP address specified by the static-bind ip-address command.

Related command: dhcp server ip-pool and static-bind ip-address.

Example

# Bind the PC with a MAC address of 0000-e03f-0305 to 10.1.1.1, whose subnet mask is 255.255.255.0.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server ip-pool 0

[H3C-dhcp-0] static-bind ip-address 10.1.1.1 mask 255.255.255.0

[H3C-dhcp-0] static-bind mac-address 0000-e03f-0305

4.3 DHCP Relay Configuration Commands

4.3.1 debugging dhcp relay

Syntax

debugging dhcp relay { all| packet | error | event }

undo debugging dhcp relay { all| packet | error | event }

View

User view

Parameter

all: Enables all types of debugging concerning DHCP Relay.

packet: Enables debugging for packets.

error: Enables debugging for error messages.

event: Enables debugging for events.

Description

Use the debugging dhcp-relay command to enable debugging for DHCP Relay.

Use the undo debugging dhcp-relay command to disable specified type of debugging concerning DHCP Relay.

Debugging for DHCP Relay is disabled by default.

Example

# Enable debugging for DHCP Relay.

<H3C> debugging dhcp relay

*0.7200205-DHCP-8-dhcp_debug:

From client to server:

Interface: VLAN-Interface 1

Type: dhcp-request

ClientHardAddress: 0010-dc19-695d

ServerIpAddress: 192.168.1.2

*0.7200230-DHCP-8-dhcp_debug:

From server to client:

Interface: VLAN-Interface 1

ServerGroupNo: 0

Type: dhcp-ack

ClientHardAddress: 0010-dc19-695d

your ip address: 10.1.1.1

*0.7200580-DHCP-8-largehop:

Discard DHCP request packet because of too large hop count!

*0.7200725-DHCP-8-invalidpkt:

Wrong DHCP packet!

Table 4-6 Description on the fields of the debugging dhcp-relay command

Field	Description
Interface	The VLAN interface that forwards DHCP packets
Type	Type of the forwarded DHCP packet
ClientHardAddress	The MAC address of the DHCP client
ServerIpAddress	The IP address of the DHCP server
your ip address	The IP address assigned to the DHCP client

4.3.2 dhcp relay security

Syntax

dhcp relay security ip-address mac-address static

undo dhcp relay security ip-address

View

System view

Parameter

ip-address: IP address the user uses.

mac-address: MAC address the user owns.

static: Specifies the user address entry is static.

Description

Use the dhcp relay security command to add a user address entry for the DHCP server.

Use the undo dhcp relay security command to remove a user address entry configured for the DHCP server.

Before adding/removing a user address entry, you can check user address entries configured for the DHCP server using the display dhcprelay-security command.

Example

# Configure a user address entry for a DHCP server, with an IP address of 1.1.1.1 and a MAC address of 0005-5D02-F2B3.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp relay security 1.1.1.1 0005-5D02-F2B3 static

4.3.3 dhcp relay security address-check

Syntax

dhcp relay security address-check { enable | disable }

View

VLAN interface view

Parameter

None

Description

Use the dhcp relay security address-check enable command to enable security address checking on a VLAN interface.

Use the dhcp relay security address-check disable command to disable security address checking on a VLAN interface.

For a VLAN interface, security address checking is disabled by default.

Example

# Enable security address checking on VLAN interface 1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C]interface vlan-interface 1

[H3C-Vlan-interface1] dhcp relay security address-check enable

4.3.4 dhcp-server detect

Syntax

dhcp server detect

undo dhcp server detect

View

System view

Parameter

None

Description

Use the dhcp server detect command to enable fake DHCP server detecting.

Use the undo dhcp server detect command to disable fake DHCP server detecting.

A private DHCP server in a network also answers IP address request packets and issues IP addresses to DHCP clients. However, the IP addresses they issued always bring addresses conflicts and cause users cannot access networks. This kind of DHCP servers are known as fake DHCP servers.

Example

# Enable fake DHCP server detecting.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dhcp server detect

4.3.5 display dhcp relay address

Syntax

display dhcp relay address { interface vlan-interface vlan-id | all }

View

Any view

Parameter

vlan-id: VLAN number.

interface vlan-interface: Specifies to display information about the DHCP servers configured for the VLAN interface.

all: Specifies to display information about the DHCP servers configured for all VLAN interfaces.

Description

Use the display dhcp relay address command to display information about DHCP servers configured for a VLAN interface.

Example

# Display information about DHCP servers configured for all VLAN interfaces.

<H3C> display dhcp relay address all

** Vlan-interface192 DHCP Relay Address **

Relay Address [0] : 193.193.1.1

Relay Address [1] : 1.1.1.1

# Display information about DHCP servers configured for VLAN interface 192.

<H3C> display dhcp relay address interface vlan 192

** Vlan-interface192 DHCP Relay Address **

Relay Address [0] : 193.193.1.1

Relay Address [1] : 1.1.1.1

4.3.6 display dhcprelay-security

Syntax

display dhcprelay-security [ ip-address ]

View

Any view

Parameter

ip-address: User IP address.

Description

Use the display dhcprelay-security command to display information about specific or all user address entries that the DHCP server maintains.

Example

# Display information about all user address entries that the DHCP server maintains.

<H3C> display dhcprelay-security

IP Address MAC Address IP Address Type

2.2.2.2 0005-5d02-f2b2 Static

3.3.3.3 0005-5d02-f2b3 Dynamic

--- 2 dhcp-security item(s) found ---

Table 4-7 Description on the fields of the display dhcp-security command

Field	Description
IP Address	User IP address
MAC Address	User MAC address
IP Address Type	Type of the user address entry, which can be static or dynamic

4.3.7 ip relay address

Syntax

ip relay address ip-address

undo ip relay address { ip-address | all }

View

VLAN interface view

Parameter

ip-address: IP address of the DHCP server to which the DHCP packets received by this VLAN interface are forwarded.

all: Specifies all DHCP servers configured for the VLAN interface to forward DHCP packets to.

Description

Use the ip relay address command to specify the VLAN interface to operate in DHCP Relay mode and to specify the DHCP server to which the DHCP packets received by this VLAN interface are forwarded.

Use the undo ip relay address command to remove the DHCP server configured for the VLAN interface to forward DHCP packets.

No DHCP server is configured for a VLAN interface by default.

Caution:

The IP address of the intended DHCP server for the Dhcp relay feature cannot be the IP address of the VLAN interface corresponding to the DHCP Relay. Otherwise, the system gives the information such as “Can't set ip relay address as interface address on interface Vlan-interface 100!”.

Example

# Specify users belonging to VLAN interface 1 to acquire their IP addresses from a specified DHCP server.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C]interface vlan1

[H3C-Vlan-interface1] ip relay address 10.9.0.3

Chapter 5 DHCP Option 82 Configuration Commands

5.1 DHCP Option 82 Configuration Commands

5.1.1 dhcp relay information enable

Syntax

dhcp relay information enable

undo dhcp relay information enable

View

System view

Parameter

None

Description

Use the dhcp relay information enable command to enable the function of Option 82 support on DHCP relay.

Use the undo dhcp relay information enable command to disable the function of Option 82 support on DHCP relay.

By default, this function is enabled. In this case, the DHCP relay will add Option 82 into the request packets sent from the DHCP clients and then forward the packets to the DHCP server.

Related command: dhcp server relay information enable.

Example

# Enable Option 82 support on DHCP relay so that the relay adds Option 82 into the request packets from the DHCP clients before it forwards these packets to a DHCP server.

<H3C> system-view

System View: return to User View with Ctrl+Z

[H3C] dhcp relay information enable

# Disable Option 82 support on DHCP relay so that the relay does not add Option 82 into the request packets from the DHCP clients before it forwards these packets to a DHCP server.

[H3C] undo dhcp relay information enable

5.1.2 dhcp relay information strategy

Syntax

dhcp relay information strategy { drop | keep | replace }

undo dhcp relay information strategy

View

System view

Parameter

drop: Indicates that the DHCP relay will drop the packets carrying Option 82.

keep: Indicates that the DHCP relay DHCP relay does not change the packets carrying Option 82.

replace: Indicates that the DHCP relay replaces Option 82 carried by the packets with its own Option 82.

Description

Use the dhcp relay information strategy command to configure the strategy for the DHCP relay to process the packets carrying Option 82.

Use the undo dhcp relay information strategy command to restore the default strategy.

By default, the replace strategy is adopted.

Example

# Configure the DHCP relay to drop the request packets carrying Option 82.

<H3C> system-view

System View: return to User View with Ctrl+Z

[H3C] dhcp relay information strategy drop

# Restore the default strategy for the DHCP relay to process the request packets.

[H3C]undo dhcp relay information strategy

5.1.3 dhcp server relay information enable

Syntax

dhcp server relay information enable

undo dhcp server relay information enable

View

System view

Parameter

None

Description

Use the dhcp server relay information enable command to enable the function of Option 82 support on DHCP server.

Use the undo dhcp server relay information enable command to disable the function of Option 82 support on DHCP server.

When a client connected to a DHCP relay broadcasts a DHCP request packet, the DHCP relay is responsible for forwarding the packet to a DHCP server. After Option 82 support is enabled on the DHCP server, if the request packet forwarded by the DHCP relay to the DHCP server carries Option 82, the response packet sent by the DHCP server will carry a response Option 82.

After receiving the response packet from the DHCP server to the DHCP client, the DHCP relay check whether Option 82 exists in the packet. If yes, it strips Option 82. That is, the response packet sent to the client does not carry Option 82.

By default, the function is enabled. That is, the DHCP server will return Option 82 carried in the request packet to the DHCP relay.

Related command: dhcp relay information enable.

Example

# Enable the DHCP server to return Option 82 carried in the request packets to the DHCP relay.

<H3C> system-view

System View: return to User View with Ctrl+Z

[H3C] dhcp server relay information enable

# Disable the DHCP server from returning Option 82 carried in the request packets to the DHCP relay.

[H3C] undo dhcp server relay information enable

Chapter 6 DNS Configuration Commands

6.1 Static DNS Configuration Commands

6.1.1 ip host

Syntax

ip host hostname ip-address

undo ip host hostname [ ip-address ]

View

System view

Parameter

hostname: Name of the host. It is a character string that consists of 1 to 20 characters, including letters, numbers, "_" or “,”, and it must contain at least one letter.

ip-address: Host IP address (the corresponding IP address to the host name) in dotted decimal notation.

Description

Use the ip host command to configure the host name and the host IP address.

Use the undo ip host command to cancel the host name and the host IP address.

By default, Host name and corresponding IP address are null.

Related command: display ip host.

Example

# Set swtich1’s IP address to be 10.110.0.1.

[H3C] ip host switch1 10.110.0.1

6.1.2 display ip host

Syntax

display ip host

View

Any view

Parameter

None

Description

Use the display ip host command to view all the host names and the corresponding IP addresses.

Example

# Display all host names and the corresponding IP addresses of the hosts.

<H3C> display ip host

Host Age Flags Address

My 0 static 1.1.1.1

Aa 0 static 2.2.2.4

Table 6-1 Description on the fields of the display ip host command

Field	Description
Host	Host name
Age	Valid period
Flags	Flags
Address	Host IP address

6.2 Dynamic DNS Configuration Commands

6.2.1 debugging dns

Syntax

debugging dns

undo debugging dns

View

User view

Parameter

None

Description

Use the debugging dns command to enable DNS debugging.

Use the undo debugging dns command to disable DNS debugging.

By default, DNS debugging is disabled.

Example

# Enable DNS debugging

<H3C> debugging dns

make DNS packet for name adcd.com succeed

The information above indicates that the query packet for the domain name “abcd.com” is generated.

send the packet to 172.16.1.1 DNS server for 1 time

The information above indicates that the first query is performed to the domain name with the IP address of “172.16.1.1”.

receive a right answer from server 0xAC100101

The information above indicates that a correct answer packet is received from the server.

query timeout

The information above indicates that the query for a domain name from a server times out because no answer is received.

6.2.2 display dns domain

Syntax

display dns domain

View

Any view

Parameter

None

Description

Use the display dns domain command to view the domain name suffix list.

Related command: dns domain.

Example

# View domain name suffix list.

<H3C> display dns domain

No Domain-name

0 abcd.com

Table 6-2 Description on the fields of the display dns domain command

Field	Description
No	Sequence number
Domain-name	Domain name suffix name

6.2.3 display dns dynamic-host

Syntax

display dns dynamic-host

View

Any view

Parameter

None

Description

Use the display dns dynamic-host command to view the dynamic domain name buffer.

Example

# View the dynamic domain name buffer.

<H3C> display dns dynamic-host

No Domain-name Ipaddress RR‑TTL(S) Alias

0 www.baidu.com 202.108.249.134 63000

1 www.yahoo.akadns.net 66.94.230.39 24

2 www.hotmail.com 207.68.172.239 3585

3 www.eyou.com 61.136.62.70 3591

Table 6-3 Description on the fields of the display dns dynamic-host command

Field	Description
No	Sequence number
Domain-name	Domain name
Ipaddress	Corresponding IP name of the domain name
RR–TTL(S)	Time to live, that is, the time for an entry to be stored, in seconds.
Alias	Alias of the domain name. There can be four of them at the most.

6.2.4 display dns server

Syntax

display dns server

View

Any view

Parameter

None

Description

Use the display dns server command to view the related information of the domain name server.

Related command: dns server.

Example

# View the related information of the domain name server.

<H3C> display dns server

Domain-server Ipaddress

0 172.16.1.1

1 172.16.1.2

Table 6-4 Description on the fields of the display dns server command

Field	Description
Domain-server	Domain name server
Ipaddress	Corresponding IP address of the domain name server

6.2.5 dns domain

Syntax

dns domain domain-name

undo dns domain [ domain-name ]

View

System view

Parameter

domain-name: Domain name suffix.

Description

Use the dns domain command to add the domain name suffix.

Use the undo dns domain command to delete the domain name suffix.

The system supports up to 10 domain name suffixes. To delete the domain name suffix, input the suffix name, and the specific suffix is deleted. Otherwise, all of the suffixes are deleted.

Related command: display dns domain.

Example

# Configure a domain name suffix “com”.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dns domain com

6.2.6 dns resolve

Syntax

dns resolve

undo dns resolve

View

System view

Parameter

None

Description

Use the dns resolve command to enable the dynamic domain name resolution function.

Use the undo dns resolve command to disable the dynamic domain name resolution function.

By default, the dynamic domain name resolution function is disabled.

Example

# Enable dynamic domain name resolution.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dns resolve

6.2.7 dns server

Syntax

dns server ip-address

undo dns server [ ip-address ]

View

System view

Parameter

ip-address: IP address of the domain name server.

Description

Use the dns server command to configure the IP address of a domain name server.

Use the undo dns server command to delete the IP address of a domain name server.

The system supports up to six domain name server. To delete the domain name server, input the IP address, and the specific server is deleted. Otherwise, all of the servers are deleted.

Related command: display dns server.

Example

# Configure a domain name server, with an IP address of 172.16.1.1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] dns server 172.16.1.1

6.2.8 reset dns dynamic-host

Syntax

reset dns dynamic-host

View

User view

Parameter

None

Description

Use the reset dns dynamic-host command to clear the dynamic domain name buffer.

Related command: display dns dynamic-host.

Example

# Clear the dynamic domain name buffer.

<H3C> reset dns dynamic-host

Chapter 7 IP Performance Configuration Commands

7.1 IP Performance Configuration Commands

7.1.1 display fib

Syntax

display fib

View

Any view

Parameter

None

Description

Use the display fib command to view the entries of the forwarding information base. Each line outputs indicates a FIB entry. The information includes destination address/mask length, next hop, current flag, timestamp and outbound interface.

Example

# Display the entries of the Forwarding Information Base.

<H3C> display fib

Destination/Mask Nexthop Flag TimeStamp Interface

10.153.17.0/24 10.153.17.99 U t[0] Vlan-interface1

10.153.18.88/32 127.0.0.1 GHU t[0] InLoopBack0

10.153.18.0/24 10.153.18.88 U t[0] LoopBack0

10.153.17.99/32 127.0.0.1 GHU t[0] InLoopBack0

127.0.0.0/8 127.0.0.1 U t[0] InLoopBack0

Table 7-1 Description on the fields of the display fib command

Field	Description
Destination/Mask	Destination address/Mask length
Nexthop	The forwarding next hop address
Flag	The flag options include: B – Blackhole route D – Dynamic route G – Gateway route H – Local host route S – Static route U – Route in UP status R – Unreachable route L – Route generated by ARP or ESIS
Timestamp	Timestamp
Interface	The forwarding interface

7.1.2 display fib ip-address

Syntax

display fib [ ip-address1 { mask1 | mask-length1 } [ ip-address2 { mask2 | mask-length2 } | longer ] | longer ]

View

Any view

Parameter

ip-address1, ip-address2: Destination IP address, in dotted decimal format. ip-address1 and ip-address2 jointly define an address range. The FIB entries in this address range are displayed.

mask1, mask2: IP address mask, in dotted decimal format.

mask-length1, mask-length2: An integer in the range of 0 to 32 to represent the mask length.

longer: Specifies to display the FIB entries that match the specified IP address/subnet mask pairs.

Description

Use the display fib ip-address command to view the FIB entries matching the destination IP address (range). Each line outputs a FIB entry and the display contents for each entry include destination address/mask length, next hop, current flag, timestamp and outbound interface.

Example

# Display the FIB entries whose destination addresses match 169.253.0.0 in the natural mask range or which match most of 169.253.0.0..

<H3C> display fib 169.253.0.0

Route Entry Count: 1

Destination/Mask Nexthop Flag TimeStamp Interface

169.253.0.0/16 2.1.1.1 U t[0] Vlan-interface1

# Display the FIB entries whose destination addresses are in the range of 169.254.0.0/16 to 169.254.0.6/16.

<H3C> display fib 169.254.0.0 255.255.0.0 169.254.0.6 255.255.0.0

Route Entry Count: 1

Destination/Mask Nexthop Flag TimeStamp Interface

169.254.0.1/16 2.1.1.1 U t[0] Vlan-interface1

For the descriptions of the displayed fields, refer to Table 7-1.

7.1.3 display fib acl

Syntax

display fib acl { number | name }

View

Any view

Parameter

number: ACL in number form, in the range 2000 to 2999

name: ACL in name form, a string of 1 to 32 characters.

Description

Use the display fib command to view the FIB entries matching a specific ACL.

Example

# Display the FIB entries matching ACL 2000.

<H3C> display fib acl 2000

Route entry matched by access-list 2000:

Summary counts: 1

Destination/Mask Nexthop Flag TimeStamp Interface

127.0.0.0/8 127.0.0.1 U t[0] InLoopBack0

For the descriptions of the displayed fields, refer to Table 7-1.

7.1.4 display fib |

Syntax

display fib | { { begin | include | exclude } text }

View

Any view

Parameter

begin: Displays the FIB entries from the first one containing the character string text.

include: Displays only those FIB entries containing the character string text.

exclude: Displays only those FIB entries excluding the character string text.

text: Character string.

Description

Use the display fib | command to view the FIB entries which are output from the buffer according to regular expression and related to the specific character string.

Example

# Display the lines starting from the first one containing the string 169.254.0.0

<H3C> display fib | begin 169.254.0.0

Destination/Mask Nexthop Flag TimeStamp Interface

169.254.0.0/16 2.1.1.1 U t[0] Vlan-interface1

2.0.0.0/16 2.1.1.1 U t[0] Vlan-interface1

For the descriptions of the displayed fields, refer to Table 7-1.

7.1.5 display fib ip-prefix

Syntax

display fib ip-prefix listname

View

Any view

Parameter

listname: Prefix list name, a string of 1 to 19 characters in length.

Description

Use the display fib command to view the FIB entries matching the specific prefix list.

Example

# Display the FIB entries matching the prefix list abc0.

<H3C> display fib ip-prefix abc0

Route Entry matched by prefix-list abc0:

Summary count: 3

Destination/Mask Nexthop Flag TimeStamp Interface

127.0.0.0/8 127.0.0.1 U t[0] InLoopBack0

127.0.0.1/32 127.0.0.1 U t[0] InLoopBack0

169.0.0.0/8 2.1.1.1 SU t[0] Vlan-interface1

For the descriptions of the displayed fields, refer to Table 7-1.

7.1.6 display fib statistics

Syntax

display fib statistics

View

Any view

Parameter

None

Description

Use the display fib statistics command to view the total number of FIB entries.

Example

# Display the total number of FIB entries.

<H3C> display fib statistics

Route Entry Count : 30

7.1.7 display icmp statistics

Syntax

display icmp statistics

View

Any view

Parameter

None

Description

Use the display icmp statistics command to view the statistics information about ICMP packets.

Related command: display ip interface, reset ip statistics.

Example

# View statistics about ICMP packets.

<H3C> display icmp statistics

Input: bad formats 0 bad checksum 0

echo 5 destination unreachable 0

source quench 0 redirects 0

echo reply 10 parameter problem 0

timestamp 0 information request 0

mask requests 0 mask replies 0

time exceeded 0

Output:echo 10 destination unreachable 0

source quench 0 redirects 0

echo reply 5 parameter problem 0

timestamp 0 information reply 0

mask requests 0 mask replies 0

time exceeded 0

Table 7-2 Description on the fields of the display icmp statistics command

Field	Description
bad formats	Number of input packets in bad format
bad checksum	Number of input packets with wrong checksum
echo	Number of input/output echo request packets
destination unreachable	Number of input/output packets with unreachable destination
source quench	Number of input/output source quench packets
redirects	Number of input/output redirected packets
echo reply	Number of input/output echo reply packets
parameter problem	Number of input/output packets with parameter problems
timestamp	Number of input/output timestamp packets
information request	Number of input information request packets
mask requests	Number of input/output mask request packets
mask replies	Number of input/output mask reply packets
information reply	Number of output information reply packets
time exceeded	Number of packets that exceeds the time

7.1.8 display ip socket

Syntax

display ip socket [ socktype sock-type ] [ task-id socket-id ]

View

Any view

Parameter

sock-type: The type of a socket (tcp:1, udp: 2, raw ip: 3).

task-id: The ID of a task, with the value ranging from 1 to 100.

socket-id: The ID of a socket, with the value ranging from 0 to 3072.

Description

Use the display ip socket command to display the information about the sockets in the current system.

Example

# Display the information about the socket of TCP type.

<H3C> display ip socket socktype 1

SOCK_STREAM:

Task = VTYD(18), socketid = 1, Proto = 6,

LA = 0.0.0.0:23, FA = 0.0.0.0:0,

sndbuf = 8192, rcvbuf = 8192, sb_cc = 0, rb_cc = 0,

socket option = SO_ACCEPTCONN SO_KEEPALIVE SO_SENDVPNID SO_SETKEEPALIVE,

socket state = SS_PRIV SS_ASYNC

Task = VTYD(18), socketid = 2, Proto = 6,

LA = 10.153.17.99:23, FA = 10.153.17.56:1161,

sndbuf = 8192, rcvbuf = 8192, sb_cc = 0, rb_cc = 0,

socket option = SO_KEEPALIVE SO_OOBINLINE SO_SENDVPNID SO_SETKEEPALIVE,

socket state = SS_ISCONNECTED SS_PRIV SS_ASYNC

Task = VTYD(18), socketid = 3, Proto = 6,

LA = 10.153.17.99:23, FA = 10.153.17.82:1121,

sndbuf = 8192, rcvbuf = 8192, sb_cc = 0, rb_cc = 0,

socket option = SO_KEEPALIVE SO_OOBINLINE SO_SENDVPNID SO_SETKEEPALIVE,

socket state = SS_ISCONNECTED SS_PRIV SS_ASYNC

Table 7-3 Description on the fields of the display ip socket command

Field	Description
SOCK_STREAM	The socket type
Task	The ID of a task
socketid	The ID of a socket
Proto	The protocol number used by the socket
sndbuf	The sending buffer size of the socket
rcvbuf	The receiving buffer size of the socket
sb_cc	The current data size in the sending buffer. The value makes sense only for the socket of TCP type, because only TCP is able to cache data
rb_cc	The current data size in the receiving buffer
socket option	The option of the socket
socket state	The state of the socket

7.1.9 display ip statistics

Syntax

display ip statistics

View

Any view

Parameter

None

Description

Use the display ip statistics command to view the statistics information about IP packets.

Related command: display ip interface, reset ip statistics.

Example

# View statistics about IP packets.

<H3C> display ip statistics

Input: sum 7120 local 112

bad protocol 0 bad format 0

bad checksum 0 bad options 0

Output: forwarding 0 local 27

dropped 0 no route 2

compress fails 0

Fragment:input 0 output 0

dropped 0

fragmented 0 couldn't fragment 0

Reassembling:sum 0 timeouts 0

Table 7-4 Description on the fields of the display ip statistics command

Field		Description
Input:	sum	Sum of input packets
	local	Number of received packets whose destination is the local device
	bad protocol	Number of packets with wrong protocol number
	bad format	Number of packets in bad format
	bad checksum	Number of packets with wrong checksum
	bad options	Number of packets that have wrong options
Output:	forwarding	Number of forwarded packets
	local	Number of packets that are sent by the local device
	dropped	Number of dropped packets during transmission
	no route	Number of packets that cannot be routed
	compress fails	Number of packets that cannot be compressed
Fragment:	input	Number of input fragments
	output	Number of output fragments
	dropped	Number of dropped fragments
	fragmented	Number of packets that are fragmented
	couldn't fragment	Number of packets that cannot be fragmented
Reassembling:	sum	Number of packets that are reassembled
Reassembling:	timeouts	Number of packets that time out

7.1.10 display tcp statistics

Syntax

display tcp statistics

View

Any view

Parameter

None

Description

Use the display tcp statistics command to view the statistics information about TCP packets.

For the related commands, see display tcp status, reset tcp statistics.

Example

# View statistics about TCP packets.

<H3C> display tcp statistics

Received packets:

Total: 753

packets in sequence: 412 (11032 bytes)

window probe packets: 0, window update packets: 0

checksum error: 0, offset error: 0, short error: 0

duplicate packets: 4 (88 bytes), partially duplicate packets: 5 (7 bytes)

out-of-order packets: 0 (0 bytes)

packets of data after window: 0 (0 bytes)

packets received after close: 0

ACK packets: 481 (8776 bytes)

duplicate ACK packets: 7, too much ACK packets: 0

Sent packets:

Total: 665

urgent packets: 0

control packets: 5 (including 1 RST)

window probe packets: 0, window update packets: 2

data packets: 618 (8770 bytes) data packets retransmitted: 0 (0 bytes)

ACK-only packets: 40 (28 delayed)

Retransmitted timeout: 0, connections dropped in retransmitted timeout: 0

Keepalive timeout: 0, keepalive probe: 0, Keepalive timeout, so connections disconnected : 0

Initiated connections: 0, accepted connections: 0, established connections: 0

Closed connections: 0 (dropped: 0, initiated dropped: 0)

Packets dropped with MD5 authentication: 0

Packets permitted with MD5 authentication: 0

Table 7-5 Description on the fields of the display tcp statistics command

Field	Description
Received packets	Information followed is about received packets
Total:753	Total number of received packets: 753
packets in sequence: 412 (11032 bytes)	Up to 412 packets (total of 11,032 bytes) arrive in sequence
window probe packets: 0, window update packets: 0	Number of window probe packets: 0 Number of window update packets: 0
checksum error: 0, offset error: 0, short error: 0	Number of checksum errors: 0 Number of offset errors: 0 Number of short errors: 0
duplicate packets: 4 (88 bytes), partially duplicate packets: 5 (7 bytes)	Number of duplicate packets: 4 (total of 88 bytes) Number of partially duplicate packets: 5 (total of 7 bytes)
out-of-order packets: 0 (0 bytes)	Number of out-of-order packets: 0 (0 byte)
packets of data after window: 0 (0 bytes)	Number of packets out of receiving window: 0 (0 byte)
packets received after close: 0	Number of packets received after the connection closed: 0
ACK packets: 481 (8776 bytes)	Number of ACK packets: 481 (total of 8776 bytes of data acknowledged)
duplicate ACK packets: 7, too much ACK packets: 0	Number of duplicate ACK packets: 7 Number of too-much ACK packets: 0 (ACK packets that acknowledge data not sent)
Sent packets	Information followed is about sent packets
Total: 665	Total number of sent packets: 665
urgent packets: 0	Number of urgent packets: 0
control packets: 5 (including 1 RST)	Number of control packets: 5 (including 1 RST packet)
window probe packets: 0, window update packets: 2	Number of window probe packets: 0 Number of window update packets: 2
data packets: 618 (8770 bytes) data packets retransmitted: 0 (0 bytes)	Number of data packets: 618 (total of 8770 bytes) Number of data packets retransmitted: 0 (0 byte)
ACK-only packets: 40 (28 delayed)	Number of ACK packets: 40 (28 of which delayed)
Retransmitted timeout: 0, connections dropped in retransmitted timeout: 0	Number of retransmitted timeout events: 0 Number of connections dropped due to the number of retransmitted timeout events exceeding the specified value: 0
Keepalive timeout: 0, keepalive probe: 0, Keepalive timeout, so connections	Number of keepalive timeout events: 0 Number of keepalive probe packets sent: 0
disconnected : 0	Number of connections disconnected when keepalive probes fail: 0
Initiated connections: 0, accepted connections: 0, established connections: 0	Number of initiated connections: 0 Number of accepted connections: 0 Number of established connection: 0
Closed connections: 0 (dropped: 0, initiated dropped: 0)	Number of closed connection: 0 Number of dropped connections (after SYN messages received): 0 Number of connections initiated drooped: 0
Packets dropped with MD5 authentication: 0	Number of packets dropped with MD5 authentication: 0
Packets permitted with MD5 authentication: 0	Number of packets permitted with MD5 authentication: 0

7.1.11 display tcp status

Syntax

display tcp status

View

Any view

Parameter

None

Description

Use the display tcp status command to view all TCP connection states. This helps user monitor TCP connection at any time.

Example

# Display the state of all TCP connections.

<H3C> display tcp status

TCPCB Local Add:port Foreign Add:port State

03e37dc4 0.0.0.0:4001 0.0.0.0:0 Listening

04217174 100.0.0.204:23 100.0.0.253:65508 Established

The displayed information indicates that a TCP connection is established. The local IP address of this TCP connection is 100.0.0.204, and the local port number is 23. The remote IP address is 100.0.0.253, and the remote port number is 65508. In addition, there is a local server process which listens to the port 4001.

7.1.12 display udp statistics

Syntax

display udp statistics

View

Any view

Parameter

None

Description

Use the display udp statistics command to view UDP traffic statistic information.

It displays the statistic information of all current UDP connections. The statistics information about UDP packets are divided into two major kinds which are received packets and sent packets. The packets are further divided into different types such as check packets and error packets. There are also some statistics related closely to the connections, such as the number of broadcast packets. All these displayed information are measured in packets.

Related command: reset udp statistics.

Example

# Display the UDP traffic statistic information.

<H3C> display udp statistics

Received packet:

Total:0

checksum error:0

shorter than header:0, data length larger than packet:0

no socket on port:0

broadcast:0

not delivered, input socket full:0

input packets missing pcb cache:0

Sent packet:

Total:0

Table 7-6 Description on the fields of the display udp statistics command

Field	Description
Received packet: Total: 0	Total received UDP packets: 0
checksum error: 0	Number of checksum errors: 0
shorter than header: 0, data length larger than packet: 0	Cases that the length of the packets is shorter than the header: 0 Cases that the data length exceeds the packet length: 0
no socket on port: 0	Cases that there is no socket on port: 0
broadcast: 0	Number of broadcast packets: 0
not delivered, input socket full: 0	Cases that the packets are not forwarded because the socket buffer is full: 0
input packets missing pcb cache: 0	Cases that the packets cannot find pcb: 0
Sent packet: Total: 0	Total sent UDP packets: 0

7.1.13 reset ip statistics

Syntax

reset ip statistics

View

User view

Parameter

None

Description

Use the reset ip statistics command to clear the IP statistics information.

Related command: display ip interface, display ip statistics.

Example

# Clear the IP statistics information.

<H3C> reset ip statistics

7.1.14 reset tcp statistics

Syntax

reset tcp statistics

View

User view

Parameter

None

Description

Use the reset tcp statistics command to clear the TCP statistics information.

Related command: display tcp statistics.

Example

# Clear the TCP statistics information.

<H3C> reset tcp statistics

7.1.15 reset udp statistics

Syntax

reset udp statistics

View

User view

Parameter

None

Description

Use the reset udp statistics command to can clear the UDP statistics information.

Example

# Clear the UDP traffic statistics information.

<H3C> reset udp statistics

7.1.16 tcp timer fin-timeout

Syntax

tcp timer fin-timeout time-value

undo tcp timer fin-timeout

View

System view

Parameter

time-value: TCP finwait timer value in second, with the value ranging from 76 to 3600; By default, it is 675 seconds.

Description

Use the tcp timer fin-timeout command to configure the TCP finwait timer.

Use the undo tcp timer fin-timeout command to restore the default value of the TCP finwait timer.

When the TCP connection state changes from FIN_WAIT_1 to FIN_WAIT_2, the finwait timer is enabled. If the switch does not receive FIN packets before the finwait timer times out, the TCP connection is terminated.

Related command: tcp timer syn-timeout, tcp window.

Example

# Configure the TCP finwait timer value as 800 seconds.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] tcp timer fin-timeout 800

7.1.17 tcp timer syn-timeout

Syntax

tcp timer syn-timeout time-value

undo tcp timer syn-timeout

View

System view

Parameter

time-value: TCP synwait timer value measured in seconds, whose value ranges from 2 to 600. The default time-value is 75 seconds.

Description

Use the tcp timer syn-timeout command to configure the TCP synwait timer.

Use the undo tcp timer syn-timeout command to restore the default value of the timer.

TCP enables the synwait timer if a SYN packet is sent. The TCP connection is terminated if the response packet is not received.

Related command: tcp timer fin-timeout, tcp window.

Example

# Configure the TCP synwait timer value as 80 seconds.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] tcp timer syn-timeout 80

7.1.18 tcp window

Syntax

tcp window window-size

undo tcp window

View

System view

Parameter

window-size: The size of the sending and receiving buffers measured in kilobytes (KB), whose value ranges from 1 to 32. By default, the window-size is 8KB.

Description

Use the tcp window command to configure the size of the sending and receiving buffers of the connection-oriented Socket.

Use the undo tcp window command to restore the default size of the buffer.

Related command: tcp timer fin-timeout, tcp timer syn-timeout.

Example

# Configure the size of the sending and receiving buffers as 3KB.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] tcp window 3

H3C S9500 Series Routing Switches Command Manual-(V1.01)

2.1.1 arp proxy enable

4.3.5 display dhcp relay address

6.1 Static DNS Configuration Commands

7.1.2 display fib ip-address

7.1.4 display fib |

7.1.6 display fib statistics

7.1.12 display udp statistics

7.1.13 reset ip statistics

7.1.14 reset tcp statistics

7.1.15 reset udp statistics

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