display ip interface

Function

The display ip interface command displays the configuration and the statistics related to the IP address of the interface, including the packets and bytes received by and sent from the interface, multicast packets, and broadcast packets received, sent, forwarded, and discarded by the interface.

The display ip interface brief command displays brief information related to the IP address of the interface, including the IP address, mask, the status of the physical link and the protocol, and the interface description.

Format

display ip interface [ interface-type interface-number ]

display ip interface brief [ interface-type [ interface-number ] | interface-type &<1-8> | slot slot-number [ card card-number ] | ip-configured [ except interface-type ] ]

Parameters

Parameter	Description	Value
brief	Displays summary information, including the IP address, subnet mask, physical link, the Up or Down state of the protocol, and number of interfaces in different states.	-
interface-type	Specifies the interface type. If no interface-type is specified, the system displays IP configuration and statistics about all interfaces.	-
interface-number	Specifies the interface number, which identifies an interface together with interface-type. If no interface-number is specified, the system displays the IP configuration and statistics about all interfaces of the interface-type.	-
slot slot-number	Displays the IP configuration and statistics of interfaces on the specified slot. If the slot number is not specified, brief information related to the IP addresses of the interfaces on all interface boards and main control boards is displayed. Only the AntiDDoS8000 supports this parameter.	-
card card-number	Displays the IP configuration and statistics of interfaces on specified card. If the card number is not specified, brief information related to the IP addresses of all the interfaces on the specified slot is displayed. Only the AntiDDoS8000 supports this parameter.	-
ip-configured	Displays the IP configuration of interfaces configured with IP addresses. Only the AntiDDoS8000 supports this parameter.	-
except interface-type	Displays the IP configuration of interfaces excluding the interfaces of the specified type. Only the AntiDDoS8000 supports this parameter.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display ip interface brief command to view the following:

IP configurations of all interfaces
IP configurations of interfaces of the specified type, specified interfaces.
IP configurations of interfaces configured with IP addresses

This command, however, cannot be used to display the IP configurations of Layer-2 interfaces or member interfaces of an Eth-Trunk.

The display ip interface command displays the IP configuration and statistics. You can view the command output before monitoring the interface status and diagnosing interface faults.

Example

# Display the specific information about GigabitEthernet 1/0/1.

<sysname> display ip interface GigabitEthernet 1/0/1
GigabitEthernet1/0/1 current state : DOWN
Line protocol current state : DOWN
The Maximum Transmit Unit : 1500 bytes
input packets : 0, bytes : 0, multicasts : 0
output packets : 0, bytes : 0, multicasts : 0
Directed-broadcast packets:
 received packets:            0, sent packets:            0
 forwarded packets:           0, dropped packets:           0
ARP packet input number:           0
  Request packet:                  0
  Reply packet:                    0
  Unknown packet:                  0
Internet Address is 10.1.1.1/24
Broadcast address : 10.1.1.255
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

**Table 1** Description of the **display ip interface gigabitethernet** command output
Item	Description
current state	Physical status of : UP: the normal starting state. DOWN: the abnormal state. Administratively down: If the administrator uses the shutdown command on the interface, the state is Administratively Down.
Line protocol current state	Status of the link protocol of the interface: UP: the normal starting state. DOWN: the abnormal state or the IP address is not configured on the interface.
The Maximum Transmit Unit	The packet larger than the MTU is fragmented before being sent. If the non-fragmentation is configured, the packet is discarded.
input packets : 0, bytes : 0, multicasts: 0	Total number of packets, bytes, and multicast packets received by the interface.
output packets : 0, bytes : 0, multicasts: 0	Total number of packets, bytes, and multicast packets sent by the interface.
Directed-broadcast packets	Number of packets broadcast on the interface directly.
received packets	Total number of received packets.
sent packets	The total number of sent packets.
forwarded packets	The total number of the forwarded packets.
dropped packets	The total number of discarded packets.
ARP packet input number	Number of received ARP packets.
Request packet	Number of request packets.
Reply packet	Number of response packets.
Unknown packet	Number of unknown packets.
Internet Address	IP address and subnet mask of the interface.
Broadcast address	Broadcast address of the interface.
TTL invalid packet number	Number of TTL invalid packets.
ICMP packet input number	Number of received ICMP packets.
Echo reply	Number of echo-reply packets.
Unreachable	Number of packets with unreachable destination.
Source quench	Number of source suppress packets.
Routing redirect	Number of redirected packets.
Echo request	Number of echo-request packets.
Router advert	Number of router-advertising packets.
Router solicit	Number of router-soliciting packets.
Time exceed	Number of timeout packets.
IP header bad	Number of packets with the corrupted IP header.
Timestamp request	Number of timestamp-requiring packets.
Timestamp reply	Number of timestamp-replying packets.
Information request	Number of information-requiring packets.
Information reply	Number of information-replying packets.
Netmask request	Number of mask-requiring packets.
Netmask reply:	Number of mask-replying packets.
Unknown type:	Number of packets of the unknown type.

# Display brief information related to the IP addresses of all interfaces on the device.

<sysname>display ip interface brief
*down: administratively down
(s): spoofing
Interface                   IP Address      Physical Protocol Description
GigabitEthernet0/0/0        192.168.196.205  up       up       GigabitEthernet0/0/0
GigabitEthernet1/0/1        10.1.1.1         down     down     GigabitEthernet1/0/1
GigabitEthernet1/0/1.1      unassigned      down     down     GigabitEthernet1/0/1.1
GigabitEthernet1/0/2        unassigned      up       down     GigabitEthernet1/0/2

**Table 2** Description of the **display ip interface brief** command output
Item	Description
*down:	The interface is physically Down. Administratively down: The network administrator runs the shutdown command on the interface.
(s): spoofing	The letter "s" refers to spoofing.
The number of interface that is UP/DOWN in Protocol is	The Up or Down state of the protocol and the number of interfaces in different states.
Interface	Interface type and number.
IP Address/Mask	IP address and subnet mask of a Layer-3 interface.
Physical	Physical status of an interface: Up: The interface runs normally. (1) indicates that the loopback function is configured on the interface. Down: The interface becomes faulty. down: The administrator runs the shutdown* command on the interface. (1) indicates that the loopback function is configured on the interface. !down: The FIB module is in the overload suspension state. In this case, the link protocol status of the interface is Down.
Protocol	Link protocol status of the interface. Possible link protocol status is as follows: Up: The link protocol status of the interface is normal. (s) indicates that the link protocol status of the interface is Up when this interface is created and not configured with an IP address. This is the build-in attribute of an interface. When this interface is configured with an IP address, (s) is still displayed. Down: The link protocol status of the interface is abnormal or the interface is not configured with an IP address. (1) indicates that the loopback function is configured on the interface.