display interface

Use display interface to display aggregate interface information.

Syntax

display interface [ { bridge-aggregation | route-aggregation } [ interface-number | interface-number.subnumber ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

bridge-aggregation: Specifies Layer 2 aggregate interfaces.

route-aggregation: Specifies Layer 3 aggregate interfaces.

interface-number: Specifies an existing aggregate interface number.

interface-number.subnumber: Specifies an existing subinterface of a Layer 3 aggregate interface. The interface-number argument specifies the main interface number. The subnumber argument specifies the subinterface number and is separated from the main interface number by a dot (.).

brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.

description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of each interface description.

down: Displays information about interfaces in down state and the causes for the down state. If you do not specify this keyword, the command displays information about interfaces in all states.

Usage guidelines

If you do not specify an aggregate interface type, the command displays information about all interfaces.

If you specify an aggregate interface type but do not specify an interface number, the command displays information about all aggregate interfaces of the specified type.

Examples

# Display detailed information about Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> display interface bridge-aggregation 1
Bridge-Aggregation1
Current state: UP
IP packet frame type: Ethernet II, hardware address: 000f-e207-f2e0
Description: Bridge-Aggregation1 Interface
Bandwidth: 1000 kbps
2Gbps-speed mode, full-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
PVID: 1
Port link-type: Access
 Tagged VLANs:   None
 UnTagged VLANs: 1
Last clearing of counters: Never
Last 300 seconds input:  6900 packets/sec 885160 bytes/sec    0%
Last 300 seconds output:  3150 packets/sec 404430 bytes/sec    0%
Input (total):  5364747 packets, 686688416 bytes
         2682273 unicasts, 1341137 broadcasts, 1341337 multicasts, 0 pauses
Input (normal):  5364747 packets, 686688416 bytes
         2682273 unicasts, 1341137 broadcasts, 1341337 multicasts, 0 pauses
Input:  0 input errors, 0 runts, 0 giants, 0 throttles
         0 CRC, 0 frame, 0 overruns, - aborts
         - ignored, - parity errors
Output (total): 1042508 packets, 133441832 bytes
         1042306 unicasts, 0 broadcasts, 202 multicasts, - pauses
Output (normal): 1042508 packets, 133441832 bytes
         1042306 unicasts, 0 broadcasts, 202 multicasts, 0 pauses
Output: 0 output errors, - underruns, - buffer failures
         0 aborts, 0 deferred, 0 collisions, 0 late collisions
         - lost carrier, - no carrier

# Display detailed information about Layer 3 aggregate interface Route-Aggregation 1.

<Sysname> display interface route-aggregation 1
Route-Aggregation1
Current state: UP
Line protocol state: UP
Description: Route-Aggregation1 Interface
Bandwidth: 1000 kbps
Maximum transmission unit: 1500
Internet protocol processing: Disabled
IP packet frame type: Ethernet II, hardware address: 0000-0000-0000
IPv6 packet frame type: Ethernet II, hardware address: 0000-0000-0000
Port priority: 0
Output queue - Urgent queuing: Size/Length/Discards 0/100/0
Output queue - Protocol queuing: Size/Length/Discards 0/500/0
Output queue - FIFO queuing: Size/Length/Discards 0/75/0
Unknown-speed mode, unknown-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
Last clearing of counters: Never
    Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec
    Last 300 seconds output rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec
    0 packets input, 0 bytes, 0 drops
    0 packets output, 0 bytes, 0 drops

# Display brief information about Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> display interface bridge-aggregation 1 brief
Brief information on interfaces in bridge mode:
Link: ADM - administratively down; Stby - standby
Speed: (a) – auto
Duplex: (a)/A - auto; H - half; F - full
Type: A - access; T - trunk; H - hybrid
Interface            Link Speed   Duplex Type PVID Description
BAGG1                UP   auto    A      A    1

# Display brief information about Layer 3 aggregate interface Route-Aggregation 1.

<Sysname> display interface route-aggregation 1 brief
Brief information on interfaces in route mode:
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface            Link Protocol Primary IP         Description
RAGG1                UP   UP       --

Table 5: Command output

Field

Description

Bridge-Aggregation1

Layer 2 aggregate interface name.

Route-Aggregation1

Layer 3 aggregate interface name.

Current state

Physical link state of the interface:

  • Administratively 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.

IP packet frame type

IPv4 packet framing format.

Description

Description of the interface.

Bandwidth

Expected bandwidth of the interface. This field is not displayed when the bandwidth is 0 kbps.

Port priority

Port priority of the interface.

Output queue - Urgent queuing: Size/Length/Discards

Information about the urgent output queue:

  • Size—Number of packets in the queue.

  • Length—Maximum number of packets that the queue can contain.

  • Discards—Number of dropped packets.

Output queue - Protocol queuing: Size/Length/Discards

Information about the protocol output queue:

  • Size—Number of packets in the queue.

  • Length—Maximum number of packets that the queue can contain.

  • Discards—Number of dropped packets.

Output queue - FIFO queuing: Size/Length/Discards

Information about the FIFO output queue:

  • Size—Number of packets in the queue.

  • Length—Maximum number of packets that the queue can contain.

  • Discards—Number of dropped packets.

Unknown-speed mode, unknown-duplex mode

The interface speed and duplex mode are unknown.

Port link-type

Port link type:

  • Access.

  • Trunk.

  • Hybrid.

Tagged VLANs

VLAN whose packets are sent out of this interface with a tag.

Untagged VLANs

VLAN whose packets are sent out of this interface without a tag.

Last clearing of counters

Time when the reset counters interface command was last used to clear the interface statistics. This field displays Never if the reset counters interface command has never been used on the interface since device startup.

Last 300 seconds input/output rate

Average input or output rate over the last 300 seconds.

Input/Output (total)

Statistics of all packets received or sent on the interface.

Input/Output (normal)

Statistics of all normal packets received or sent on the interface.

Line protocol state

Data link layer state of the interface:

  • UP.

  • DOWN.

Maximum transmission unit

MTU of the interface.

Internet protocol processing: Disabled

The interface is not assigned an IP address and cannot process IP packets.

Internet address

IP address of the interface. The primary attribute indicates that the address is the primary IP address.

Brief information on interfaces in route mode

Brief information about Layer 3 interfaces.

Brief information on interfaces in bridge mode

Brief information about Layer 2 interfaces.

Interface

Abbreviated interface name.

Link

Physical link state of the interface:

  • UP—The interface is physically up.

  • DOWN—The interface is physically down.

  • ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command.

  • Stby—The interface is a backup interface in standby state.

Speed

Speed of the interface, in bps.

This field displays the (a) flag next to the speed if the speed is automatically negotiated.

This field displays auto if the interface is configured to autonegotiate its speed but the autonegotiation has not started.

Duplex

Duplex mode of the interface:

  • A—Autonegotiation. The interface is configured to autonegotiate its duplex mode but the autonegotiation has not started.

  • F—Full duplex.

  • F(a)—Autonegotiated full duplex.

  • H—Half duplex.

  • H(a)—Autonegotiated half duplex.

Type

Link type of the interface:

  • A—Access.

  • H—Hybrid.

  • T—Trunk.

Protocol

Data link layer protocol state of the interface:

  • UP—The data link layer protocol of the interface is up.

  • DOWN—The data link layer protocol of the interface is down.

  • UP(s)—The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s) attribute represents the spoofing flag. This value is typical of null interfaces and loopback interfaces.

Primary IP

Primary IP address of the interface. This field displays two hyphens (--) if the interface does not have an IP address.

Cause

Cause for the physical link state of an interface to be DOWN.