Interface


nv show interface

Shows information about all the interfaces on the switch, such as the name, type (swp, bond, vrf, and so on), state (up or down), speed, MTU, remote host and remote port, and IP address.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface

nv show interface <interface-id>

Shows the configuration information for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1

nv show interface <interface-id> bond member

Shows the bond member configuration for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 bond member

nv show interface <interface-id> bond member <member-id>

Shows specific bond member configuration for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 bond member bond1

nv show interface <interface> counters

Shows all counters for a specific interface, such as packet drop, error, and distribution counts.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv show interface swp1 counters

nv show interface <interface> counters drops

Shows packet drop counters for a specific interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv show interface swp1 counters drops

nv show interface <interface> counters errors

Shows error counters for a specific interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv show interface swp1 counters errors

nv show interface <interface> counters pktdist

Shows packet distribution counters for a specific interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv show interface swp1 counters pktdist

nv show interface <interface-id> ip

Shows the IP configuration for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 ip

nv show interface <interface-id> ip address

Shows the IP addresses configured for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 ip address

nv show interface <interface-id> ip address <ip-prefix-id>

Shows details about a specific IP address for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.
<ip-prefix-id>The IPv4 or IPv6 address and route prefix in CIDR notation.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 ip address 10.10.10.1/32

nv show interface <interface-id> ip gateway

Shows the gateway IP address for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 ip gateway

nv show interface <interface-id> ip gateway <ip-address-id>

Shows information about a specific gateway IP address for the specified interface

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 ip gateway 10.10.10.1

nv show interface <interface-id> ip ipv4

Shows IPv4 information for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 ip ipv4

nv show interface <interface-id> ip ipv6

Shows IPv6 information for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 ip ipv6

nv show interface <interface-id> ip neighbor

Shows information about the IP neighbors configured for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp51 ip neighbor

nv show interface <interface-id> ip neighbor ipv4

Shows the IPv4 neighbors for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp51 ip neighbor ipv4

nv show interface <interface-id> ip neighbor ipv4 <neighbor-id>

Shows information about a specific IPv4 neighbor for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.
<neighbor-id>The IPv4 address of the neighbor.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp51 ip neighbor ipv4 169.254.0.1

nv show interface <interface-id> ip neighbor ipv6

Shows the IPv6 neighbors for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp51 ip neighbor ipv6

nv show interface <interface-id> ip neighbor ipv6 <neighbor-id>

Shows information about a specific IPv6 neighbor for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.
<neighbor-id>The IPv4 address of the neighbor.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp51 ip neighbor ipv6 2001:db8:0002::0a00:0002

nv show interface <interface-id> link

Shows configuration and statistics for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 link

Shows the port breakouts for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv show interface swp1 link breakout 2x

Shows information about a specific port breakout for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.
<mode-id>The breakout mode identifier: 1x, 2x, 4x, 8x, disabled, or loopback.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv show interface swp1 link breakout 2x

Shows link flags for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 link flag

Shows the state of the specified interface; if the link is up or down.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 link state

Shows statistics for the specified interface, such as packet size, packet drops, and packet errors.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 link stats

Shows traffic engineering statistics for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 link traffic-engineering

nv show interface <interface-id> pluggable

Shows the SFP module information for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.3.0

Example

cumulus@switch:~$ nv show interface swp1 pluggable

nv show interface <interface-id> storm-control

Shows storm control configuration settings for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.3.0

Example

cumulus@switch:~$ nv show interface swp1 storm-control

nv show interface <interface-id> tunnel

Shows tunnel information for the specified interface.

Command Syntax

SyntaxDescription
<interface-id>The interface name.

Version History

Introduced in Cumulus Linux 5.1.0

Example

cumulus@switch:~$ nv show interface swp1 tunnel

nv show interface –view=counters

Shows all statistics for all the interfaces configured on the switch.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv show interface --view=counters

nv show vrf <vrf-id> loopback

Shows the loopback interfaces associated with this VRF.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show vrf default loopback

nv show vrf <vrf-id> loopback ip

Shows the IP addresses associated with the loopback interface for the specified VRF.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show vrf default loopback ip

nv show vrf <vrf-id> loopback ip address <ip-prefix-id>

Shows details about the specified loopback IP address for the specified VRF.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.
<ip-prefix-id>The IPv4 or IPv6 address and route prefix in CIDR notation.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show vrf default loopback ip address 10.10.10.1/32