Loopback and null interface configuration commands 1

default 1

description· 1

display interface loopback· 2

display interface null 5

interface loopback· 6

interface null 7

reset counters interface loopback· 7

reset counters interface null 8

shutdown· 9

 

default

Use default to restore the default settings for the loopback or null interface.

Syntax

default

Views

Loopback interface view, null interface view

Default command level

2: System level

Usage guidelines

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.

 

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

Examples

# Restore the default settings of interface loopback 1.

<Sysname> system-view

[Sysname] interface loopback 1

[Sysname-loopback1] default

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

description

Use description to set a description for the current interface.

Use undo description to restore the default.

Syntax

description text

undo description

Default

The description of a loopback or null interface is interface name Interface, for example, Loopback1 interface.

Views

Loopback interface view, null interface view

Default command level

2: System level

Parameters

text: Interface description, a string of 1 to 80 characters. The string can include case-sensitive letters, digits, special characters, spaces, and other Unicode characters and symbols

Follow these guidelines when you configure a description:

·           An interface description can be a mixture of English characters and other Unicode characters. The mixed description cannot exceed the specified length.

·           To use a type of Unicode characters or symbols in an interface description, you must install the corresponding IME and log in to the device through supported remote login software.

·           Each non-English Unicode character or symbol (non-English characters) takes the space of two regular characters. When the length of a description string reaches or exceeds the maximum line width on the terminal software, the software starts a new line. This may break a Unicode character into two parts and create garbled characters at the end of a line.

Examples

# Set the description for interface loopback 1 to loopback1.

<Sysname> system-view

[Sysname] interface loopback 1

[Sysname- loopback1] description loopback1

Related commands

display interface

display interface loopback

Use display interface loopback to display information about a loopback interface.

Syntax

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

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

Views

Any view

Default command level

1: Monitor level

Parameters

interface-number: Specifies a loopback interface by its number, which can be the number of any existing loopback interface. With this argument, this command displays information about a specified loopback interface.

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

down: Displays information about interfaces in 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.

Usage guidelines

If you do not specify the loopback keyword, this command displays information about all interfaces on the device.

If you specify the loopback keyword without the interface-number argument, this command displays information about all created loopback interfaces.

Examples

# Display detailed information about interface loopback 0.

<Sysname> display interface loopback 0

LoopBack0 current state: UP

Line protocol current state: UP (spoofing)

Description: LoopBack0 Interface

The Maximum Transmit Unit is 1536

Internet protocol processing : disabled

Physical is Loopback

Last clearing of counters:  Never

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

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

    0 packets input, 0 bytes, 0 drops

    0 packets output, 0 bytes, 0 drops

# Display brief information about interface loopback 0.

<Sysname> display interface loopback 0 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

Loop0                UP   UP(s)    --

# Display brief information about all loopback interfaces in DOWN state.

<Sysname> display interface loopback brief down

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

Link: ADM - administratively down; Stby - standby

Interface            Link Cause

Loop1                ADM  Administratively

Table 1 Command output

Field	Description
current state	Physical layer state of the interface: ·       UP—The physical layer state of the interface is up. ·       DOWN (Administratively)—The interface has been shut down manually.
Line protocol current state	Data link layer protocol state of the interface, which is always (UP) spoofing. (UP) spoofing means that the data link layer protocol state of the interface is UP, but the corresponding link might not exist, or the corresponding link is non-permanent and established on demand.
Description	Description string of the interface.
The Maximum Transmit Unit	MTU of the interface.
Internet protocol processing	State (enabled or disabled) of the network layer protocol (displayed as Internet Address is X.X.X.X/XX Primary).
Physical is loopback	The physical type of the interface is loopback.
Last clearing of counters	Time when statistics on the logical interface were last cleared by using the reset counters interface command. If the statistics of the interface have never been cleared by using the reset counters interface command after the device started, Never is displayed for this field.
Last 300 seconds input:  0 bytes/sec, 0 bits/sec, 0 packets/sec	Average input rate during the last 300 seconds, where: ·       packets/sec—Average number of packets received per second. ·       bytes/sec—Average number of bytes received per second. ·       bits/sec—Average number of bits received per second.
Last 300 seconds output:  0 bytes/sec, 0 bits/sec, 0 packets/sec	Average output rate over the last 300 seconds, where: ·       packets/sec—Average number of packets sent per second. ·       bytes/sec—Average number of bytes sent per second. ·       bits/sec—Average number of bits sent per second.
0 packets input, 0 bytes, 0 drops	Total number and size (in bytes) of the input packets of the interface and the number of the 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 the dropped packets.
The brief information of interface(s) under route mode	Brief information about Layer 3 interfaces.
Link: ADM - administratively down; Stby - standby	Explains the Link field values: ·       ADM—Represents administratively down. The interface has been administratively shut down. To recover its physical state, use the undo shutdown command. ·       Stby—Represents standby. The interface is operating as a backup interface.
Protocol: (s) - spoofing	Explains the Protocol field value. (s) represents spoofing. If the data link layer protocol of an interface is up but its link is an on-demand link or not present at all, the Protocol field displays UP(s). This attribute is typical of interface Null 0, Inloopback 0, and loopback interfaces.
Interface	Abbreviated interface name.
Link	Physical layer state of the interface: ·       UP—The interface is up. ·       ADM—The interface has been administratively shut down. To recover its physical state, use the undo shutdown command.
Protocol	Data link layer protocol state of the interface, which is always UP(s).
Main IP	Main IP address of the interface.
Description	Description of the interface.
Cause	Cause of a DOWN physical link. If the port has been shut down with the shutdown command, this field displays Administratively. To restore the physical state of the interface, use the undo shutdown command.

 

Related commands

interface loopback

display interface null

Use display interface null to display information about the null interface. Because Null 0 interface is the only null interface on a device, this command displays information about Null 0 interface even if you do not specify the 0 keyword.

Syntax

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

display interface null 0 [ brief ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

0: Specifies interface Null 0. The null interface number is always 0, because the device has only one null interface.

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

down: Displays information about interfaces in 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.

Usage guidelines

If you do not specify the null keyword, this command displays information about all interfaces on the device.

If you specify the null keyword, this command displays information about interface Null 0 with or without the 0 keyword, because the device supports only one interface Null 0.

Examples

# Display detailed information about null interface Null 0.

<Sysname> display interface null 0

NULL0 current state :UP

Line protocol current state :UP (spoofing)

Description :  NULL0 Interface

The Maximum Transmit Unit is 1500

Internet protocol processing : disabled

Physical is NULL DEV

Last clearing of counters:  Never

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

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

    0 packets input, 0 bytes, 0 drops

    0 packets output, 0 bytes, 0 drops

# Display brief information about interface Null 0.

<Sysname> display interface null 0 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

NULL0                UP   UP(s)    --

For the command output, see Table 1.

Related commands

interface null

interface loopback

Use interface loopback to create a loopback interface or enter loopback interface view.

Use undo interface loopback to remove a loopback interface.

Syntax

interface loopback interface-number

undo interface loopback interface-number

Views

System view

Default command level

2: System level

Parameters

interface-number: Specifies a loopback interface by its number, ranging from 0 to 127.

Examples

# Create interface loopback 5.

<Sysname> system-view

[Sysname] interface loopback 5

[Sysname-LoopBack5]

Related commands

display interface loopback

interface null

Use interface null to enter null interface view.

Syntax

interface null 0

Views

System view

Default command level

2: System level

Parameters

0: Specifies interface Null 0. The null interface number is fixed to 0.

Usage guidelines

A device has only one null interface, interface Null 0. Interface Null 0 is always up. You cannot remove it or shut it down.

Examples

# Enter Null 0 interface view.

<Sysname> system-view

[Sysname] interface null 0

[Sysname-NULL0]

Related commands

display interface null

reset counters interface loopback

Use reset counters interface loopback to clear statistics on loopback interfaces.

Syntax

reset counters interface [ loopback [ interface-number ] ]

Views

User view

Default command level

2: System level

Parameters

interface-number: Number of the loopback interface, which can be the number of any existing loopback interface. With this argument, the command clears statistics on a specified loopback interface.

Usage guidelines

Before collecting traffic statistics within a specific period of time on a loopback interface, clear the existing statistics.

If you do not specify the loopback keyword, this command clears the statistics on all interfaces in the system.

If you specify the loopback keyword without the interface-number argument, this command clears the statistics on all loopback interfaces.

Examples

# Clear statistics on loopback interface Loopback 5.

<Sysname> reset counters interface loopback 5

reset counters interface null

Use reset counters interface null to clear statistics on the null interface.

Syntax

reset counters interface [ null [ 0 ] ]

Views

User view

Default command level

2: System level

Parameters

0: Number of the null interface, which is always 0.

Usage guidelines

Before collecting traffic statistics within a specific period of time on the null interface, clear the existing statistics.

If you do not specify the null keyword, this command clears statistics on all interfaces.

If you specify the null keyword, this command clears the statistics on interface Null 0 with or without the 0 keyword, because the device supports only one interface Null 0.

Examples

# Clear statistics on interface Null 0.

<Sysname> reset counters interface null 0

shutdown

Use shutdown to shut down the current loopback interface.

Use undo shutdown to bring up the current loopback interface.

Syntax

shutdown

undo shutdown

Default

A loopback interface is up.

Views

Loopback interface view

Default command level

2: System level

Examples

# Shut down loopback interface loopback 1.

<Sysname> system-view

[Sysname] interface loopback 1

[Sysname-Loopback1] shutdown