Null Interface Commands


Note

All commands applicable for the Cisco NCS 5500 Series Router are also supported on the Cisco NCS 540 Series Router that is introduced from Cisco IOS XR Release 6.3.2. References to earlier releases in Command History tables apply to only the Cisco NCS 5500 Series Router.


Note

  • Starting with Cisco IOS XR Release 6.6.25, all commands applicable for the Cisco NCS 5500 Series Router are also supported on the Cisco NCS 560 Series Routers.

  • Starting with Cisco IOS XR Release 6.3.2, all commands applicable for the Cisco NCS 5500 Series Router are also supported on the Cisco NCS 540 Series Router.

  • References to releases before Cisco IOS XR Release 6.3.2 apply to only the Cisco NCS 5500 Series Router.

  • Cisco IOS XR Software Release 7.0.1 specific updates are not applicable for the following variants of Cisco NCS 540 Series Routers:

    • N540-28Z4C-SYS-A

    • N540-28Z4C-SYS-D

    • N540X-16Z4G8Q2C-A

    • N540X-16Z4G8Q2C-D

    • N540X-16Z8Q2C-D

    • N540-12Z20G-SYS-A

    • N540-12Z20G-SYS-D

    • N540X-12Z16G-SYS-A

    • N540X-12Z16G-SYS-D

This module provides command line interface (CLI) commands for configuring null interfaces on the Cisco NCS 5500 Series RouterCisco NCS 540 Series Router.

For detailed information about Null interfaces concepts, configuration tasks, and examples, refer to the Interface and Hardware Component Configuration Guide for Cisco NCS 5500 Series RoutersInterface and Hardware Component Configuration Guide for Cisco NCS 540 Series RoutersInterface and Hardware Component Configuration Guide for Cisco NCS 560 Series Routers

interface null 0

To enter null0 interface configuration mode, use the interface null 0 command in XR EXEC mode mode.

interface null 0

Syntax Description

This command has no keywords or arguments.

Command Default

No default behavior or values

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 6.0

This command was introduced.

Usage Guidelines

When you issue the interface null 0 command in XR EXEC mode mode, the CLI prompt changes to “config-null0,” indicating that you have entered interface configuration mode for the null interface. In the following sample output, the question mark (? ) online help function displays all the commands available under the interface configuration mode for the null interface: 


RP/0/RP0/CPU0:router(config)# interface null 0
RP/0/RP0/CPU0:router(config-null0)#?

  commit    Commit the configuration changes to running
  describe  Describe a command without taking real actions
  do        Run an exec command
  exit      Exit from this submode
  no        Negate a command or set its defaults
  show      Show contents of configuration

Task ID

Task ID

Operations

interface

read, write

Examples

This example shows how to enter null0 interface configuration mode: 


RP/0/RP0/CPU0:router(config)# interface null 0 
RP/0/RP0/CPU0:router(config-null0)#

show controllers null interface

To display null interface counters, use the show controllers null interface command in XR EXEC mode.

show controllers null interface

Syntax Description

This command has no keywords or arguments.

Command Default

No default behavior or values

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 6.0

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID

Operations

interface

read

sysmgr

read

Examples

The following is sample output from the show controllers null interface command, which displays null interface counters: 


RP/0/RP0/CPU0:router# show controllers null interface

Null interface:
name     : Null0
handle   : 0x0800000c
Table 1. show controllers null interface Field Descriptions

Field

Description

name

Interface whose controller information is displayed.

handle

Number that identifies the caps node that hosts the node whose controller information is displayed.

show interfaces null0

To display null0 interfaces, use the show interfaces null0 command with optional keywords in EXEC mode.

show interfaces null0 [accounting rates | brief | description | detail] [location node-id]

Syntax Description

accounting

Shows interface accounting option.

rates

Shows interface accounting (input/output) rates.

brief

Shows interface information in condensed format.

description

Describes interface.

detail

Shows interface information in detail.

location node-id

Specifies a fully qualified interface location.

Command Default

No default behavior or values

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 6.0

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

The show interfaces null0 command displays statistics about null interfaces. When no keywords are specified, information for all null interfaces is displayed.

Task ID

Task ID

Operations

interface

read

Examples

The following example shows how to use the show interfaces null0 command: 


RP/0/RP0/CPU0:router# show interfaces null0

Null0 is up, line protocol is up 
  Interface state transitions: 0
  Hardware is Null interface
  Internet address is Unknown
  MTU 1500 bytes, BW Unknown
     reliability 255/255, txload Unknown, rxload Unknown
  Encapsulation Null,  loopback not set,
  Last clearing of "show interface" counters never
  5 minute input rate 0 bits/sec, 0 packets/sec
  5 minute output rate 0 bits/sec, 0 packets/sec
     0 packets input, 0 bytes, 0 total input drops
     0 drops for unrecognized upper-level protocol
     Received 0 broadcast packets, 0 multicast packets
     0 packets output, 0 bytes, 0 total output drops
     Output 0 broadcast packets, 0 multicast packets