Cisco IOS XR System Security Debug Command Reference, Release 3.6
Crypto Conditional Debug Commands on Cisco IOS XR Software

Table Of Contents

Crypto Conditional Debug Commands on Cisco IOS XR Software

debug condition crypto ipv4

debug condition crypto hostname

debug condition crypto ike

debug condition crypto ipsec

debug condition crypto username

debug condition crypto vi


Crypto Conditional Debug Commands on Cisco IOS XR Software


This chapter describes the Cisco IOS XR software crypto conditional debug commands.

For high-level, conceptual information about using debug commands generally, see Using Debug Commands on Cisco IOS XR Software, Release 3.6.0.

debug condition crypto ipv4

To select a peer by the IPv4 address, use the debug condition crypto ivp4 command in EXEC mode. Information will be displayed for both the Internet Key Exchange (IKE) and the IP Security (IPSec) negotiation stages. To disable the peer selection, use the no form of this command.

debug condition crypto ipv4 ip-address [/length]

no debug condition crypto ipv4 ip-address [/length]

Syntax Description

ip-address

Specifies the IP address of the peer.

/length

(Optional) Prefix length, which can be indicated as a slash (/) and number. For example, /8 indicates that the first eight bits in the IP prefix are network bits. If the length argument is used, the slash is required.


Defaults

If conditional crypto debug statements are not used, crypto debug information will be displayed for all connections

Command Modes

EXEC

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco XR 12000 Series Router and the Cisco CRS-1.

Release 3.5.0

No modification.

Release 3.6.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 conditional crypto debug commands in conjunction with crypto debug commands to select the peers or connections for which crypto debug information will be displayed. If crypto debug commands are not used, the conditional crypto debug commands will not display information. If multiple conditional debug commands are used, connections are selected using OR logic.

Use the IP condition when you know the IP address of the peer, and if the peer uses the IP as the identifier.

Task ID

Task ID
Operations

crypto

execute

basic-services

read, write



Related Commands

Command
Description

debug crypto engine

Displays information about crypto engines encryption and decryption functions.

debug crypto ipsec

Displays IPSec events.

debug crypto isakmp

Displays messages about IKE events.

debug crypto pki

Displays messages about PKI client events.


debug condition crypto hostname

To select a peer by the hostname string (to a maximum of 128 characters), use the debug condition crypto hostname command in EXEC mode. Information will be displayed for both the Internet Key Exchange (IKE) and the IP Security (IPSec) negotiation stages. To disable the peer selection, use the no form of this command.

debug condition crypto hostname {peer-identity}

no debug condition crypto hostname {peer-identity}

Syntax Description

peer-identity

Identity of the hostname of the peer in the format hostname.domain, to a maximum of 128 characters.


Defaults

If conditional crypto debug statements are not used, crypto debug information will be displayed for all connections

Command Modes

EXEC

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco XR 12000 Series Router and the Cisco CRS-1.

Release 3.5.0

No modification.

Release 3.6.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 conditional crypto debug commands in conjunction with crypto debug commands to select the peers or connections for which crypto debug information will be displayed. If crypto debug commands are not used, the conditional crypto debug commands will not display information. If multiple conditional debug commands are used, connections are selected using OR logic.

Use the hostname condition when you know the domain and hostname of the peer, and if the peer uses the hostname as the identifier.

Task ID

Task ID
Operations

crypto

execute

basic-services

read, write


Related Commands

Command
Description

debug crypto ipsec

Displays IPSec events.


debug condition crypto ike

To display debug information about Internet Key Exchange (IKE) operations for specific connections, use the debug condition crypto ike command in EXEC mode. To disable the selection, use the no form of this command.

debug condition crypto ike {connid connection-id | fvrf front-door-vrf | group unity-group | isakmp-profile isakmp-profile | ivrf inside-vrf | unmatch}

no debug condition crypto ike {connid connection-id | fvrf front-door-vrf | group unity-group | isakmp-profile isakmp-profile | ivrf inside-vrf | unmatch}

Syntax Description

connid connection-id

Specifies a connection by the ID assigned to it. Range is 1 to 32767.

fvrf front-door-vrf

Specifies a connection by the front-door VPN routing and forwarding (VRF) instance it uses. Value is front-door VRF name.

group unity-group

Specifies a connection with a peer using a Unity Key-Group string as a the identifier. Value is unity group name string.

isakmp-profile isakmp-profile

Specifies the profile name of the specified IKE session as a crypto debug condition. Value is the name of the ISAKMP profile.

ivrf inside-vrf

Specifies a connection by the inside-door VRF instance it uses. Value is the inside-door VRF name.

unmatch

Sets the unlimited flag to produce a debug message even if no context is available.


Defaults

If conditional crypto debug statements are not used, crypto debug information will be displayed for all connections

Command Modes

EXEC

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco XR 12000 Series Router and the Cisco CRS-1.

Release 3.5.0

No modification.

Release 3.6.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 conditional crypto debug commands in conjunction with crypto debug commands to select the peers or connections for which crypto debug information will be displayed. If crypto debug commands are not used, the conditional crypto debug commands will not display information. If multiple conditional debug commands are used, connections are selected using OR logic.

Use the debug condition crypto ike commands to debug peer-specific, configuration, or functionality-related IKE problems that could occur during a large-scale VPN deployment, in particular with hub routers that have large numbers of peers and live traffic. The condition statements focus on specific IKE sessions using different filters.

Use the group condition when the group to which the peer belongs is known, and if the peer uses the group as the identifier.

Use the unmatch condition to show messages that cannot be related to a specific session. By default, some messages are not displayed when other conditional debug commands are used. Combine other conditional debug commands with the unmatch condition and a crypto debug command to generate output for the specified session.

Task ID

Task ID
Operations

crypto

execute

basic-services

read, write


Related Commands

Command
Description

debug crypto engine

Displays information about crypto engines encryption and decryption functions.

debug crypto ipsec

Displays IPSec events.

debug crypto isakmp

Displays messages about IKE events.

debug crypto pki

Displays messages about PKI client events.

tunnel vrf vrf-name

Determines the fvrf that the service IPSec uses.

vrf vrf-name

Determines the ivrf that the service IPSec uses.


debug condition crypto ipsec

To display debug information about IP Security (IPSec) operations for a specific session, use the debug condition crypto ipsec command in EXEC mode. To disable the selection, use the no form of this command.

debug condition crypto ipsec {flow-id flow-id | fvrf front-door-vrf | profile ipsec-profile | unmatch}

no debug condition crypto ipsec {flow-id flow-id | fvrf front-door-vrf | profile ipsec-profile | unmatch}

Syntax Description

flow-id flow-id

Specifies a IPSec session by the ID assigned to it. Range is 1 to 16500.

fvrf front-door-vrf

Specifies an IPSec section by the front-door VRF instance it uses. Value is front-door VRF name.

profile ipsec-profile

Specifies an IPSec profile as a crypto debug condition. Value is the name of the IPSec profile.

unmatch

Sets the unlimited flag to produce a debug message even if no context is available.


Defaults

If conditional crypto debug statements are not used, crypto debug information will be displayed for all connections

Command Modes

EXEC

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco XR 12000 Series Router and the Cisco CRS-1.

Release 3.5.0

No modification.

Release 3.6.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 conditional crypto debug commands in conjunction with crypto debug commands to select the peers or connections for which crypto debug information will be displayed. If crypto debug commands are not used, the conditional crypto debug commands will not display information. If multiple conditional debug commands are used, connections are selected using OR logic.

Use the debug condition crypto ipsec commands to debug peer-specific, configuration, or functionality-related IPSec problems that could occur during a large-scale VPN deployment, in particular with hub routers that have large numbers of peers and live traffic. The condition statements enable you to focus on specific IPSec sessions using different filters.

Use the unmatch condition to show messages that cannot be related to a specific session. By default, some messages are not displayed when other conditional debug commands are used. Combine other conditional debug commands with the unmatch condition and a crypto debug command to generate output for the specified session.

Task ID

Task ID
Operations

crypto

execute

basic-services

read, write


Related Commands

Command
Description

debug crypto engine

Displays information about crypto engines encryption and decryption functions.

debug crypto ipsec

Displays IPSec events.

debug crypto isakmp

Displays messages about IKE events.

debug crypto pki

Displays messages about PKI client events.

tunnel vrf vrf-name

Determines the fvrf that the service IPSec uses.


debug condition crypto username

To select a peer by its username, use the debug condition crypto username command in EXEC mode. Information is displayed for both the Internet Key Exchange (IKE) and the IP Security (IPSec). To disable the peer selection, use the no form of this command.

debug condition crypto username peer-identity

no debug condition crypto username peer-identity

Syntax Description

peer-identity

Value is the fully qualified domain name (FQDN) username of the peer in the format username@domain.


Defaults

If conditional crypto debug statements are not used, crypto debug information will be displayed for all connections

Command Modes

EXEC

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco XR 12000 Series Router and the Cisco CRS-1.

Release 3.5.0

No modification.

Release 3.6.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 conditional crypto debug commands in conjunction with crypto debug commands to select the peers or connections for which crypto debug information will be displayed. If crypto debug commands are not used, the conditional crypto debug commands will not display information. If multiple conditional debug commands are used, connections are selected using OR logic.

Use the username condition when you know the username and domain of the peer, and if the peer uses the username as the identifier.

Task ID

Task ID
Operations

crypto

execute

basic-services

read, write



Related Commands

Command
Description

debug crypto engine

Displays information about crypto engines encryption and decryption functions.

debug crypto ipsec

Displays IPSec events.

debug crypto isakmp

Displays messages about IKE events.

debug crypto pki

Displays messages about PKI client events.


debug condition crypto vi

To define a virtual interface name as a crypto debug condition, use the debug condition crypto vi command in EXEC mode. Information is displayed for both the Internet Key Exchange (IKE) and IP Security (IPSec). To disable the selection, use the no form of this command.

debug condition crypto vi {tunnel-ipsec tunnel-id}

no debug condition crypto vi {tunnel-ipsec tunnel-id}

Syntax Description

tunnel-ipsec tunnel-id

Specifies IPSec tunnel interface as a crypto debug condition. Value is the ID for the IPSec tunnel interface.

service-gre gre-id

Specifies the service-gre interface as a crypto debug condition. Value is the ID for the interface (Cisco XR 12000 Series Router only).

service-ipsec ipsec-id

Specifies the service-ipsec interface as a crypto debug condition. Value is the ID for the interface (Cisco XR 12000 Series Router only).


Defaults

If conditional crypto debug statements are not used, crypto debug information will be displayed for all connections

Command Modes

EXEC

Command History

Release
Modification

Release 3.4.0

This command was introduced on the Cisco XR 12000 Series Router and the Cisco CRS-1.

Release 3.5.0

No modification.

Release 3.6.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 conditional crypto debug commands in conjunction with crypto debug commands to select the peers or connections for which crypto debug information will be displayed. If crypto debug commands are not used, the conditional crypto debug commands will not display information. If multiple conditional debug commands are used, connections are selected using OR logic.

Use this command to see output for all connections on the specified interface.

Task ID

Task ID
Operations

crypto

execute

basic-services

read, write



Related Commands

Command
Description

debug crypto engine

Displays information about crypto engines encryption and decryption functions.

debug crypto ipsec

Displays IPSec events.

debug crypto isakmp

Displays messages about IKE events.

debug crypto pki

Displays messages about PKI client events.