Cisco IOS XR IP Addresses and Services Debug Command Reference, Release 3.3
Network Stack IPv4 and IPv6 Debug Commands on Cisco IOS XR Software

Table Of Contents

Network Stack Debug Commands on Cisco IOS XR Software

debug arm api

debug arm ipv4

debug arm ipv6

debug arm local server

debug ipv4 att-api

debug ipv4 error

debug ipv4 events

debug ipv4 ma error

debug ipv4 options

debug ipv4 packet

debug ipv4 smiap

debug ipv6 assembler

debug ipv6 fib

debug ipv6 icmp

debug ipv6 io

debug ipv6 ma

debug ipv6 nd

debug ipv6 netio

debug ipv6 packet


Network Stack Debug Commands on Cisco IOS XR Software


This chapter describes the commands used to debug Network Stack problems.

debug arm api

To enable Internet Protocol Address Repository Manager (IPARM) application program interface (API) debugging, use the debug arm api command in EXEC mode. To disable IPARM API debugging, use the no form of this command.

debug arm api {all | callbacks | calls | database | db-access | errors | ipc}

no debug arm api {all | callbacks | calls | database | db-access | errors | ipc}

Syntax Description

all

Displays all IPARM API event debug information.

callbacks

Displays API callback debug information.

calls

Displays all API call debug information.

errors

Displays IPARM API error debug information.

ipc

Displays infrastructure processes (IPC) API debug information.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

The job, process, and location keywords were deleted from the command.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

network

read


Examples

The following example shows how to enable IPARM local server debugging:

RP/0/RP0/CPU0:router# debug arm api 

debug arm ipv4

To enable IPv4 ARM server events debugging, use the debug arm ipv4 command in EXEC mode. To disableIPv4 ARM server events debugging, use the no form of this command.

debug arm ipv4 {conflict {override | policy} | error interface type instance | events [internal | external] [global | interface type instance] | redundancy [global | interface type instance]}

no debug arm ipv4 {conflict {override | policy} | error interface type instance | events [internal | external] [global | interface type instance] | redundancy [global | interface type instance]}

Syntax Description

conflict

Displays IPv4 ARM server conflict event debug information.

override

Displays IPv4 ARM server conflict override event debug information.

policy

Displays IPv4 ARM server conflict policy event debug information.

error

Displays IPV4 ARM server conflict error debug information.

events

Displays IPv4 ARM server policy event debug information.

internal

(Optional) Displays internal policy event debug information.

external

(Optional) Displays external policy event debug information.

global

(Optional) Displays noninterface specific debugging information.

interface

(Optional) Displays IPv4 ARM server event debug information for the designated interface.

type

(Optional) Interface type. For more information, use the question mark (?) online help function.

instance

(Optional) Either a physical interface instance or a virtual interface instance as follows:

Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

rack: Chassis number of the rack.

slot: Physical slot number of the modular services card or line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.

Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.

global

(Optional) Displays noninterface specific debug information.

interface

(Optional) Displays debug information for the designated interface


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Use this command to display IPv4 ARM server events related to address conflict checking and conflict overrides.

Task ID

Task ID
Operations

ipv4

read

network

read


Examples

The following example shows how to enable IPv4 ARM server event debugging:

RP/0/RP0/CPU0:router# debug arm ipv4 conflict override

debug arm ipv6

To enable IPv6 ARM server events debugging, use the debug arm ipv6 command in EXEC mode. To disable Pv6 ARM server events debugging, use the no form of this command.

debug arm ipv6 {conflict {override | policy} | events [internal | external] [global | interface type instance] | redundancy [global | interface type instance]}

no debug arm ipv6 {conflict {override | policy} | events [internal | external] [global | interface type instance] | redundancy [global | interface type instance]}

Syntax Description

conflict

Displays IPv6 ARM server conflict event debug information.

override

Displays IPv6 ARM server conflict override event debug information.

policy

Displays IPv6 ARM server conflict policy event debug information.

events

Displays IPv6 ARM server policy event debug information.

internal

(Optional) Displays internal policy event debug information.

external

(Optional) Displays external policy event debug information.

global

(Optional) Displays noninterface specific debugging information.

interface

(Optional) Displays IPv6 ARM server event debug information for the designated interface.

type

(Optional) Interface type. For more information, use the question mark (?) online help function.

instance

(Optional) Either a physical interface instance or a virtual interface instance as follows:

Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

rack: Chassis number of the rack.

slot: Physical slot number of the modular services card or line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.

Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.

global

(Optional) Displays noninterface specific debug information.

interface

(Optional) Displays debug information for the designated interface


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Use this command to display IPv6 ARM server events related to address conflict checking and conflict overrides.

Task ID

Task ID
Operations

ipv6

read

network

read


Examples

The following example shows how to enable IPv6 ARM server event debugging:

RP/0/RP0/CPU0:router# debug arm ipv6 conflict override

debug arm local server

To enable Internet Protocol Address Repository Manager (IPARM) local server debugging, use the debug arm local server command in EXEC mode. To disable IPARM local server debugging, use the no form of this command.

debug arm local server {all | callbacks | calls | errors | ipc}

no debug arm local server {all | callbacks | calls | errors | ipc}

Syntax Description

all

Displays all IPARM local server event debug information.

callbacks

Displays local server callback debug information.

calls

Displays all local server call debug information.

errors

Displays IPARM local server error debug information.

ipc

Displays infrastructure processes (IPC) local server debug information.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

The job, process, and location keywords were deleted from the command.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

service

read


Examples

The following example shows how to enable IPARM local server debugging:

RP/0/RP0/CPU0:router# debug arm local server all

debug ipv4 att-api

To enable IPv4 application programming interface (API) attribute debugging, use the debug ipv4 att-api command in EXEC mode. To disable IPv4 API attribute debugging, use the no form of this command.

debug ipv4 attr-api [callbacks | errors | events] [job job-id | process process-id] [location node-id]

no debug ipv4 attr-api [callbacks | errors | events] [job job-id | process process-id] [location node-id]

Syntax Description

callbacks

(Optional) Displays the client callback debug information.

errors

(Optional) Displays the client error debug information.

events

(Optional) Displays the client event debug information.

job job-id

(Optional) Displays IPv4 API attribute debug information for a specific job.

process process-id

(Optional) Displays IPv4 API attribute debug g information for a specific job. Process name or process ID (PID).

location node-id

(Optional) Displays IPv4 API attribute debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

ipv4

read

network

read


Examples

The following example shows how to enable IPv4 API attribute error debugging:

RP/0/RP0/CPU0:router# debug ipv4 attr-api errors

debug ipv4 error

To enable IPv4 event error debugging, use the debug ipv4 errors command in EXEC mode. To disable IPv4 event error debugging, use the no form of this command.

debug ipv4 error [detail] [location node-id]

no debug ipv4 error [detail] [location node-id]

Syntax Description

detail

(Optional) Displays detailed IPv4 event debug details.

location node-id

(Optional) Displays IPv4 event error debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

ipv4

read

network

read


Examples

The following example shows how to enable IPv4 event error debugging:

RP/0/RP0/CPU0:router# debug ipv4 error 

debug ipv4 events

To enable IPv4 event debugging, use the debug ipv4 events command in EXEC mode. To disable IPv4 event debugging, use the no form of this command.

debug ipv4 events [bulk | init] [location node-id]

no debug ipv4 events [bulk | init] [location node-id]

Syntax Description

bulk

(Optional) Displays bulk IPv4 event debug information.

init

(Optional) Displays IPv4 initialization event debug information.

location node-id

(Optional) Displays IPv4 event debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

ipv4

read

network

read


Examples

The following example shows how to enable IPv4 event debugging:

RP/0/RP0/CPU0:router# debug ipv4 events

debug ipv4 ma error

To enable IPv4 management agent error debugging, use the debug ipv4 ma error command in EXEC mode. To disable IPv4 management agent error debugging, use the no form of this command.

debug ipv4 ma error [detail] [location node-id]

no debug ipv4 ma error [detail] [location node-id]

Syntax Description

detail

(Optional) Displays detailed error debug information.

location node-id

(Optional) Displays IPv4 error debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

ipv4

read

network

read


Examples

The following example shows how to enable IPv4 management agent error debugging:

RP/0/RP0/CPU0:router# debug ipv4 ma error

debug ipv4 options

To enable IPv4 options-related error, event, and packet debugging, use the debug ipv4 options command in EXEC mode. To disable IPv4 options-related error, event, and packet debugging, use the no form of this command.

debug ipv4 options {all | events | errors | packets} [location node-id]

no debug ipv4 options {all | events | errors | packets} [location node-id]

Syntax Description

all

Displays all option debugging information.

events

Displays IPv4 options related event debugging information.

errors

Displays IPv4 options related error debugging information.

packets

Displays IPv4 options packet debugging information.

location node-id

(Optional) Displays IPv4 processing option debugging information for a specified location. The node-id argument is entered in the rack/slot/module notation.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

ipv4

read

network

read


Examples

The following example shows how to enable all IPv4 processing option debugging:

RP/0/RP0/CPU0:router# debug ipv4 options all 

debug ipv4 packet

To enable IPv4 input and output packet debugging, use the debug ipv4 packet command in EXEC mode. To disable IPv4 input and output packet debugging, use the no form of this command.

debug ipv4 packet [access-list] [dump {ingress | egress} | error | detail] [location node-id]

no debug ipv4 packet [access-list] [dump {ingress | egress} | error | detail] [location node-id]

Syntax Description

access-list

(Optional) Access list.

dump

(Optional) Prints packet in hex format.

ingress

Dumps ingress pak ipv4_io_netio_input to /tmp/ipv4_netio_in.pak.

egress

Dumps egress pak in ipv4_io_netio_output to /tmp/ipv4_netio_out.pak.

error

(Optional) Prints packet errors.

detail

(Optional) Prints more debugging detail.

location node-id

(Optional) Displays IPv4 packets for a specific node. The node-id argument is entered in the rack/slot/module notation.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

ipv4

read

network

read


Examples

The following example shows how to enable IPv4 input and output packet error debugging:

RP/0/RP0/CPU0:router# debug ipv4 packet error 

debug ipv4 smiap

To enable IPv4 Single Management IP Address Process (SMIAP) debugging, use the debug ipv4 smiap command in EXEC mode. To disable IPv4 SMIAP debugging, use the no form of this command.

debug ipv4 smiap {error | event} location node-id

no debug ipv4 smiap {error | event} location node-id

Syntax Description

error

Displays SMIAP debug information.

event

Displays SMIAP debug information.

location node-id

Displays IPv4 SMIAP debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

ipv4

read

network

read


Examples

The following example shows how to enable IPv4 SMIAP error debugging:

RP/0/RP0/CPU0:router# debug ipv4 smiap error location 0/2/cp0 

debug ipv6 assembler

To enable IPv6 fragmented packet assembler debugging, use the debug ipv6 assembler command in EXEC mode. To disable IPv6 fragmented packet assembler debugging, use the no form of this command.

debug ipv6 assembler {all | errors | events | packet} [location node-id]

no debug ipv6 assembler {all | errors | events | packet} [location node-id]

Syntax Description

all

Displays all IPv6 fragmented packet assembler debug information.

errors

Displays IPv6 fragmented packet assembler error debug information.

events

Displays IPv6 fragmented packet assembler event debug information.

packet

Displays IPv6 fragmented packet assembler packet debug information.

location node-id

(Optional) Displays IPv6 fragmented packet assembler debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

ipv6

read

network

read


Examples

The following example shows how to enable IPv6 fragmented packet assembler debugging:

RP/0/RP0/CPU0:router# debug ipv6 assembler all location 0/2/cp0

debug ipv6 fib

To enable IPv6 forwarding information base debugging, use the debug ipv6 fib command in EXEC mode. To disable IPv4 forwarding information base debugging, use the no form of this command.

debug ipv6 fib {adjacency | download | errors | lookup | messages | nsf | route | timing} [location node-id]

no debug ipv6 fib {adjacency | download | errors | lookup | messages | nsf | route | timing} [location node-id]

Syntax Description

adjacency

Displays IPv6 fowarding information base adjacency information.

download

Displays IPv6 fowarding information base download information.

errors

Displays IPv6 fowarding information base errors information.

lookup

Displays IPv6 fowarding information base loopup table information.

messages

Displays IPv6 fowarding information base messages.

nsf

Displays IPv6 fowarding information base nsf information.

route

Displays IPv6 fowarding information base routing information.

timing

Displays IPv6 fowarding information base timing information.

location node-id

(Optional) Displays IPv6 fowarding information base debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

cef

read

ipv6

read


Examples

The following example shows how to enable ipv6 fib debugging:

RP/0/RP0/CPU0:router# debug ipv6 fib adjacency

debug ipv6 icmp

To enable IPv6 Internet Control Message Protocol (ICMP) debugging, use the debug ipv6 icmp command in EXEC mode. To disable ICMP debugging, use the no form of this command.

debug ipv6 icmp [location node-id]

no debug ipv6 icmp [location node-id]

Syntax Description

location node-id

(Optional) Displays IPv6 ICMP debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

ipv6

read

network

read


Examples

The following example shows how to enable IPv6 ICMP debugging:

RP/0/RP0/CPU0:router# debug ipv6 icmp location 0/2/cp0

debug ipv6 io

To enable IPv6 inbound and outbound debugging, use the debug ipv6 io command in EXEC mode. To disable IPv6 inbound and outbound debugging, use the no form of this command.

debug ipv6 io {all | api {calls | errors} [job job-id | process process-id] | errors | events | packets [incoming | outgoing] [detail]} [location node-id]

no debug ipv6 io {all | api {calls | errors} [job job-id | process process-id] | errors | events | packets [incoming | outgoing] [detail]} [location node-id]

Syntax Description

all

Displays all IPv6 input and output debug information except packet input and output.

api

Displays IPv6 input and output client packet partner API call debug information on the client side.

calls

Displays debug calls to the IPv6 input and output packet partner API.

errors

Displays debug errors in the IPv6 input and output packet partner API library.

job job-id

(Optional) Displays IPv4 API attribute debug information for a specific job.

process process-id

(Optional) Displays IPv4 API attribute debug g information for a specific job. Process name or process ID (PID).

errors

Displays IPv6 input and output error debug information.

events

Displays IPv6 input and output event debug information.

packets

Displays IPv6 input and output packet debug information.

incoming

(Optional) Displays IPv6 incoming packet debug information only.

outgoing

(Optional) Displays IPv6 outgoing packet debug information only.

detail

(Optional) Displays IPv6 full packet dump debug information only.

location node-id

(Optional) Displays IPv6 inbound and outbound debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

ipv6

read

network

read


Examples

The following example shows how to enable IPv6 inbound and outbound debugging:

RP/0/RP0/CPU0:router# debug ipv6 io all location 0/2/cp0

debug ipv6 ma

To enable IPv6 management agent debugging, use the debug ipv6 ma command in EXEC mode. To disable IPv6 management agent debugging, use the no form of this command.

debug ipv6 ma {errors | events | mhost} [location node-id]

no debug ipv6 ma {errors | events | mhost} [location node-id]

Syntax Description

errors

Displays IPv6 MA error debug information.

events

Displays IPv6 MA event debug information.

mhost

Displays IPv6 MA mhost event debug information.

location node-id

(Optional) Displays IPv6 MA debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

ipv6

read

network

read


Examples

The following example shows how to enable IPv6 management agent event debugging:

RP/0/RP0/CPU0:router# debug ipv6 ma events location 0/2/cp0

debug ipv6 nd

To enable IPv6 neighbor discovery debugging, use the debug ipv6 nd command in EXEC mode. To disable IPv6 neighbor discovery debugging, use the no form of this command.

debug ipv6 nd {api errors | events | packet [interface | incoming | outgoing] [detail] | timers} [location node-id]

no debug ipv6 nd {api errors | errors | events | packet [interface | incoming | outgoing] [detail] | timers} [location node-id]

Syntax Description

api

Displays debug IPv6 neighbor discovery (ND) duplicate address detection (DAD) client application program interface (API) calls and errors on the client side.

errors

Displays debug errors in the IPv6 neighbor discovery DAD client API library.

errors

Displays IPv6 neighbor discovery errors.

events

Displays IPv6 neighbor discovery event messages.

packet

Displays IPv6 neighbor discovery packets for received and sent packets.

Note Debug packet messages can be verbose, therefore, use this keyword only when the volume of traffic is known low.

interface

(Optional) Restricts ND packet debug on interface.

detail

(Optional) Displays full packet dump information, including the contents of the packet.

incoming

(Optional) Displays IPv6 neighbor incoming packet debug information only.

outgoing

(Optional) Displays IPv6 neighbor outgoing packet debug information only.

timers

Displays IPv6 neighbor discovery timer related events.

Note The output from this keyword can be very verbose.

location node-id

(Optional) Displays IPv6 neighbor information for a specified location. The node-id argument is entered in the rack/slot/module notation.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

The call, job, and process keywords were deprecated. The interface keyword was added.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Use api keyword to track the communication channel between IPV6_ND and IPV6_MA components.

Use the errors keyword when the neighbor is not functioning normally. Error messages are printed when error conditions are detected. Error messages include lost connections, failed memory allocations, failed API function calls, and so on.

Use the events keyword to collect data for further debugging or analysis. Event messages are printed from internal and external sources. Neighbor events include sending a NS packet, notification from the interface manager, installing a neighbor adjacency to the adjacency information base (AIB), and so on.

Use the packet keyword to debug neighbor- related protocol problems such that failed to resolve a MAC address, and so on.

Use the timers keyword to debug protocol related problems. Timer-related events such as `RA timer expires' are printed.

Task ID

Task ID
Operations

ipv6

read

network

read


Examples

The following example shows how to enable IPv6 neighbor event debugging:

RP/0/RP0/CPU0:router# debug ipv6 nd events location 0/2/cp0

debug ipv6 netio

To enable IPv6 network input and output debugging, use the debug ipv6 netio command in EXEC mode. To disable IPv6 network input and output debugging, use the no form of this command.

debug ipv6 netio {cap | proto} [location node-id | interface-type interface-instance]

no debug ipv6 netio {cap | proto} [location node-id | interface-type interface-instance]

Syntax Description

cap

Displays IPv6 netio capsulation debug information.

proto

Displays IPv6 netio protocol debug information.

location node-id

(Optional) Displays IPv6 network debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.

interface-instance

(Optional) Interface type. For more information, use the question mark (?) online help function.

This argument is available when the cap or proto keywords are selected.

interface-type

(Optional) Either a physical interface instance or a virtual interface instance as follows:

Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

rack: Chassis number of the rack.

slot: Physical slot number of the modular services card or line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.

Virtual interface instance. Number range varies depending on interface type.

This argument is available when the cap or proto keywords are selected.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

ipv6

read

cef

read


Examples

The following example shows how to enable IPv6 network input and output netio protocol debugging:

RP/0/RP0/CPU0:router# debug ipv6 netio proto location 0/2/cp0

debug ipv6 packet

To enable IPv6 packet data debugging, use the debug ipv6 packet command in EXEC mode. To disable IPv6 packet data debugging, use the no form of this command.

debug ipv6 packet [input | output | detail] [location node-id | interface-type interface-instance]

no debug ipv6 packet [input | output | detail] [location node-id | interface-type interface-instance]

Syntax Description

input

(Optional) Displays IPv6 packet data debug information for packets arriving from an interface.

output

(Optional) Displays IPv6 packet data debug information for packets leaving an interface.

detail

(Optional) Displays detailed IPv6 packet data debug information.

location node-id

(Optional) Displays IPv6 network debug information for a specified location. The node-id argument is entered in the rack/slot/module notation.

interface-instance

(Optional) Interface type. For more information, use the question mark (?) online help function.

This argument is available when the input or output keywords are selected.

interface-type

(Optional) Either a physical interface instance or a virtual interface instance as follows:

Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

rack: Chassis number of the rack.

slot: Physical slot number of the modular services card or line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.

Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.This argument is available when the input or output keywords are selected.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance. For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

ipv6

read

cef

read


Examples

The following example shows how to enable IPv6 packet data debugging for incoming packets:

RP/0/RP0/CPU0:router# debug ipv6 packet input POS 0/3/0/0