- Table of Contents
-
- 05-Layer 3—IP Services Command Reference
- 00-Preface
- 01-ARP commands
- 02-IP addressing commands
- 03-DHCP commands
- 04-DNS commands
- 05-mDNS gateway commands
- 06-mDNS relay commands
- 07-NAT commands
- 08-IP forwarding basics commands
- 09-Fast forwarding commands
- 10-Adjacency table commands
- 11-IRDP commands
- 12-IP performance optimization commands
- 13-UDP helper commands
- 14-IPv6 basics commands
- 15-DHCPv6 commands
- 16-IPv6 fast forwarding commands
- 17-Tunneling commands
- 18-GRE commands
- 19-HTTP redirect commands
- Related Documents
-
Title | Size | Download |
---|---|---|
02-IP addressing commands | 111.90 KB |
Contents
IP addressing commands
display ip interface
Use display ip interface to display IP configuration and statistics for Layer 3 interfaces.
Syntax
display ip interface [ interface-type [ interface-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type: Specifies an interface by its type.
interface-number: Specifies an interface by its number.
Usage guidelines
Use the display ip interface command to display IP configuration and statistics for the specified Layer 3 interface. The statistics include the following information:
· The number of unicast packets, bytes, and multicast packets the interface has sent and received.
· The number of TTL-invalid packets and ICMP packets the interface has received.
The packet statistics helps you locate a possible attack on the network.
If you specify only the interface type, this command displays IP configuration and statistics for all interfaces of this interface type. If you do not specify any optional parameters, this command displays IP configuration and statistics for all Layer 3 interfaces.
Examples
# Display IP configuration and statistics for VLAN-interface 10.
<Sysname> display ip interface vlan-interface 10
Vlan-interface10 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
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
Table 1 Command output
Field |
Description |
current state |
Physical link state of the interface: · Administrative DOWN—The interface has been shut down by using the shutdown command. · DOWN—The interface is administratively up, but its physical state is down (possibly because no physical link exists or the link has failed). · UP—The interface is both administratively and physically up. |
Line protocol current state |
Data link layer state of the interface. · DOWN—The data link layer protocol is down. · UP—The data link layer protocol is up. · UP (spoofing)—The data link layer protocol is up, but the link is an on-demand link or does not exist. |
Internet Address |
IP address of the interface and type of the address. Possible IP address types include: · Primary—Manually configured primary IP address. · Sub—Manually configured secondary IP address. If the interface has both primary and secondary IP addresses, the primary IP address is displayed. If the interface has only secondary IP addresses, the lowest secondary IP address is displayed. · DHCP-Allocated—DHCP allocated IP address. For more information, see DHCP client configuration in Layer 3—IP Services Configuration Guide. · BOOTP-Allocated—BOOTP allocated IP address. For more information, see BOOTP client configuration in Layer 3—IP Services Configuration Guide. · Unnumbered—IP address borrowed from another interface. · MAD—IP address assigned to an IRF member device for MAD on the interface. For more information, see IRF configuration in Virtual Technologies Configuration Guide. · MTunnel—IP address of the multicast tunnel interface (MTI), which is the same as the IP address of the MVPN source interface. For more information, see multicast VPN configuration in IP Multicast Configuration Guide. |
Broadcast address |
Broadcast address of the subnet attached to an interface. |
The Maximum Transmit Unit |
MTU of the interface, in bytes. |
input packets, bytes, multicasts output packets, bytes, multicasts |
All received and sent packets and bytes, and received and sent multicast packets on an interface (statistics start at the device startup). |
TTL invalid packet number |
Number of TTL-invalid packets received on the interface (statistics start at the device startup). |
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 number of ICMP packets received on the interface (statistics start at the device startup): · Echo reply packets. · Unreachable packets. · Source quench packets. · Routing redirect packets. · Echo request packets. · Router advertisement packets. · Router solicitation packets. · Time exceeded packets. · IP header bad packets. · Timestamp request packets. · Timestamp reply packets. · Information request packets. · Information reply packets. · Netmask request packets. · Netmask reply packets. · Unknown type packets. |
Related commands
display ip interface brief
ip address
statistics l3-packet enable
display ip interface brief
Use display ip interface brief to display brief IP configuration for Layer 3 interfaces.
Syntax
display ip interface [ interface-type [ interface-number ] ] brief [ description ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type: Specifies an interface type. If you do not specify an interface type, this command displays brief IP configuration for all Layer 3 interfaces.
interface-number: Specifies an interface number. If you do not specify an interface number, this command displays brief IP configuration for all Layer 3 interfaces of the specified type.
description: Displays complete interface descriptions. If you do not specify this keyword, the command displays a maximum of 11 characters for each interface description. If the description is longer than 11 characters, the first 8 characters are displayed with an ellipsis (...) followed.
Usage guidelines
Information displayed by the command includes the state of the physical and link layer protocols, IP address, and interface descriptions.
When the length of the interface name exceeds 18 characters or the length of the VPN instance name it belongs to exceeds 12 characters, the display information of the property column will shift to the right without line breaks. The information displayed in subsequent attribute columns is not aligned with the column in which it is located.
If you specify the description keyword to display the complete interface description that exceeds 11 characters, the description will be displayed on the next line from the leftmost side.
Examples
# Display brief IP configuration for VLAN interfaces.
<Sysname> display ip interface vlan-interface brief
*down: administratively down
(s): spoofing (l): loopback
Interface Physical Protocol IP address/Mask VPN instance Description
Vlan10 down down 6.6.6.1/24 -- Link to ...
Vlan2 down down 7.7.7.1/24 vpn-first-instance --
# Display brief IP configuration for VLAN interfaces, including complete interface descriptions.
<Sysname> display ip interface vlan-interface brief description
*down: administratively down
(s): spoofing (l): loopback
Interface Physical Protocol IP address/Mask VPN instance Description
Vlan10 down down 6.6.6.1/24 -- Link to Cor
eRouter
Vlan2 down down 7.7.7.1/24 vpn-first-instance --
Table 2 Command output
Field |
Description |
*down: administratively down |
The interface is administratively shut down by using the shutdown command. |
(s) : spoofing |
Spoofing attribute of the interface. The link protocol state of the interface is up, but the link is temporarily established on demand or does not exist. |
Interface |
Interface name. |
Physical |
Physical state of the interface: · *down—The interface is administratively shut down by using the shutdown command. · down—The interface is administratively up but its physical state is down, possibly because of a connection or link failure. · up—Both the administrative and physical states of the interface are up. |
Protocol |
Link layer protocol state of the interface: · down—The protocol state of the interface is down. · down(l)—The protocol state of the interface is down (loopback). · up—The protocol state of the interface is up. · up(l)—The protocol state of the interface is up (loopback). · up(s)—The protocol state of the interface is up (spoofing). |
IP address/Mask |
IP address and mask length of the interface. If no IP address is configured, this field displays hyphens (--). |
VPN instance |
Name of the VPN instance to which the interface belongs. If the interface does not belong to any VPN instance, this field displays hyphens (--). |
Description |
Description of the interface. If no description is configured, this field displays hyphens (--). |
Related commands
display ip interface
ip address
ip address
Use ip address to assign an IP address to the interface.
Use undo ip address to remove the IP address from the interface.
Syntax
ip address ip-address { mask-length | mask } [ irf-member member-id | sub ]
undo ip address ip-address { mask-length | mask } [ irf-member member-id | sub ]
Default
No IP address is assigned to an interface.
Views
Interface view
Predefined user roles
network-admin
Parameters
ip-address: Specifies the IP address of the interface, in dotted decimal notation.
mask-length: Specifies the subnet mask length in the range of 1 to 31. For a loopback interface, the value range is 1 to 32.
mask: Specifies the subnet mask in dotted decimal notation.
irf-member member-id: Assigns an IP address to the management Ethernet port of the specified IRF member device. The member-id argument specifies an IRF member device by its member ID. The value range for the member-id argument is 1 to 10.
sub: Assigns a secondary IP address to the interface.
Usage guidelines
Use the command to assign a primary or secondary IP address to an interface.
An interface can have only one primary IP address. If you execute this command multiple times to specify different primary IP addresses on an interface, the most recent configuration takes effect. If the interface connects to multiple subnets, configure primary and secondary IP addresses on the interface so the subnets can communicate with each other through the interface.
You cannot assign secondary IP addresses to an interface that obtains an IP address through BOOTP, IP unnumbered, or DHCP.
If you do not specify any parameters, the undo ip address command removes all IP addresses from the interface. The undo ip address ip-address { mask | mask-length } command removes the primary IP address. The undo ip address ip-address { mask | mask-length } sub command removes a secondary IP address.
The primary and secondary IP addresses assigned to the interface can be located on the same network segment. Different interfaces on your device must reside on different network segments.
If you assign IP addresses to the management Ethernet ports of IRF member devices, make sure the following requirements are met:
· The IP addresses must be in the same subnet if you assign them through the same management Ethernet port of the master device.
· The IP addresses must be in different subnets if you assign them through different management Ethernet ports of the master device.
In an IRF fabric, only the IP address assigned to the management Ethernet port of the master takes effect. Make sure no IP address conflict exists when you assign IP addresses to the management Ethernet ports of subordinates. The system does not warn of an IP address conflict because the IP addresses assigned to the management Ethernet ports of subordinates do not take effect. After an IRF fabric split, the IP addresses assigned to the management Ethernet ports of the new masters (original subordinates) take effect.
Examples
# Assign VLAN-interface 10 a primary IP address 129.12.0.1 and a secondary IP address 202.38.160.1, with subnet masks both 255.255.255.0.
<Sysname> system-view
[Sysname] interface vlan-interface 10
[Sysname-Vlan-interface10] ip address 129.12.0.1 255.255.255.0
[Sysname-Vlan-interface10] ip address 202.38.160.1 255.255.255.0 sub
Related commands
display ip interface
display ip interface brief
ip address unnumbered
Use ip address unnumbered to configure the current interface as IP unnumbered to borrow an IP address from the specified interface.
Use undo ip address unnumbered to restore the default.
Syntax
ip address unnumbered interface interface-type interface-number
undo ip address unnumbered
Default
The interface does not borrow IP addresses from other interfaces.
Views
Interface view
Predefined user roles
network-admin
Parameters
interface interface-type interface-number: Specifies an interface from which the current interface can borrow an IP address.
Usage guidelines
Typically, you assign an IP address to an interface either manually or through DHCP. If the IP addresses are not enough, or the interface is used only occasionally, you can configure an interface to borrow an IP address from other interfaces. This is called IP unnumbered, and the interface borrowing the IP address is called IP unnumbered interface.
Loopback interfaces cannot borrow IP addresses of other interfaces, but other interfaces can borrow IP addresses of loopback interfaces.
Multiple interfaces can use the same unnumbered IP address. If an interface has multiple manually configured IP addresses, only the primary IP address manually configured can be borrowed.
You cannot enable a dynamic routing protocol on the interface that has no IP address configured. To enable the interface to communicate with other devices, you must configure a static route to the peer device on the interface.
Examples
# Configure VLAN-interface 10 to borrow the IP address of VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 10
[Sysname-Vlan-interface10] ip address unnumbered interface vlan-interface 100