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
Interface   State  Speed  MTU    Type      Remote Host      Remote Port      Summary         
----------  -----  -----  -----  --------  ---------------  --------------…  ---------------…
BLUE        up            65575  vrf                                         IP Address:     
                                                                             127.0.0.1/8     
                                                                             IP Address:     
                                                                             ::1/128         
RED         up            65575  vrf                                         IP Address:     
                                                                             127.0.0.1/8     
                                                                             IP Address:     
                                                                             ::1/128         
bond1       up     1G     9000   bond                                                        
bond2       up     1G     9000   bond                                                        
bond3       up     1G     9000   bond                                                        
br_default  up            9216   bridge                                                      
br_l3vni    up            9216   bridge                                                      
eth0        up     1G     1500   eth       oob-mgmt-switch  swp10            IP Address:     
                                                                             192.168.200.11/…
lo          up            65536  loopback                                    IP Address:     
                                                                             10.10.10.1/32   
                                                                             IP Address:     
                                                                             127.0.0.1/8     
                                                                             IP Address:     
                                                                             ::1/128         
mgmt        up            65575  vrf                                         IP Address:     
                                                                             127.0.0.1/8     
                                                                             IP Address:     
                                                                             ::1/128         
swp1        up     1G     9000   swp       server01         48:b0:2d:bc:2e…                  
swp2        up     1G     9000   swp       server02         48:b0:2d:36:9e…                  
swp3        up     1G     9000   swp       server03         48:b0:2d:09:b9…                  
swp4        down          1500   swp                                                         
swp5        down          1500   swp                                                         
swp6        up     1G     9216   swp                                                        
...

nv show interface <interface-id>

Shows the configuration information for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1
                           operational              applied
-------------------------  -----------------------  -------
type                       swp                      swp    
router                                                     
  pbr                                                      
    [map]                                                  
  ospf                                                     
    enable                                          off    
  pim                                                      
    enable                                          off    
  adaptive-routing                                         
    enable                                          off    
  ospf6                                                    
    enable                                          off    
lldp                                                       
  dcbx-pfc-tlv             off                             
  dcbx-ets-config-tlv      off                             
  dcbx-ets-recomm-tlv      off                             
  state                    enabled                         
  [neighbor]               server01                        
evpn                                                       
  multihoming                                              
    uplink                                          off    
ptp                                                        
  enable                   off                      off    
[acl]                                                      
synce                                                      
  enable                                            off    
neighbor                                                   
  [ipv4]                                                   
  [ipv6]                                                   
sflow                                                      
  sample-rate              0                               
  state                    disabled                 enabled
parent                     bond1                           
ip                                                         
  vrrp                                                     
    enable                                          off    
  igmp                                                     
    enable                                          off    
  neighbor-discovery                                       
    enable                                          on     
    router-advertisement                                   
      enable                                        off    
    home-agent                                             
      enable                                        off    
    [rdnss]                                                
    [dnssl]                                                
    [prefix]                                               
  ipv4                                                     
    forward                                         on     
  ipv6                                                     
    enable                                          on     
    forward                                         on     
  vrf                                               default
  [gateway]                                                
link                                                       
  auto-negotiate           off                      on     
  duplex                   full                     full   
  speed                    1G                       auto   
  mac-address              48:b0:2d:f0:b9:86               
  fec                                               auto   
  mtu                      9000                     9216   
  fast-linkup              off                             
  [breakout]                                               
  state                    up                       up     
  flap-protection                                          
    enable                                          on     
  stats                                                    
    in-bytes               8.19 MB                         
    in-pkts                67797                           
    in-drops               0                               
    in-errors              0                               
    out-bytes              9.96 MB                         
    out-pkts               102895                          
    out-drops              0                               
    out-errors             0                               
    carrier-transitions    4                               
    carrier-up-count       2                               
    carrier-down-count     2                               
  protodown                disabled                        
  oper-status              up                              
  admin-status             up                              
  oper-status-last-change  2024/10/22 18:36:00.469 
...

Cumulus Linux 5.11 and later shows the last time (date and time) the operational state of an interface changed.


nv show interface <interface-id> bond

Shows the bond member configuration for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 bond

nv show interface <interface-id> bond member

Shows the bond members for the specified interface.

Command Syntax

Syntax Description
<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

Syntax Description
<interface-id> The interface name.
<member-id> The bond 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

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv show interface swp1 counters
                     operational  applied  pending
-------------------  -----------  -------  -------
carrier-transitions  6                            

Detailed Counters
====================
    Counter            Receive  Transmit
    -----------------  -------  --------
    Broadcast Packets  0        0       
    Multicast Packets  0        0       
    Total Octets       0        0       
    Total Packets      0        0       
    Unicast Packets    0        0       

Drop Counters
================
    Counter          Receive  Transmit
    ---------------  -------  --------
    ACL Drops        0        n/a     
    Buffer Drops     0        n/a     
    Non-Queue Drops  n/a      0       
    Queue Drops      n/a      0       
    Total Drops      0        0       

Error Counters
=================
    Counter           Receive  Transmit
    ----------------  -------  --------
    Alignment Errors  0        n/a     
    FCS Errors        0        n/a     
    Jabber Errors     0        n/a     
    Length Errors     0        n/a     
    Oversize Errors   0        n/a     
    Symbol Errors     0        n/a     
    Total Errors      0        0       
    Undersize Errors  0        n/a     

Packet Size Statistics
=========================
    Counter     Receive  Transmit
    ----------  -------  --------
    64          0        0       
    65-127      0        0       
    128-255     0        0       
    256-511     0        0       
    512-1023    0        0       
    1024-1518   0        0       
    1519-2047   0        0       
    2048-4095   0        0       
    4096-16383  0        0       

Ingress Buffer Statistics
============================
    priority-group  rx-frames  rx-buffer-discards  rx-shared-buffer-discards
    --------------  ---------  ------------------  -------------------------
    0               0          0 Bytes             0 Bytes                  
    1               0          0 Bytes             0 Bytes                  
    2               0          0 Bytes             0 Bytes                  
    3               0          0 Bytes             0 Bytes                  
    4               0          0 Bytes             0 Bytes                  
    5               0          0 Bytes             0 Bytes                  
    6               0          0 Bytes             0 Bytes                  
    7               0          0 Bytes             0 Bytes
...

nv show interface <interface> counters drops

Shows packet drop counters for a specific interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv show interface swp1 counters drops
Counter          Receive  Transmit
---------------  -------  --------
ACL Drops        0        n/a     
Buffer Drops     0        n/a
Non-Queue Drops  n/a      0       
Queue Drops      n/a      0       
Total Drops      0        0

nv show interface <interface> counters errors

Shows error counters for a specific interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv show interface swp1 counters errors
Counter           Receive  Transmit
----------------  -------  --------
Alignment Errors  0        n/a     
FCS Errors        0        n/a     
Jabber Errors     0        n/a     
Length Errors     0        n/a     
Oversize Errors   0        n/a     
Symbol Errors     0        n/a     
Total Errors      0        0       
Undersize Errors  0        n/a

nv show interface <interface> counters pktdist

Shows packet distribution counters for a specific interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv show interface swp1 counters pktdist
Counter     Receive  Transmit
----------  -------  --------
64          0        0       
65-127      0        0       
128-255     0        0       
256-511     0        0       
512-1023    0        0       
1024-1518   0        0       
1519-2047   0        0       
2048-4095   0        0       
4096-16383  0        0

nv show interface <interface-id> ip

Shows the IP configuration for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 ip
                        operational  applied  pending
----------------------  -----------  -------  -------
igmp                                                 
  enable                             off      off    
ipv4                                                 
  forward                            on       on     
ipv6                                                 
  enable                             on       on     
  forward                            on       on     
neighbor-discovery                                   
  enable                             on       on     
  [dnssl]                                            
  home-agent                                         
    enable                           off      off    
  [prefix]                                           
  [rdnss]                                            
  router-advertisement                               
    enable                           off      off    
vrrp                                                 
  enable                             off      off    
vrf                                  default  default
[gateway]

nv show interface <interface-id> ip address

Shows the IP addresses configured for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

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

-------------
10.10.10.1/32
127.0.0.1/8  
::1/128  

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

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

Command Syntax

Syntax Description
<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 lo 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

Syntax Description
<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

Syntax Description
<interface-id> The interface name.
<ip-address-id> The gateway IP address.

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

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 ip ipv4
         operational  applied  pending
-------  -----------  -------  -------
forward               on       on

nv show interface <interface-id> ip ipv6

Shows IPv6 information for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 ip ipv6
        operational  applied  pending
-------  -----------  -------  -------
enable                on       on     
forward               on       on

nv show interface <interface-id> ip neighbor

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

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp51 ip neighbor
        operational                applied  pending
------  -------------------------  -------  -------
[ipv4]  169.254.0.1                                
[ipv6]  fe80::4ab0:2dff:fe08:9898

nv show interface <interface-id> ip neighbor ipv4

Shows the IPv4 neighbors for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp51 ip neighbor ipv4
             lladdr             state    
-----------  -----------------  ---------
169.254.0.1  48:b0:2d:08:98:98  permanent

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

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

Command Syntax

Syntax Description
<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
        operational        applied  pending
------  -----------------  -------  -------
lladdr  48:b0:2d:08:98:98                  
state   permanent

nv show interface <interface-id> ip neighbor ipv6

Shows the IPv6 neighbors for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp51 ip neighbor ipv6
                           lladdr             state    
-------------------------  -----------------  ---------
fe80::4ab0:2dff:fe08:9898  48:b0:2d:08:98:98  reachable

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

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

Command Syntax

Syntax Description
<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 fe80::4ab0:2dff:fe08:9898
        operational        applied  pending
------  -----------------  -------  -------
lladdr  48:b0:2d:08:98:98                  
state   reachable

nv show interface <interface-id> link

Shows configuration and statistics for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$  nv show interface swp1 link
                         operational              applied
-----------------------  -----------------------  -------
admin-status             up                              
oper-status              up                              
oper-status-last-change  2024/10/22 18:36:00.469         
protodown                disabled                        
auto-negotiate           off                      on     
duplex                   full                     full   
speed                    1G                       auto   
mac-address              48:b0:2d:f0:b9:86               
fec                                               auto   
mtu                      9000                     9216   
fast-linkup              off                             
[breakout]                                               
state                    up                       up     
flap-protection                                          
  enable                                          on     
stats                                                    
  in-bytes               8.21 MB                         
  in-pkts                67938                           
  in-drops               0                               
  in-errors              0                               
  out-bytes              9.98 MB                         
  out-pkts               103107                          
  out-drops              0                               
  out-errors             0                               
  carrier-transitions    4                               
  carrier-up-count       2                               
  carrier-down-count     2

Cumulus Linux 5.11 and later shows the last time (date and time) the operational state of an interface changed and the number of carrier transitions.


Shows the port breakouts for the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.4.0

Example

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

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

Command Syntax

Syntax Description
<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

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

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

Shows physical layer information, such the error counters for each lane on a port.

Switches with the Spectrum 1 ASIC do not support the nv show interface <interface> link phy-detail command.

Command Syntax

Syntax Description
<interface-id> The interface you want to configure.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch:~$ nv show interface swp1 link phy-detail 
                          operational
-------------------------  -----------------
time-since-last-clear-min  324
phy-received-bits          15561574400000000
symbol-errors              0
effective-errors           0
phy-raw-errors-lane0       747567424
phy-raw-errors-lane1       215603747
phy-raw-errors-lane2       158456437
phy-raw-errors-lane3       30578923
phy-raw-errors-lane4       121708834
phy-raw-errors-lane5       29244642
phy-raw-errors-lane6       79102523
phy-raw-errors-lane7       96656135
raw-ber                    1E-7
symbol-ber                 15E-255
effective-ber              15E-255
raw-ber-lane0              3E-6
raw-ber-lane1              9E-7
raw-ber-lane2              6E-7
raw-ber-lane3              1E-7
raw-ber-lane4              5E-7
raw-ber-lane5              1E-7
raw-ber-lane6              3E-7
raw-ber-lane7              4E-7
rs-num-corr-err-bin0       757956054591
rs-num-corr-err-bin1       598244758
rs-num-corr-err-bin2       807002
rs-num-corr-err-bin3       3371
rs-num-corr-err-bin4       180
rs-num-corr-err-bin5       1
rs-num-corr-err-bin6       0
rs-num-corr-err-bin7       0
rs-num-corr-err-bin8       1
rs-num-corr-err-bin9       0
rs-num-corr-err-bin10      0
rs-num-corr-err-bin11      0
rs-num-corr-err-bin12      0
rs-num-corr-err-bin13      0
rs-num-corr-err-bin14      0
rs-num-corr-err-bin15      0

Shows physical layer diagnostic information for a port.

Switches with the Spectrum 1 ASIC do not support the nv show interface <interface> link phy-diag command.

Command Syntax

Syntax Description
<interface-id> The interface you want to configure.

Version History

Introduced in Cumulus Linux 5.10.0

Example

cumulus@switch$ nv show interface swp20 link phy-diag 
                                  operational
--------------------------------  -----------
pd-fsm-state                      0x7
eth-an-fsm-state                  0x6
phy-hst-fsm-state                 0x8
psi-fsm-state                     0x0
phy-manager-link-enabled          0x9bff0
core-to-phy-link-enabled          0x9b800
cable-proto-cap-ext               0x0
loopback-mode                     0x0
retran-mode-request               0x0
retran-mode-active                0x0
fec-mode-request                  0x1
profile-fec-in-use                0x4
pd-link-enabled                   0x80000
phy-hst-link-enabled              0x80000
eth-an-link-enabled               0x0
phy-manager-state                 0x3
eth-proto-admin                   0x0
ext-eth-proto-admin               0x0
eth-proto-capability              0x0
ext-eth-proto-capability          0x0
data-rate-oper                    0x0
an-status                         0x0
an-disable-admin                  0x0
proto-mask                        0x2
module-info-ext                   0x0
ethernet-compliance-code          0x1c
ext-ethernet-compliance-code      0x32
memory-map-rev                    0x40
linear-direct-drive               0x0
cable-breakout                    0x0
cable-rx-amp                      0x1
cable-rx-pre-emphasis             0x0
cable-rx-post-emphasis            0x0
cable-tx-equalization             0x0
cable-attenuation-53g             0x0
cable-attenuation-25g             0x0
cable-attenuation-12g             0x0
cable-attenuation-7g              0x0
cable-attenuation-5g              0x0
tx-input-freq-sync                0x0
tx-cdr-state                      0xff
rx-cdr-state                      0xff
module-fw-version                 0x2e820043
module-st                         0x3
dp-st-lane0                       0x4
dp-st-lane1                       0x4
dp-st-lane2                       0x4
dp-st-lane3                       0x4
dp-st-lane4                       0x4
dp-st-lane5                       0x4
dp-st-lane6                       0x4
dp-st-lane7                       0x4
rx-output-valid                   0x0
rx-power-type                     0x1
active-set-host-compliance-code   0x52
active-set-media-compliance-code  0x1c
error-code-response               0x0
temp-flags                        0x0
vcc-flags                         0x0
mod-fw-fault                      0x0
dp-fw-fault                       0x0
rx-los-cap                        0x0
tx-fault                          0x0
tx-los                            0x0
tx-cdr-lol                        0x0
tx-ad-eq-fault                    0x0
rx-los                            0x0
rx-cdr-lol                        0x0
rx-output-valid-change            0x0
flag-in-use                       0x0

Shows the link protodown reason details for an interface.

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.9.0

Example

cumulus@switch:~$ nv show interface swp1 link protodown-reason

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

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 link state
operational  applied  pending
  -----------  -------  -------
  up           up       up

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

Command Syntax

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show interface swp1 link stats
                     operational  applied  pending
-------------------  -----------  -------  -------
carrier-transitions  6                            
in-bytes             39.22 MB                     
in-drops             0                            
in-errors            0                            
in-pkts              324557                       
out-bytes            48.51 MB                     
out-drops            0                            
out-errors           0                            
out-pkts             501951

Shows traffic engineering statistics for the specified interface.

Command Syntax

Syntax Description
<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.

Cumulus Linux 5.11 and later no longer provides this command. Use the nv show platform transceiver <interface> command instead.

Command Syntax

Syntax Description
<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

Syntax Description
<interface-id> The interface name.

Version History

Introduced in Cumulus Linux 5.3.0

Example

cumulus@switch:~$ nv show interface swp1 storm-control
                 applied
---------------  -------
broadcast        400    
multicast        3000   
unknown-unicast  2000

nv show interface <interface-id> tunnel

Shows tunnel information for the specified interface.

Command Syntax

Syntax Description
<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 bonds

Shows information about the bonds on the switch, such as the admin and operational status, the LACP mode and rate, if LACP bypass is enabled, and the up delay and down delay settings.

Version History

Introduced in Cumulus Linux 5.11.0

Example

cumulus@switch:~$ nv show interface bonds
Interface  Admin Status  Oper Status  Mode  Mlag ID  Lacp-rate  Lacp-bypass  Up-delay  Down-delay
---------  ------------  -----------  ----  -------  ---------  -----------  --------  ----------
bond1      up            down         lacp           fast       off          0         0 

nv show interface bond-members

Shows information about the bond members on the switch, such as which interfaces are part of the bond, the admin and operational status, and the speed and MTU of each bond member.

Version History

Introduced in Cumulus Linux 5.11.0

Example

cumulus@switch:~$ nv show interface bond-members
Interface  Parent  Admin Status  Oper Status  Speed  MTU 
---------  ------  ------------  -----------  -----  ----
swp1       bond1   up            up           1G     9216
swp2       bond1   up            up           1G     9216
swp3       bond1   up            up           1G     9216
swp4       bond1   up            up           1G     9216

nv show interface carrier-stats

Shows information about the interfaces on the switch, such as the operational status, the number of state changes, and the date and time of the last state change.

Version History

Introduced in Cumulus Linux 5.11.0

Example

cumulus@switch:~$ nv show interface carrier-stats
Interface  Oper Status  Up Count  Down Count  Total State Changes  Last State Change      
---------  -----------  --------  ----------  -------------------  -----------------------
bond1      down         0         0           0                    Never                  
eth0       up           1         1           2                    2024/11/04 19:42:24.613
lo         up           1         0           1                    2024/11/04 19:42:24.613                  
mgmt       up           0         0           0                    Never                  
swp1       up           1         1           2                    2024/11/04 22:32:37.918
swp2       up           1         1           2                    2024/11/04 22:32:37.940
swp3       up           1         1           2                    2024/11/04 22:32:37.963
swp4       up           1         1           2                    2024/11/04 22:32:37.980
swp5       down         1         1           2                    2024/11/04 19:41:56.512
swp6       down         1         1           2                    2024/11/04 19:41:56.512
swp7       down         1         1           2                    2024/11/04 19:41:56.512
swp8       down         1         1           2                    2024/11/04 19:41:56.512
...

nv show interface down

Shows information about interfaces that are down.

Version History

Introduced in Cumulus Linux 5.11.0

Example

cumulus@switch:~$ nv show interface down
Interface  Admin Status  Oper Status  Speed  MTU    Type      Summary                
---------  ------------  -----------  -----  -----  --------  -----------------------
bond1      up            down                9216   bond                             
lo         up            unknown             65536  loopback  IP Address: 127.0.0.1/8
                                                              IP Address:     ::1/128
swp5       down          down                1500   swp                              
swp6       down          down                1500   swp                              
swp7       down          down                1500   swp                              
swp8       down          down                1500   swp                              
swp9       down          down                1500   swp                              
swp10      down          down                1500   swp                              
swp11      down          down                1500   swp                              
swp12      down          down                1500   swp
...

nv show interface svi

Shows SVI information on the switch.

Version History

Introduced in Cumulus Linux 5.11.0

Example

cumulus@switch:~$ nv show interface svi

nv show interface vrf

Shows VRF information on the switch.

Version History

Introduced in Cumulus Linux 5.11.0

Example

cumulus@switch:~$ nv show interface vrf
Interface  Summary                
---------  -----------------------
mgmt       IP Address: 127.0.0.1/8
           IP Address: 127.0.1.1/8
           IP Address:     ::1/128

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
Interface   MTU    RX_OK   RX_ERR  RX_DRP  RX_OVR  TX_OK   TX_ERR  TX_DRP  TX_OVR  Flg  
----------  -----  ------  ------  ------  ------  ------  ------  ------  ------  -----
BLUE        65575  0       0       0       0       0       0       1197    0       OmRU 
RED         65575  0       0       0       0       0       0       1197    0       OmRU 
bond1       9000   324612  0       0       0       502040  0       0       0       BMmRU
bond2       9000   330788  0       0       0       499929  0       0       0       BMmRU
bond3       9000   324604  0       0       0       499590  0       0       0       BMmRU
br_default  9216   44391   0       0       0       40362   0       0       0       BMRU 
br_l3vni    9216   0       0       0       0       7253    0       0       0       BMRU 
eth0        1500   214911  0       0       0       29286   0       0       0       BMRU 
lo          65536  227368  0       0       0       227368  0       0       0       LRU  
mgmt        65575  31690   0       0       0       0       0       1197    0       OmRU 
swp1        9000   324616  0       0       0       502040  0       0       0       BMsRU
swp2        9000   330792  0       0       0       499929  0       0       0       BMsRU
swp3        9000   324608  0       0       0       499590  0       0       0       BMsRU
swp6        9216   0       0       0       0       97832   0       0       0       BMRU 
swp7        9216   0       0       0       0       97832   0       0       0       BMRU 
swp51       9216   273647  0       10793   0       274422  0       0       0       BMRU 
swp52       9216   249220  0       10793   0       262843  0       0       0       BMRU 
vlan10      9216   13482   0       80      0       14416   0       0       0       BMRU 
vlan10-v0   9216   300     0       80      0       7090    0       0       0       BMRU 
vlan20      9216   20409   0       50      0       11355   0       0       0       BMRU 
vlan20-v0   9216   275     0       50      0       5894    0       0       0       BMRU 
vlan30      9216   11700   0       50      0       12033   0       0       0       BMRU 
vlan30-v0   9216   226     0       50      0       5894    0       0       0       BMRU 
vlan220_l3  9216   0       0       0       0       2420    0       0       0       BMRU 
vlan297_l3  9216   0       0       0       0       2420    0       0       0       BMRU 
vxlan48     9216   27342   0       0       0       25891   40829   51      0       BMRU 
vxlan99     9216   0       0       0       0       0       0       4800    0       BMRU

nv show system link

Show global link configuration.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show system link
                 applied
---------------  -------
flap-protection         
  threshold      5      
  interval       10

Shows the link flap protection threshold and interval configuration settings.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show system link flap-protection
           applied
---------  -------
threshold  8      
interval   30

nv show vrf <vrf-id> loopback

Shows the loopback interfaces associated with this VRF.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show vrf default loopback
             operational    applied      pending    
-----------  -------------  -----------  -----------
ip                                                  
  [address]  10.10.10.1/32                          
  [address]  127.0.0.1/8    127.0.0.1/8  127.0.0.1/8
  [address]  ::1/128        ::1/128      ::1/128

nv show vrf <vrf-id> loopback ip

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

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show vrf default loopback ip
           operational    applied      pending    
---------  -------------  -----------  -----------
[address]  10.10.10.1/32                          
[address]  127.0.0.1/8    127.0.0.1/8  127.0.0.1/8
[address]  ::1/128        ::1/128      ::1/128

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

Syntax Description
<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