03-Interface Command Reference

HomeSupportResource CenterNFVH3C VSRH3C VSRTechnical DocumentsCommandCommand ReferencesH3C VSR Series Virtual Services Routers Command References(V7)-R0621-6W30003-Interface Command Reference
02-Ethernet interface commands
Title Size Download
02-Ethernet interface commands 177.04 KB

Ethernet interface commands

Common Ethernet interface commands

bandwidth

Use bandwidth to set the expected bandwidth of an interface.

Use undo bandwidth to restore the default.

Syntax

bandwidth bandwidth-value

undo bandwidth

Default

The expected bandwidth (in kbps) is the interface baud rate divided by 1000.

Views

Ethernet interface view

Ethernet subinterface view

Predefined user roles

network-admin

Parameters

bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.

Usage guidelines

The expected bandwidth is an informational parameter used only by higher-layer protocols for calculation. You cannot adjust the actual bandwidth of an interface by using this command.

Examples

# Set the expected bandwidth of GigabitEthernet 1/0 to 1000 kbps.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0

[Sysname-GigabitEthernet1/0] bandwidth 1000

# Set the expected bandwidth of GigabitEthernet 1/0.1 to 1000 kbps.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0.1

[Sysname-GigabitEthernet1/0.1] bandwidth 1000

Related commands

speed

dampening

Use dampening to enable the device to dampen an interface when the interface is flapping.

Use undo dampening to restore the default.

Syntax

dampening [ half-life reuse suppress max-suppress-time ]

undo dampening

Default

Interface dampening is disabled on Ethernet interfaces.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

half-life: Specifies the amount of time after which a penalty is decreased, in the range of 1 to 120 seconds. The default value is 54 seconds.

reuse: Specifies the reuse threshold in the range of 200 to 20000. The default value is 750. The reuse threshold must be less than the suppression threshold.

suppress: Specifies the suppression threshold in the range of 200 to 20000. The default value is 2000.

max-suppress-time: Specifies the maximum amount of time the interface can be dampened, in the range of 1 to 255 seconds. The default value is 162 seconds (three times the half-life timer).

Usage guidelines

When configuring the dampening command, follow these rules to set the values mentioned above:

·     The ceiling is equal to 2 (Max-suppress-time/Decay) × reuse-limits. It is not user configurable.

·     The configured suppress limit is lower than or equal to the ceiling.

·     The ceiling is lower than or equal to the maximum suppress limit supported.

This command does not take effect on the administratively down events. When you execute the shutdown command, the penalty restores to 0, and the interface reports the down event to the higher layer protocols.

After an interface in down state is dampened, the interface state displayed through the display interface command is always down.

Examples

# Enable interface dampening on GigabitEthernet 1/0.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0

[Sysname-GigabitEthernet1/0] dampening

# Enable interface dampening on GigabitEthernet 1/0, and set the following parameters:

·     Half life time to 2 seconds.

·     Reuse value to 800.

·     Suppression threshold to 3000.

·     Maximum suppression interval to 5 seconds.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0

[Sysname-GigabitEthernet1/0] dampening 2 800 3000 5

Related commands

display interface

default

Use default to restore the default settings for an interface.

Syntax

default

Views

Ethernet interface view

Ethernet subinterface view

Predefined user roles

network-admin

Usage guidelines

CAUTION

CAUTION:

The default command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command when you use it in a live network.

This command might fail to restore the default settings for some commands because of command dependencies or system restrictions. You can use the display this command in interface view to identify these commands, and use their undo forms or follow the command reference to restore their default settings. If your restoration attempt still fails, follow the error message instructions to solve the problem.

Examples

# Restore the default settings for GigabitEthernet 1/0.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0

[Sysname-GigabitEthernet1/0] default

This command will restore the default settings. Continue? [Y/N]:y

# Restore the default settings for GigabitEthernet 1/0.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0.1

[Sysname-GigabitEthernet1/0.1] default

This command will restore the default settings. Continue? [Y/N]:y

description

Use description to configure the description of an interface.

Use undo description to restore the default.

Syntax

description text

undo description

Default

The description of an interface is the interface name plus Interface (for example, GigabitEthernet1/0 Interface).

Views

Ethernet interface view

Ethernet subinterface view

Predefined user roles

network-admin

Parameters

text: Specifies the interface description, a case-sensitive string of 1 to 255 characters.

Examples

# Set the description of GigabitEthernet 1/0 to lan-interface.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0

[Sysname-GigabitEthernet1/0] description lan-interface

# Set the description of GigabitEthernet 1/0.1 to subinterface1/0.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0.1

[Sysname-GigabitEthernet1/0.1] description subinterface1/0.1

display counters

Use display counters to display interface traffic statistics.

Syntax

display counters { inbound | outbound } interface [ interface-type [ interface-number | interface-number.subnumber ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

inbound: Displays inbound traffic statistics.

outbound: Displays outbound traffic statistics.

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.

Usage guidelines

To clear the Ethernet interface traffic statistics, use the reset counters interface command.

If you do not specify an interface type, this command displays traffic statistics for all interfaces that have traffic counters.

If you specify an interface type but do not specify an interface number, this command displays traffic statistics for all interfaces of the specified type.

If you specify an interface type and number, this command displays traffic statistics for the specified interface.

Examples

# Display inbound traffic statistics for all interfaces.

<Sysname> display counters inbound interface

Interface            Total (pkts)    Broadcast (pkts)    Multicast (pkts)  Err (pkts)

GE1/0                         100                 100                   0           0

GE2/0                    Overflow            Overflow            Overflow    Overflow

 

 Overflow: More than 14 digits (7 digits for column "Err").

       --: Not supported.

Table 1 Command output

Field

Description

Interface

Abbreviated interface name.

Total (pkts)

Total number of packets received or sent through the interface.

Broadcast (pkts)

Total number of broadcast packets received or sent through the interface.

Multicast (pkts)

Total number of multicast packets received or sent through the interface.

Err (pkts)

Total number of error packets received or sent through the interface.

Overflow: More than 14 digits (7 digits for column "Err")

The command displays Overflow when any of the following conditions exist:

·     The data length of an Err field value is greater than 7 decimal digits.

·     The data length of a non-Err field value is greater than 14 decimal digits.

--: Not supported

The statistical item is not supported.

Related commands

reset counters interface

display counters rate

Use display counters rate to display traffic rate statistics for interfaces in up state for the most recent statistics polling interval.

Syntax

display counters rate { inbound | outbound } interface [ interface-type [ interface-number | interface-number.subnumber ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

inbound: Displays inbound traffic rate statistics.

outbound: Displays outbound traffic rate statistics.

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.

Usage guidelines

If you do not specify an interface type, this command displays traffic rate statistics for all up interfaces that have traffic counters.

If you specify an interface type but do not specify an interface number, this command displays traffic rate statistics for all up interfaces of the specified type.

If you specify an interface type and an interface, this command displays traffic rate statistics for the specified interface.

If an interface that you specify is always down for the most recent statistics polling interval, the system prompts that the interface does not support the command.

You can use the flow-interval command to set the statistics polling interval.

Examples

# Display the inbound traffic rate statistics for all interfaces.

<Sysname> display counters rate inbound interface

Usage: Bandwidth utilization in percentage

Interface            Usage (%)   Total (pps)   Broadcast (pps)   Multicast (pps)

GE1/0                       0             0                --               --

 

 Overflow: More than 14 digits.

       --: Not supported.

Table 2 Command output

Field

Description

Interface

Abbreviated interface name.

Usage (%)

Bandwidth usage (in percentage) of the interface for the last statistics polling interval.

Total (pps)

Average receiving or sending rate (in pps) for unicast packets for the last statistics polling interval.

Broadcast (pps)

Average receiving or sending rate (in pps) for broadcast packets for the last statistics polling interval.

Multicast (pps)

Average receiving or sending rate (in pps) for multicast packets for the last statistics polling interval. .

Overflow: more than 14 decimal digits

The command displays Overflow if the data length of a statistical item is greater than 14 decimal digits.

--: not supported

The statistical item is not supported.

Related commands

flow-interval

reset counters interface

display ethernet statistics

Use display ethernet statistics to display the Ethernet module statistics.

Syntax

In standalone mode:

display ethernet statistics

In IRF mode:

display ethernet statistics slot slot-number

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

slot slot-number: Specifies an IRF member device by its member ID. (In IRF mode.)

Examples

# (In standalone mode.) Display the Ethernet module statistics.

<Sysname> display ethernet statistics

ETH receive packet statistics:

    Totalnum        : 10447          ETHIINum     : 4459

    SNAPNum         : 0              RAWNum       : 0

    LLCNum          : 0              UnknownNum   : 0

    ForwardNum      : 4459           ARP          : 0

    MPLS            : 0              ISIS         : 0

    ISIS2           : 0              IP           : 0

    IPV6            : 0

ETH receive error statistics:

    NullPoint       : 0              ErrIfindex   : 0

    ErrIfcb         : 0              IfShut       : 0

    ErrAnalyse      : 5988           ErrSrcMAC    : 5988

    ErrHdrLen       : 0

 

ETH send packet statistics:

    L3OutNum        : 211            VLANOutNum   : 0

    FastOutNum      : 155            L2OutNum     : 0

ETH send error statistics:

    MbufRelayNum    : 0              NullMbuf     : 0

    ErrAdjFwd       : 0              ErrPrepend   : 0

    ErrHdrLen       : 0              ErrPad       : 0

    ErrQoSTrs       : 0              ErrVLANTrs   : 0

    ErrEncap        : 0              ErrTagVLAN   : 0

    IfShut          : 0              IfErr        : 0

# (In IRF mode.) Display the Ethernet module statistics for the specified slot.

<Sysname> display ethernet statistics slot 1

ETH receive packet statistics:

    Totalnum        : 10447          ETHIINum     : 4459

    SNAPNum         : 0              RAWNum       : 0

    LLCNum          : 0              UnknownNum   : 0

    ForwardNum      : 4459           ARP          : 0

    MPLS            : 0              ISIS         : 0

    ISIS2           : 0              IP           : 0

    IPV6            : 0

ETH receive error statistics:

    NullPoint       : 0              ErrIfindex   : 0

    ErrIfcb         : 0              IfShut       : 0

    ErrAnalyse      : 5988           ErrSrcMAC    : 5988

    ErrHdrLen       : 0

 

ETH send packet statistics:

    L3OutNum        : 211            VLANOutNum   : 0

    FastOutNum      : 155            L2OutNum     : 0

ETH send error statistics:

    MbufRelayNum    : 0              NullMbuf     : 0

    ErrAdjFwd       : 0              ErrPrepend   : 0

    ErrHdrLen       : 0              ErrPad       : 0

    ErrQoSTrs       : 0              ErrVLANTrs   : 0

    ErrEncap        : 0              ErrTagVLAN   : 0

    IfShut          : 0              IfErr        : 0

Table 3 Output description

Field

Description

ETH receive packet statistics

Statistics about the Ethernet packets received by the Ethernet module:

·     Totalnum—Total number of received packets.

·     ETHIINum—Number of packets encapsulated by using Ethernet II.

·     SNAPNum—Number of packets encapsulated by using SNAP.

·     RAWNum—Number of packets encapsulated by using RAW.

·     ISISNum—Number of packets encapsulated by using ISIS.

·     LLCNum—Number of packets encapsulated by using LLC.

·     UnknownNum—Number of packets encapsulated by using unknown methods.

·     ForwardNum—Number of packets forwarded at Layer 2 or sent to the CPU.

·     ARP—Number of ARP packets.

·     MPLS—Number of MPLS packets.

·     ISIS—Number of IS-IS packets.

·     ISIS2—Number of large 802.3/802.2 frames encapsulated by using IS-IS.

·     IP—Number of IP packets.

·     IPv6—Number of IPv6 packets.

ETH receive error statistics

Statistics about the error Ethernet packets in the inbound direction on the Ethernet module. Errors might be included in packets or occur during the receiving process. The items include:

·     NullPoint—Number of packets that include null pointers.

·     ErrIfindex—Number of packets that include incorrect interface indexes.

·     ErrIfcb—Number of packets that include incorrect interface control blocks.

·     IfShut—Number of packets that are being received when the interface is shut down.

·     ErrAnalyse—Number of packets that include packet parsing errors.

·     ErrSrcMAC—Number of packets that include incorrect source MAC addresses.

·     ErrHdrLen—Number of packets that include header length errors.

ETH send packet statistics

Statistics about the Ethernet packets sent by the Ethernet module:

·     L3OutNum—Number of packets sent out of Layer 3 Ethernet interfaces.

·     VLANOutNum—Number of packets sent out of VLAN interfaces.

·     FastOutNum—Number of packets fast forwarded.

·     L2OutNum—Number of packets sent out of Layer 2 Ethernet interfaces.

·     MbufRelayNum—Number of packets transparently sent.

ETH send error statistics

Statistics about the error Ethernet packets in the outbound direction on the Ethernet module:

·     NullMbuf—Number of packets with null pointers.

·     ErrAdjFwd—Number of packets with adjacency table errors.

·     ErrPrepend—Number of packets with extension errors.

·     ErrHdrLen—Number of packets with header length errors.

·     ErrPad—Number of packets with padding errors.

·     ErrQoSTrs—Number of packets that failed to be sent by QoS.

·     ErrVLANTrs—Number of packets that failed to be sent in VLANs.

·     ErrEncap—Number of packets that failed to be sent due to link header encapsulation failures.

·     ErrTagVLAN—Number of packets that failed to be sent due to VLAN tag encapsulation failures.

·     IfShut—Number of packets that are being sent when the interface is shut down.

·     IfErr—Number of packets with incorrect outgoing interfaces.

Related commands

reset ethernet statistics

display interface

Use display interface to display interface information.

Syntax

display interface [ interface-type [ interface-number | interface-number.subnumber ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.

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. If you do not specify this keyword, the command displays information about interfaces in all states.

Usage guidelines

If you do not specify an interface type, this command displays information about all interfaces except VA interfaces. For more information about VA interfaces, see PPP in Layer 2—WAN Access Configuration Guide.

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

Examples

# Display information about Layer 3 interface GigabitEthernet 1/0.

<Sysname> display interface gigabitethernet 1/0

GigabitEthernet1/0

Current state: Administratively DOWN

Line protocol state: DOWN

Description: GigabitEthernet1/0 Interface

Bandwidth: 1000000 kbps

Maximum transmission unit: 1500

Internet protocol processing: Disabled

IP packet frame type: Ethernet II, hardware address: 3822-d666-bd0c

IPv6 packet frame type: Ethernet II, hardware address: 3822-d666-bd0c

loopback: not set, promiscuous mode: not set                                   

1000Mb/s, Full-duplex, link type: autonegotiation,                             

flow-control: disabled

Output queue - Urgent queuing: Size/Length/Discards 0/1024/0

Output queue - Protocol queuing: Size/Length/Discards 0/500/0

Output queue - FIFO queuing: Size/Length/Discards 0/75/0

Last link flapping: 5 days 3 hours 6 minutes                                   

Last clearing of counters: 09:59:36 Wed 12/26/2018                             

Current system time:2018-12-26 10:33:19                                         

Last time when physical state changed to up:2018-12-21 07:27:13                

Last time when physical state changed to down:2018-12-21 07:27:10              

 Last 200 second input: 6 packets/sec 1728 bytes/sec 0%                         

 Last 200 second output: 0 packets/sec 22 bytes/sec 0%                         

 Input (total):  10694 packets, 2944465 bytes                                  

          951 unicasts, 3337 broadcasts, 6406 multicasts, 0 pauses             

 Input (normal):  10694 packets, 2944465 bytes                                 

          951 unicasts, 3337 broadcasts, 6406 multicasts, 0 pauses             

 Input:  0 input errors, 0 runts, 0 giants, 0 throttles                        

          0 CRC, 0 frame, 0 overruns, 0 aborts                                 

          0 ignored, 0 parity errors                                           

 Output (total): 1325 packets, 83462 bytes                                     

          1321 unicasts, 4 broadcasts, 0 multicasts, 0 pauses                  

 Output (normal): 1325 packets, 83462 bytes                                    

          1321 unicasts, 4 broadcasts, 0 multicasts, 0 pauses                  

 Output: 0 output errors, 0 underruns, 0 buffer failures                       

          0 aborts, 0 deferred, 0 collisions, 0 late collisions                

          0 lost carrier, 0 no carrier

Table 4 Command output

Field

Description

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).

·     DOWN ( Link-Aggregation interface down )—The aggregate interface to which the interface belongs has been shut down by using the shutdown command.

·     DOWN ( Tunnel-Bundle administratively down )—The tunnel bundle interface to which the interface belongs has been shut down by using the shutdown command.

·     DOWN (Monitor-Link uplink down )—The interface has been shut down by Monitor Link.

·     ETH-rddc Shutdown—The interface has been shut down by the Reth module.

·     mac-address moving down—The interface has been shut down by the MAC address move suppression feature.

·     MAD ShutDown—The interface has been shut down by IRF MAD. This state occurs if the interface is on an IRF fabric placed in Recovery state after an IRF split.

·     OFP DOWN—The interface has been shut down by OpenFlow.

·     UP—The interface is both administratively and physically up.

Line protocol state

Data link layer state of the interface. The state is determined through automatic parameter negotiation at the data link layer.

·     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. This attribute is typical of null interfaces and loopback interfaces.

·     DOWN—The data link layer protocol is down.

·     DOWN (protocols)—The data link layer has been shut down by protocols included in the parentheses. Available protocols include:

¡     DLDP—Shuts down the data link layer when it detects that the link is unidirectional.

¡     OAM—Shuts down the data link layer when it detects a remote link failure.

¡     LAGG—Shuts down the data link layer when it detects that the aggregate interface does not have Selected ports.

¡     BFD—Shuts down the data link layer when it detects a link failure.

¡     MACSEC—Shuts down the data link layer when it fails to negotiate the encryption parameters.

Bandwidth

Expected bandwidth of the interface.

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/mask-length (Type)

IP address of the interface and type of the address in parentheses.

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 3IP Services Configuration Guide.

·     BOOTP-allocatedBOOTP allocated IP address. For more information, see BOOTP client configuration in Layer 3IP Services Configuration Guide.

·     PPP-negotiated—IP address assigned by a PPP server during PPP negotiation. For more information, see PPP configuration in Layer 2WAN Access 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.

IP packet frame type

IPv4 packet framing format.

hardware address

MAC address of the interface.

IPv6 packet frame type

IPv6 packet framing format.

Output queue - Urgent queuing: Size/Length/Discards

Statistics for the urgent queue in the output queue:

·     Number of buffered packets.

·     Maximum number of packets that can be buffered.

·     Number of dropped packets.

Output queue - Protocol queuing: Size/Length/Discards

Statistics for the protocol queue in the output queue:

·     Number of buffered packets.

·     Maximum number of packets that can be buffered.

·     Number of dropped packets.

Output queue - FIFO queuing: Size/Length/Discards

Statistics for the FIFO queue in the output queue:

·     Number of buffered packets.

·     Maximum number of packets that can be buffered.

·     Number of dropped packets.

Port priority

Port priority of the interface.

Loopback is not set

No loopback test is running on the interface. This field depends on your configuration.

1000Mbps-speed mode

The interface is operating at 1000 Mbps. This field depends on your configuration and the link parameter negotiation result.

Unknown-speed mode

The speed of the interface is unknown because the speed negotiation fails or the interface is physically disconnected.

full-duplex mode

The interface is operating in full duplex mode. This field depends on your configuration and the link parameter negotiation result.

unknown-duplex mode

The duplex mode of the interface is unknown because the duplex mode negotiation fails or the interface is physically disconnected.

Link speed type is force link

The interface is manually configured with a speed (for example, 1000 Mbps) by using the speed command.

link duplex type is force link

The interface is manually configured with a duplex mode (for example, half or full) by using the duplex command.

Flow-control is not enabled

Generic flow control is disabled on the interface. This field depends on your configuration and the link parameter negotiation result.

Maximum frame length

Maximum length of Ethernet frames allowed to pass through the interface.

Allow jumbo frame to pass

The interface allows jumbo frames to pass through.

Broadcast max-

Broadcast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration.

Multicast max-

Multicast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration.

Unicast max-

Unknown unicast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration.

PVID

Port VLAN ID (PVID) of the interface.

MDI type

MDIX mode of the interface:

·     automdix.

·     mdi.

·     mdix.

Port link-type

Link type of the interface:

·     access.

·     trunk.

·     hybrid.

Tagged VLANs

VLANs for which the interface sends packets without removing VLAN tags.

Untagged VLANs

VLANs for which the interface sends packets after removing VLAN tags.

VLAN Passing

VLANs whose packets can be forwarded by the port. The VLANs must have been created.

VLAN permitted

VLANs whose packets are permitted by the port.

Trunk port encapsulation

Encapsulation protocol type for the trunk port.

Last link flapping

The amount of time that has elapsed since the most recent physical state change of the interface. This field displays Never if the interface has been physically down since device startup.

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.

Current system time

Current system time in the YYYY/MM/DD HH:MM:SS format. If the time zone is configured, this field is in the YYYY/MM/DD HH:MM:SS UTC±HH:MM:SS format.

Last time when physical state changed to up

Last time when physical state of the interface changed to up.

A hyphen (-) indicates that the physical state of the interface has not changed to up.

Last time when physical state changed to down

Last time when physical state of the interface changed to down.

A hyphen (-) indicates that the physical state of the interface has not changed to down.

Last 300 second input:  0 packets/sec 0 bytes/sec 0%

Last 300 second output:  0 packets/sec 0 bytes/sec 0%

Average inbound or outbound traffic rate (in pps and Bps) in the last 300 seconds, and the ratio of the actual rate to the interface bandwidth.

A hyphen (-) indicates that the statistical item is not supported.

Input(total):  0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

The two fields on the first line represent the inbound traffic statistics (in packets and bytes) for the interface. All inbound normal packets, abnormal packets, and normal pause frames were counted.

The four fields on the second line represent:

·     Number of inbound unicast packets.

·     Number of inbound broadcasts.

·     Number of inbound multicasts.

·     Number of inbound pause frames.

A hyphen (-) indicates that the statistical item is not supported.

Input(normal):  0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

The two fields on the first line represent the inbound normal traffic and pause frame statistics (in packets and bytes) for the interface.

The four fields on the second line represent:

·     Number of inbound normal unicast packets.

·     Number of inbound normal broadcasts.

·     Number of inbound normal multicasts.

·     Number of inbound normal pause frames.

A hyphen (-) indicates that the statistical item is not supported.

input errors

Statistics of incoming error packets.

runts

Number of inbound frames meeting the following conditions:

·     Shorter than 64 bytes.

·     In correct format.

·     Containing valid CRCs.

giants

Number of inbound giants. Giants refer to frames larger than the maximum frame length supported on the interface.

For an Ethernet interface that does not permit jumbo frames, the maximum frame length is as follows:

·     1518 bytes (without VLAN tags).

·     1522 bytes (with VLAN tags).

For an Ethernet interface that permits jumbo frames, the maximum Ethernet frame length is set when you configure jumbo frame support on the interface.

throttles

Number of inbound frames that had a non-integer number of bytes.

CRC

Total number of inbound frames that had a normal length, but contained CRC errors.

frame

Total number of inbound frames that contained CRC errors and a non-integer number of bytes.

overruns

Number of packets dropped because the input rate of the port exceeded the queuing capability.

aborts

Total number of illegal inbound packets:

·     Fragment frames—CRC error frames shorter than 64 bytes. The length (in bytes) can be an integral or non-integral value.

·     Jabber frames—CRC error frames greater than the maximum frame length supported on the Ethernet interface (with an integral or non-integral length).

¡     For an Ethernet interface that does not permit jumbo frames, the maximum frame length is 1518 bytes (without VLAN tags) or 1522 bytes (with VLAN tags).

¡     For an Ethernet interface that permits jumbo frames, the maximum Ethernet frame length is set when you configure jumbo frame support on the interface.

·     Symbol error frames—Frames that contained a minimum of one undefined symbol.

·     Unknown operation code frames—Non-pause MAC control frames.

·     Length error frames—Frames whose 802.3 length fields did not match the actual frame length (46 to 1500 bytes).

ignored

Number of inbound frames dropped because the receiving buffer of the port ran low.

parity errors

Total number of frames with parity errors.

Output(total): 0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

The two fields on the first line represent the outbound traffic statistics (in packets and bytes) for the interface. All outbound normal packets, abnormal packets, and normal pause frames were counted.

The four fields on the second line represent:

·     Number of outbound unicast packets.

·     Number of outbound broadcasts.

·     Number of outbound multicasts.

·     Number of outbound pause frames.

A hyphen (-) indicates that the statistical item is not supported.

Output(normal): 0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

The two fields on the first line represent the outbound normal traffic and pause frame statistics (in packets and bytes) for the interface.

The four fields on the second line represent:

·     Number of outbound normal unicast packets.

·     Number of outbound normal broadcasts.

·     Number of outbound normal multicasts.

·     Number of outbound normal pause frames.

A hyphen (-) indicates that the statistical item is not supported.

output errors

Number of outbound packets with errors.

underruns

Number of packets dropped because the output rate of the interface exceeded the output queuing capability. This is a low-probability hardware anomaly.

buffer failures

Number of packets dropped because the transmitting buffer of the interface ran low.

aborts

Number of packets that failed to be transmitted, for example, because of Ethernet collisions.

deferred

Number of frames that the interface deferred to transmit because of detected collisions.

collisions

Number of frames that the interface stopped transmitting because Ethernet collisions were detected during transmission.

late collisions

Number of frames that the interface deferred to transmit after transmitting their first 512 bits because of detected collisions.

lost carrier

Number of carrier losses during transmission. This counter increases by one when a carrier is lost, and applies to serial WAN interfaces.

no carrier

Number of times that the port failed to detect the carrier when attempting to send frames. This counter increases by one when a port failed to detect the carrier, and applies to serial WAN interfaces.

# Display brief information about all interfaces.

<Sysname> display interface brief

Brief information on interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) – spoofing

 

Interface            Link Protocol Primary IP      Description

GE1/0                DOWN DOWN     --

Loop0                UP   UP(s)    2.2.2.9

NULL0                UP   UP(s)    --

Vlan1                UP   UP       --

Vlan999              UP   UP       192.168.1.42

 

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

GE2/0                DOWN auto    A      A    1

# Display brief information about GigabitEthernet 1/0, including the complete description of the interface.

<Sysname> display interface gigabitethernet 1/0 brief description

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

GE1/0                UP   auto    F(a)   A    1    aaaaaaaaaaaaaaaaaaaaaaaaaaaaa

aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

# Display information about interfaces in DOWN state and the causes.

<Sysname> display interface brief down

Brief information on interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Interface            Link Cause

GE1/0                DOWN Not connected

Vlan2                DOWN Not connected

 

Brief information on interfaces in bridge mode:

Link: ADM - administratively down; Stby - standby

Interface            Link Cause

GE2/0                DOWN Not connected

Table 5 Command output

Field

Description

Brief information on interfaces in route mode:

Brief information about Layer 3 interfaces.

Interface

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. To see the primary interface, use the display interface-backup state command.

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.

Description

Description of the interface.

Brief information of interfaces in bridge mode:

Brief information about Layer 2 interfaces.

Type: A - access; T - trunk; H – hybrid

Link type options for interfaces.

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.

PVID

Port VLAN ID.

Cause

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

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

·     DOWN ( Link-Aggregation interface down )—The interface is a member port of an aggregate interface, and the aggregate interface is down.

·     DOWN (Loopback detection down)—The loopback detection module has detected loops.

·     DOWN ( Monitor-Link uplink down )—The monitor link module has detected that the uplink is down.

·     MAD ShutDown—The interface is on an IRF fabric placed by IRF MAD in Recovery state after an IRF split.

·     Not connected—No physical connection exists (possibly because the network cable is disconnected or faulty).

·     Storm-Constrain—The storm control feature has detected that unknown unicast traffic, multicast traffic, or broadcast traffic exceeded the upper threshold.

·     STP DOWN—The interface has been shut down by the BPDU guard feature.

·     Port Security Disabled—The interface has been shut down by the intrusion detection mechanism because the interface received illegal packets.

·     OFP DOWN—The interface has been shut down by OpenFlow.

·     Standby—The interface is a backup interface in standby state.

Related commands

reset counters interface

flow-interval

Use flow-interval to set the statistics polling interval.

Use undo flow-interval to restore the default.

Syntax

flow-interval interval

undo flow-interval

Default

The statistics polling interval is 300 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Sets the statistics polling interval in seconds. The interval is in the range of 5 to 300 and must be a multiple of 5.

Examples

# Set the statistics polling interval to 100 seconds.

<Sysname> system-view

[Sysname] flow-interval 100

interface

Use interface to enter interface view, create a subinterface and enter its view, or enter the view of an existing subinterface.

Syntax

interface interface-type { interface-number | interface-number.subnumber }

Views

System view

Predefined user roles

network-admin

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.

Examples

# Enter the view of GigabitEthernet 1/0.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0

[Sysname-GigabitEthernet1/0]

# Create Ethernet subinterface GigabitEthernet 1/0.1 and enter its view.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0.1

[Sysname-GigabitEthernet1/0.1]

jumboframe enable

Use jumboframe enable to allow jumbo frames within the specified length to pass through.

Use undo jumboframe enable to prevent jumbo frames from passing through.

Use undo jumboframe enable size to restore the default.

Syntax

jumboframe enable [ size ]

undo jumboframe enable [ size ]

Default

The device allows frames within 16384 bytes to pass through.

Views

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

size: Sets the maximum length (in bytes) of Ethernet frames that are allowed to pass through. The value for this argument is 1536 to 16384.

Usage guidelines

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Allow jumbo frames to pass through GigabitEthernet 1/0.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0

[Sysname-GigabitEthernet1/0] jumboframe enable

 

 

 

reset counters interface

Use reset counters interface to clear the interface statistics.

Syntax

reset counters interface [ interface-type [ interface-number | interface-number.subnumber ] ]

Views

User view

Predefined user roles

network-admin

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.

Usage guidelines

Use this command to clear history statistics if you want to collect traffic statistics for a specific time period.

If you do not specify an interface type, this command clears statistics for all interfaces except VA interfaces. For more information about VA interfaces, see PPPoE in Layer 2—WAN Access Configuration Guide.

If you specify an interface type but do not specify an interface number, this command clears statistics for all interfaces of the specified type.

Examples

# Clear the statistics for GigabitEthernet 1/0.

<Sysname> reset counters interface gigabitethernet 1/0

Related commands

display counters interface

display counters rate interface

display interface

reset ethernet statistics

Use reset ethernet statistics to clear the Ethernet module statistics.

Syntax

In standalone mode:

reset ethernet statistics

In IRF mode:

reset ethernet statistics [ slot slot-number ]

Views

User view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command clears statistics for all IRF member devices. (In IRF mode.)

Examples

# (In standalone mode.) Clear the Ethernet module statistics.

<Sysname> reset ethernet statistics

# (In IRF mode.) Clear the Ethernet module statistics for the specified slot.

<Sysname> reset ethernet statistics slot 1

Related commands

display ethernet statistics

shutdown

Use shutdown to shut down an Ethernet interface or subinterface.

Use undo shutdown to bring up an Ethernet interface or subinterface.

Syntax

shutdown

undo shutdown

Default

An Ethernet interface or subinterface is up.

Views

Ethernet interface view

Ethernet subinterface view

Predefined user roles

network-admin

Usage guidelines

Some interface configurations might require an interface restart before taking effect.

Examples

# Shut down and then bring up GigabitEthernet 1/0.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0

[Sysname-GigabitEthernet1/0] shutdown

[Sysname-GigabitEthernet1/0] undo shutdown

# Shut down and then bring up GigabitEthernet 1/0.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0.1

[Sysname-GigabitEthernet1/0.1] shutdown

[Sysname-GigabitEthernet1/0.1] undo shutdown

sub-interface rate-statistic

Use sub-interface rate-statistic to enable rate statistics collection for the subinterfaces of an Ethernet interface.

Use undo sub-interface rate-statistic to disable rate statistics collection for the subinterfaces of an Ethernet interface.

Syntax

sub-interface rate-statistic

undo sub-interface rate-statistic

Default

The system does not collect rate statistics for the subinterfaces of an Ethernet interface.

Views

Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

This command is resource intensive. When you use this command, make sure you fully understand its impact on system performance.

Examples

# Enable rate statistics collection for the subinterfaces of GigabitEthernet 1/0.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0

[Sysname-GigabitEthernet1/0] sub-interface rate-statistic

This configuration may make a negative effect on the performance. Are you sure to continue? [Y/N]:y

Layer 3 Ethernet interface or subinterface commands

mac-address

Use mac-address to set the MAC address of an Ethernet interface.

Use undo mac-address to restore the default.

Syntax

mac-address mac-address

undo mac-address

Default

No MAC address is configured for an Ethernet interface.

Views

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

mac-address: Specifies a MAC address in the format of H-H-H.

Usage guidelines

When you set a MAC address for a Layer 3 Ethernet subinterface, select a MAC address different from that of the main interface.

Do not set a VRRP-reserved MAC address for a Layer 3 Ethernet subinterface.

Examples

# Set the MAC address of GigabitEthernet 1/0 to 0001-0001-0001.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0

[Sysname-GigabitEthernet1/0] mac-address 1-1-1

mtu

Use mtu to set the MTU for an Ethernet interface or subinterface.

Use undo mtu to restore the default.

Syntax

mtu size

undo mtu

Default

The MTU of an Ethernet interface or subinterface is 1500 bytes.

Views

Layer 3 Ethernet interface view

Layer 3 Ethernet subinterface view

Predefined user roles

network-admin

Parameters

size: Sets the MTU in bytes. The value range for this argument varies by interface type.

Usage guidelines

A smaller MTU size results in more fragments. When you set the MTU for an interface, consider QoS queue lengths, for example, consider that the default FIFO queue length is 75. To prevent a too small MTU from causing packet drops in QoS queuing, you can perform one of the following configurations:

·     Tune the MTU with the mtu command.

·     Tune QoS queue lengths with the qos fifo queue-length command.

For more information about the qos fifo queue-length command, see ACL and QoS Command Reference.

Examples

# Set the MTU to 1430 bytes for GigabitEthernet 1/0.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0

[Sysname-GigabitEthernet1/0] mtu 1430

# Set the MTU to 1430 bytes for GigabitEthernet 1/0.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0.1

[Sysname-GigabitEthernet1/0.1] mtu 1430