display ip interface description

Function

The display ip interface description command displays IP-related information (such as the IP address, subnet mask, physical layer status, link layer protocol status, and number of interfaces in different states) and description of an interface.

Format

display ip interface description [ interface-type [ interface-number ] | interface-type &<2-8> ]

Parameters

Parameter	Description	Value
interface-type	Indicates the interface type. If no interface type is specified, IP-related configurations and statistics of all interfaces are displayed.	-
interface-number	Indicates the interface number, which is used together with interface-type to identify an interface. If no interface number is specified, IP-related configurations and statistics of interfaces in the same type are displayed.	-
interface-type &<2-8>	Indicates that the command can display IP-related information about interfaces of multiple types. The command can display IP-related information about interfaces in a maximum of eight types.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

Instead of running the display ip interface brief and display interface description commands, you can run the display ip interface description command to view both IP-related information and description of an interface, which facilitates the user operation.

Precautions

The display ip interface description command cannot display information about Layer 2 interfaces or member interfaces of an Eth-Trunk. If an interface is bound with a homogeneous VLL or VSI, the command displays no information about the interface.

Example

# View IP-related information and description of a specified interface.

<sysname> display ip interface description

Codes:
      Ana(Analogmodem),       Asy(Async),             Cell(Cellular),
      Dia(Dialer),            Eth(Ethernet)           GE(GigabitEthernet),
      H(Hssi),                Ima(Ima-group),         Loop(LoopBack),
      MTun(MTunnel),          S(Serial),              Tun(Tunnel),
      VE(Virtual-Ethernet),   VT(Virtual-Template)

      d(dampened),            D(down),                *D(administratively down)
      !D(FIB overload down),  l(loopback),            s(spoofing)
      U(up),                  E(E-Trunk down)

   
------------------------------------------------------------------------------  
Number of interfaces whose physical status is Up: 9                          
Number of interfaces whose physical status is Down: 1                          
Number of interfaces whose protocol status is Up: 9                          
Number of interfaces whose protocol status is Down: 1                       
                                                                                
Interface                     IP Address/Mask    Phy  Prot Description          
GE0/0/0                       10.1.201.6/16      U    U    From SH to WH

**Table 1** Description of the **display ip interface description** command output
Item	Description
Codes:	The following information provides the full spelling and explanation of the abbreviated interface names, physical status, and link layer protocols. Full spelling of the abbreviated interface names is as follows: Ana: Analog modem interfaces Asy: Async interfaces Cell: Cellular interfaces Dia: Dialer interfaces Eth: Ethernet interfaces GE: GigabitEthernet interfaces H: Hssi interfaces Ima: IMA-Group interfaces Loop: Loopback interfaces MTun: MTunnel interfaces S: Serial interfaces Tun: Tunnel interfaces VE: Virtual-Ethernet interfaces VT: Virtual-Template interfaces Explanation of the abbreviated physical status of the interface is as follows: U: indicates that the physical status of the interface is Up.U(l) indicates that the interface is enabled with the loopback function. D: indicates that the physical status of the interface is Down. D: indicates that the network administrator has run the shutdown* command on the interface. !D: indicates that the FIB module is in the overload suspension state. The link layer protocol of the interface goes Down. ^D:indicates that the FIB module is in the standby state. E: Indicates that the Eth-Trunk is Down because of the protocol negotiation on the E-Trunk. Explanation of the abbreviated link layer protocol status is as follows: U: indicates that the status of the link layer protocol on the interface is Up. U(s) indicates that the link layer protocol of the interface is Up even though the interface is not configured with an IP address. (s) is an inherent attribute of the interface and will be displayed when the interface is configured with an IP address. (d) indicates that the protocol module of the interface is dampened. D: indicates that the link layer protocol of the interface is Down or no IP address is assigned to the interface.
Number of interfaces whose physical status is Up:	Indicates the number of interfaces whose physical status is Up.
Number of interfaces whose physical status is Down:	Indicates the number of interfaces whose physical status is Down.
Number of interfaces whose protocol status is Up:	Indicates the number of interfaces whose link layer protocol is Up.
Number of interfaces whose protocol status is Down:	Indicates the number of interfaces whose link layer protocol is Down.
Interface	Indicates the name and number of an interface.
IP Address/Mask	Indicates the IP address and subnet mask of an interface.
Phy	Indicates the physical status of an interface.
Prot	Indicates the link layer protocol status of an interface.
Description	Indicates the description of an interface, expressed in characters. A maximum of 20 characters can be displayed. When the length of the description is greater than 20 characters, only the first 17 characters are displayed and the last 3 characters are replaced by ellipsis (...). If the description of an interface is the default setting, no information is displayed.