- Table of Contents
-
- 06-Layer 3 - IP Services Command Reference
- 00-Preface
- 01-ARP Commands
- 02-IP Addressing Commands
- 03-DHCP Commands
- 04-DNS Commands
- 05-NAT Commands
- 06-IP Forwarding Basics Commands
- 07-Adjacency Table Commands
- 08-IP Performance Optimization Commands
- 09-UDP helper Commands
- 10-IPv6 Basics Commands
- 11-DHCPv6 Commands
- 12-IPv6 DNS Commands
- 13-Tunneling Commands
- Related Documents
-
Title | Size | Download |
---|---|---|
02-IP Addressing Commands | 76.47 KB |
IP addressing configuration commands
display ip interface
Syntax
display ip interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
interface-type interface-number: Specifies an interface by its type and number.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display ip interface to display IP configuration information for the specified Layer 3 interface or all Layer 3 interfaces.
Examples
# Display IP configuration information for VLAN-interface 1.
<Sysname> 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
ARP packet input number: 0
Request packet: 0
Reply packet: 0
Unknown packet: 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
# Display IP configuration information for the network management interface.
<Sysname>display ip interface M-Ethernet 0/0/0
M-Ethernet0/0/0 current state :DOWN
Line protocol current state :DOWN
Table 1 Command output
Field |
Description |
current state |
Current physical state of the interface: · Administrative DOWN—The interface is shut down by the shutdown command. · DOWN—The interface is administratively up but its physical state is down, which might be caused by a connection or link failure. · UP—Both the administrative and physical states of the interface are up. |
Line protocol current state |
Current state of the link layer protocol: · DOWN—The protocol state of the interface is down. · UP—The protocol state of the interface is up. · UP (spoofing)—The protocol state of the interface pretends to be up. However, no corresponding link is present, or the corresponding link is not present permanently but is established as needed. |
Internet Address |
IP address of an interface followed by: · Primary—Identifies a primary IP address. · Sub—Identifies a secondary IP address. · negotiated—Identifies a PPP negotiated IP address. · unnumbered—Identifies an unnumbered IP address. · acquired via DHCP—Identifies an IP address obtained through DHCP. · acquired via BOOTP—Identifies an IP address obtained through BOOTP. · Cluster—Identifies a cluster IP address. · Mad—Identifies a MAD IP address. |
Broadcast address |
Broadcast address of the subnet attached to an interface. |
The Maximum Transmit Unit |
Maximum transmission units on an interface, in bytes. |
input packets, bytes, multicasts output packets, bytes, multicasts |
Unicast packets, bytes, and multicast packets received on an interface (the statistics start at the switch startup). |
ARP packet input number Request packet Reply packet Unknown packet |
Total number of ARP packets received on an interface (the statistics start at the switch startup): · ARP request packets. · ARP reply packets. · Unknown packets. |
TTL invalid packet number |
Number of TTL-invalid packets received on an interface (the statistics start at the switch 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 an interface (the statistics start at the switch 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. |
display ip interface brief
Syntax
display ip interface [ interface-type [ interface-number ] ] brief [ description ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
interface-type: Interface type.
interface-number: Interface number.
description: Displays complete interface descriptions. If you do not specify this keyword, the command displays a maximum of 23 characters for each interface description. If the description is longer than 23 characters, the first 20 characters are displayed, followed by an ellipsis (...).
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display ip interface brief to display brief IP configuration information for the specified Layer 3 interface or all Layer 3 interfaces.
If you do not specify the interface type and interface number, this command displays brief IP configuration information for all Layer 3 interfaces.
If you specify only the interface type, this command displays brief IP configuration information for all Layer 3 interfaces of the specified type.
If you specify both the interface type and interface number, this command displays only brief IP configuration information for the specified interface.
Related commands: display ip interface.
Examples
# Display brief IP configuration information for VLAN interfaces.
<Sysname> display ip interface vlan-interface brief
(s): spoofing (l): loopback
Interface Physical Protocol IP Address Description
Vlan1 up up 6.6.6.6 --
Vlan2 up up 7.7.7.7 ABCDEFGHIJKLMNOPQRST...
# Display brief IP configuration information for VLAN interfaces and complete interface descriptions.
<Sysname> display ip interface vlan-interface brief description
(s): spoofing (l): loopback
Interface Physical Protocol IP Address Description
Vlan1 up up 6.6.6.6 --
Vlan2 up up 7.7.7.7 ABCDEFGHIJKLMNOPQRSTUVW
XYZ
Table 2 Command output
Field |
Description |
(s): spoofing |
Spoofing attribute of the interface. It indicates that an interface might have no link present even when its link layer protocol is displayed up or the link is set up only on demand. |
(l): loopback |
Link loopback test that PPP and HDLC support. |
Interface |
Interface name. |
Physical |
Physical state of interface: · *down—The interface is administratively down. The interface is shut down by the shutdown command. · down—The interface is administratively up but its physical state is down, which might be caused by a connection or link failure. · up—Both the administrative and physical states of the interface are up. |
Protocol |
Link layer protocol state: · down—The link layer protocol state of the interface is down. · up—The link layer protocol state of the interface is up. · up(s)—The protocol state of the interface is up (spoofing). · up(l)—The protocol state of the interface is up (loopback). · down(l)—The protocol state of the interface is down (loopback). |
IP Address |
IP address of interface. If no IP address is configured, two hyphens (--) are displayed. |
Description |
Interface description information. If no description is configured, two hyphens (--) are displayed. |
ip address
Syntax
ip address ip-address { mask-length | mask } [ sub ]
undo ip address [ ip-address { mask-length | mask } [ sub ] ]
View
Interface view
Default level
2: System level
Parameters
ip-address: IP address of interface, in dotted decimal notation.
mask-length: Subnet mask length, the number of consecutive ones in the mask.
mask: Subnet mask in dotted decimal notation.
sub: Secondary IP address for the interface.
Description
Use ip address to assign an IP address and mask to the interface.
Use undo ip address to remove all IP addresses from the interface.
Use the undo ip address ip-address { mask | mask-length } command to remove the primary IP address.
Use the undo ip address ip-address { mask | mask-length } sub command to remove a secondary IP address.
By default, no IP address is assigned to any interface.
When assigning IP addresses to an interface:
· You can assign only one primary IP address to an interface.
· The primary and secondary IP addresses can be located in the same network segment.
· Before removing the primary IP address, remove all secondary IP addresses.
· An interface can have up to 128 IP addresses configured, in which, one is the primary IP address, and all others are secondary IP addresses.
· Do not assign a secondary IP address to an interface that is configured to obtain an IP address through PPP negotiation.
Related commands: display ip interface.
Examples
# Assign VLAN-interface 1 a primary IP address 129.12.0.1 and a secondary IP address 202.38.160.1, with subnet masks 255.255.255.0.
<Sysname> system-view
[Sysname] interface vlan-interface 1
[Sysname-Vlan-interface1] ip address 129.12.0.1 255.255.255.0
[Sysname-Vlan-interface1] ip address 202.38.160.1 255.255.255.0 sub