02-Interface Command Reference

HomeSupportRoutersH3C SR8800 Router SeriesReference GuidesCommand ReferencesH3C SR8800 Command Reference-Release3347-6W10302-Interface Command Reference
01-Ethernet Interface Commands
Title Size Download
01-Ethernet Interface Commands 256.73 KB

 

 

NOTE:

In this documentation, SPC cards refer to the interface cards prefixed with SPC, for example, SPC-GT48L. SPE cards refer to the cards prefixed with SPE, for example, SPE-1020-E.

 

General Ethernet interface/subinterface configuration commands

combo enable

Syntax

combo enable { copper | fiber }

View

Ethernet interface view (Combo interface)

Default level

2: System level

Parameters

copper: Activates the electrical port of the Combo interface.

fiber: Activates the optical port of the Combo interface.

Description

Use the combo enable command to activate the electrical or optical port of a Combo interface.

By default, the electrical port of a Combo interface is activated.

Combo interfaces are logical interfaces. A Combo interface comprises one optical (fiber) port and one electrical (copper) port. The two ports cannot work simultaneously because they share the same forwarding interface. If one port is enabled, the other port is automatically disabled.

Examples

# Activate the electrical port of Combo interface GigabitEthernet 3/1/3.

<Sysname> system-view

[Sysname] interface gigabitethernet 3/1/3

[Sysname-GigabitEthernet3/1/3] combo enable fiber

default

Syntax

default

View

Ethernet interface view, Ethernet subinterface view

Default level

2: System level

Parameters

None

Description

Use the default command to restore the default settings for an Ethernet interface or subinterface.

This command might fail to restore the default settings for some commands for reasons such as command dependencies and system restrictions. You can use the display this command in interface view to check for these commands, and perform their undo forms or follow the command reference to individually restore their default settings. If your restoration attempt still fails, follow the error message to resolve the problem.

 

CAUTION

CAUTION:

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

 

Examples

# Restore the default settings for interface GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 2/1/1

[Sysname-GigabitEthernet2/1/1] default

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

# Restore the default settings for subinterface GigabitEthernet 2/1/1.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 2/1/1.1

[Sysname-GigabitEthernet2/1/1.1] default

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

description

Syntax

description text

undo description

View

Ethernet interface view, Ethernet subinterface view

Default level

2: System level

Parameters

text: Specifies the interface description, a string of 1 to 80 characters. The string can include case-sensitive letters, digits, special characters such as tilde (~), exclamation mark(!), at sign (@), number sign (#), dollar sign ($), percent (%), caret (^), ampersand (&), asterisk(*), brackets({ }, ( ),[ ], < >), hyphen (-), underscore(_), plus (+), equal sign (=), vertical bar (|), backslash (\), colon (:), semicolon (;) prime ("), apostrophe('),comma (,), period (.), slash (/), spaces, and other Unicode characters and symbols.

 

 

NOTE:

·       Each Unicode character takes the space of two regular characters.

·       To use Unicode characters or symbols in an interface description, install the specific input method editor and log in to the router through remote login software that supports the character type.

·       When the length of a description string reaches or exceeds the maximum line width on the terminal software, the software starts a new line, possibly breaking a Unicode character into two. As a result, garbled characters may be displayed at the end of a line.

 

Description

Use the description command to change the description of the interface.

Use the undo description command to restore the default.

The default description of an Ethernet interface is the interface name plus Interface.

Related commands: display interface.

Examples

# Change the description of interface GigabitEthernet 2/1/1 to aaa.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] description aaa

display counters

Syntax

display counters { inbound | outbound } interface [ interface-type ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

inbound: Displays inbound traffic statistics.

outbound: Displays outbound traffic statistics.

interface-type: Specifies an interface type. If the RPR interface type is specified, broadcast and multicast packets are regarded as multicast packets.

|: 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 the display counters command to display traffic statistics for interfaces.

·           If an interface type is specified, this command displays traffic statistics for all interfaces of that type.

·           If no interface type is specified, this command displays traffic statistics for all interfaces that have traffic counters.

Examples

# Display inbound traffic statistics for all GigabitEthernet interfaces.

<Sysname> display counters inbound interface gigabitethernet

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

GE2/1/1                      100                100                  0         0

GE2/1/2                        0                  0                  0         0

GE2/1/3                 Overflow           Overflow           Overflow  Overflow

GE2/1/4                        0                  0                  0         0

 

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

      --: not supported.

Table 1 Output description

Field

Description

Interface

Abbreviated interface name.

Total (pkts)

Total number of packets received or sent through the interface. You can specify a traffic direction by using the inbound or outbound keyword.

Broadcast (pkts)

Total number of broadcast packets received/sent through the interface. You can specify a traffic direction by using the inbound or outbound keyword.

Multicast (pkts)

Total number of multicast packets received/sent through the interface. You can specify a traffic direction by using the inbound or outbound keyword.

Err (pkts)

Total number of error packets received/sent through the interface. You can specify a traffic direction by using the inbound or outbound keyword.

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

The command displays Overflow in any of the following cases:

·       The data length of an error statistic is greater than 7 decimal digits.

·       The data length of a non-error statistic is greater than 14 decimal digits.

--: not supported.

The statistical item is not supported.

 

display counters rate

Syntax

display counters rate { inbound | outbound } interface [ interface-type ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

inbound: Displays inbound traffic rate statistics.

outbound: Displays outbound traffic rate statistics.

interface-type: Specifies an interface type. If the RPR interface type is specified, broadcast and multicast packets are regarded as multicast packets.

|: 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 the display counters rate command to display traffic rate statistics over the last sampling interval.

·           If you provide the interface-type argument, this command displays the traffic rate statistics of all the interfaces of that type in the up state.

·           If you do not provide the argument, this command displays the traffic rate statistics of all the interfaces that support this command.

To set the sampling interval, use the flow-interval command.

Examples

# Display inbound traffic rate statistics for all GigabitEthernet interfaces.

<Sysname> display counters rate inbound interface gigabitethernet

Interface           Total(pkts/sec)   Broadcast(pkts/sec)   Multicast(pkts/sec)

GE2/1/1                         200                   100                   100

GE2/1/2                         300                   200                   100

GE2/1/4                         300                   200                   100

 

Overflow: more than 14 decimal digits.

      --: not supported.

Table 2 Output description

Field

Description

Interface

Brief interface name.

Total(pkts/sec)

Average rate (in packets per second) of receiving/sending packets during the sampling interval. You can specify the direction of the packets using the inbound and outbound keyword.

Broadcast(pkts/sec)

Average rate (packets per second) of receiving/sending broadcast packets during the sampling interval. You can specify the direction of the packets using the inbound and outbound keyword.

Multicast(pkts/sec)

Average rate (packets per second) of receiving/sending multicast packets during the sampling interval. You can specify the direction of the packets using the inbound and outbound keyword.

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

The command displays Overflow in any of the following cases:

·       The data length of an error statistic is greater than 7 decimal digits.

·       The data length of a non-error statistic is greater than 14 decimal digits.

--: not supported.

The statistics item is not supported.

 

display interface

Syntax

display interface [ interface-type ] [ brief [ down ] ] [ | { begin | exclude | include } regular-expression ]

display interface interface-type { interface-number | interface-number.subnumber } [ brief ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

interface-type: Type of a specified interface.

interface-number: Number of a specified interface.

interface-number.subnumber: Subinterface number, where interface-number is an interface number; subnumber is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4093.

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

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

|: 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 the display interface command to display Ethernet interface information.

·           If the interface type is not specified, the command displays detailed information about all interfaces.

·           If only the interface type is specified, the command displays detailed information about all interfaces of that type.

Examples

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

<Sysname> display interface GigabitEthernet 2/1/1

GigabitEthernet2/1/1 current state: DOWN

Line protocol current state: DOWN

Description: GigabitEthernet2/1/1 Interface

The Maximum Transmit Unit is 1500

Link delay is 1(sec)

Internet protocol processing : disabled

IP Packet Frame Type: PKTFMT_ETHNT_2,  Hardware Address: 000f-e201-2498

IPv6 Packet Frame Type: PKTFMT_ETHNT_2,  Hardware Address: 000f-e201-2498

Media type is not sure, Port hardware type is No connector

 Loopback is not set

 1000Mbps-speed mode, full-duplex mode

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

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

 Input  (total): 0 packets, 0 bytes

          0 broadcasts, 0 multicasts

 Input  (normal): 0 packets, 0 bytes

          - broadcasts, - multicasts

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

          0 CRC, 0 frame, 0 overruns, - aborts

          0 ignored, - parity errors

 Output  (total): 0 packets, 0 bytes

          - broadcasts, - multicasts, 0 pauses

 Output  (normal): 0 packets, 0 bytes

          - broadcasts, - multicasts, 0 pauses

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

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

          - lost carrier, - no carrier

 Peak value of input: 0 bytes/sec, at 2010-10-27 16:34:33

 Peak value of output: 0 bytes/sec, at 2010-10-27 16:34:33

Table 3 Output description

Field

Description

GigabitEthernet2/1/1 current state

Current state of the Ethernet interface:

·       DOWN ( Administratively )—The Ethernet interface was shut down with the shutdown command. The interface is administratively down.

·       DOWN ( Link-Aggregation interface down )—The Ethernet interface is physically down because the aggregate interface corresponding to the aggregation group to which the Ethernet interface belongs was shut down with the shutdown command.

·       DOWN—The Ethernet interface is administratively up but physically down (possibly because no physical link is present or the link has failed).

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

Line protocol current state

Link layer state of the interface:

·       DOWN—The interface is physically down.

·       UPThe interface is physically up.

Description

Description of the interface.

The Maximum Transmit Unit

The MTU of the interface.

Link delay

Delay before a physical link up/down event is reported.

Internet protocol processing

IP packet processing: disabled indicates that IP packets cannot be processed.

For an interface configured with an IP address, this field changes into Internet Address is.

Last 300 seconds input

Average input rate over the last 300 seconds:

·       packets/sec indicates the average input rate in terms of the average number of packets received per second.

·       bytes/sec indicates the average input rate in terms of the average number of bytes received per second.

·       x% indicates the percentage of the average input rate to the total bandwidth.

Last 300 seconds output

Average output rate over the last 300 seconds:

·       packets/sec indicates the average output rate in terms of the average number of packets output per second.

·       bytes/sec indicates the average output rate in terms of the average number of bytes output per second.

·       x% indicates the percentage of the average output rate to the total bandwidth.

Input (total):

Input (normal):

Input:

Output (total):

Output (normal):

Output:

Statistics about inbound and outbound packet errors on the interface. If a statistical item is not supported, a hyphen (-) is displayed.

Peak value of input

Peak input rate on the interface and time when the peak occurred.

Peak value of output

Peak output rate on the interface and time when the peak occurred.

 

# Display information about Layer 3 Ethernet subinterface GigabitEthernet 3/0/1.1.

<Sysname> display interface gigabitethernet 3/0/1.1

GigabitEthernet 3/0/1.1 current state: DOWN

Line protocol current state: DOWN

Description: GigabitEthernet3/0/1.1 Interface

The Maximum Transmit Unit is 1500

Internet protocol processing : disabled

IP Packet Frame Type: PKTFMT_ETHNT_2,  Hardware Address: 00e0-fc00-96c1

IPv6 Packet Frame Type: PKTFMT_ETHNT_2,  Hardware Address: 00e0-fc00-96c1

 Last clearing of counters:  Never

Table 4 Output description

Field

Description

GigabitEthernet3/0/1.1 current state

The state of the Ethernet subinterface:

·       DOWN ( Administratively )—The Ethernet subinterface was shut down with the shutdown command. The Ethernet subinterface is administratively down.

·       DOWN ( Link-Aggregation interface down )—The Ethernet subinterface is physically down because the aggregate interface corresponding to the aggregation group to which the subinterface belongs was shut down with the shutdown command.

·       DOWN—The Ethernet subinterface is administratively up but physically down (possibly because no physical link is present or the link has failed).

·       UP—The Ethernet subinterface is both administratively and physically up.

Line protocol current state

The link layer state of the subinterface:

·       DOWN—The interface is physically down.

·       UPThe interface is physically up.

Internet protocol processing

Disabled indicates that IP packets cannot be processed.

For an interface configured with an IP address, this field changes to Internet Address is.

IP Packet Frame Type

Encapsulation format for IPv4 packets.

Hardware Address

MAC address corresponding to the subinterface.

IPv6 Packet Frame Type

Encapsulation format for IPv6 packets.

Last clearing of counters

Time when the reset counts interface command was last used to clear statistics on the subinterface.

If the command was never used since the device was started, this field displays Never.

 

# Display information about Layer 2 interface GigabitEthernet 5/1/15.

<Sysname> display interface GigabitEthernet 5/1/15

GigabitEthernet3/1/15 current state: DOWN

 IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 000f-e246-6e5b

 Description: GigabitEthernet3/1/15 Interface

 Loopback is not set

 Media type is not sure, Port hardware type is No connector

 Unknown-speed mode, full-duplex mode

 Link speed type is autonegotiation, link duplex type is force link

 Flow-control is not enabled

 The Maximum Frame Length is 1552

 Broadcast MAX-ratio: 100%

 Unicast MAX-ratio: 100%

 Multicast MAX-ratio: 100%

 PVID: 100

 Link delay is 1(sec)

 Port link-type: access

  Tagged   VLAN ID : none

  Untagged VLAN ID : 100

 Port priority: 0

 Last clearing of counters:  Never

 Peak value of input: 0 bytes/sec, at 2009-06-03 10:39:27

 Peak value of output: 0 bytes/sec, at 2009-06-03 10:39:27

 Last 300 seconds input:  0 packets/sec 0 bytes/sec      -%

 Last 300 seconds output:  0 packets/sec 0 bytes/sec     -%

 Input (total):  0 packets, 0 bytes

          - unicasts, 0 broadcasts, 0 multicasts, - pauses

 Input (normal):  0 packets, 0 bytes

          - unicasts, - broadcasts, - multicasts, - pauses

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

          0 CRC, 0 frame, 0 overruns, - aborts

          0 ignored, - parity errors

 Output (total): 0 packets, 0 bytes

          - unicasts, - broadcasts, - multicasts, 0 pauses

 Output (normal): 0 packets, 0 bytes

          - unicasts, - broadcasts, - multicasts, 0 pauses

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

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

          - lost carrier, - no carrier  

Table 5 Output description

Field

Description

GigabitEthernet 5/1/15 current state

Physical state of the Ethernet interface. For more information, see Table 6.

IP Packet Frame Type

Ethernet framing format on the interface.

Description

Description of the interface.

Unknown-speed mode

The interface will negotiate a speed with its peer.

Broadcast MAX-ratio

Broadcast suppression threshold as a percentage of the interface transmission capability. When the threshold is exceeded, the interface drops broadcast packets.

Unicast MAX-ratio

Unknown unicast suppression threshold as a percentage of the interface transmission capability. When the threshold is exceeded, the interface drops unknown unicast packets.

Multicast MAX-ratio

Multicast suppression threshold as a percentage of the interface transmission capability. When the threshold is exceeded, the interface drops multicast packets.

PVID

Default VLAN ID.

Link delay

Delay before a physical link up/down event is reported.

Port link-type

Interface link type, which could be access, trunk, and hybrid.

Tagged   VLAN ID

VLANs whose packets are sent through the port with VLAN tag kept.

Untagged VLAN ID

VLANs whose packets are sent through the port with VLAN tag stripped off.

Last clearing of counters

Time when the reset counts interface command was last used to clear statistics on the subinterface.

If the command was never used since the device was started, this field displays Never.

Peak value of input

Peak value of inbound traffic, in bytes/sec.

Peak value of output

Peak value of outbound traffic, in bytes/sec.

Last 300 seconds input:  0 packets/sec 0 bytes/sec

Last 300 seconds output:  0 packets/sec 0 bytes/sec

Average rate of input and output traffic in the last 300 seconds, in pps and Bps.

Input (total):  0 packets, 0 bytes

          - unicasts, 0 broadcasts, 0 multicasts, - pauses

Packet statistics on the inbound direction of the interface, including the statistics of normal packets, abnormal packets, and normal pause frames, in packets and bytes.

Number of unicast packets, broadcast packets, multicast packets, and pause frames on the inbound direction of the interface.

Input (normal):  0 packets, 0 bytes

          - unicasts, - broadcasts, - multicasts, - pauses

Normal packet statistics on the inbound direction of the interface, including the statistics of normal packets and pause frames, in packets and bytes.

Number of unicast packets, broadcast packets, multicast packets, and pause frames on the inbound direction of the interface.

input errors

Input packets with errors.

runts

Frames received that were shorter than 64 bytes, yet in correct formats, and contained valid CRCs.

giants

Frames received that were longer than the maximum allowed frame length of the interface:

The word “giants” refers to frames that are longer than 1518 bytes (without VLAN tags) or 1522 bytes (with VLAN tags).

throttles

The number of times the receiver on the interface was disabled, possibly because of buffer or CPU overload.

CRC

Total number of packets received that had a normal length, but contained checksum errors.

frame

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

overruns

Number of times the receive rate of the interface exceeded the capacity of the input queue, causing packets to be discarded.

aborts

Total number of illegal packets received, including:

·       Fragment frames—Frames that were shorter than 64 bytes (with an integral or non-integral length) and contained checksum errors.

·       Jabber frames—Frames that were longer than 1518 or 1522 bytes and contain checksum errors (with an integral or non-integral length).

·       Symbol error frames—Frames that contained at least one undefined symbol.

·       Unknown operation code frames—Frames that were MAC control frames, excluding PAUSE frames.

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

ignored

Number of received packets ignored by the interface because the interface hardware ran low on internal buffers.

parity errors

Total number of frames with parity errors.

Output (total): 0 packets, 0 bytes

          - unicasts, - broadcasts, - multicasts, 0 pauses

Packet statistics on the outbound direction of the interface, including the statistics of normal packets, abnormal packets, and normal pause frames, in packets and bytes.

Number of unicast packets, broadcast packets, multicast packets, and pause frames on the outbound direction of the interface.

Output (normal): 0 packets, 0 bytes

          - unicasts, - broadcasts, - multicasts, 0 pauses

Normal packet statistics on the outbound direction of the interface, including the statistics of normal packets and pause frames, in packets and bytes.

Number of unicast packets, broadcast packets, multicast packets, and pause frames in the outbound direction of the interface. If a statistical item is not supported, a hyphen (-) is displayed.

output errors

Output packets with errors.

underruns

Number of times the transmit rate of the interface exceeded the capacity of the output queue, causing packets to be discarded. This is a very rare hardware-related problem.

buffer failures

Number of packets dropped because the interface ran low on output buffers.

aborts

Number of packets that failed to be transmitted due to causes such as Ethernet collisions.

deferred

Number of frames whose first transmission attempt was delayed, due to traffic on the network media, and that were successfully transmitted later.

collisions

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

late collisions

Number of times frames were delayed due to the detection of collisions after the first 512 bits of the frames were already on the network.

lost carrier

Number of times the carrier was lost during transmission. This counter applies to serial WAN interfaces.

no carrier

Number of times the carrier was not present in the transmission. This counter applies to serial WAN interfaces.

 

Table 6 Description on the possible physical states of a Layer 2 Ethernet interface

Field

Description

UP

The interface is physically up.

DOWN

The interface is physically down because no physical connection exists (possibly reason: the network cable is disconnected or faulty).

DOWN ( Administratively )

The interface is physically down because it was shut down with the shutdown command. To restore its physical state, use the undo shutdown command.

DOWN ( Link-Aggregation interface down )

The interface is physically down because the aggregate interface corresponding to the aggregation group to which it belongs was shut down with the shutdown command.

DOWN ( OAM connection failure )

The interface is physically down because an OAM connection fails to be established on it or the OAM connection is disconnected.

DOWN ( Loopback detection-protected )

The interface is shut down because a loop is detected on it.

DOWN ( BPDU-protected )

The interface is shut down by the BPDU guard function.

 

# Display information about Layer 3 Ethernet subinterface GigabitEthernet 2/1/1.100.

·           When packet statistics collection is disabled (the default state) on the subinterface.

<Sysname> display interface GigabitEthernet 2/1/1.100

GigabitEthernet2/1/1.100 current state: UP

Line protocol current state: UP

Description: GigabitEthernet2/1/1.100 Interface

The Maximum Transmit Unit is 1500

Internet protocol processing : disabled

IP Packet Frame Type: PKTFMT_ETHNT_2,  Hardware Address: 000f-e288-d480

IPv6 Packet Frame Type: PKTFMT_ETHNT_2,  Hardware Address: 000f-e288-d480

 Last clearing of counters:  Never    

·           When packet statistics collection is enabled on the subinterface.

<Sysname> display interface GigabitEthernet 2/1/1.100

GigabitEthernet2/1/1.100 current state: UP

Line protocol current state: UP

Description: GigabitEthernet2/1/1.100 Interface

The Maximum Transmit Unit is 1500

Internet Address is 5.5.5.1/24 Primary

IP Packet Frame Type: PKTFMT_ETHNT_2,  Hardware Address: 000f-e288-d480

IPv6 Packet Frame Type: PKTFMT_ETHNT_2,  Hardware Address: 000f-e288-d480

 Last clearing of counters:  15:07:48 Thu 10/26/2090

 Input  (total): 1 packets, 128 bytes

        (broadcasts) 0 packets, 0 bytes

        (multicasts) 0 packets, 0 bytes

        (unicasts)   1 packets, 128 bytes

 Output (total): 0 packets, 0 bytes

        (broadcasts) 0 packets, 0 bytes

        (multicasts) 0 packets, 0 bytes

        (unicasts)   0 packets, 0 bytes    

Table 7 Output description

Field

Description

GigabitEthernet2/1/1.100 current state

Physical layer state of the subinterface

Line protocol current state

Link layer state of the subinterface

Description

Description about the subinterface

The Maximum Transmit Unit

MTU on the subinterface

Internet protocol processing

Capability of processing IP packets

If this feature is disabled, IP packets cannot be processed. If an IP address is assigned for the interface, this field changes to “Internet Address is.”

IP Packet Frame Type, Hardware Address

Frame packet and hardware address of an outgoing packet

IPv6 Packet Frame Type, Hardware Address

Frame packet and hardware address of an outgoing IPv6 packet

Last clearing of counters

Time when the counters are cleared. If this field is “never”, the counters have never been cleared.

Input

Statistics about input/output packets.

Output

 

# Display brief information about all interfaces.

<Sysname> display interface brief

The brief information of interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface            Link Protocol Main IP         Description

GE2/1/1              UP   UP       10.1.1.2        Link to CoreRouter

GE2/1/2              Stby DOWN     --

Loop0                UP   UP(s)    2.2.2.9

NULL0                UP   UP(s)    --

Vlan1                UP   DOWN     --

Vlan999              UP   UP       192.168.1.42

 

The brief information of interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Speed or Duplex: (a)/A - auto; H - half; F - full

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

Interface            Link Speed   Duplex Type PVID Description

GE2/1/3              DOWN auto    F      A    1

GE2/1/4              DOWN auto    F      A    1

# Display the brief interface information about interfaces in the up state.

<Sysname> display interface brief | include UP

The brief information of interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface            Link Protocol Main IP         Description

GE2/1/1              UP   UP       10.1.1.2        Link to CoreRouter

Loop0                UP   UP(s)    2.2.2.9

NULL0                UP   UP(s)    --

Vlan1                UP   DOWN     --

Vlan999              UP   UP       192.168.1.42

# Display the brief information about all but Ethernet interfaces.

<Sysname> display interface brief | exclude GE

The brief information of interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface            Link Protocol Main IP         Description

Loop0                UP   UP(s)    2.2.2.9

NULL0                UP   UP(s)    --

Vlan1                UP   DOWN     --

Vlan999              UP   UP       192.168.1.42

# Display information about interfaces in the down state and the relevant causes.

<Sysname> display brief interface down

The brief information of interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Interface            Link Cause

GE2/1/2              DOWN Not connected

GE2/1/3              DOWN Not connected

GE2/1/4              DOWN Not connected

GE2/1/5              DOWN Not connected

GE2/1/6              DOWN Not connected

GE2/1/7              DOWN Not connected

GE2/1/8              DOWN Not connected

Tun1                 DOWN Not connected

 

The brief information of interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Interface            Link Cause

BAGG2                DOWN Not connected

GE2/1/1              DOWN Not connected 

Table 8 Output description

Field

Description

The brief information of interface(s) under route mode:

The command displays brief information about Layer 3 interfaces.

Link: ADM - administratively down; Stby - standby

Link state of the interface:

·       ADM—The interface has been shut down by the network administrator. To recover its physical layer state, perform the undo shutdown command.

·       Stby—The interface is a standby interface.

Protocol: (s) - spoofing

If the network layer protocol state of an interface is shown as UP, but its link is an on-demand link or not present at all, its protocol attribute includes the spoofing flag (an s in parentheses). This attribute is typical of interface Null 0 and the loopback interfaces.

Interface

Interface name.

Link

Physical link state of the interface:

·       UP—The link is up.

·       DOWN—The link is physically down.

·       ADM—The link has been administratively shut down. To recover its physical state, perform the undo shutdown command.

·       Stby—The interface is a standby interface.

Protocol

Protocol connection state of the interface, which can be UP, DOWN, or UP(s).

The brief information of interface(s) under bridge mode:

Brief information about Layer 2 interfaces.

Speed or Duplex: (a)/A - auto; H - half; F - full

If the speed of an interface is automatically negotiated, its speed attribute includes the auto negotiation flag, letter a in parentheses.

If the duplex mode of an interface is automatically negotiated, its duplex mode attribute includes the following options:

·       (a)/A—Auto negotiation

·       H—Half negotiation

·       F—Full negotiation

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

Link type options for Ethernet interfaces.

Speed

Interface rate, in bps.

Duplex

Duplex mode of the interface:

·       AAuto-negotiation

·       FFull duplex

·       F(a)Auto-negotiated full duplex

·       HHalf duplex

·       H(a)Auto-negotiated half duplex

Type

Link type of the interface:

·       AAccess

·       HHybrid

·       TTrunk

PVID

Default VLAN ID of the interface.

Cause

Causes for the physical state of an interface to be DOWN. For more information, see Table 10.

 

Table 9 Acronyms for different types of interfaces

Interface name

Acronyms

GigabitEthernet

GE

Ten-GigabitEthernet

XGE

 

Table 10 Causes for the physical state of an interface to be DOWN

Field

Description

Not connected

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

Administratively

The port was brought down with the shutdown command. To restore the physical state of the interface, use the undo shutdown command.

Link-Aggregation interface down

The aggregate interface corresponding to the aggregation group to which the interface belongs was shut down with the shutdown command.

OAM connection failure

OAM connection fails (possibly because the connection fails to be established or the connection is disconnected).

Loopback detection-protected

The interface is shut down because a loop is detected on it.

BPDU-protected

The interface is shut down by the BPDU guard function.

 

duplex

Syntax

duplex { auto | full | half }

undo duplex

View

Ethernet interface view

Default level

2: System level

Parameters

auto: Sets the interface to operate in auto-negotiation mode.

full: Sets the interface to operate in full duplex mode.

half: Sets the interface to operate in half-duplex mode. This keyword is not available for optical ports.

Description

Use the duplex command to set the duplex mode for an Ethernet interface.

Use the undo duplex command to restore the default duplex mode of the Ethernet interface.

By default, the duplex mode is auto for Ethernet interfaces.

10-GE interfaces do not support this command.

Examples

# Configure GigabitEthernet 2/1/1 to operate in full-duplex mode.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] duplex full

flag sdh

Syntax

flag { j0 | j1 } sdh value

undo flag { j0 | j1 } sdh

View

Ten-GigabitEthernet interface view

Default level

2: System level

Parameters

j0: Sets the regenerator section trace byte.

j1: Sets the path trace byte.

value: Value of J0 or J1 bytes, a string of 1 to 15 characters.

Description

Use the flag sdh command to set a value for the overhead bytes J0/J1 in Synchronous Digital Hierarchy (SDH) frames when the 10-GE interface works in WAN mode.

Use the undo flag command to restore the default value of J0/J1 bytes.

By default, the value of all J0 and J1 bytes is all 0s.

Related commands: port-mode.

 

 

NOTE:

This command is valid only when the 10-GE interface works in WAN mode.

 

Examples

# Set J0 bytes in SDH frames to Sysname.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/2

[Sysname-Ten-GigabitEthernet3/1/2] port-mode wan

[Sysname-Ten-GigabitEthernet3/1/2] flag j0 sdh Sysname

flow-control

Syntax

flow-control

undo flow-control

View

Ethernet interface view

Default level

2: System level

Parameters

None

Description

Use the flow-control command to enable TxRx mode generic flow control on an Ethernet interface.

Use the undo flow-control command to disable generic flow control on the Ethernet interface.

TxRx mode flow control enables an Ethernet interface to receive common pause frames from its peer, and send common pause frames to notify its peer of congestions.

By default, generic flow control on an Ethernet interface is disabled.

With the flow-control command configured, an interface can both send and receive flow control frames:

·           When congested, the interface sends a flow control frame to its peer.

·           Upon receiving a flow control frame from the peer, the interface suspends sending packets.

To implement flow control on a link, you must enable the generic flow control function at both ends of the link.

Examples

# Enable TxRx mode generic flow control on the interface GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 2/1/1

[Sysname-GigabitEthernet2/1/1] flow-control

flow-interval

Syntax

flow-interval interval

undo flow-interval

View

System view

Default level

2: System level

Parameters

interval: Sets the statistics polling interval, ranging from 5 to 300 seconds that must be a multiple of 5.

Description

Use the flow-interval command to set the interface statistics polling interval.

Use the undo flow-interval command to restore the default interval.

By default, the statistics polling interval on Ethernet interfaces is 300 seconds.

Examples

# Set the statistics polling interval to 100 seconds.

<Sysname> system-view

[Sysname] flow-interval 100

interface

Syntax

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

View

System view

Default level

2: System level

Parameters

interface-type: Interface type.

interface-number: Interface number.

interface-number.subnumber: Logical subinterface number, where interface-number is the number of the main interface, and subnumber is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4093.

Description

Use the interface command to enter interface/subinterface view. With the interface-number.subnumber argument specified, if the subinterface identified by the argument does not exist, this command creates the subinterface first.

When you create an Ethernet subinterface, the system uses the subinterface number as the VLAN ID of the Ethernet subinterface. For example, the initial VLAN ID of Ethernet subinterface GigabitEthernet 3/1/2.10 is 10.

Note that for the local and remote Ethernet subinterfaces to transmit traffic correctly, configure them with the same subinterface number and VLAN ID.

Examples

# Enter Ethernet interface view of GigabitEthernet2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1]

# Create Ethernet subinterface GigabitEthernet 3/1/2.23.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/2.23

[Sysname-GigabitEthernet3/1/2.23]

link-delay

Syntax

link-delay delay-time

undo link-delay

View

Ethernet interface view

Default level

2: System level

Parameters

delay-time: Sets the physical state change suppression interval on the Ethernet interface. The value ranges from 0 to 10 seconds.

Description

Use the link-delay command to set the physical state change suppression interval on an Ethernet interface.

Use the undo link-delay command to restore the default.

By default, the physical state change suppression interval on an Ethernet interface is one second.

H3C does not recommend you to configure the command on ports that are enabled with MSTP.

 

 

NOTE:

The command is effective to the ports in the down state, but is ineffective to those manually shut down with the shutdown command.

 

Examples

# Enable physical state change suppression on GigabitEthernet 2/1/1, setting the suppression interval to 8 seconds.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] link-delay 8

loopback

Syntax

loopback { external | internal }

undo loopback

View

Ethernet interface view

Default level

2: System level

Parameters

external: Enables external loopback testing to test all on-chip functions related to the Ethernet interface. This keyword is not supported.

internal: Enables internal loopback testing to test the hardware of Ethernet interfaces.

Description

Use the loopback command to enable loopback testing on an Ethernet interface.

Use the undo loopback command to disable loopback testing on an Ethernet interface.

By default, loopback testing is disabled on Ethernet interfaces.

 

 

NOTE:

·       Enable loopback testing for troubleshooting, such as identifying an Ethernet interface problem.

·       During loopback testing, the Ethernet interface is operating in full duplex mode, regardless of its duplex configuration. After loopback testing is disabled, the duplex configuration of the interface is restored.

 

Examples

# Enable internal loopback testing on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] loopback internal

port link-mode

Syntax

port link-mode { bridge | route }

undo port link-mode

View

Ethernet interface view

Default level

2: System level

Parameters

bridge: Specifies the Layer 2 mode.

route: Specifies the Layer 3 mode.

Description

Use the port link-mode command to change the link mode of an Ethernet interface.

Use the undo port link-mode command to restore the default.

By default, an Ethernet interface operates in route mode.

According to the layer at which the router processes received data packets, Ethernet interfaces may operate in bridge or route mode. This command is applicable only to the Ethernet interfaces whose link mode can be changed.

 

 

NOTE:

After you change the link mode of an Ethernet interface, all the settings of the Ethernet interface are restored to their defaults under the new link mode.

 

Examples

# Configure GigabitEthernet 2/1/1 to operate in Layer 2 mode.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] port link-mode bridge

port link-mode interface-list

Syntax

port link-mode { bridge | route } interface-list

View

System view

Default level

2: System level

Parameters

bridge: Specifies the Layer 2 mode.

route: Specifies the Layer 3 mode.

interface-list: Ethernet interface list, in the format of interface-type interface-number [ to interface-type interface-number ] &<1-10>, where &<1-10> indicates that you can specify up to 10 ports or port ranges.

Description

Use the port link-mode interface-list command to change the link mode of Ethernet interfaces.

Depending on the hardware structure of interface cards, for a router, some interfaces can operate only as Layer 2 Ethernet interfaces (in bridge mode), some can operate only as Layer 3 Ethernet interfaces (in route mode), and others can operate either as Layer 2 or Layer 3 Ethernet interfaces (you can use commands to set the link mode to bridge or route).

Configuring the port link-mode interface-list command in system view and configuring the port link-mode command in Ethernet interface view lead to the same result. The difference between the two commands is that the former changes the link mode of multiple Ethernet interfaces in batch, and the latter changes the link mode of one Ethernet interface at a time.

 

 

NOTE:

·       After you change the link mode of an Ethernet interface, all the settings of the Ethernet interface are restored to their defaults under the new link mode.

·       The link mode configuration for an Ethernet interface in system view and that in interface view supersede each other, and the one configured last takes effect.

 

Examples

# Configure GigabitEthernet 3/1/1 through GigabitEthernet 3/1/4 to operate in Layer 2 mode.

<Sysname> system-view

[Sysname] port link-mode bridge GigabitEthernet 3/1/1 to GigabitEthernet 3/1/4

port-mode

Syntax

port-mode { lan | wan }

undo port-mode

View

Ten-GigabitEthernet interface view

Default level

2: System level

Parameters

lan: Specifies the LAN mode. A port operating in this mode transmits Ethernet packets and connects an Ethernet network.

wan: Specifies the WAN mode. A port operating in this mode transmits Synchronous Digital Hierarchy (SDH) packets and connects an SDH network. In addition, it supports point-to-point packet transmission only.

Description

Use the port-mode command to configure a 10-GE interface to work in LAN or WAN mode.

Use the undo port-mode command to restore the default.

By default, a 10-GE interface operates in LAN mode.

Examples

Configure Ten-GigabitEthernet 2/1/1 to operate in the WAN mode.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 2/1/1

[Sysname-Ten-GigabitEthernet2/1/1] port-mode wan

reset counters interface

Syntax

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

View

User view

Default level

2: System level

Parameters

interface-type: Interface type.

interface-number: Interface number.

interface-number.subnumber: Logical subinterface number, where interface-number is the number of the main interface, and subnumber is the number of a subinterface created under the interface. The subnumber argument ranges from 1 to 4093.

Description

Use the reset counters interface command to clear the statistics of an interface/subinterface.

Before sampling network traffic within a specific period of time on an interface, you need to clear the existing statistics.

·           If the interface type is not specified, this command clears the statistics of all the interfaces.

·           If only the interface type is specified, this command clears the statistics of the interfaces of the specified type.

·           If both the interface type and interface/subinterface number are specified, this command clears the statistics of the specified interface/subinterface.

Examples

# Clear the statistics of interface GigabitEthernet 2/1/1.

<Sysname> reset counters interface GigabitEthernet 2/1/1

shutdown

Syntax

shutdown

undo shutdown

View

Ethernet interface view, Ethernet subinterface view, port group view

Default level

2: System level

Parameters

None

Description

Use the shutdown command to shut down an Ethernet interface or subinterface.

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

By default, Ethernet interfaces/subinterfaces are in the up state.

You may need to shut down and then bring up an Ethernet interface to activate configuration changes such as the speed or duplex mode changes.

Examples

# Shut down and then bring up interface GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] shutdown

[Sysname-GigabitEthernet2/1/1] undo shutdown

speed

Syntax

speed { 10 | 100 | 1000 | auto }

undo speed

View

Ethernet interface view

Default level

2: System level

Parameters

10: Sets the interface speed to 10 Mbps.

100: Sets the interface speed to 100 Mbps.

1000: Sets the interface speed to 1,000 Mbps.

auto: Enables the interface to negotiate a speed with its peer.

Description

Use the speed command to set the speed of an Ethernet interface.

Use the undo speed command to restore the default.

By default, an Ethernet interface negotiates a speed with its peer.

For an Ethernet electrical port, use the speed command to set its speed to match the speed of the peer interface.

For an optical port, use the speed command to set its speed to match the rate of a pluggable optical transceiver.

Examples

# Set the speed of Ethernet interface GigabitEthernet 2/1/1 to 100 Mbps.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] speed 100

Layer 2 Ethernet interface configuration commands

broadcast-suppression

Syntax

broadcast-suppression { ratio | pps max-pps | kbps max-kbps }

undo broadcast-suppression

View

Layer 2 Ethernet interface view, port group view

Default level

2: System level

Parameters

ratio: Sets the broadcast suppression threshold as a percentage of the transmission capability of an Ethernet interface. The smaller the percentage, the less broadcast traffic is allowed to pass through. The value of the ratio argument ranges from 1 to 100, and must be 100 for Ethernet interfaces on an SPC card.

pps max-pps: Specifies the maximum number of broadcast packets that the Ethernet interface can forward per second, ranging from 1 to 148,810 pps.

kbps max-kbps: Specifies the maximum number of kilobits of broadcast traffic that the Ethernet interface can forward per second, ranging from 1 to 1,000,000 kbps.

·           When the pps or kbps keyword is specified, and a suppression granularity larger than 1 is specified on the router, the value of the pps or kbps keyword must be no smaller than and an integral multiple of the granularity. The broadcast suppression threshold value configured through this keyword on an Ethernet interface may not be the one that actually takes effect. To display the actual broadcast suppression threshold value on an Ethernet interface, you can use the display interface command.

·           When the pps or kbps keyword is not specified, or the suppression granularity is set to 1, the value of the pps or kbps keyword must be no smaller than 1, and the broadcast suppression threshold value is the one that actually takes effect on the Ethernet interface.

Description

Use the broadcast-suppression command to set the broadcast suppression threshold on an Ethernet interface or a group of Ethernet interfaces.

Use the undo broadcast-suppression command to restore the default.

By default, Ethernet interfaces do not suppress broadcast traffic.

If you execute this command in Ethernet interface view, the configuration takes effect only on the interface. If you execute this command in port-group view, the configuration takes effect on all the ports in the port group.

When broadcast traffic exceeds the broadcast suppression threshold, the interface discards broadcast packets until the broadcast traffic drops below the threshold.

If you set different broadcast suppression thresholds in Ethernet interface view or port-group view multiple times, the one configured last takes effect.

 

 

NOTE:

SPE cards support the ratio argument only among the keywords and arguments of this command.

 

Examples

# Set the broadcast suppression threshold to 20% on Ethernet interface GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] broadcast-suppression 20

display port-group manual

Syntax

display port-group manual [ all | name port-group-name ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: System level

Parameters

all: Specifies all the manual port groups.

name port-group-name: Specifies the name of a manual port group, a string of 1 to 32 characters.

|: 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 the display port-group manual command to display the information about a manual port group or all the manual port groups.

·           If you provide the port-group-name argument, this command displays the details for a specified manual port group, including its name and the Ethernet interface ports included.

·           If you provide the all keyword, this command displays the details for all manual port groups, including their names and the Ethernet interface ports included.

·           Absence of parameters indicates that the names of all the port groups will be displayed.

Examples

# Display the names of all the port groups.

<Sysname> display port-group manual

The following manual port group exist(s):

group1                                    group2

# Display detailed information about all manual port groups.

<Sysname> display port-group manual all

Member of group1:

    GigabitEthernet2/1/1                              GigabitEthernet2/1/2           

    GigabitEthernet2/1/3

    GigabitEthernet2/1/4                              GigabitEthernet2/1/5           

    GigabitEthernet2/1/6

    GigabitEthernet2/1/7                              GigabitEthernet3/1/1           

    GigabitEthernet3/1/2

    GigabitEthernet3/1/3

 

Member of group2:

None

group-member

Syntax

group-member interface-list

undo group-member interface-list

View

Port group view

Default level

2: System level

Parameters

interface-list: Ethernet interface list, in the form of interface-type interface-number [ to interface-type interface-number ] &<1-10>, where &<1-10> indicates that you can specify up to 10 port or port ranges.

Description

Use the group-member command to add an Ethernet interface to a specified manual port group.

Use the undo group-member command to remove a specified Ethernet interface from a manual port group.

By default, there is no Ethernet interface in a manual port group.

Examples

# Add interface GigabitEthernet 2/1/1 to the manual port group named group1.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group-manual-group1] group-member GigabitEthernet 2/1/1

jumboframe enable

Syntax

jumboframe enable [ value ] slot slot-num

undo jumboframe enable slot slot-num

View

System view

Default level

2: System level

Parameters

value: Maximum length (in bytes) of Ethernet frames that are allowed to pass through. The value argument ranges from 1552 to 9216. The latest configuration overrides the previous one.

slot-num: Number of the slot where the card is seated.

Description

Use the jumboframe enable command to allow jumbo frames with the specified length to pass through an Ethernet port.

Use the undo jumboframe enable command to prevent jumbo frames from passing through an Ethernet port.

By default, jumbo frames of 9216 bytes are allowed to pass through Ethernet interfaces.

Examples

# Enable jumbo frames to pass through all the Ethernet interfaces on the card in slot 4.

<Sysname> system-view

[Sysname] jumboframe enable slot 4

mdi

Syntax

mdi { across | auto | normal }

undo mdi

View

Layer 2 Ethernet interface view

Default level

2: System level

Parameters

across: Specifies the MDI mode as across.

auto: Specifies the MDI mode as auto.

normal: Specifies the MDI mode as normal.

Description

Use the mdi command to configure the MDI mode of an Ethernet interface.

Use the undo mdi command to restore the system default.

By default, the MDI mode of an Ethernet interface is auto, that is, the Ethernet interface determines the physical pin roles (transmit or receive) through negotiation.

 

 

NOTE:

Optical ports do not support this command.

 

Examples

# Configure the MDI mode of GigabitEthernet 2/1/1 as across.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] mdi across

multicast-suppression

Syntax

multicast-suppression { pps max-pps | kbps max-kbps }

undo multicast-suppression

View

Layer 2 Ethernet interface view, port group view

Default level

2: System level

Parameters

pps max-pps: Specifies the maximum number of multicast packets that the interface can forward per second, ranging from 1 to 1,488,100 pps.

kbps max-kbps: Specifies the maximum number of kilobits of multicast packets that the interface can forward per second, ranging from 1 to 1,000,000 kbps. The value must be an integral multiple of the suppression granularity.

·           When the pps or kbps keyword is specified, and a suppression granularity larger than 1 is specified on the router, the value of the pps or kbps keyword must be no smaller than and an integral multiple of the granularity. The multicast suppression threshold value configured through this keyword on an Ethernet interface may not be the one that actually takes effect. To display the actual multicast suppression threshold value on an Ethernet interface, you can use the display interface command.

·           When the pps or kbps keyword is not specified, or the suppression granularity is set to 1, the value of the pps or kbps keyword must be no smaller than 1, and the multicast suppression threshold value is the one that actually takes effect on the Ethernet interface.

Description

Use the multicast-suppression command to set the multicast suppression threshold on an Ethernet interface or a group of Ethernet interfaces.

Use the undo multicast-suppression command to restore the default.

By default, Ethernet interfaces do not suppress multicast traffic.

If you execute this command in Ethernet interface view, the configurations take effect only on the interface. If you execute this command in port group view, the configurations take effect on all ports in the port group.

When multicast traffic exceeds the threshold you configure, the system discards multicast packets until the multicast traffic drops below the threshold.

If you set different multicast suppression thresholds in Ethernet interface view or port group view multiple times, the one configured last takes effect.

 

 

NOTE:

SPE cards do not support this command.

 

Examples

# Set the multicast threshold to 1000 kbps on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 2/1/1

[Sysname-GigabitEthernet2/1/1] multicast-suppression kbps 1000

port-group manual

Syntax

port-group manual port-group-name

undo port-group manual port-group-name

View

System view

Default level

2: System level

Parameters

port-group-name: Manual port group name, a string of 1 to 32 characters.

Description

Use the port-group manual command to create a manual port group and enter manual port group view.

Use the undo port-group manual command to delete a manual port group.

By default, no manual port group is created.

Examples

# Create a manual port group named group1.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group-manual-group1]

speed auto

Syntax

speed auto [ 10 | 100 | 1000 ] *

undo speed

View

100-Mbps or Gigabit Layer 2 Ethernet interface view

Default level

2: System level

Parameters

10: Sets 10 Mbps as an option for speed auto negotiation.

100: Sets 100 Mbps as an option for speed auto negotiation.

1000: Sets 1000 Mbps as an option for speed auto negotiation.

Description

Use the speed auto command to set options for speed auto negotiation.

Use the undo speed command to restore the default.

By default, the options for speed auto negotiation include 10 Mbps, 100 Mbps, and 1000 Mbps.

The speed command and the speed auto command supersede each other, and the one configured last takes effect.

For example, if you configure speed 100 after configuring speed auto 100 1000 on an interface, the interface speed is set to 100 Mbps by force without negotiation. If you configure speed auto 100 1000 after configuring speed 100 on the interface, the interface negotiates with its peer, and the negotiated speed is either 100 Mbps or 1000 Mbps.

Examples

# Configure the port GigabitEthernet 2/1/1 to use 10 Mbps and 1000 Mbps for speed negotiation.

<Sysname> system-view

[Sysname] interface gigabitethernet 2/1/1

[Sysname-GigabitEthernet2/1/1] speed auto 10 1000

unicast-suppression

Syntax

unicast-suppression { pps max-pps | kbps max-kbps }

undo unicast-suppression

View

Layer 2 Ethernet interface view, port group view

Default level

2: System level

Parameters

pps max-pps: Specifies the maximum number of unknown unicast packets that the Ethernet interface can forward per second, ranging from 1 to 1,488,100 pps.

kbps max-kbps: Specifies the maximum number of kilobits of unknown unicast traffic that the Ethernet interface can forward per second, ranging from 1 to 1,000,000 kbps. The value must be an integral multiple of the suppression granularity.

·           When the pps or kbps keyword is specified, and a suppression granularity larger than 1 is specified on the router, the value of the pps or kbps keyword must be no smaller than and an integral multiple of the granularity. The unknown unicast suppression threshold value configured through this keyword on an Ethernet interface may not be the one that actually takes effect. To display the actual unknown unicast suppression threshold value on an Ethernet interface, you can use the display interface command.

·           When the pps or kbps keyword is not specified, or the suppression granularity is set to 1, the value of the pps or kbps keyword must be no smaller than 1, and the unknown unicast suppression threshold value is the one that actually takes effect on the Ethernet interface.

Description

Use the unicast-suppression command to set the unknown unicast suppression threshold on an Ethernet interface or a group of Ethernet interfaces.

Use the undo unicast-suppression command to restore the default.

By default, Ethernet interfaces do not suppress unknown unicast traffic.

If you execute this command in Ethernet interface view, the configuration takes effect only on the interface. If you execute this command in port group view, the configuration takes effect on all ports in the port group.

When unknown unicast traffic exceeds the threshold you configure, the system discards unknown unicast packets until the unknown unicast traffic drops below the threshold.

If you set different unknown unicast suppression thresholds in Ethernet interface view or port group view multiple times, the one configured last takes effect.

 

 

NOTE:

SPE cards do not support this command.

 

Examples

# Set the unknown unicast threshold to 1000 kbps on GigabitEthernet 2/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 2/1/1

[Sysname-GigabitEthernet2/1/1] unicast-suppression kbps 1000

Layer 3 Ethernet interface/subinterface configuration commands

mtu

Syntax

mtu size

undo mtu

View

Layer 3 Ethernet interface view, Layer 3 Ethernet subinterface view

Default level

2: System level

Parameters

size: specifies the maximum transmission unit (MTU), ranging from 46 to 9198 bytes.

Description

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

Use the undo mtu command to restore the default.

By default, the MTU of an Ethernet interface/subinterface is 1500 bytes.

Examples

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

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1

[Sysname-GigabitEthernet2/1/1] mtu 1430

traffic-statistic enable

Syntax

traffic-statistic enable

undo traffic-statistic enable

View

Layer 3 Ethernet subinterface view

Default level

2: System level

Parameters

None

Description

Use the traffic-statistic enable command to enable traffic statistics collection on a Layer 3 Ethernet subinterface.

Use the undo traffic-statistic enable command to disable traffic statistics collection on a Layer 3 Ethernet subinterface.

By default, traffic statistics collection is disabled on a Layer 3 Ethernet subinterface.

 

 

NOTE:

·       Do not simultaneously enable traffic statistics collection and ACL functions (such as packet filtering and Portal) that may conflict with the traffic statistics collection.

·       This feature is available only on SPE cards.

 

Related commands: display interface and reset counters interface.

Examples

# Enable traffic statistics collection on subinterface GigabitEthernet 2/1/1.100.

<Sysname> system-view

[Sysname] interface GigabitEthernet 2/1/1.100

[Sysname-GigabitEthernet2/1/1.100] traffic-statistic enable

VE interface configuration commands

display interface ve-bridge

Syntax

display interface [ ve-bridge ] [ brief [ down ] ] [ | { begin | exclude | include } regular-expression ]

display interface ve-bridge interface-number [ brief ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

interface-number: Layer 2 Virtual Ethernet (VE-bridge) interface number, which can be the number of any existing VE-bridge interface.

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

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

|: 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 the display interface ve-bridge command to view information about the specified Layer 2 VE interface.

If you do not specify the ve-bridge keyword, this command displays information about all interfaces.

If you specify the ve-bridge keyword but do not specify the interface-number argument, this command displays information about all existing Layer 2 VE interfaces.

Related commands: interface ve-bridge.

Examples

# Display status information about interface VE-Bridge 3/0/1.

<Sysname> display interface ve-bridge 3/0/1

VE-Bridge3/0/1 current state: UP

 IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 00e0-fc00-8900

 Description: VE-Bridge3/0/1 Interface

 PVID: 100

 Port link-type: access

  Tagged   VLAN ID : none

  Untagged VLAN ID : 100

Last clearing of counters:  Never

Carrier Layer: 1 PVC total, 1 map up, 0 map down

Input:  0 packets, 0 bytes, 0 errors

Output: 0 packets, 0 bytes, 0 errors

# Display brief information about interface VE-Bridge 3/0/1.

<Sysname> display interface ve-bridge 3/0/1 brief

The brief information of interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Speed or Duplex: (a)/A - auto; H - half; F - full

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

Interface            Link Speed   Duplex Type PVID Description

VEB1                 DOWN auto    A      A    1

# Display brief information about all VE-bridge interfaces in the down state.

<Sysname> display interface ve-bridge brief down

The brief information of interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Interface            Link Cause

VEB1                 DOWN Not connected

Table 11 Output description

Field

Description

current state

Current state of the interface:

·       DOWN—The interface is physically down, possibly because no physical link is present or the link has failed.

·       UP—The interface is physically up.

IP Packet Frame Type

Ethernet framing type.

Hardware Address

MAC address of the interface.

Description

Description of the interface.

PVID

Default VLAN ID of the interface.

Port link-type

Link type of the port, which can be access, trunk, or hybrid.

Tagged VLAN ID

VLANs whose traffic is tagged by the port.

Untagged VLAN ID

VLANs whose traffic is not tagged by the port.

Last clearing of counters:  Never

Time when the reset counts interface command was last used to clear statistics on the interface. Never indicates that the reset counts interface command was never used since the router was started.

Carrier Layer: 1 PVC total, 1 map up, 0 map down

Data link layer information: the number of PVCs bound with the existing interface, the number of PVCs in the up state, and the number of PVCs in the down state. This field is available only if the interface supports traffic statistics collection.

Input

Statistics about packets received, including the total number and size (in bytes) of the input packets of the interface, and the number of error packets. This field is available only if the interface supports traffic statistics collection.

Output

Statistics about packets sent, including the total number and size (in bytes) of the output packets of the interface, and the number of error packets. This field is available only if the interface supports traffic statistics collection.

The brief information of interface(s) under bridge mode:

Brief information about Layer 2 interfaces.

Speed or Duplex: (a)/A - auto; H - half; F - full

If the speed of an interface is automatically negotiated, its speed attribute includes the auto negotiation flag, letter a in parentheses.

If the duplex mode of an interface is automatically negotiated, its duplex mode attribute includes the  following options:

·       (a)/A—Auto negotiation

·       H—Half negotiation

·       F—Full negotiation

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

Link type options for Ethernet interfaces.

Speed

Interface rate, in bps.

Duplex

Duplex mode of the interface:

·       A—Auto-negotiation

·       F—Full duplex

·       F(a)—Auto-negotiated full duplex

·       H—Half duplex

·       H(a)—Auto-negotiated half duplex

Type

Link type of the interface:

·       A—Access

·       H—Hybrid

·       T—Trunk

PVID

Default VLAN ID of the interface

Cause

Causes for the physical state of an interface to be DOWN. For more information, see Table 12.

 

Table 12 Causes for the physical state of an interface to be DOWN

Field

Description

Not connected

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

Administratively

The port was shut down with the shutdown command. To restore the physical state of the interface, use the undo shutdown command.

Link-Aggregation interface down

The aggregate interface corresponding to the aggregation group to which the interface belongs was shut down with the shutdown command.

OAM connection failure

OAM connection fails (possibly because the connection fails to be established or the connection is disconnected).

Loopback detection-protected

The interface is shut down because a loop is detected on it.

BPDU-protected

The interface is shut down by the BPDU guard function.

 

display interface virtual-ethernet

Syntax

display interface [ virtual-ethernet ] [ brief [ down ] ] [ | { begin | exclude | include } regular-expression ]

display interface virtual-ethernet { interface-number } [ brief ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

interface-number: Virtual Ethernet (VE) interface number, which can be the number of any existing Layer 3 VE interface.

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

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

|: 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 the display interface virtual-ethernet command to view information about a Layer 3 VE interface.

If you do not specify the virtual-ethernet keyword, this command displays information about all interfaces.

If you specify the virtual-ethernet keyword but do not specify any interface number, this command displays information about all Layer 3 VE interfaces and subinterfaces.

Related commands: interface virtual-ethernet.

Examples

# Display status information about interface Virtual-Ethernet 3/0/1.

<Sysname> display interface virtual-ethernet 3/0/1

Virtual-Ethernet3/0/1 current state: UP

Line protocol current state: UP

Description: Virtual-Ethernet3/0/1 Interface

The Maximum Transmit Unit is 1500

Internet protocol processing : disabled

IP Packet Frame Type: PKTFMT_ETHNT_2,  Hardware Address: 00e0-fc00-8902

IPv6 Packet Frame Type: PKTFMT_ETHNT_2,  Hardware Address: 00e0-fc00-8902

Last clearing of counters:  Never

Carrier Layer: 0 PVC total, 0 map up, 0 map down

    Last 300 seconds input: 0 bytes/sec, 0 packets/sec

    Last 300 seconds output: 0 bytes/sec, 0 packets/sec

    0 packets input, 0 bytes, 0 drops

    0 packets output, 0 bytes, 0 drops

# Display brief information about interface Virtual-Ethernet 3/0/1.

<Sysname> display interface virtual-ethernet 3/0/1 brief

The brief information of interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface            Link Protocol Main IP         Description

VE1                  DOWN DOWN     --                         

# Display brief information about all Virtual-Ethernet interfaces in the down state.

<Sysname> display interface virtual-ethernet brief down

The brief information of interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Interface            Link Cause

VE1                  DOWN Not connected

Table 13 Output description

Field

Description

current state

Current state  of the interface:

·       DOWN—The interface is physically down (possibly because no physical link is present or the link has failed).

·       UP—The interface is physically up.

Line protocol current state

State of the data link layer protocol (up or down).

The Maximum Transmit Unit

MTU of the interface.

Internet protocol processing

State of the network layer protocol (enabled or disabled).

IP Packet Frame Type

Encapsulation format for IPv4 packets.

Hardware Address

MAC address corresponding to the interface.

IPv6 Packet Frame Type

Encapsulation format for IPv6 packets.

Carrier Layer

PVCs bound with the interface.

Last 300 seconds input:  0 bytes/sec 0 packets/sec

Average rate of input traffic in the last 300 seconds, in pps and Bps.

Last 300 seconds output:  0 bytes/sec 0 packets/sec

Average rate of output traffic in the last 300 seconds, in pps and Bps.

0 packets input, 0 bytes, 0 drops

Total number and size (in bytes) of the input packets of the interface and the number of dropped packets.

0 packets output, 0 bytes, 0 drops

Total number and size (in bytes) of the output packets of the interface and the number of dropped packets.

The brief information of interface(s) under route mode:

The command displays brief information about Layer 3 interfaces.

Link: ADM - administratively down; Stby - standby

·       ADM—The interface has been shut down by the network administrator. To recover its physical layer state, perform the undo shutdown command.

·       Stby—The interface is a standby interface.

Protocol: (s) - spoofing

If the network layer protocol state of an interface is shown as UP, but its link is an on-demand link or not present at all, its protocol attribute includes the spoofing flag (an s in parentheses). This attribute is typical of interface Null 0 and the loopback interfaces.

Interface

The interface name.

Link

The physical link state:

·       UPThe link is up.

·       ADMThe link has been administratively shut down. To recover its physical state, perform the undo shutdown command.

Protocol

The protocol connection state, which is UP(s).

Cause

The cause of a DOWN physical link:

·       AdministrativelyThe port was shut down with the shutdown command. To restore the physical state of the interface, use the undo shutdown command.

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

 

interface ve-bridge

Syntax

interface ve-bridge interface-number

undo interface ve-bridge interface-number

View

System view

Default level

2: System level

Parameters

interface-number: Layer 2 VE interface number.

Description

Use the interface ve-bridge command to create a Layer 2 VE interface and enter Layer 2 VE interface view.

Use the undo interface ve-bridge command to remove a Layer 2 VE interface.

You cannot remove a VE interface that has been associated to a PVC.

Examples

# Create Layer 2 VE interface VE-Bridge 3/0/1.

<Sysname> system-view

[Sysname] interface ve-bridge 3/0/1

[Sysname-Ve-bridge3/0/1]

interface virtual-ethernet

Syntax

interface virtual-ethernet interface-number

undo interface virtual-ethernet interface-number

View

System view

Default level

2: System level

Parameters

interface-number: Layer 3 VE interface number.

Description

Use the interface virtual-ethernet command to create a Layer 3 VE interface or enter Layer 3 VE interface view.

Use the undo interface virtual-ethernet command to remove a Layer 3 VE interface.

You cannot remove a Layer 3 VE interface that has been associated to a PVC.

Examples

# Create Layer 3 VE interface Virtual-Ethernet 3/0/1.

<Sysname> system-view

[Sysname] interface virtual-ethernet 3/0/1

[Sysname-Virtual-Ethernet3/0/1]

mac-address

Syntax

mac-address mac-address

undo mac-address

View

Layer 3 VE interface view

Default level

2: System level

Parameters

mac-address: MAC address, in the form of H-H-H.

Description

Use the mac-address command to assign a MAC address to a Layer 3 VE interface.

Use the undo mac-address command to restore the default.

To make the new MAC address configuration take effect, execute the reset arp command on the interface. For more information about the reset arp command, see Layer 3—IP Services Command Reference.

Examples

# Change the MAC address of Layer 3 VE interface Virtual-Ethernet 3/0/1 to 000F-E26B-02F1.

<Sysname> system-view

[Sysname] interface virtual-ethernet 3/0/1

[Sysname-Virtual-Ethernet3/0/1] mac-address 000f-e26b-02f1

reset counters interface ve-bridge

Syntax

reset counters interface [ ve-bridge [ interface-number ] ]

View

User view

Default level

2: System level

Parameters

interface-number: Specifies an interface number.

Description

Use the reset counters interface ve-bridge command to clear the Layer 2 VE interface statistics.

Before collecting traffic statistics for a specific period of time on an interface, clear the old statistics first.

If you do not specify the ve-bridge keyword, this command clears statistics for all interfaces.

If you specify the ve-bridge keyword but do not specify any interface number, this command clears statistics for all Layer 2 VE interfaces.

Examples

# Clear the statistics of Layer 2 VE interface VE-bridge 3/0/1.

<Sysname> reset counters interface ve-bridge 3/0/1

reset counters interface virtual-ethernet

Syntax

reset counters interface [ virtual-ethernet [ interface-number ] ]

View

User view

Default level

2: System level

Parameters

interface-number: Specifies an interface number.

Description

Use the reset counters interface virtual-ethernet command to clear the Layer 3 VE interface statistics.

Before collecting traffic statistics for a specific period of time on an interface, clear the old statistics first.

If you do not specify the virtual-ethernet keyword, this command clears statistics for all interfaces.

If you specify the virtual-ethernet keyword but do not specify any interface number, this command clears statistics for all Layer 3 VE interfaces.

Examples

# Clear the statistics of Layer 3 VE interface Virtual-Ethernet 3/0/1.

<Sysname> reset counters interface virtual-ethernet 3/0/1

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become A Partner
  • Partner Policy & Program
  • Global Learning
  • Partner Sales Resources
  • Partner Business Management
  • Service Business
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网