Cisco IOS High Availability Command Reference
service call-home through show ip pim interface

Table Of Contents

service call-home

service image-version efsu

set (EEM)

set mpls-label

show acircuit checkpoint

show archive

show bfd neighbors

show c7300

show call-home

show ccm clients

show ccm queues

show ccm sessions

show cef nsf

show cef state

show clns interface

show clns neighbors

show configuration lock

show dampening interface

show event manager directory user

show event manager environment

show event manager history events

show event manager history traps

show event manager metric processes

show event manager policy available

show event manager policy pending

show event manager policy registered

show event manager session cli username

show glbp

show interface dampening

show ip bgp

show ip bgp labels

show ip bgp neighbors

show ip bgp vpnv4

show ip bgp vpnv4 all sso summary

show ip cef

show ip multicast redundancy state

show ip multicast redundancy statistics

show ip ospf

show ip ospf neighbor

show ip pim interface


service call-home

To enable the call-home service, use the service call-home command in global configuration mode. To disable the call-home service, use the no form of this command.

service call-home

no service call-home

Syntax Description

This command has no arguments or keywords.

Command Default

Call-home service is disabled.

Command Modes

Global configuration (config)

Command History

Release
Modification

12.2(33)SXH

This command was introduced.

12.2(33)SRC

This command was integrated into Cisco IOS Release 12.2(33)SRC.


Examples

This example shows how to enable the call-home service:

Router(config)# service call-home

This example shows how to disable the call-home service:

Router(config)# no service call-home

Related Commands

Command
Description

call-home (global configuration)

Enters call-home configuration mode.

call-home test

Manually sends a call-home test message.

show call-home

Displays call-home configuration information.


service image-version efsu

To enable Enhanced Fast Software Upgrade (eFSU) functionality, use the no version of the service image-version efsu command in global configuration mode.

no service image-version efsu

Syntax Description

This command has no arguments or keywords.

Defaults

eFSU functionality is not enabled.

Command Modes

Global configuration

Command History

Release
Modification

12.2(33)SRB

This command was introduced.


Usage Guidelines

The no service image-version efsu command functionality is similar to that of the service image-version compatibility command. The no service image-version efsu command is used to omit the compatibility matrix creation for Cisco 7600 series router eFSU images.

Examples

The following example enables eFSU functionality:

Router# no service image-version efsu

Related Commands

Command
Description

issu abortversion

Cancels the ISSU upgrade or downgrade process in progress and restores the router to its state before the process had started.

issu acceptversion

Halts the rollback timer and ensures the new Cisco IOS software image is not automatically aborted during the ISSU process.

issu loadversion

Starts the ISSU process.

issu runversion

Forces a switchover of the active to the standby processor and causes the newly active processor to run the new image.

service image-version compatibility

Enables FSU functionality.


set (EEM)


Note Effective with Cisco IOS Release 12.4(22)T, the set (EEM) command is replaced by the action set (EEM) command. See the action set (EEM) command for more information.


To set the value of a local Embedded Event Manager (EEM) applet variable, use the set command in applet configuration mode. To remove the value of an EEM applet variable, use the no form of this command.

set label variable-name variable-value

no set label variable-name variable-value

Syntax Description

label

Unique identifier that can be any string value. Actions are sorted and run in ascending alphanumeric key sequence using the label as the sort key. If the string contains embedded blanks, enclose it in double quotation marks.

variable-name

The EEM applet variable name. Currently only the _exit_status variable is supported.

variable-value

Integer value that represents the variable. For the _exit_status variable, this is the value that represents the exit status for the applet. Zero represents a successful exit status, and a nonzero value represents a failed exit status.


Command Default

No EEM applet variable values are set.

Command Modes

Applet configuration (config-applet)

Command History

Release
Modification

12.3(14)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(18)SXF4

This command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(18)SXF5

This command was integrated into Cisco IOS Release 12.2(18)SXF5.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

12.4(22)T

This command was replaced by the action set command.


Usage Guidelines

In EEM applet configuration mode, three types of configuration statements are supported. The event commands are used to specify the event criteria to trigger the applet to run, the action commands are used to specify an action to perform when the EEM applet is triggered, and the set command is used to set the value of an EEM applet variable. Currently only the _exit_status variable is supported for the set command.

Examples

The following example shows how to set the _exit_status variable to represent a successful status after an event has occurred three times and an action has been performed:

Router(config)# event manager applet cli-match
Router(config-applet)# event cli pattern {.*interface loopback*} sync yes occurs 3
Router(config-applet)# action 1.0 cli command "no shutdown"
Router(config-applet)# set 1.0 _exit_status 0

Related Commands

Command
Description

event manager applet

Registers an event applet with the Embedded Event Manager and enters applet configuration mode.


set mpls-label

To enable a route to be distributed with a Multiprotocol Label Switching (MPLS) label if the route matches the conditions specified in the route map, use the set mpls-label command in route-map configuration mode. To disable this function, use the no form of this command.

set mpls-label

no set mpls-label

Syntax Description

This command has no arguments or keywords.

Command Default

No route with an MPLS label is distributed.

Command Modes

Route-map configuration

Command History

Release
Modification

12.0(21)ST

This command was introduced.

12.0(22)S

This command was integrated into Cisco IOS Release 12.0(22)S.

12.2(11)S

This command was integrated into Cisco IOS Release 12.2(11)S.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SRB

Support for IPv6 was added.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.


Usage Guidelines

This command can be used only with the neighbor route-map out command to manage outbound route maps for a Border Gateway Protocol (BGP) session.

Use the route-map global configuration command with match and set route-map commands to define the conditions for redistributing routes from one routing protocol into another. Each route-map command has a list of match and set commands associated with it. The match commands specify the match criteria—the conditions under which redistribution is allowed for the current route-map command. The set commands specify the set actions—the particular redistribution actions to perform if the criteria enforced by the match commands are met. The no route-map command deletes the route map.

Examples

The following example shows how to create a route map that enables the route to be distributed with a label if the IP address of the route matches an IP address in ACL1:

Router(config-router)# route-map incoming permit 10
Router(config-route-map)# match ip address 1
Router(config-route-map)# set mpls-label

Related Commands

Command
Description

match ip address

Distributes any routes that have a destination network number address that is permitted by a standard or extended access list.

match ipv6 address

Distributes IPv6 routes that have a prefix permitted by a prefix list or specifies an IPv6 access list to use to match packets for PBR for IPv6.

match mpls-label

Redistributes routes that contain MPLS labels and match the conditions specified in the route map.

neighbor route-map out

Manage outbound route maps for a BGP session.

route-map (IP)

Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing.


show acircuit checkpoint

To display checkpointing information for each attachment circuit (AC), use the show acircuit checkpoint command in privileged EXEC mode.

show acircuit checkpoint

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(25)S

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

12.2(33)SRC

This command was integrated into Cisco IOS Release 12.2(33)SRC.


Usage Guidelines

This command is used for interface-based attachment circuits. For Frame Relay and ATM circuits, use the following commands to show redundancy information:

debug atm ha-error

debug atm ha-events

debug atm ha-state

debug atm l2transport

debug frame-relay redundancy

Examples

The following show acircuit checkpoint command displays information about the ACs that have been check-pointed. The output varies, depending on whether the command output is for the active or standby Route Processor (RP).

On the active RP, the command displays the following output:

Router# show acircuit checkpoint

AC HA Checkpoint info:
Last Bulk Sync: 1 ACs
 AC    IW    XC    Id  VCId   Switch    Segment  St  Chkpt
----  ----  ----  ---  ----  --------  --------  --  -----
HDLC  LIKE  ATOM    3   100      1000      1000   0    N
VLAN  LIKE  ATOM    2  1002      2001      2001   3    Y

On the standby RP, the command displays the following output::

Router# show acircuit checkpoint

AC HA Checkpoint info:
 AC    IW    XC    Id  VCId   Switch    Segment  St  F-SLP
----  ----  ----  ---  ----  --------  --------  --  -----
HDLC  LIKE  ATOM    3   100         0         0   0   001
VLAN  LIKE  ATOM    2  1002      2001      2001   2   000

Table 24 describes the significant fields shown in the display.

Table 24 show acircuit checkpoint Field Descriptions 

Field
Description

Last Bulk Sync

The number of ACs that were sent to the backup RP during the last bulk synchronization between the active and backup RPs.

AC

The type of attachment circuit.

IW

The type of interworking, either like-to-like (AToM) or any-to-any (Interworking).

XC

The type of cross-connect. Only AToM ACs are checkpointed.

ID

This field varies, depending on the type of attachment circuit. For Ethernet VLANs, the ID is the VLAN ID. For PPP and High-Level Data Link Control (HDLC), the ID is the AC circuit ID.

VCID

The configured virtual circuit ID.

Switch

An ID used to correlate the control plane and data plane contexts for this virtual circuit (VC). This is an internal value that is not for customer use.

Segment

An ID used to correlate the control plane and data plane contexts for this VC. This is an internal value that is not for customer use.

St

The state of the attachment circuit. This is an internal value that is not for customer use.

Chkpt

Whether the information about the AC was checkpointed.

F-SLP

Flags that provide more information about the state of the AC circuit. These values are not for customer use.


Related Commands

Command
Description

show mpls l2transport vc

Displays AToM status information.

show mpls l2transport vc checkpoint

Displays the status of the checkpointing process for both the active and standby RPs.


show archive

To display information about the files saved in the Cisco IOS configuration archive, use the show archive command in privileged EXEC mode.

show archive

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(7)T

This command was introduced.

12.2(25)S

This command was integrated into Cisco IOS Release 12.2(25)S.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(31)SB2

This command was implemented on the Cisco 10000 series.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB and implemented on the Cisco 10000 series.


Examples

The following is sample output from the show archive command:

Router# show archive

There are currently 1 archive configurations saved.
The next archive file will be named disk0:myconfig-2
 Archive #  Name
   0 
   1       disk0:myconfig-1 <- Most Recent
   2 
   3 
   4 
   5 
   6 
   7 
   8 
   9 
   10 
   11 
   12 
   13 
   14 

The following is sample output from the show archive command after several archive files of the running configuration have been saved. In this example, the maximum number of archive files to be saved is set to three.

Router# show archive

There are currently 3 archive configurations saved.
The next archive file will be named disk0:myconfig-8
 Archive #  Name
   0        
   1       :Deleted
   2       :Deleted
   3       :Deleted
   4       :Deleted
   5       disk0:myconfig-5
   6       disk0:myconfig-6
   7       disk0:myconfig-7 <- Most Recent
   8
   9
   10
   11
   12
   13
   14

Table 25 describes the significant fields shown in the displays.

Table 25 show archive Field Descriptions 

Field
Description

Archive #

Indicates the number of the running configuration file saved to the Cisco IOS configuration archive. You can set the maximum number of archive files of the running configuration to be saved in the configuration archive. The most recent archive file is the last one shown in the display.

Name

Indicates the name of the running configuration file saved to the Cisco IOS configuration archive.


Related Commands

Command
Description

archive config

Saves a copy of the current running configuration to the Cisco IOS configuration archive.

configure confirm

Confirms replacement of the current running configuration with a saved Cisco IOS configuration file.

configure replace

Replaces the current running configuration with a saved Cisco IOS configuration file.

maximum

Sets the maximum number of archive files of the running configuration to be saved in the Cisco IOS configuration archive.

path

Specifies the location and filename prefix for the files in the Cisco IOS configuration archive.

time-period

Sets the time increment for automatically saving an archive file of the current running configuration in the Cisco IOS configuration archive.


show bfd neighbors

To display a line-by-line listing of existing Bidirectional Forwarding Detection (BFD) adjacencies, use the show bfd neighbors command in user EXEC or privileged EXEC mode.

show bfd neighbors [client {bgp | eigrp | isis | ospf | rsvp | te-frr} | details | [interface type number] | internal | ipv4 ip-address | ipv6 ipv6-address | vrf vrf-name]

Syntax Description

client

(Optional) Displays neighbors of a specific client.

bgp

Specifies a Border Gateway Protocol (BGP) client.

eigrp

Specifies an EIGRP client.

isis

Specifies an IS-IS client.

ospf

Specifies an Open Shortest Path First (OSPF) client.

rsvp

Specifies an RSVP client.

te-frr

Specifies a TE-FRR client.

details

(Optional) Displays all BFD protocol parameters and timers for each neighbor.

interface type number

(Optional) Displays neighbors at a specified interface.

internal

(Optional) Displays internal BFD information

ipv4

(Optional) Specifies an IPv4 neighbor. If the ipv4 keyword is used without the optional ip-address argument, all IPv4 sessions are displayed.

ip-address

(Optional) IP address of a neighbor, in A.B.C.D format.

ipv6

(Optional) Specifies an IPv6 neighbor. If the ipv6 keyword is used without the optional ipv6-address argument, all IPv6 sessions are displayed.

ipv6-address

(Optional) IPv6 address of a neighbor, in X:X:X:X::X format.

vrf vrf-name

(Optional) Displays entries for a specific Virtual Private Network (VPN) routing and forwarding (VRF) instance.


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

0S Release
Modification

12.0(31)S

This command was integrated into Cisco IOS Release 12.0(31)S.

S Release
Modification

12.2(18)SXE

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SRC

The vrf vrf-name keyword and argument, the client keyword, and the ip-address argument were added in this release.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB.

12.2(33)SRE

This command was modified. Support for IPv6 was added.

T Release
Modification

12.4(4)T

This command was integrated into Cisco IOS Release 12.4(4)T.

12.4(9)T

Support for BFD Version 1 and BFD echo mode was added.

X Release
Modification

Cisco IOS XE Release 2.1

Support for IPv6 was added.


Usage Guidelines

The show bfd neighbors command can be used to help troubleshoot the BFD feature.

The full output for the details keyword is not supported on the Route Processor (RP) for the Cisco 12000 series Internet router. If you want to enter the show bfd neighbors command with the details keyword for the Cisco 12000 series Internet router, you must enter it on the line card. Use the attach slot command to establish a command-line interface (CLI) session with a line card.

Examples

Examples for 12.0(31)S, 12.2(18)SXE, 12.2(33)SRA, 12.2(33)SB, and 12.4(4)T

The following sample output shows the status of the adjacency or neighbor:

Router# show bfd neighbors

OurAddr       NeighAddr      LD/RD RH  Holdown(mult) State     Int
172.16.10.1   172.16.10.2    1/6  1   260  (3 )      Up        Fa0/1 

The following sample output from the show bfd neighbors command entered with the details keyword shows BFD protocol parameters and timers for each neighbor:

Router# show bfd neighbors details 

NeighAddr                         LD/RD    RH/RS     State     Int
10.1.1.2                           1/1         1(RH) Up        Et0/0
Session state is UP and not using echo function.
OurAddr: 10.1.1.1       
Local Diag: 0, Demand mode: 0, Poll bit: 0
MinTxInt: 50000, MinRxInt: 50000, Multiplier: 3 Received MinRxInt: 50000, Received 
Multiplier: 3 Holddown (hits): 150(0), Hello (hits): 50(2223) Rx Count: 2212, Rx Interval 
(ms) min/max/avg: 8/68/49 last: 0 ms ago Tx Count: 2222, Tx Interval (ms) min/max/avg: 
40/60/49 last: 20 ms ago Elapsed time watermarks: 0 0 (last: 0) Registered protocols: CEF 
Stub
Uptime: 00:01:49
Last packet: Version: 0                  - Diagnostic: 0
             I Hear You bit: 1           - Demand bit: 0
             Poll bit: 0                 - Final bit: 0
             Multiplier: 3               - Length: 24
             My Discr.: 1                - Your Discr.: 1
             Min tx interval: 50000      - Min rx interval: 50000
             Min Echo interval: 50000 

The following sample output from the RP on a Cisco 12000 series router shows the status of the adjacency or neighbor:

Router# show bfd neighbors

Cleanup timer hits: 0

OurAddr       NeighAddr     LD/RD RH  Holdown(mult)  State     Int
172.16.10.2   172.16.10.1    2/0  0   0    (0 )      Up        Fa6/0          
 Total Adjs Found: 1

The following sample output from the RP on a Cisco 12000 series router shows the status of the adjacency or neighbor with the details keyword:

RouterB# show bfd neighbors details

Cleanup timer hits: 0

OurAddr       NeighAddr     LD/RD RH  Holdown(mult)  State     Int
172.16.10.2   172.16.10.1    2/0  0   0    (0 )      Up        Fa6/0          
Registered protocols: OSPF
Uptime: never
%% BFD Neighbor statistics are not available on RP. Please execute this command on Line 
Card.

The following sample output from a line card on a Cisco 12000 series router shows the status of the adjacency or neighbor:

Router# attach 6

Entering Console for 8 Port Fast Ethernet in Slot: 6
Type "exit" to end this session

Press RETURN to get started!

Router> show bfd neighbors

Cleanup timer hits: 0

OurAddr       NeighAddr     LD/RD RH  Holdown(mult)  State     Int
172.16.10.2   172.16.10.1    2/1  1   848  (5 )      Up        Fa6/0          
 Total Adjs Found: 1

The following sample output from a line card on a Cisco 12000 series router shows the status of the adjacency or neighbor with the details keyword:

Router# attach 6

Entering Console for 8 Port Fast Ethernet in Slot: 6
Type "exit" to end this session

Press RETURN to get started!

Router> show bfd neighbors details

Cleanup timer hits: 0

OurAddr       NeighAddr     LD/RD RH  Holdown(mult)  State     Int
172.16.10.2   172.16.10.1    2/1  1   892  (5 )      Up        Fa6/0          
Local Diag: 0, Demand mode: 0, Poll bit: 0
MinTxInt: 50000, MinRxInt: 1000, Multiplier: 3
Received MinRxInt: 200000, Received Multiplier: 5
Holdown (hits): 1000(0), Hello (hits): 200(193745)
Rx Count: 327406, Rx Interval (ms) min/max/avg: 152/248/196 last: 108 ms ago
Tx Count: 193748, Tx Interval (ms) min/max/avg: 204/440/331 last: 408 ms ago
Last packet: Version: 0            - Diagnostic: 0
             I Hear You bit: 1     - Demand bit: 0
             Poll bit: 0           - Final bit: 0
             Multiplier: 5         - Length: 24
             My Discr.: 1          - Your Discr.: 2
             Min tx interval: 200000    - Min rx interval: 200000
             Min Echo interval: 0
Uptime: 17:54:07
SSO Cleanup Timer called: 0
SSO Cleanup Action Taken: 0
Pseudo pre-emptive process count: 7728507 min/max/avg: 8/16/8 last: 12 ms ago
 IPC Tx Failure Count: 0
 IPC Rx Failure Count: 0
 Total Adjs Found: 1
LC-Slot6>

Example for 12.4(9)T and Later Releases

The following sample output verifies that the BFD neighbor router is also running BFD Version 1 and that the BFD session is up and running in echo mode:

Router# show bfd neighbors details 

OurAddr       NeighAddr     LD/RD  RH/RS   Holdown(mult)  State     Int
172.16.1.2    172.16.1.1     1/6    Up        0    (3 )   Up        Fa0/1       
Session state is UP and using echo function with 50 ms interval.
Local Diag: 0, Demand mode: 0, Poll bit: 0
MinTxInt: 1000000, MinRxInt: 1000000, Multiplier: 3
Received MinRxInt: 1000000, Received Multiplier: 3
Holdown (hits): 3000(0), Hello (hits): 1000(337)
Rx Count: 341, Rx Interval (ms) min/max/avg: 1/1008/882 last: 364 ms ago
Tx Count: 339, Tx Interval (ms) min/max/avg: 1/1016/886 last: 632 ms ago
Registered protocols: EIGRP
Uptime: 00:05:00
Last packet: Version: 1            - Diagnostic: 0
             State bit: Up         - Demand bit: 0
             Poll bit: 0           - Final bit: 0
             Multiplier: 3         - Length: 24
             My Discr.: 6          - Your Discr.: 1
             Min tx interval: 1000000    - Min rx interval: 1000000
             Min Echo interval: 50000

Example for Cisco IOS XE Release 2.1 and Later Releases

The following example displays all IPv6 sessions:

Router# show bfd neighbors ipv6 2001::1

OurAddr    NeighAddr  LD/RD  RH/RS  Holddown(mult)  State  Int
1:1::5     1:1::6      2/2    Up        0    (3 )   Up     Et0/0
2:2::5     2:2::6      4/4    Up        0    (3 )   Up     Et1/0

Table 26 describes the significant fields shown in the display.

Table 26 show bfd neighbors Field Descriptions 

Field
Description

OurAddr

IP address of the interface for which the show bfd neighbors command was entered.

NeighAddr

IPv4 or IPv6 address of the BFD adjacency or neighbor.

LD/RD

Local discriminator and remote discriminator being used for the session.

RH

Remote Heard—Indicates that the remote BFD neighbor has been heard.

Holdown(mult)

The detect timer multiplier that is used for this session.

State

State of the interface—Up or Down.

Int

Interface type and slot/port.

Session state is UP and using echo function with 50 ms interval.

BFD is up and running in echo mode. The 50-millisecond interval has been adopted from the bfd command.

Note BFD Version 1 and echo mode are supported only with Cisco IOS Release 12.4(9)T and later releases.

RX Count

Number of BFD control packets that have been received from the BFD neighbor.

TX Count

Number of BFD control packets that have been sent by the BFD neighbor.

TX Interval

The interval, in milliseconds, between sent BFD packets.

Registered protocols

Routing protocols that have been registered with BFD.

Last packet: Version:

BFD version detected and run between the BFD neighbors. The system automatically performs BFD version detection, and BFD sessions between neighbors will run in the highest common BFD version between neighbors. For example, if one BFD neighbor is running BFD Version 0, and the other BFD neighbor is running Version 1, the session will run BFD Version 0.

Note BFD Version 1 and echo mode are supported only with Cisco IOS Release 12.4(9)T and later releases.

Diagnostic

A diagnostic code specifying the local system's reason for the last transition of the session from Up to some other state.

State values are as follows:

0—No Diagnostic

1—Control Detection Time Expired

2—Echo Function Failed

3—Neighbor Signaled Session Down

4—Forwarding Plane Reset

5—Path Down

6—Concentrated Path Down

7—Administratively Down

I Hear You bit

I Hear You Bit. This bit is set to 0 if the transmitting system either is not receiving BFD packets from the remote system or is tearing down the BFD session for some reason. During normal operation the I Hear You bit is set to 1 to signify that the remote system is receiving the BFD packets from the transmitting system.

Demand bit

Demand Mode bit. If set, the transmitting system wants to operate in demand mode. BFD has two modes—asynchronous and demand. The Cisco implementation of BFD supports only asynchronous mode.

Poll bit

Poll bit. If the Poll bit is set, the transmitting system is requesting verification of connectivity or of a parameter change.

Final bit

Final bit. If the Final bit is set, the transmitting system is responding to a received BFD control packet that had a Poll (P) bit set.

Multiplier

Detect time multiplier. The negotiated transmit interval, multiplied by the detect time multiplier, determines the detection time for the transmitting system in BFD asynchronous mode.

The detect time multiplier is similar to the hello multiplier in Intermediate System-to-Intermediate System (IS-IS), which is used to determine the hold timer: (hello interval) * (hello multiplier) = hold timer. If a hello packet is not received within the hold-timer interval, a failure has occurred.

Similarly, for BFD: (transmit interval) * (detect multiplier) = detect timer. If a BFD control packet is not received from the remote system within the detect-timer interval, a failure has occurred.

Length

Length of the BFD control packet, in bytes.

My Discr.

My Discriminator. Unique, nonzero discriminator value generated by the transmitting system used to demultiplex multiple BFD sessions between the same pair of systems.

Your Discr.

Your Discriminator. The discriminator received from the corresponding remote system. This field reflects the received value of My Discriminator, or is zero if that value is unknown.

Min tx interval

Minimum transmission interval, in microseconds, that the local system wants to use when sending BFD control packets.

Min rx interval

Minimum receipt interval, in microseconds, between received BFD control packets that the system can support.

Min Echo interval

Minimum interval, in microseconds, between received BFD control packets that the system can support. If the value is zero, the transmitting system does not support the receipt of BFD echo packets.

The Cisco implementation of BFD for Cisco IOS Releases 12.2(18)SXE and 12.0(31)S does not support the use of echo packets.


Related Commands

Command
Description

attach

Connects to a specific line card for the purpose of executing monitoring and maintenance commands on that line card only.


show c7300

To display the types and status of cards installed in a Cisco 7304 router, use the show c7300 command in privileged EXEC mode.

show c7300

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(9)EX

This command was introduced.

12.1(10)EX

The output of this command was enhanced to include information about Field-Programmable Gate Array (FPGA) images.

12.1(10)EX2

The output of this command was enhanced to include information about a standby route processor (RP).

12.2(18)S

This command was integrated into Cisco IOS Release 12.2(18)S.

12.2(20)S

Support was added for the Cisco 7304 router.

12.2(20)S2

Support was added for modular services cards (MSCs) and shared port adapters (SPAs) on the Cisco 7304 router.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

This command displays the types and status of cards installed in a Cisco 7304 router (such as network services engines [NSEs], RPs, line cards, MSCs, and SPAs), and information about incompatible FPGA images. When the bundled and current FPGA images are compatible, they are not displayed.

This command also displays whether your system is in compliance with line card configuration guidelines. For NSEs and line cards, empty slots are not displayed in the output. However, for SPAs, several status values are reported, including an empty subslot, which is reported as "missing."

If your system contains an unsupported line card or RP with no matching bundled FPGA image in Cisco IOS software, then this command displays "None" instead of the bundled FPGA version number.

Use this command to display information about the status of the active and standby NSEs.

Examples

The following example displays information about a Cisco 7304 router that has current FPGA images:

Router# show c7300

Slot      Card Type           Status          Insertion time
----      ---------           ------          --------------
0,1       NSE-100             Active          00:13:16 ago
4         1OC48-POS           Active          00:01:43 ago

System is compliant with hardware configuration guidelines.

All the FPGAs in the system are up-to-date

Network IO Interrupt Throttling:
 throttle count=3, timer count=3
 active=0, configured=1
 netint usec=3999, netint mask usec=200

The following example displays information about a Cisco 7304 router that has incompatible FPGA images that need to be updated. If your system contains an unsupported line card or RP with no matching bundled FPGA image in Cisco IOS software, "None" is displayed instead of a bundled FPGA version number.

Router# show c7300

Slot      Card Type           Status          Insertion time
----      ---------           ------          --------------
0,1       NSE-100             Active          00:02:26 ago
4         6T3                 Active          00:02:23 ago
5         6T3                 Active          00:02:23 ago

System is compliant with hardware configuration guidelines.

%WARNING:The following FPGAs in the system may need an update.

Slot      Card Type           Current FPGA    Bundled FPGA    
----      ---------           ------------    ------------    
0         NSE-100 (MB)        0.12            None            

Network IO Interrupt Throttling:
 throttle count=0, timer count=0
 active=0, configured=1
 netint usec=3999, netint mask usec=200

The following example displays sample output information about the redundancy status of the NSEs installed in the system. In the following example, the active RP is the NSE-100 installed in slot 0 and slot 1. The standby is the NSE-100 installed in slot 2 and slot 3.

Router# show c7300

Slot      Card Type           Status          Insertion time
----      ---------           ------          --------------
0,1       NSE-100             Active          00:02:03 ago
2,3       NSE-100             Standby         00:02:03 ago
4         4OC3-POS            Active          00:01:59 ago
5         6T3                 Active          00:01:59 ago

System is compliant with hardware configuration guidelines.

Network IO Interrupt Throttling:
 throttle count=0, timer count=0
 active=0, configured=1
 netint usec=3999, netint mask usec=200

The following example displays information about a Cisco 7304 router with an NSE-100, MSC-100s, and 4-Port 10/100 Fast Ethernet SPAs:

Router# show c7300

Slot      Card Type           Status          Insertion time
----      ---------           ------          --------------
0,1       NSE100              Active          00:45:29 ago
2         7304-MSC-100        Active          00:44:36 ago
3         7304-MSC-100        Active          00:44:36 ago
4         7304-MSC-100        Active          00:44:36 ago
5         7304-MSC-100        Active          00:14:39 ago

The FPGA versions for the cards listed above are current

Shared Port Adapter information:
Slot/Subslot  SPA Type            Status          Insertion time
------------  --------            ------          --------------
2/0           SPA-4FE-7304        ok              00:44:36 ago
2/1           SPA-4FE-7304        ok              00:44:36 ago
3/0           SPA-4FE-7304        ok              00:44:35 ago
3/1           not present         missing         never
4/0           SPA-4FE-7304        ok              00:44:35 ago
4/1           SPA-4FE-7304        ok              00:44:35 ago
5/0           SPA-4FE-7304        ok              00:14:36 ago
5/1           SPA-4FE-7304        ok              00:14:36 ago

Network IO Interrupt Throttling:
 throttle count=1, timer count=1
 active=0, configured=1
 netint usec=3999, netint mask usec=200

Table 27 provides a description for each of the possible status fields for SPAs.

Table 27 SPA Status Field Descriptions

Status Field for SPAs
Description

booting

SPA is initializing.

failed

SPA is powered off due to five automatic recovery failures.

FW mismatch

An FPGA version mismatch with the Cisco IOS software has been detected for the SPA.

missing

SPA is not present in the MSC subslot.

not allowed online

SPA is not supported.

ok

SPA is operational.

stopped

SPA is deactivated by the hw-module subslot stop command.

unknown

SPA is in unrecognizable state.


Related Commands

Command
Description

show c7300 errorlog

Displays error information about a Cisco 7304 router.

show diag

Displays hardware information for any slot or the chassis.

show redundancy (7300)

Displays redundancy information for the active and standby NSEs.

show version

Displays the configuration of the system hardware, the number of each interface type installed, the Cisco IOS software version, the names and sources of configuration files, and the boot images. Displays the configuration of the ROM monitor.


show call-home

To display the configured call-home information, use the show call-home command in privileged EXEC mode.

show call-home [alert-group | detail | mail-server | profile {all | name} | statistics]

Syntax Description

alert-group

(Optional) Displays the available alert group.

detail

(Optional) Displays the call-home configuration in detail.

mail-server

(Optional) Displays the call-home mail server-related information.

profile all

(Optional) Displays configuration information for all existing profiles.

profile name

(Optional) Displays configuration information for a specific destination profile.

statistics

(Optional) Displays the call-home statistics.


Command Default

This command has no default settings.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SXH

This command was introduced.


Examples

The following example displays the configured call-home settings:

Router# show call-home

Current call home settings:
    call home feature : disable
    call home message's from address: switch@example.com
    call home message's reply-to address: support@example.com
    contact person's email address: technical@example.com
    contact person's phone number: +1-111-111-1111
    street address: 1234 Any Street, Any city, Any state, 12345
    customer ID: ExampleCorp
    contract ID: X123456789
    site ID: SantaClara
    Mail-server[1]: Address: smtp.example.com Priority: 1
    Mail-server[2]: Address: 192.168.0.1 Priority: 2
    Rate-limit: 20 message(s) per minute

Available alert groups:
    Keyword                  State   Description
    ------------------------ ------- -------------------------------
    configuration            Disable configuration info
    diagnostic               Disable diagnostic info
    environment              Disable environmental info
    inventory                Enable  inventory info
    syslog                   Disable syslog info

Profiles:
    Profile Name: campus-noc
    Profile Name: CiscoTAC-1

The following example displays detailed call-home configuration information:

Router# show call-home detail 

Current call home settings:
    call home feature : disable
    call home message's from address: switch@example.com
    call home message's reply-to address: support@example.com
    contact person's email address: technical@example.com
    contact person's phone number: +1-111-111-1111
    street address: 1234 Any Street, Any city, Any state, 12345
    customer ID: ExampleCorp
    contract ID: X123456789
    site ID: SantaClara
    Mail-server[1]: Address: smtp.example.com Priority: 1
    Mail-server[2]: Address: 192.168.0.1 Priority: 2
    Rate-limit: 20 message(s) per minute

Available alert groups:
    Keyword                  State   Description
    ------------------------ ------- -------------------------------
    configuration            Disable configuration info
    diagnostic               Disable diagnostic info
    environment              Disable environmental info
    inventory                Enable  inventory info
    syslog                   Disable syslog info

Profiles:
    Profile Name: campus-noc
    Profile status: ACTIVE
    Preferred Message Format: long-text
    Message Size Limit: 3145728 Bytes
    Preferred Transport Method: email
    Email address(es): noc@example.com
    HTTP  address(es): Not yet set up

    Alert-group               Severity
    ------------------------  ------------
    inventory                 normal      

    Syslog-Pattern            Severity
    ------------------------  ------------
    N/A                       N/A

Profile Name: CiscoTAC-1
    Profile status: INACTIVE
    Preferred Message Format: xml
    Message Size Limit: 3145728 Bytes
    Preferred Transport Method: email
    Email address(es): callhome@cisco.com
    HTTP  address(es): Not yet set up

    Periodic configuration info message is scheduled every 1 day of the month at 09:27

    Periodic inventory info message is scheduled every 1 day of the month at 09:12

    Alert-group               Severity
    ------------------------  ------------
    diagnostic                minor       
    environment               minor       

    Syslog-Pattern            Severity
    ------------------------  ------------
    .*                        major       

The following example displays available call home alert groups:

Router# show call-home alert-group 

Available alert groups:
    Keyword                  State   Description
    ------------------------ ------- -------------------------------
    configuration            Disable configuration info
    diagnostic               Disable diagnostic info
    environment              Disable environmental info
    inventory                Enable  inventory info
    syslog                   Disable syslog info

The following example displays e-mail server status information:

Router# show call-home mail-server status

Please wait. Checking for mail server status ...

Translating "smtp.example.com"
    Mail-server[1]: Address: smtp.example.com Priority: 1 [Not Available]
    Mail-server[2]: Address: 192.168.0.1 Priority: 2 [Not Available]

The following example displays information for all predefined and user-defined profiles:

Router# show call-home profile all

Profile Name: campus-noc
Profile status: ACTIVE
    Preferred Message Format: long-text
    Message Size Limit: 3145728 Bytes
    Preferred Transport Method: email
    Email address(es): noc@example.com
    HTTP  address(es): Not yet set up

    Alert-group               Severity
    ------------------------  ------------
    inventory                 normal 

    Syslog-Pattern            Severity
    ------------------------  ------------
    N/A                       N/A

Profile Name: CiscoTAC-1
    Profile status: INACTIVE
    Preferred Message Format: xml
    Message Size Limit: 3145728 Bytes
    Preferred Transport Method: email
    Email address(es): callhome@cisco.com
    HTTP  address(es): Not yet set up

    Periodic configuration info message is scheduled every 1 day of the month at 09:27

    Periodic inventory info message is scheduled every 1 day of the month at 09:12

    Alert-group               Severity
    ------------------------  ------------
    diagnostic                minor       
    environment               minor       

    Syslog-Pattern            Severity
    ------------------------  ------------
    .*                        major       

The following example displays information for a user-defined destination profile:

Router# show call-home profile campus-noc

Profile Name: campus-noc
    Profile status: ACTIVE
    Preferred Message Format: long-text
    Message Size Limit: 3145728 Bytes
    Preferred Transport Method: email
    Email address(es): noc@example.com
    HTTP  address(es): Not yet set up

    Alert-group               Severity
    ------------------------  ------------
    inventory                 normal      

    Syslog-Pattern            Severity
    ------------------------  ------------
    N/A                       N/A

The following example displays the call-home statistics:

Router# show call-home statistics 

Successful Call-Home Events: 0

Dropped Call-Home Events due to Rate Limiting: 0

Related Commands

Command
Description

call-home (global configuration)

Enters call-home configuration mode.

call-home send alert-group

Sends a specific alert group message.

service call-home

Enables or disables call home.


show ccm clients

To display information about cluster control manager (CCM) clients on high availability (HA), dual Route Processor systems, use the show ccm clients command in privileged EXEC mode.

show ccm clients

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(31)SB2

This command was introduced.

12.2(33)SRC

This command was integrated into Cisco IOS Release 12.2(33)SRC.


Usage Guidelines

The CCM manages the capability to synchronize session initiation on the standby processor of a dual Route Processor HA system. Use the show ccm clients command to display information about CCM clients.

Examples

The following is sample output from the show ccm clients command on a router's active processor:

Router# show ccm clients

CCM bundles sent since peer up:
                                        Sent            Queued for flow control
    Sync Session                        10              1
    Update Session                      6               1
    Active Bulk Sync End                1               0
    Session Down                        10              0
    ISSU client msgs                    115             0
    Dynamic Session Sync                0               0
    Unknown msgs                        0               0
Client events sent since peer up:
    PPP                                 66
    PPPoE                               0
    PPPoA                               0
    AAA                                 44
    PPP SIP                             11
    LTERM                               11
    AC                                  0
    SSS FM                              0
    IP SIP                              0
    IP IF                               0
    DPM                                 0
    COA                                 0

The following is sample output from the show ccm clients command on a router's standby processor:

Router# show ccm clients

CCM bundles rcvd since last boot:
    Sync Session                8
    Update Session              0
    Active Bulk Sync            1
    Session Down                8
    ISSU client msgs            59
    Dynamic Session Sync        0
    Unknown msgs                0

Client events extracted since last boot:
    PPP                         72
    PPPoE                       50
    PPPoA                       0
    AAA                         32
    PPP SIP                     0
    LTERM                       8
    AC                          0
    SSS FM                      0
    IP SIP                      0
    IP IF                       0
    DPM                         0
    COA                         0
    Auto Svc                    0

Table 28 describes the significant fields shown in the display. Any data not described in Table 28 is used for Cisco internal debugging purposes.

c

Table 28 show ccm clients Field Descriptions 

Field
Description

Sent

Number of CCM bundles sent by the active processor since initiation on the standby processor.

Queued for flow control

Number of the following types of CCM bundles queued on the active processor when flow control is OFF since initiation on the standby processor:

Sync Session—Synchronization session bundles.

Update Session—Individual client update to session bundles.

Active Bulk Sync—Active processor bulk synchronization bundles.

Session Down—Session down bundles.

ISSU client msgs—In service software upgrade (ISSU) bundles.

Dynamic Session Sync—Dynamic cluster update to session bundles.

Unknown msgs—Unknown message bundles.

. The queued bundles will be sent when flow control is ON again.

Client events sent since peer up

Number of client events sent since initiation on the standby processor.

CCM bundles rcvd since last boot

Number of the following types of CCM bundles received by the standby processor since initiation:

Sync Session—Synchronization session bundles.

Update Session—Individual client update to session bundles.

Active Bulk Sync—Active processor bulk synchronization bundles.

Session Down—Session down bundles.

ISSU client msgs—ISSU bundles.

Dynamic Session Sync—Dynamic cluster update to session bundles.

Unknown msgs—Unknown message bundles.

Client events extracted since last boot

Number of client events extracted since initiation on the standby processor.


Related Commands

Command
Description

show ccm queues

Displays CCM queue statistics.

show ccm sessions

Displays CCM session information.


show ccm queues

To display cluster control manager (CCM) queue statistics for high availability (HA) dual Route Processor systems, use the show ccm queues command in privileged EXEC mode.

show ccm queues

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(31)SB2

This command was introduced.

12.2(33)SRC

This command was integrated into Cisco IOS Release 12.2(33)SRC.


Usage Guidelines

The CCM manages the capability to synchronize session initiation on the standby processor of a redundant processor HA system. Use the show ccm queues command to display queue statistics for CCM sessions on active and standby processors. This command is generally used only by Cisco engineers for internal debugging of CCM processes.

Examples

The following is sample output from the show ccm queues command. No field descriptions are provided because command output is used for Cisco internal debugging purposes only.

Router# show ccm queues

8 Event Queues
                 size   max      kicks     starts    false   suspends  ticks(ms)
 4 CCM              0     7      16167      16168        1          0        20

 Event Names
                          Events  Queued  MaxQueued  Suspends  usec/evt max/evt
 1  4 Sync Session              0        0        0        0         0         0
 2  4 Sync Client               0        0        0        0         0         0
 3  4 Update                    0        0        0        0         0         0
 4  4 Session Down              0        0        0        0         0         0
 5  4 Bulk Sync Begi            1        0        1        0         0         0
 6  4 Bulk Sync Cont            2        0        2        0         0         0
 7  4 Bulk Sync End             1        0        1        0         0         0
 8  4 Rcv Bulk End              0        0        0        0         0         0
 9  4 Dynamic Sync C            0        0        0        0         0         0
10  4 Going Active              0        0        0        0         0         0
11  4 Going Standby             0        0        0        0         0         0
12  4 Standby Presen            1        0        1        0         0         0
13  4 Standby Gone              0        0        0        0         0         0
15  4 CP Message              188        0        7        0         0         0
16  4 Recr Session              0        0        0        0         0         0
17  4 Recr Update               0        0        0        0         0         0
18  4 Recr Sess Down            0        0        0        0         0         0
19  4 ISSU Session N            1        0        1        0         0         0
20  4 ISSU Peer Comm            0        0        0        0         0         0
21  4 Free Session          16103        0        1        0         0         0
22  4 Sync Dyn Sessi            0        0        0        0         0         0
23  4 Recr Dyn Sessi            0        0        0        0         0         0
24  4 Session Ready             0        0        0        0         0         0

FSM Event Names           Events
 0    Invalid                   0
 1    All Ready                 0
 2    Required Not Re           0
 3    Update                    0
 4    Down                  16103
 5    Error                     0
 6    Ready                     0
 7    Not Syncable              0
 8    Recreate Down             0

Related Commands

Command
Description

show ccm clients

Displays CCM client information.

show ccm sessions

Displays CCM session information.


show ccm sessions

To display information about cluster control manager (CCM) sessions on high availability (HA) dual Route Processor systems, use the show ccm sessions command in privileged EXEC mode.

show ccm sessions

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(31)SB2

This command was introduced.

12.2(33)SRC

This command was integrated into Cisco IOS Release 12.2(33)SRC.


Usage Guidelines

The CCM manages the capability to synchronize session initiation on the standby processor of a redundant processor HA system. Use the show ccm sessions command to display information on CCM sessions on active and standby processors, and also to display information on subscriber redundancy policies configured using the subscriber redundancy command.

Examples

The following is sample output from the show ccm sessions command on a Cisco 10000 series router active processor:

Router# show ccm sessions

Global CCM state:                                CCM HA Active - Dynamic Sync
Global ISSU state:                               Compatible, Clients Cap 0x0
	Number of sessions in state Down:                0
	Number of sessions in state Not Ready:           0
	Number of sessions in state Ready:               0
	Number of sessions in state Dyn Sync:            0

Timeout: Timer Type   Delay    Remaining Starts    CPU Limit CPU Last
		------------ -------- --------- --------- --------- --------
		Rate         00:00:01 	-         2         -         -       
		Dynamic CPU  00:00:10 	-         0         90        0 

The following is sample output from the show ccm sessions command on a Cisco 10000 series router standby processor:

Router# show ccm sessions

Global CCM state:                        CCM HA Standby - Collecting
Global ISSU state:                       Compatible, Clients Cap 0xFFE

                                         Current     Bulk Sent   Bulk Rcvd
                                         ----------- ----------- -----------
Number of sessions in state Down:        0           0           0          
Number of sessions in state Not Ready:   0           0           0          
Number of sessions in state Ready:       0           0           0          
Number of sessions in state Dyn Sync:    0           0           0          

Timeout: Timer Type   Delay    Remaining Starts      CPU Limit CPU Last
         ------------ -------- --------- ----------- --------- --------
         Rate         00:00:01 -         0           -         -       
         Dynamic CPU  00:00:10 -         0           90        0       
         Bulk Time Li 00:08:00 -         0           -         -       
         RF Notif Ext 00:00:20 -         0           -         -       

The following is sample output from the show ccm sessions command on a Cisco 7600 series router active processor:

Router# show ccm sessions

Global CCM state:                                CCM HA Active - Dynamic Sync
Global ISSU state:                               Compatible, Clients Cap 0xFFFE

										Current     Bulk Sent   Bulk Rcvd
                                         ----------- ----------- -----------
Number of sessions in state Down:        0           0           0          
Number of sessions in state Not Ready:   7424        0           0          
Number of sessions in state Ready:       0           0           0          
Number of sessions in state Dyn Sync:    20002       28001       0 
Timeout: Timer Type   Delay    Remaining Starts      CPU Limit CPU Last
         ------------ -------- --------- ----------- --------- --------
Rate         00:00:01 -         924         -         -       
         Dynamic CPU  00:00:10 -         0           90        2       
         Bulk Time Li 00:08:00 -         0           -         -       
         RF Notif Ext 00:00:20 -         18          -         - 

The following is sample output from the show ccm sessions command on a Cisco 7600 series router standby processor:

Router# show ccm sessions

Global CCM state:                        CCM HA Standby - Collecting
Global ISSU state:                       Compatible, Clients Cap 0xFFE

                                         Current     Bulk Sent   Bulk Rcvd
                                         ----------- ----------- -----------
Number of sessions in state Down:        0           0           0          
Number of sessions in state Not Ready:   8038        0           0          
Number of sessions in state Ready:       20002       0           28001      
Number of sessions in state Dyn Sync:    0           0           0 
Timeout: Timer Type   Delay    Remaining Starts      CPU Limit CPU Last
         ------------ -------- --------- ----------- --------- --------
Rate         00:00:01 -         0           -         -       
         Dynamic CPU  00:00:10 -         0           90        0       
         Bulk Time Li 00:08:00 -         1           -         -       
         RF Notif Ext 00:00:20 -         0           -         - 

Table 29 describes the significant fields shown in the display. Any data not described in the table is used for Cisco internal debugging.

Table 29 show ccm sessions Field Descriptions 

Field
Description

Global CCM state

Displays the processor's active or standby status and its CCM state. For example:

CCM HA Active - Dynamic Sync means that this is the active processor, standby is in STANDBY_HOT state, and CCM is ready to synchronize sessions.

CCM HA Active - Collecting means that this is the active processor and there is no standby processor. CCM can collect sessions but cannot synchronize them to a standby processor.

CCM HA Active - Bulk Sync means that this is the active processor and a standby processor is booting up. CCM is doing a bulk synchronization of sessions.

CCM HA Standby- Collecting means that this is the standby processor and is in STANDBY_HOT state. CCM is collecting sessions for synchronizing if a switchover happens.

Global ISSU state

Compatible, Clients Cap 0xFFFE0 indicates that CCM is compatible for in-service software upgrade (ISSU) clients—that is, ISSU-compatible Cisco IOS versions are running on both processors. It also means that CCM has the client capability for the clients in the bitmask 0xFFFE.

Current

CCM sessions currently ready for synchronization.

Bulk Sent

CCM sessions sent during bulk synchronization.

Bulk Rcvd

CCM sessions received during bulk synchronization.

Number of sessions in state Down

Sessions in the down state.

Number of sessions in state Not Ready

Sessions in the not ready state.

Number of sessions in state Ready

Sessions in the ready state.

Number of sessions in state Dyn Sync

Sessions in the dynamic synchronization state.

Timeout

Displays statistics for the following timers:

Rate—Monitors the number of sessions to be synchronized per configured time period.

Dynamic CPU—Monitors CPU limit, number of sessions, delay, and allowed calls configured for dynamic synchronization parameters.

Bulk Time Li—Monitors the time limit configured for bulk synchronization.

RF Notif Ext—Monitors redundancy facility (RF) active and standby state progressions and events.

Use the subscriber redundancy command to modify parameters that these timers monitor.

Delay

Timer delay (in hh:mm:ss) for bulk and dynamic synchronization for subscriber sessions.

Remaining

Indicates remaining time in seconds before the timer expires.

Starts

Indicates the number of times the timer started.

CPU Limit

CPU usage percentage, a configurable value; default is 90 percent.

CPU Last

Indicates the last time that the CPU limit timer was running.


Related Commands

Command
Description

show ccm clients

Displays CCM client information.

show ccm queues

Displays CCM queue information.

subscriber redundancy

Configures subscriber session redundancy policies.


show cef nsf

To show the current Cisco nonstop forwarding (NSF) state of Cisco Express Forwarding on both the active and standby Route Processors (RPs), use the show cef nsf command in privileged EXEC mode.

show cef nsf

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(22)S

This command was introduced.

12.2(18)S

This command was integrated into Cisco IOS Release 12.2(18)S.

12.2(20)S

Support for the Cisco 7304 router was added.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.


12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.


Usage Guidelines

If you enter the show cef nsf command before a switchover occurs, no switchover activity is reported. After a switchover occurs, you can enter the show cef nsf command to display details about the switchover as reported by the newly active RP. On the Cisco 12000 and 7500 series Internet routers, details about line card switchover are also provided.

Examples

The following example shows the current NSF state:

Router# show cef nsf

Last switchover occurred:        00:01:30.088 ago
 Routing convergence duration:   00:00:34.728
 FIB stale entry purge durations:00:00:01.728 - Default
                                  00:00:00.088 - Red

          Switchover
 Slot    Count   Type   Quiesce Period
 1           2    sso   00:00:00.108
 2           1   rpr+   00:00:00.948
 3           2    sso   00:00:00.152
 5           2    sso   00:00:00.092
 6           1   rpr+   00:00:00.632

 No NSF stats available for the following linecards:4 7

Table 30 describes the significant fields shown in the display.

Table 30 show cef nsf Field Descriptions 

Field
Description

Last switchover occurred

Time since the last system switchover.

Routing convergence duration

Time taken after the switchover before the routing protocol signaled Cisco Express Forwarding that they had converged.

Stale entry purge

Time taken by Cisco Express Forwarding to purge any stale entries in each FIB table. In the example, these are the FIB tables names "Default" and "Red."

Switchover

Per-line card NSF statistics.

Slot

Line card slot number.

Count

Number of times the line card has switched over. This value will always be 1, unless the type is SSO.

Type

Type of switchover the line card performed last. The type can be SSO, RPR+ or RPR.

Quiesce Period

Period of time when the line card was disconnected from the switching fabric. During this time, no packet forwarding can take place.

Other system restart requirements may add additional delay until the line card can start forwarding packets.


Related Commands

Command
Description

clear ip cef epoch

Begins a new epoch and increments the epoch number for a Cisco Express Forwarding table.

show cef state

Displays the state of Cisco Express Forwarding on a networking device.


show cef state

To display the state of Cisco Express Forwarding on a networking device, use the show cef state command in privileged EXEC mode.

show cef state

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.0(22)S

This command was introduced on Cisco 7500, 10000, and 12000 series Internet routers.

12.2(18)S

This command was integrated into Cisco IOS Release 12.2(18)S on Cisco 7500 series routers.

12.2(20)S

Support for the Cisco 7304 router was added. The Cisco 7500 series router is not supported in Cisco IOS Release 12.2(20)S.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.4(20)T

This command was integrated into Cisco IOS Release 12.4(20)T.


Examples

Example for Cisco IOS Releases 12.2(25)S, 12.2(28)SB, 12,2(33)SRA, 12,2(33)SXH, 12.4(20T, and Later Releases

The following example shows the state of Cisco Express Forwarding on the active route processor (RP):

Router# show cef state

CEF Status:
 RP instance
 common CEF enabled
IPv4 CEF Status:
 CEF enabled/running
 dCEF disabled/not running
 CEF switching enabled/running
 universal per-destination load sharing algorithm, id A189DD49
IPv6 CEF Status:
 CEF enabled/running
 dCEF disabled/not running
 original per-destination load sharing algorithm, id A189DD49

Table 32 describes the significant fields shown in the display.

Table 31 show cef state Field Description (New) 

Field
Description

RP instance

Cisco Express Forwarding status is for the RP.

common CEF enabled

Common Cisco Express Forwarding is enabled.

IPv4 CEF Status

Cisco Express Forwarding mode and status is for IPv4.

universal per-destination load sharing algorithm

IPv4 is using the universal per-destination load sharing algorithm for Cisco Express Forwarding traffic.

IPv6 CEF Status

Cisco Express Forwarding mode and status is for IPV6.

original per-destination load sharing algorithm

IPv6 is using the original per-destination load sharing algorithm for Cisco Express Forwarding traffic.


Example for Cisco IOS Releases Before Cisco IOS 12.2(25)S

The following example shows the state of Cisco Express Forwarding on the active route processor (RP):

Router# show cef state

RRP state:   
     I am standby RRP:          no
     RF Peer Presence:          yes
     RF PeerComm reached:       yes
     Redundancy mode:           SSO(7)
     CEF NSF:                   enabled/running

Table 32 describes the significant fields shown in the display.

Table 32 show cef state Field Descriptions 

Field
Description

I am standby RRP: no

This RP is not the standby.

RF Peer Presence: yes

This RP does have RF peer presence.

RF PeerComm reached: yes

This RP has reached RF peer communication.

Redundancy mode: SSO(&)

Type of redundancy mode on this RP.

CEF NSF: enabled/running

States whether Cisco Express Forwarding nonstop forwarding (NSF) is running or not.


The following example shows the state of Cisco Express Forwarding on the standby RP:

Router# show cef state

RRP state:   
     I am standby RRP:          yes
     My logical slot:           0
     RF Peer Presence:          yes
     RF PeerComm reached:       yes
     CEF NSF:                   running



Related Commands

Command
Description

clear ip cef epoch

Begins a new epoch and increments the epoch number for a Cisco Express Forwarding table.

show cef nsf

Displays the current NSF state of Cisco Express Forwarding on both the active and standby RPs.


show clns interface

To list the CLNS-specific information about each interface, use the show clns interface command in privileged EXEC mode.

show clns interface [type number]

Syntax Description

type

(Optional) Interface type.

number

(Optional) Interface number.


Command Modes

Privileged EXEC

Command History

Mainline Release
Modification

10.0

This command was introduced.

0S Release
 

12.0(31)S

Support for the BFD feature was added.

S Release
 

12.2(18)SXE

Support for the Bidirectional Forwarding Detection (BFD) feature was added.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

T Release
 

12.4(4)T

Support for the BFD feature was added.


Examples

The following is sample output from the show clns interface command that includes information for Token Ring and serial interfaces:

Router# show clns interface

TokenRing 0 is administratively down, line protocol is down
  CLNS protocol processing disabled
TokenRing 1 is up, line protocol is up
  Checksums enabled, MTU 4461, Encapsulation SNAP
  ERPDUs enabled, min. interval 10 msec.
  RDPDUs enabled, min. interval 100 msec., Addr Mask enabled
  Congestion Experienced bit set at 4 packets
  CLNS fast switching disabled
  DEC compatibility mode OFF for this interface
  Next ESH/ISH in 18 seconds
  Routing Protocol: ISO IGRP
      Routing Domain/Area: <39.0003> <0020>
Serial 2 is up, line protocol is up
  Checksums enabled, MTU 1497, Encapsulation HDLC
ERPDUs enabled, min. interval 10 msec.
     RDPDUs enabled, min. interval 100 msec., Addr Mask enabled
     Congestion Experienced bit set at 4 packets
     CLNS fast switching enabled
     DEC compatibility mode OFF for this interface
     CLNS cluster alias enabled on this interface
     Next ESH/ISH in 48 seconds
  Routing Protocol: IS-IS
       Circuit Type: level-1-2
       Level-1 Metric: 10, Priority: 64, Circuit ID: 0000.0C00.2D55.0A
       Number of active level-1 adjacencies: 0
       Level-2 Metric: 10, Priority: 64, Circuit ID: 0000.0000.0000.00
       Number of active level-2 adjacencies: 0
       Next IS-IS LAN Level-1 hello in 3 seconds
       Next IS-IS LAN Level-2 hello in 3 seconds

Cisco IOS Release 12.2(18)SXE, 12.0(31)S, and 12.4(4)T

The following is sample output from the show clns interface command that verifies that the BFD feature has been enabled on Ethernet interface 3/0. The relevant command output is shown in bold in the output.

Router# show clns interface ethernet 3/0

Ethernet3/0 is up, line protocol is up
  Checksums enabled, MTU 1497, Encapsulation SAP
  ERPDUs enabled, min. interval 10 msec.
  CLNS fast switching enabled
  CLNS SSE switching disabled
  DEC compatibility mode OFF for this interface
  Next ESH/ISH in 42 seconds
  Routing Protocol: IS-IS
    Circuit Type: level-1-2
    Interface number 0x1, local circuit ID 0x2
    Level-1 Metric: 10, Priority: 64, Circuit ID: RouterA.02
    DR ID: 0000.0000.0000.00
    Level-1 IPv6 Metric: 10
    Number of active level-1 adjacencies: 0
    Level-2 Metric: 10, Priority: 64, Circuit ID: RouterA.02
    DR ID: 0000.0000.0000.00
    Level-2 IPv6 Metric: 10
    Number of active level-2 adjacencies: 0
    Next IS-IS LAN Level-1 Hello in 3 seconds
    Next IS-IS LAN Level-2 Hello in 5 seconds
    BFD enabled

Table 33 describes the significant fields shown in the display.

Table 33 show clns interface Field Descriptions 

Field
Description

TokenRing 0 is administratively down, line protocol is down

(First interface). Shown to be administratively down with CLNS disabled.

TokenRing 1 is up, line protocol is up

(Second interface). Shown to be up, and the line protocol is up.

Serial 2 is up, line protocol is up

(Third interface). Shown to be up, and the line protocol is up.

Checksums enabled

Can be enabled or disabled.

MTU

The number following maximum transmission unit (MTU) is the maximum transmission size for a packet on this interface.

Encapsulation

Describes the encapsulation used by CLNP packets on this interface.

ERPDUs

Displays information about the generation of error protocol data units (ERPDUs). They can be either enabled or disabled. If they are enabled, they are sent out no more frequently than the specified interval.

RDPDUs

Provides information about the generation of redirect protocol data units (RDPDUs). They can be either enabled or disabled. If they are enabled, they are sent out no more frequently than the specified interval. If the address mask is enabled, redirects are sent out with an address mask.

Congestion Experienced

Tells when CLNS will turn on the congestion experienced bit. The default is to turn this bit on when there are more than four packets in a queue.

CLNS fast switching

Displays whether fast switching is supported for CLNS on this interface.

DEC compatibility mode

Indicates whether Digital Equipment Corporation (DEC) compatibility has been enabled.

CLNS cluster alias enabled on this interface

Indicates that CLNS cluster aliasing has been enabled on this interface.

Next ESH/ISH

Displays when the next end system (ES) hello or intermediate system (IS) hello will be sent on this interface.

Routing Protocol

Lists the areas that this interface is in. In most cases, an interface will be in only one area.

Circuit Type

Indicates whether the interface has been configured for local routing (level 1), area routing (level 2), or local and area routing (level 1-2).

Interface number, local circuit ID
Level-1 Metric
DR ID
Level-1 IPv6 Metric
Number of active level-1 adjacencies
Level-2 Metric
DR ID
Level-2 IPv6 Metric
Number of active level-2 adjacencies
Next IS-IS LAN Level-1
Next IS-IS LAN Level-2

Last series of fields displays information pertaining to the International Organization for Standardization (ISO) CLNS routing protocols enabled on the interface. For ISO Interior Gateway Routing Protocol (IGRP), the routing domain and area addresses are specified. For IS-IS, the Level 1 and Level 2 metrics, priorities, circuit IDs, and number of active Level 1 and Level 2 adjacencies are specified.

BFD enabled

BFD has been enabled on the interface.


show clns neighbors

To display end system (ES), intermediate system (IS), and multitopology Integrated Intermediate System-to-Intermediate System (M-ISIS) neighbors, use the show clns neighbors command in user EXEC or privileged EXEC mode.

show clns neighbors [process-tag] [interface-type interface-number] [area] [detail]

Syntax Description

process-tag

(Optional) A unique name among all International Organization for Standardization (ISO) router processes including IP and Connectionless Network Service (CLNS) router processes for a given router. If a process tag is specified, output is limited to the specified routing process. When null is specified for the process tag, output is displayed only for the router process that has no tag specified. If a process tag is not specified, output is displayed for all processes.

interface-type

(Optional) Interface type.

interface-number

(Optional) Interface number.

area

(Optional) Displays the CLNS multiarea adjacencies.

detail

(Optional) Displays the area addresses advertised by the neighbor in the hello messages. Otherwise, a summary display is provided.

In IPv6, this keyword displays the address family of the adjacency.


Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

10.0

This command was introduced.

12.0(5)T

The area and detail keywords were added.

12.2(15)T

Support was added for IPv6.

12.2(18)S

This command was integrated into Cisco IOS Release 12.2(18)S.

12.0(26)S

This command was integrated into Cisco IOS Release 12.0(26)S.

12.0(29)S

The process-tag argument was added.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(25)SG

This command was integrated into Cisco IOS Release 12.2(25)SG.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

Cisco IOS XE Release 2.4

This command was introduced on Cisco ASR 1000 Series Routers.


Usage Guidelines

The show clns neighbors command displays the adjacency that is learned through multitopology IS-IS for IPv6.

Examples

The following is sample output from the show clns neighbors command:

Router# show clns neighbors

System Id          Interface    SNPA            State  Holdtime  Type Protocol
0000.0000.0007     Et3/3        aa00.0400.6408  UP     26        L1   IS-IS
0000.0C00.0C35     Et3/2        0000.0c00.0c36  Up     91        L1   IS-IS
0800.2B16.24EA     Et3/3        aa00.0400.2d05  Up     27        L1   M-ISIS
0800.2B14.060E     Et3/2        aa00.0400.9205  Up     8         L1   IS-IS

The following is sample output from the show clns neighbors command using the process-tag argument to display information about the VRF-aware IS-IS instance tag1:

Router# show clns tagRED neighbors

Tag tag1:
System Id          Interface    SNPA            State  Holdtime  Type Protocol
igp-03             Fa0/         200d0.2b7f.9502 Up     9         L2   IS-IS
igp-03             PO2/2.1      DLCI 211        Up     27        L2   IS-IS
igp-02             PO2/0.1      DLCI 131        Up     29        L2   IS-IS
igp-11             Fa0/4        000e.d79d.7920  Up     7         L2   IS-IS
igp-11             Fa0/5        000e.d79d.7921  Up     8         L2   IS-IS
igp-11             PO3/2.1      DLCI 451        Up     24        L2   IS-IS

The following is sample output from the show clns neighbors command using the detail keyword:

Router# show clns neighbors detail

System Id          Interface    SNPA            State  Holdtime  Type Protocol
0000.0000.0007     Et3/3        aa00.0400.6408  UP     26        L1   IS-IS

Area Address(es): 20
IP Address(es): 172.16.0.42*
Uptime: 00:21:49
0000.0C00.0C35     Et3/2        0000.0c00.0c36  Up     91        L1   IS-IS

Area Address(es): 20
IP Address(es): 192.168.0.42*
Uptime: 00:21:52
0800.2B16.24EA     Et3/3        aa00.0400.2d05  Up     27        L1   M-ISIS

Area Address(es): 20
IP Address(es): 192.168.0.42*
IPv6 Address(es): FE80::2B0:8EFF:FE31:EC57
Uptime: 00:00:27
Topology: IPv6
0800.2B14.060E     Et3/2        aa00.0400.9205  Up     8         L1   IS-IS

Area Address(es): 20
IP Address(es): 192.168.0.30*
Uptime: 00:21:52

The following is sample output from the show clns neighbors command using the process-tag argument to display information about the VRF-aware IS-IS instance tagSecond:

Router# show clns tagSecond neighbors

Tag tagSecond:

System Id      Interface   SNPA                State  Holdtime  Type Protocol
igp-03         Fa0/2       00d0.2b7f.9502      Up     9         L2   IS-IS
igp-03         PO2/2.1     DLCI 211            Up     27        L2   IS-IS
igp-02         PO2/0.1     DLCI 131            Up     29        L2   IS-IS
igp-11         Fa0/4       000e.d79d.7920      Up     7         L2   IS-IS
igp-11         Fa0/5       000e.d79d.7921      Up     8         L2   IS-IS
igp-11         PO3/2.1     DLCI 451            Up     24        L2   IS-IS

Table 34 describes the significant fields shown in the display.

Table 34 show clns neighbors Field Descriptions 

Field
Description

Tag tagSecond

Tag name that identifies an IS-IS instance.

System Id

Six-byte value that identifies a system in an area.

Interface

Interface from which the system was learned.

SNPA

Subnetwork Point of Attachment. This is the data-link address.

State

State of the ES, IS, or M-ISIS.

    Init

System is an IS and is waiting for an IS-IS hello message. IS-IS regards the neighbor as not adjacent.

    Up

Believes the ES or IS is reachable.

Holdtime

Number of seconds before this adjacency entry times out.

Type

The adjacency type. Possible values are as follows:

ES—End-system adjacency either discovered via the ES-IS protocol or statically configured.

IS—Router adjacency either discovered via the ES-IS protocol or statically configured.

M-ISIS—Router adjacency discovered via the multitopology IS-IS protocol.

L1—Router adjacency for Level 1 routing only.

L1L2—Router adjacency for Level 1 and Level 2 routing.

L2—Router adjacency for Level 2 only.

Protocol

Protocol through which the adjacency was learned. Valid protocol sources are ES-IS, IS-IS, ISO IGRP, Static, DECnet, and M-ISIS.


Notice that the information displayed in the show clns neighbors detail command output includes everything shown in show clns neighbors command output in addition to the area address associated with the IS neighbor and its uptime. When IP routing is enabled, Integrated-ISIS adds information to the output of the show clns commands. The show clns neighbors detail command output shows the IP addresses that are defined for the directly connected interface and an asterisk (*) to indicate which IP address is the next hop.

show configuration lock

To display information about the lock status of the running configuration file during a configuration replace operation, use the show configuration lock command in privileged EXEC mode.

show configuration lock

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC(#)

Command History

Release
Modification

12.2(25)S

This command was introduced.

12.3(14)T

This command was integrated into Cisco IOS Release 12.3(14)T.

The output of this command was updated to display the configuration locking class.

12.0(31)S

The command output was enhanced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(31)SB2

This command was implemented on the Cisco 10000 series.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB and implemented on the Cisco 10000 series.


Examples

The following is sample output from the show configuration lock command when the running configuration file is locked by another user.

Cisco IOS Release 12.2(25)S, Release 12.2(28)SB, Release 12.3(14)T, and Later Releases

Router# configure terminal 

Enter configuration commands, one per line. End with CNTL/Z. 

Router(config)# configuration mode exclusive ?

auto     Lock configuration mode automatically
manual   Lock configuration mode on-demand

Router(config)# configuration mode exclusive auto 
Router(config)# end

Router# show running-config | include configuration 

configuration mode exclusive auto

Router# configure terminal               !<----------- Acquires the lock

Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# show configuration lock 

Parser Configure Lock 
--------------------- 
Owner PID : 3 
User : unknown 
TTY : 0 
Type : EXCLUSIVE 
State : LOCKED 
Class : EXPOSED 
Count : 1 
Pending Requests : 0 
User debug info : configure terminal  
Router(config)# 
Router(config)# end             ! <------------ Releases the lock 

The following is sample output from the show configuration lock command when the running configuration file is not locked by another user.

Router# show configuration lock 
 
Parser Configure Lock 
--------------------- 
Owner PID : -1 
User : unknown 
TTY : -1 
Type : NO LOCK 
State : FREE 
Class : unknown 
Count : 0 
Pending Requests : 0 
User debug info : 

Cisco IOS Release 12.0(31)S, 12.2(33)SRA, and Later Releases

Router# show configuration lock 

Parser Configure Lock
------------------------------------------------------
Owner PID                         : 3
User                              : unknown
TTY                               : 0
Type                              : EXCLUSIVE
State                             : LOCKED
Class                             : EXPOSED
Count                             : 1
Pending Requests                  : 0
User debug info                   : configure terminal 
Session idle state                : TRUE
No of exec cmds getting executed  : 0
No of exec cmds blocked           : 0
Config wait for show completion   : FALSE
Remote ip address                 : Unknown
Lock active time (in Sec)         : 6
Lock Expiration timer (in Sec)    : 593

Table 35 describes the significant fields shown in the displays.

Table 35 show configuration lock Field Descriptions

Field
Description

Owner PID

Process identifier (PID) of the process that owns the lock.

User

Owner's username.

TTY

Owner's terminal number.

Type

Lock type (EXCLUSIVE/COUNTER/NO LOCK).

State

State of the lock (FREE/LOCKED).

Class

Classification of users of the lock (EXPOSED/ROLLBACK). Processes other than ROLLBACK belong to the EXPOSED class.

Count

In the case of a counter lock, total number of processes holding the lock.

Pending Requests

Total number of processes blocked by the lock.

User debug info

Any string given by the process (used for debugging only).

Session idle state

Indicates whether the user in an access session locking session is idle. Displays TRUE or FALSE.

No of exec cmds getting executed

Total number of EXEC commands (show and clear) being executed simultaneously from different sessions.

No of exec cmds blocked

Total number of EXEC commands (show and clear) waiting for the configuration command (running from the access session locking session) to complete its execution.

Config wait for show completion

Indicates whether a configuration command executed in an access session locking session is waiting for the completion of the show command being executed simultaneously from a different session. Displays TRUE or FALSE.

Remote ip address

IP address of the terminal from which the user telneted to the router.

Lock active time (in Sec)

Amount of time, in seconds, that elapsed since the lock was acquired.

Lock Expiration timer (in Sec)

The amount of time, in seconds, that expires before the lock is automatically released.


The following example shows how to configure the configuration file for single user auto configuration mode (using the configuration mode exclusive auto command). Use the configure terminal command to enter global configuration mode and lock the configuration mode exclusively. Once the Cisco IOS configuration mode is locked exclusively, you can verify the lock using the show configuration lock command.

Router# configure terminal 
Router(config)# configuration mode exclusive auto 
Router(config)# end 

Router# configure terminal 

Router(config)# show configuration lock

Parser Configure Lock
Owner PID        :  10
User             :  User1
TTY              :  3
Type             :  EXCLUSIVE
State            :  LOCKED
Class            :  Exposed
Count            :  0
Pending Requests :  0
User debug info  :  0

Related Commands

Command
Description

configuration mode exclusive

Enables single-user (exclusive) access functionality for the Cisco IOS CLI.

configure replace

Replaces the current running configuration with a saved Cisco IOS configuration file.

debug configuration lock

Enables debugging of the Cisco IOS configuration lock.


show dampening interface

To display a summary of dampened interfaces, use the show damping interface command in user EXEC or privileged EXEC mode.

show dampening interface

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.0(22)S

This command was introduced.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

12.2(18)SXD

This command was integrated into Cisco IOS Release 12.2(18)SXD.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Examples

The following is sample output from the show damping interface command in privileged EXEC mode:

Router# show dampening interface 

3 interfaces are configured with dampening.
No interface is being suppressed.
Features that are using interface dampening:
  IP Routing
  CLNS Routing

Table 36 describes the significant fields shown in the sample output of the show dampening interface command.

Table 36 show dampening interface Field Descriptions 

Field
Description

... interfaces are configured with dampening.

Displays the number of interfaces that are configured for event dampening.

No interface is being suppressed.

Displays the suppression status of the interfaces that are configured for event dampening.

Features that are using interface dampening:

Displays the routing protocols that are configured to perceived interface dampening.


Related Commands

Command
Description

clear counters

Clears the interface counters.

dampening

Enables IP event dampening at the interface level.

show interface dampening

Displays a summary of the dampening parameters and status.


show event manager directory user

To display the directory to use for storing user library files or user-defined Embedded Event Manager (EEM) policies, use the show event manager directory user command in privileged EXEC mode.

show event manager directory user [library | policy]

Syntax Description

library

(Optional) User library files.

policy

(Optional) User-defined EEM policies.


Command Default

The directories for both user library and user policy files are displayed.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(14)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(18)SXF4

This command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(18)SXF5

This command was integrated into Cisco IOS Release 12.2(18)SXF5.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

Use the event manager directory user command to specify the directory to use for storing user library or user policy files.

Examples

The following example shows the /usr/fm_policies folder on disk 0 as the directory to use for storing EEM user library files:

Router# show event manager directory user library

disk0:/usr/fm_policies

Related Commands

Command
Description

event manager directory user

Specifies a directory to use for storing user library files or user-defined EEM policies.


show event manager environment

To display the name and value of Embedded Event Manager (EEM) environment variables, use the show event manager environment command in privileged EXEC mode.

show event manager environment [all | variable-name]

Syntax Description

all

(Optional) Displays information for all environment variables. This is the default.

variable-name

(Optional) Displays information about the specified environment variable.


Command Default

If no argument or keyword is specified, information for all environment variables is displayed.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)S

This command was introduced.

12.3(14)T

This command was integrated into Cisco IOS Release 12.3(14)T.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(18)SXF4

This command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(18)SXF5

This command was integrated into Cisco IOS Release 12.2(18)SXF5.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Examples

The following is sample output from the show event manager environment command:

Router# show event manager environment

No.  Name                          Value
1    _cron_entry                   0-59/1 0-23/1 * * 0-7
2    _show_cmd                     show version
3    _syslog_pattern               .*UPDOWN.*Ethernet1/0.*
4    _config_cmd1                  interface Ethernet1/0
5    _config_cmd2                  no shutdown

Table 37 describes the significant fields shown in the display.

Table 37 show event manager environment Field Descriptions 

Field
Description

No.

The index number assigned to the EEM environment variable.

Name

The name given to the EEM environment variable when it was created.

Value

The text content defined for the EEM environment variable when it was created.


Related Commands

Command
Description

event manager environment

Sets an EEM environment variable.


show event manager history events

To display the Embedded Event Manager (EEM) events that have been triggered, use the show event manager history events command in privileged EXEC mode.

show event manager history events [detailed] [maximum number]

Syntax Description

detailed

(Optional) Displays detailed information about each EEM event.

maximum

(Optional) Specifies the maximum number of events to display.

number

(Optional) Number in the range from 1 to 50. The default is 50.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(25)S

This command was introduced.

12.3(14)T

This command was integrated into Cisco IOS Release 12.3(14)T.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(18)SXF4

This command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(18)SXF5

This command was integrated into Cisco IOS Release 12.2(18)SXF5.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

12.4(20)T

The output was modified to include the Job ID and Status fields.


Usage Guidelines

Use the show event manager history events command to track information about the EEM events that have been triggered.

Examples

The following is sample output from the show event manager history events command showing that two types of events, Simple Network Management Protocol (SNMP) and application, have been triggered.

Router# show event manager history events

No.  Time of Event             Event Type          Name
1    Fri Aug13  21:42:57 2004  snmp                applet: SAAping1 
2    Fri Aug13  22:20:29 2004  snmp                applet: SAAping1 
3    Wed Aug18  21:54:48 2004  snmp                applet: SAAping1 
4    Wed Aug18  22:06:38 2004  snmp                applet: SAAping1 
5    Wed Aug18  22:30:58 2004  snmp                applet: SAAping1 
6    Wed Aug18  22:34:58 2004  snmp                applet: SAAping1 
7    Wed Aug18  22:51:18 2004  snmp                applet: SAAping1 
8    Wed Aug18  22:51:18 2004  application         applet: CustApp1

The following is sample output from the show event manager history events command that includes the Job ID and Status fields:

Router# show event manager history events

No. Job ID  Status   Time of Event             Event Type  Name
1   1       success  Thu Sep 7  02:54:04 2006  syslog      applet: two
2   2       success  Thu Sep 7  02:54:04 2006  syslog      applet: three 
3   3       success  Thu Sep 7  02:54:04 2006  syslog      applet: four 
4   4       abort    Thu Sep 7  02:54:04 2006  syslog      applet: five
5   5       abort    Thu Sep 7  02:54:04 2006  syslog      applet: six 
6   6       abort    Thu Sep 7  02:54:04 2006  syslog      applet: seven 
7   7       abort    Thu Sep 7  02:54:04 2006  syslog      applet: eight 
8   8       cleared  Thu Sep 7  02:54:04 2006  syslog      applet: nine 
9   9       cleared  Thu Sep 7  02:54:04 2006  syslog      applet: ten 
10  10      cleared  Thu Sep 7  02:54:04 2006  syslog      applet: eleven 

The following is sample output from the show event manager history events command using the detailed keyword:

Router# show event manager history events detailed

No. Job ID  Status   Time of Event             Event Type          Name
1   1       success  Thu Sep 7  02:54:04 2006  syslog              applet: two 
 msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
2   2       success  Thu Sep 7  02:54:04 2006  syslog              applet: three 
 msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
3   3      success   Thu Sep 7  02:54:04 2006  syslog              applet: four 
 msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
4   4      abort     Thu Sep 7  02:54:04 2006  syslog              applet: five 
 msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
5   5      abort     Thu Sep 7  02:54:04 2006  syslog              applet: six 
 msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
6   6      abort     Thu Sep 7  02:54:04 2006  syslog              applet: seven 
 msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
7   7      cleared   Thu Sep 7  02:54:04 2006  syslog              applet: eight 
 msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
8   8      cleared   Thu Sep 7  02:54:04 2006  syslog              applet: nine 
 msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
9   9      cleared   Thu Sep 7  02:54:04 2006  syslog              applet: ten 
 msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console}
10  10     success   Thu Sep 7  02:54:04 2006  syslog              applet: eleven 
 msg {23:13:29: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console} 

Table 38 describes the significant fields shown in the displays.

Table 38 show event manager history events Field Descriptions 

Field
Description

No.

Event number.

Job ID

Unique internal EEM scheduler job identification number.

Status

Policy completion status for the policy scheduled for this event. There are three possible status values:

Success—Indicates that the policy for this event completed normally.

Abort—Indicates that the policy for this event terminated abnormally.

Cleared—Indicates that the policy for this event was removed from execution using the event manager scheduler clear command.

Time of Event

Day, date, and time when the event was triggered.

Event Type

Type of event.

Name

Name of the policy that was triggered.


Related Commands

Command
Description

event manager history size

Modifies the size of the EEM history tables.

event manager scheduler clear

Clears EEM policies that are executing or pending execution.


show event manager history traps

To display the Embedded Event Manager (EEM) Simple Network Management Protocol (SNMP) traps that have been sent, use the show event manager history traps command in privileged EXEC mode.

show event manager history traps [server | policy]

Syntax Description

server

(Optional) Displays SNMP traps that were triggered from the EEM server.

policy

(Optional) Displays SNMP traps that were triggered from within an EEM policy.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(25)S

This command was introduced.

12.3(14)T

This command was integrated into Cisco IOS Release 12.3(14)T.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(18)SXF4

This command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(18)SXF5

This command was integrated into Cisco IOS Release 12.2(18)SXF5.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

Use the show event manager history traps command to identify whether the SNMP traps were implemented from the EEM server or from an EEM policy.

Examples

The following is sample output from the show event manager history traps command:

Router# show event manager history traps policy

No.  Time                      Trap Type           Name
1    Wed Aug18  22:30:58 2004  policy              EEM Policy Director
2    Wed Aug18  22:34:58 2004  policy              EEM Policy Director
3    Wed Aug18  22:51:18 2004  policy              EEM Policy Director

Table 39 describes the significant fields shown in the display.

Table 39 show event manager history traps Field Descriptions 

Field
Description

No.

Trap number.

Time

Date and time when the SNMP trap was implemented.

Trap Type

Type of SNMP trap.

Name

Name of the SNMP trap that was implemented.


Related Commands

Command
Description

event manager history size

Modifies the size of the EEM history tables.


show event manager metric processes

To display Embedded Event Manager (EEM) reliability metric data for Cisco IOS Software Modularity processes, use the show event manager metric processes command in privileged EXEC mode.

show event manager metric processes {all | process-name}

Syntax Description

all

Displays the process metric data for all Cisco IOS Software Modularity processes.

process-name

Specific process name.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(18)SXF4

This command was introduced.


Usage Guidelines

Use this command to display the reliability metric data for Cisco IOS Software Modularity processes. The system keeps a record of when processes start and end, and this data is used as the basis for reliability analysis.

The information provided by this command allows you to get availability information for a process or group of processes. A process is considered available when it is running.

Examples

The following is partial sample output from the show event manager metric processes command. In this partial example, the first and last entries showing the metric data for the processes on all the cards inserted in the system are displayed.

Router# show event manager metric processes all

=====================================
node name: node0
process name: devc-pty, instance: 1
sub_system: 0, version: 00.00.0000
--------------------------------
last event type: process start
recent start time: Fri Oct10  20:34:40 2003
recent normal end time: n/a
recent abnormal end time: n/a
number of times started: 1
number of times ended normally: 0
number of times ended abnormally: 0
most recent 10 process start times:
--------------------------
Fri Oct10  20:34:40 2003
--------------------------

most recent 10 process end times and types:

cumulative process available time: 6 hours 30 minutes 7 seconds 378 milliseconds
cumulative process unavailable time: 0 hours 0 minutes 0 seconds 0 milliseconds
process availability:  0.100000000
number of abnormal ends within the past 60 minutes (since reload): 0
number of abnormal ends within the past 24 hours (since reload): 0
number of abnormal ends within the past 30 days (since reload): 0
.
.
.
=====================================
node name: node0
process name: cdp2.iosproc, instance: 1
sub_system: 0, version: 00.00.0000
--------------------------------
last event type: process start
recent start time: Fri Oct10  20:35:02 2003
recent normal end time: n/a
recent abnormal end time: n/a
number of times started: 1
number of times ended normally: 0
number of times ended abnormally: 0
most recent 10 process start times:
--------------------------
Fri Oct10  20:35:02 2003
--------------------------

most recent 10 process end times and types:
cumulative process available time: 6 hours 29 minutes 45 seconds 506 milliseconds
cumulative process unavailable time: 0 hours 0 minutes 0 seconds 0 milliseconds
process availability:  0.100000000
number of abnormal ends within the past 60 minutes (since reload): 0
number of abnormal ends within the past 24 hours (since reload): 0
number of abnormal ends within the past 30 days (since reload): 0

Table 40 describes the significant fields shown in the display.

Table 40 show event manager metric processes Field Descriptions 

Field
Description

node name

Node name.

process name

Software Modularity process name.

instance

Instance number of the Software Modularity process.

sub_system

Subsystem number.

version

Version number.



show event manager policy available

To display Embedded Event Manager (EEM) policies that are available to be registered, use the show event manager policy available command in privileged EXEC mode.

show event manager policy available [description [policy-name] | [detailed policy-filename] [system | user]]

Syntax Description

description

(Optional) Specifies a brief description of the available policy.

policy-name

(Optional) Name of the policy.

detailed

(Optional) Displays the actual sample policy for the specified policy-filename.

policy-filename

(Optional) Name of sample policy to be displayed.

system

(Optional) Displays all available system policies.

user

(Optional) Displays all available user policies.


Command Default

If no keyword is specified, information for all available system and user policies is displayed.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(25)S

This command was introduced.

12.3(14)T

The user keyword was added, and this command was integrated into
Cisco IOS Release 12.3(14)T.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(18)SXF4

The detailed keyword and the policy-filename argument were added, and this command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(18)SXF5

This command was integrated into Cisco IOS Release 12.2(18)SXF5.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

12.4(20)T

The output was modified to display bytecode scripts with a file extension of .tbc.

15.0(1)M

The command was modified. The description keyword and policy-name argument were added.


Usage Guidelines

This command is useful if you forget the exact name of a policy required for the event manager policy command.

The detailed keyword displays the actual specified sample policy. Use description policy-name to describe a policy. If policy-name is not specified, the output of show command displays the description of all the available policies.

In Cisco IOS Release 12.4(20)T, EEM 2.4 introduced bytecode support to allow storage of Tcl scripts in bytecode format, and the output of this command was modified to display files with a .tbc extension as well as the usual .tcl extension for Tcl scripts.

Examples

The following is sample output from the show event manager policy available command:

Router# show event manager policy available

No.  Type    Time Created                  Name
1    system  Tue Sep 12 09:41:32 2002      sl_intf_down.tcl
2    system  Tue Sep 12 09:41:32 2002      tm_cli_cmd.tcl

Table 41 describes the fields shown in the display.

Table 41 show event manager policy available Field Descriptions 

Field
Description

No.

Index number automatically assigned to the policy.

Type

Indicates whether the policy is a system policy.

Time Created

Time stamp indicating the date and time when the policy file was created.

Name

Name of the EEM policy file.


The following is sample output from the show event manager policy available command with the detailed keyword and a policy name specified:

Router# show event manager policy available detailed tm_cli_cmd.tcl

::cisco::eem::event_register_timer cron name crontimer2 cron_entry $_cron_entry maxrun 240
#------------------------------------------------------------------
# EEM policy that will periodically execute a cli command and email the
# results to a user.
#
# July 2005, Cisco EEM team
#
# Copyright (c) 2005 by cisco Systems, Inc.
# All rights reserved.
#------------------------------------------------------------------
### The following EEM environment variables are used:
###
### _cron_entry (mandatory)            - A CRON specification that determines 
###                                      when the policy will run. See the 
###                                      IOS Embedded Event Manager 
###                                      documentation for more information
###                                      on how to specify a cron entry.
### Example: _cron_entry                 0-59/1 0-23/1 * * 0-7 
###
### _email_server (mandatory)          - A Simple Mail Transfer Protocol (SMTP)
###                                      mail server used to send e-mail.
### Example: _email_server               mailserver.customer.com
###

The following is sample output from the show event manager policy available command showing a Tcl script with a .tcl filename extension and a bytecode script with a filename extension of .tbc. This example is for a Cisco IOS Release 12.4(20)T or later image.

Router# show event manager policy available

No.  Type    Time Created                  Name
1    system  Tue Jun 10 09:41:32 2008      sl_intf_down.tcl
2    system  Tue Jun 10 09:41:32 2008      tm_cli_cmd.tbc

Related Commands

Command
Description

event manager policy

Registers an EEM policy with the EEM.


show event manager policy pending

To display Embedded Event Manager (EEM) policies that are pending for execution, use the show event manager policy pending command in privileged EXEC mode.

show event manager policy pending [queue-type {applet | call-home | axp | script} | class class-options | detailed]

Syntax Description

queue-type

(Optional) Specifies the queue type of the EEM policy.

applet

(Optional) Specifies EEM applet policy.

call-home

(Optional) Specifies EEM Call-Home policy.

axp

(Optional) Specifies EEM axp policy.

script

(Optional) Specifies EEM script policy.

class

(Optional) Specifies EEM class policy.

class-options

(Optional) Specifies the EEM policy class. You can specify either one or all of the following:

class-letter—The class letter assigned for the EEM policy. Letters range from A to Z. Multiple instances of class letter can be specified.

default—Specifies policies registered with default class.

range class-letter-range—Specifies the EEM policy class in a range. Multiple instances of range class-letter-range can be specified. The letters used in class-letter-range must be in uppercase.

detailed

(Optional) Specifies the detailed content of the EEM policies.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(25)S

This command was introduced.

12.3(14)T

This command was integrated into Cisco IOS Release 12.3(14)T.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(18)SXF4

This command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(18)SXF5

This command was integrated into Cisco IOS Release 12.2(18)SXF5.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

12.4(20)T

The output was modified to include the Job ID and Status fields.

12.4(22)T

This command is supported with new options to qualify the policy queues reported in the output display and provides detailed policy information.


Usage Guidelines

Pending policies are policies that are pending execution in the EEM server execution queue. When an event is triggered, the policy that is registered to handle the event is queued for execution in the EEM server. Use the show event manager policy pending command to display the policies in this queue and to view the policy details.

Examples

The following is sample output from the show event manager policy pending command:

Router# show event manager policy pending

no. job id   p s    status    time of event                event type     name
1    12851   N A    pend    Mon Oct29   20:51:18 2007   timer watchdog   loop.tcl
2    12868   N A    pend    Mon Oct29   20:51:24 2007   timer watchdog   loop.tcl
3    12873   N A    pend    Mon Oct29   20:51:27 2007   timer watchdog   loop.tcl
4    12907   N A    pend    Mon Oct29   20:51:41 2007   timer watchdog   loop.tcl
5    13100   N A    pend    Mon Oct29   20:52:55 2007   timer watchdog   loop.tcl

Table 42 describes the significant fields shown in the displays.

Table 42 show event manager policy pending Field Descriptions 

Field
Description

no.

Index number automatically assigned to the policy.

job id

Unique internal EEM scheduler job identification number.

p

Priority of the policy. There are four priorities:

L—Indicates that the policy is of low priority.

H—Indicates that the policy is of high priority.

N—Indicates that the policy is of normal priority.

Z—Indicates that the policy is of least priority.

s

Scheduler node of the policy. There are two nodes:

A—Indicates that the scheduler node of this policy is active.

S—Indicates that the scheduler node of this policy is standby.

status

Scheduling status for the policy. There are six possible status values:

pend—Indicates that the policy is awaiting execution.

runn—Indicates that the policy is executing.

exec—Indicates that the policy has completed executing and is awaiting scheduler cleanup tasks.

hold—Indicates that the policy is being held.

wait—Indicates that the policy is waiting for a new event.

continue—Indicates that the policy receives a new event and is ready to run.

time of event

Date and time when the policy was queued for execution in the EEM server.

event type

Type of event.

name

Name of the EEM policy file.


Related Commands

Command
Description

show event manager

Shows the event manager details of an EEM policy.


show event manager policy registered

To display Embedded Event Manager (EEM) policies that are already registered, use the show event manager policy registered command in privileged EXEC mode.

show event manager policy registered [description [policy-name] | detailed policy-filename [system | user] | [event-type event-name] [system | user] [time-ordered | name-ordered]]

Syntax Description

description

(Optional) Displays a brief description about the registered policy.

policy-name

(Optional) Policy name for which the description should be displayed. If policy name is not provided, then description of all registered policies are displayed.

detailed

(Optional) Displays the contents of the specified policy.

system

(Optional) Displays the registered system policies.

user

(Optional) Displays the registered user policies.

policy-filename

(Optional) Name of policy whose contents are to be displayed.

event-type

(Optional) Displays the registered policies for the event type specified in the event-name argument. If the event type is not specified, all registered policies are displayed.

event-name

(Optional) Type of event. The following values are valid:

application—Application event type.

cli—Command-line interface (CLI) event type.

config—Configuration change event type.

counter—Counter event type.

env—Environmental event type.

interface—Interface event type.

ioswdsysmon—Watchdog system monitor event type.

none—Manually run policy event type.

oir—OIR event type.

rf—Redundancy facility event type.

snmp—Simple Network Management Protocol (SNMP) event type.

snmp-object—Snmp object event type.

syslog—Syslog event type.

test—Test event type.

timer-absolute—Absolute timer event type.

timer-countdown—Countdown timer event type.

timer-cron—Clock daemon (CRON) timer event type.

timer-watchdog—Watchdog timer event type.

time-ordered

(Optional) Displays the policies in the order of the time at which they were registered. This is the default.

name-ordered

(Optional) Displays the policies, in alphabetical order, by policy name.


Command Default

If this command is invoked with no optional keywords, it displays all registered EEM system and user policies for all event types. The policies are displayed according to the time at which they were registered.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.0(26)S

This command was introduced.

12.3(4)T

This command was integrated into Cisco IOS Release 12.3(4)T.

12.2(25)S

This command was integrated into Cisco IOS Release 12.2(25)S.

12.3(14)T

Additional event types and the user keyword were added, and this command was integrated into Cisco IOS Release 12.3(14)T.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(18)SXF4

The detailed keyword and the policy-filename argument were added, and this command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(18)SXF5

This command was integrated into Cisco IOS Release 12.2(18)SXF5.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

15.0(1)M

This command was modified. The description keyword and the policy-name argument were added.


Usage Guidelines

The output shows registered policy information in two parts. The first line in each policy description lists the index number assigned to the policy, the policy type (system), the type of event registered, the time when the policy was registered, and the name of the policy file. The remaining lines of each policy description display information about the registered event and how the event is to be handled; the information comes directly from the Tool Command Language (Tcl) command arguments that make up the policy file. Output of the show event manager policy registered command is most helpful to persons who are writing and monitoring EEM policies.

The detailed keyword displays the actual specified sample policy including details about the environment variables used by the policy and instructions for running the policy.

Examples

The following is sample output from the show event manager policy registered command:

Router# show event manager policy registered

No.  Class   Type    Event Type          Trap  Time Registered           Name
1    applet  system  snmp                Off   Fri Aug 13 17:42:52 2004  IPSLAping1
 oid {1.3.6.1.4.1.9.9.42.1.2.9.1.6.4} get-type exact entry-op eq entry-val {1}
 exit-op eq exit-val {2} poll-interval 5.000
 action 1.0 syslog priority critical msg Server IPecho Failed: OID=$_snmp_oid_val 
 action 1.1 snmp-trap strdata EEM detected server reachability failure to 10.1.88.9
 action 1.2 publish-event sub-system 88000101 type 1 arg1 10.1.88.9 arg2 IPSLAEcho arg3 
fail
 action 1.3 counter name _IPSLA1F value 1 op inc

Table 43 describes the significant fields shown in the display.

Table 43 show event manager policy registered Field Descriptions 

Field
Description

No.

Index number automatically assigned to the policy.

Class

Class of policy, either applet or script.

Type

Identifies whether the policy is a system policy.

Event Type

Type of event.

Trap

Identifies whether an SNMP trap is enabled.

Time Registered

Time stamp indicating the day, date, and time when the policy file was registered.

Name

Name of the EEM policy file.


The following is sample output from the show event manager policy registered command showing the use of the detailed keyword for the policy named tm_cli_cmd.tcl:

Router# show event manager policy registered detailed tm_cli_cmd.tcl

::cisco::eem::event_register_timer cron name crontimer2 cron_entry $_cron_entry maxrun 240
#------------------------------------------------------------------
# EEM policy that will periodically execute a cli command and email the
# results to a user.
#
# July 2005, Cisco EEM team
#
# Copyright (c) 2005 by cisco Systems, Inc.
# All rights reserved.
#------------------------------------------------------------------
### The following EEM environment variables are used:
###
### _cron_entry (mandatory)            - A CRON specification that determines 
###                                      when the policy will run. See the 
###                                      IOS Embedded Event Manager 
###                                      documentation for more information
###                                      on how to specify a cron entry.
### Example: _cron_entry                 0-59/1 0-23/1 * * 0-7 
###
### _email_server (mandatory)          - A Simple Mail Transfer Protocol (SMTP)
###                                      mail server used to send e-mail.
### Example: _email_server               mailserver.example.com
###

Related Commands

Command
Description

event manager policy

Registers an EEM policy with the EEM.


show event manager session cli username

To display the username associated with Embedded Event Manager (EEM) policies that use the command-line interface (CLI) library, use the show event manager session cli username command in privileged EXEC mode.

show event manager session cli username

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(14)T

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(18)SXF4

This command was integrated into Cisco IOS Release 12.2(18)SXF4 to support Software Modularity images only.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(18)SXF5

This command was integrated into Cisco IOS Release 12.2(18)SXF5.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

Use this command to display the username associated with a Tool Command Language (Tcl) EEM policy. If you are using authentication, authorization, and accounting (AAA) security and implement authorization on a command basis, you should use the event manager session cli username command to set a username to be associated with a Tcl session. The username is used when a Tcl policy executes a CLI command. TACACS+ verifies each CLI command using the username associated with the Tcl session that is running the policy. Commands from Tcl policies are not usually verified because the router must be in privileged EXEC mode to register the policy.

Examples

The following example shows that the username of eemuser is associated with a Tcl session:

Router# show event manager session cli username

Related Commands

Command
Description

event manager session cli username

Associates a username with EEM policies that use the CLI library.


show glbp

To display Gateway Load Balancing Protocol (GLBP) information, use the show glbp command in privileged EXEC mode.

show glbp [capability [interface-type interface-number ]] | [[interface-type interface-number [group-number] [state] [brief ] [detail] [client-cache [[age number] [forwarder number]] | [mac-address address] | [summary]]]

Syntax Description

interface-type interface-number

(Optional) Interface type and number for which output is displayed.

group-number

(Optional) GLBP group number in the range from 0 to 1023.

state

(Optional) State of the GLBP router, one of the following: active, disabled, init, listen, and standby.

brief

(Optional) Summarizes each virtual gateway or virtual forwarder with a single line of output.

detail

(Optional) Displays all the status of the GLBP router in detailed format. The available status are: active, disabled, init, listen, speak, and standby.

capability

(Optional) Displays the GLBP capability interfaces.

client-cache

(Optional) Displays the GLBP client cache.

age number

(Optional) Displays the client-cache age in the range from 0 to 1440.

forwarder number

(Optional) Displays the client forwarder in the range from 1 to 4.

mac-address address

(Optional) Displays the mac-address of the client.

summary

(Optional) Displays the summary of the GLBP client caches.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(14)S

This command was introduced.

12.2(15)T

This command was integrated into Cisco IOS Release 12.2(15)T. The client-cache keyword was added.

12.3(2)T

The output was enhanced to display information about Message Digest 5 (MD5) authentication.

12.3(7)T

The output was enhanced to display information about assigned redundancy names to specified groups.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(31)SB2

This command was enhanced to display information about GLBP support of Stateful Switchover (SSO) mode.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

Cisco IOS XE Release 2.1

This command was integrated into Cisco IOS XE Release 2.1.

12.4(15)T

This command was modified. The client-cache keyword was added.

12.4(24)T

This command was modified. The detail keyword was added.

The output was modified to hide configured passwords when MD5 key-string or text authentication is configured.

12.2(33)SXI1

This command was modified. The client-cache keyword was added.

The output was modified to hide configured passwords when MD5 key-string or text authentication is configured.

12.2(33)SRE

The output was modified to hide configured passwords when MD5 key-string or text authentication is configured.


Usage Guidelines

Use the show glbp command to display information about GLBP groups on a router. The brief keyword displays a single line of information about each virtual gateway or virtual forwarder. The client-cache keyword displays the client cache details and the capability keyword displays all GLBP-capable interfaces.

Examples

The following is sample output from the show glbp command:

Router# show glbp

FastEthernet0/0 - Group 10
  State is Active
    2 state changes, last state change 23:50:33
  Virtual IP address is 10.21.8.10
  Hello time 5 sec, hold time 18 sec
    Next hello sent in 4.300 secs
  Redirect time 600 sec, forwarder time-out 7200 sec
  Authentication MD5, key-string
  Preemption enabled, min delay 60 sec
  Active is local
  Standby is unknown
  Priority 254 (configured)
  Weighting 105 (configured 110), thresholds: lower 95, upper 105
    Track object 2 state Down decrement 5
  Load balancing: host-dependent
  There is 1 forwarder (1 active)
  Forwarder 1
    State is Active
      1 state change, last state change 23:50:15
    MAC address is 0007.b400.0101 (default)
    Owner ID is 0005.0050.6c08
    Redirection enabled
    Preemption enabled, min delay 60 sec
    Active is local, weighting 105

The following is sample output from the show glbp command with the brief keyword specified:

Router# show glbp brief

Interface   Grp  Fwd Pri State    Address         Active router   Standby router
Fa0/0       10   -   254 Active   10.21.8.10       local           unknown       
Fa0/0       10   1   7   Active   0007.b400.0101   local           -

The following is sample output from the show glbp command that displays GLBP group 10:

Router# show glbp 10

FastEthernet0/0 - Group 10
  State is Active
    2 state changes, last state change 23:50:33
  Virtual IP address is 10.21.8.10
  Hello time 5 sec, hold time 18 sec
    Next hello sent in 4.300 secs
  Redirect time 600 sec, forwarder time-out 7200 sec
  Authentication MD5, key-string
  Preemption enabled, min delay 60 sec
  Active is local
  Standby is unknown
  Priority 254 (configured)
  Weighting 105 (configured 110), thresholds: lower 95, upper 105
    Track object 2 state Down decrement 5
  Load balancing: host-dependent
  There is 1 forwarder (1 active)
  Forwarder 1
    State is Active
      1 state change, last state change 23:50:15
    MAC address is 0007.b400.0101 (default)
    Owner ID is 0005.0050.6c08
    Redirection enabled
    Preemption enabled, min delay 60 sec
    Active is local, weighting 105

The following output shows that the redundancy name has been assigned to the "glbp1" group:

Router# show glbp ethernet0/1 1


Ethernet0/1 - Group 1

 State is Listen

   64 state changes, last state change 00:00:54

 Virtual IP address is 10.1.0.7

 Hello time 50 msec, hold time 200 msec

   Next hello sent in 0.030 secs

 Redirect time 600 sec, forwarder time-out 14400 sec

  Authentication text, string "authword"

 Preemption enabled, min delay 0 sec

 Active is 10.1.0.2, priority 105 (expires in 0.184 sec)

 Standby is 10.1.0.3, priority 100 (expires in 0.176 sec)

 Priority 96 (configured)

 Weighting 100 (configured 100), thresholds: lower 95, upper 100

   Track object 1 state Up decrement 10

 Load balancing: round-robin

 IP redundancy name is "glbp1"

  Group members:

   0004.4d83.4801 (10.0.0.0)

   0010.7b5a.fa41 (10.0.0.1)

   00d0.bbd3.bc21 (10.0.0.2) local


The following output shows GLBP support for SSO mode on an active RP:

Router# show glbp 

Ethernet0/0 - Group 1 
State is Standby 
1 state change, last state change 00:00:20 
Virtual IP address is 172.24.1.254 
Hello time 3 sec, hold time 10 sec 
Next hello sent in 0.232 secs 
Redirect time 600 sec, forwarder time-out 14400 sec 
Preemption disabled 
Active is 172.24.1.2, priority 100 (expires in 7.472 sec) 
Standby is local 
Priority 100 (default) 
Weighting 100 (default 100), thresholds: lower 1, upper 100 
Load balancing: round-robin 
Group members: 
aabb.cc00.0100 (172.24.1.1) local 
aabb.cc00.0200 (172.24.1.2) 
There are 2 forwarders (1 active) 
Forwarder 1 
State is Listen 
MAC address is 0007.b400.0101 (learnt) 
Owner ID is aabb.cc00.0200 
Time to live: 14397.472 sec (maximum 14400 sec) 
Preemption enabled, min delay 30 sec 
Active is 172.24.1.2 (primary), weighting 100 (expires in 9.540 sec) 
Forwarder 2 
State is Active 
1 state change, last state change 00:00:28 
MAC address is 0007.b400.0102 (default) 
Owner ID is aabb.cc00.0100 
Preemption enabled, min delay 30 sec 
Active is local, weighting 100

The following output shows GLBP support for SSO mode on a standby RP:

RouterRP-standby# show glbp 

Ethernet0/0 - Group 1 
State is Init (standby RP, peer state is Standby) 
Virtual IP address is 172.24.1.254 
Hello time 3 sec, hold time 10 sec 
Redirect time 600 sec, forwarder time-out 14400 sec 
Preemption disabled 
Active is unknown 
Standby is unknown 
Priority 100 (default) 
Weighting 100 (default 100), thresholds: lower 1, upper 100 
Load balancing: round-robin 
Group members: 
aabb.cc00.0100 (172.24.1.1) local 
aabb.cc00.0200 (172.24.1.2) 
There are 2 forwarders (0 active) 
Forwarder 1 
State is Init (standby RP, peer state is Listen) 
MAC address is 0007.b400.0101 (learnt) 
Owner ID is aabb.cc00.0200 
Preemption enabled, min delay 30 sec 
Active is unknown 
Forwarder 2 
State is Init (standby RP, peer state is Active) 
MAC address is 0007.b400.0102 (default) 
Owner ID is aabb.cc00.0100 
Preemption enabled, min delay 30 sec 
Active is unknown

GLBP support for Stateful Switchover (SSO) mode is enabled by default but may be disabled by the no glbp sso command. If GLBP support for SSO mode is disabled, the output of the show glbp command on the standby RP will display a warning:

RouterRP-standby# show glbp 

Ethernet0/0 - Group 1 
State is Init (GLBP SSO disabled) <------ GLBP SSO is disabled.
Virtual IP address is 172.24.1.254 
Hello time 3 sec, hold time 10 sec 
Redirect time 600 sec, forwarder time-out 14400 sec 
Preemption disabled 
Active is unknown 
Standby is unknown 
Priority 100 (default) 
Weighting 100 (default 100), thresholds: lower 1, upper 100 
Load balancing: round-robin 
Group members: 
aabb.cc00.0100 (172.24.1.1) local 
There are 2 forwarders (0 active) 
Forwarder 1 
State is Init (GLBP SSO disabled)
MAC address is 0007.b400.0101 (learnt) 
Owner ID is aabb.cc00.0200 
Preemption enabled, min delay 30 sec 
Active is unknown 
Forwarder 2 
State is Init (GLBP SSO disabled)
MAC address is 0007.b400.0102 (default) 
Owner ID is aabb.cc00.0100 
Preemption enabled, min delay 30 sec 
Active is unknown

Table 44 describes the significant fields shown in the displays.

Table 44 show glbp Field Descriptions 

Field
Description

FastEthernet0/0 - Group

Interface type and number and GLBP group number for the interface.

State is

State of the virtual gateway or virtual forwarder. For a virtual gateway, the state can be one of the following:

Active—The gateway is the active virtual gateway (AVG) and is responsible for responding to Address Resolution Protocol (ARP) requests for the virtual IP address.

Disabled—The virtual IP address has not been configured or learned yet, but another GLBP configuration exists.

Initial—The virtual IP address has been configured or learned, but virtual gateway configuration is not complete. An interface must be up and configured to route IP, and an interface IP address must be configured.

Listen—The virtual gateway is receiving hello packets and is ready to change to the "speak" state if the active or standby virtual gateway becomes unavailable.

Speak—The virtual gateway is attempting to become the active or standby virtual gateway.

Standby—The gateway is next in line to be the AVG.

 

For a virtual forwarder, the state can be one of the following:

Active—The gateway is the active virtual forwarder (AVF) and is responsible for forwarding packets sent to the virtual forwarder MAC address.

Disabled—The virtual MAC address has not been assigned or learned. This is a transitory state because a virtual forwarder changing to a disabled state is deleted.

Initial—The virtual MAC address is known, but virtual forwarder configuration is not complete. An interface must be up and configured to route IP, an interface IP address must be configured, and the virtual IP address must be known.

Listen—The virtual forwarder is receiving hello packets and is ready to change to the "active" state if the AVF becomes unavailable.

Virtual IP address is

The virtual IP address of the GLBP group. All secondary virtual IP addresses are listed on separate lines. If one of the virtual IP addresses is a duplicate of an address configured for another device, it will be marked as "duplicate." A duplicate address indicates that the router has failed to defend its ARP cache entry.

Hello time, hold time

The hello time is the time between hello packets (in seconds or milliseconds). The hold time is the time (in seconds or milliseconds) before other routers declare the active router to be down. All routers in a GLBP group use the hello- and hold-time values of the current AVG. If the locally configured values are different, the configured values appear in parentheses after the hello- and hold-time values.

Next hello sent in

The time until GLBP will send the next hello packet (in seconds or milliseconds).

Preemption

Whether GLBP gateway preemption is enabled. If enabled, the minimum delay is the time (in seconds) for which a higher-priority nonactive router will wait before preempting the lower-priority active router.

This field is also displayed under the forwarder section where it indicates GLBP forwarder preemption.

Active is

The active state of the virtual gateway. The value can be "local," "unknown," or an IP address. The address (and the expiration date of the address) is the address of the current AVG.

This field is also displayed under the forwarder section where it indicates the address of the current AVF.

Standby is

The standby state of the virtual gateway. The value can be "local," "unknown," or an IP address. The address (and the expiration date of the address) is the address of the standby gateway (the gateway that is next in line to be the AVG).

Weighting

The initial weighting value with lower and upper threshold values.

Track object

The list of objects that are being tracked and their corresponding states.

IP redundancy name is

The name of the GLBP group.


Related Commands

Command
Description

glbp ip

Enables GLBP.

glbp timers

Configures the time between hello messages and the time before other routers declare the active GLBP router to be down.

glbp weighting track

Specifies an object to be tracked that affects the weighting of a GLBP gateway.


show interface dampening

To display dampened interfaces on the local router, use the show interface dampening command in privileged EXEC mode.

show interface dampening

Syntax Description

This command has no keywords or arguments.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(22)S

This command was introduced.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

12.2(18)SXD

This command was integrated into Cisco IOS Release 12.2(18)SXD.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2.


Examples

The following is sample output from the show interface dampening command:

Router# show interface dampening 

Flaps Penalty    Supp ReuseTm   HalfL  ReuseV   SuppV  MaxSTm    MaxP Restart
      0       0   FALSE       0       5    1000    2000      20   16000       0

Table 45 describes the significant fields shown in the display.

Table 45 show interface dampening Field Descriptions 

Field
Description

Flaps

Displays the number of times that an interface has flapped.

Penalty

Displays the accumulated penalty.

Supp

Indicates if the interface is dampened.

ReuseTm

Displays the reuse timer.

HalfL

Displays the half-life counter.

ReuseV

Displays the reuse threshold timer.

SuppV

Displays the suppress threshold.

MaxSTm

Displays the maximum suppress.

MaxP

Displays the maximum penalty.

Restart

Displays the restart timer.


Related Commands

Command
Description

clear counters

Clears the interface counters.

dampening

Enables IP event dampening at the interface level.

show dampening interface

Displays a summary of interface dampening.


show ip bgp

To display entries in the Border Gateway Protocol (BGP) routing table, use the show ip bgp command in user EXEC or privileged EXEC mode.

show ip bgp [ip-address [mask [longer-prefixes [injected] | shorter-prefixes [length]]] | all | oer-paths | prefix-list name | route-map name]

Syntax Description

ip-address

(Optional) IP address entered to filter the output to display only a particular host or network in the BGP routing table.

mask

(Optional) Mask to filter or match hosts that are part of the specified network.

longer-prefixes

(Optional) Displays the specified route and all more specific routes.

injected

(Optional) Displays more specific prefixes injected into the BGP routing table.

shorter-prefix

(Optional) Displays the specified route and all less specific routes.

length

(Optional) Specifies the prefix length. The value for this argument is a number from 0 to 32.

all

(Optional) Displays all address family information in the BGP routing table.

oer-paths

(Optional) Displays Optimized Edge Routing (OER) controlled prefixes in the BGP routing table.

prefix-list name

(Optional) Filters the output based on the specified prefix list.

route-map name

(Optional) Filters the output based on the specified route map.


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

10.0

This command was introduced.

12.0

The display of prefix advertisement statistics was added.

12.0(6)T

The display of a message indicating support for route refresh capability was added.

12.0(14)ST

The prefix-list, route-map, and shorter-prefixes keywords were added.

12.2(2)T

The output was modified to display multipaths and a best path to the specified network.

12.0(21)ST

The output was modified to show the number of Multiprotocol Label Switching (MPLS) labels that arrive at and depart from the prefix.

12.0(22)S

A new status code indicating stale routes was added to support BGP graceful restart.

12.2(14)S

A message indicating support for BGP policy accounting was added and this command was integrated into Cisco IOS Release 12.2(14)S.

12.2(14)SX

This command was integrated into Cisco IOS Release 12.2(14)SX.

12.2(15)T

A new status code indicating stale routes was added to support BGP graceful restart.

12.3(2)T

The all keyword was added.

12.2(17b)SXA

This command was integrated into Cisco IOS Release 12.2(17b)SXA.

12.3(8)T

The oer-paths keyword was added.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(31)SB2

This command was integrated into Cisco IOS Release 12.2(31)SB2.

12.0(32)S12

This command was modified. Support for displaying 4-byte autonomous system numbers in asdot notation only was added.

12.0(32)SY8

This command was modified. Support for displaying 4-byte autonomous system numbers in asplain and asdot notation was added.

12.4(24)T

This command was modified. Support for displaying 4-byte autonomous system numbers in asdot notation only was added.

Cisco IOS XE Release 2.3

This command was modified. Support for displaying 4-byte autonomous system numbers in asdot notation only was added.

12.2(33)SXI1

This command was modified. Support for displaying 4-byte autonomous system numbers in asplain and asdot notation was added.

12.0(33)S3

This command was modified. Support for displaying 4-byte autonomous system numbers in asplain notation was added and the default display format is now asplain.

Cisco IOS XE Release 2.4

This command was modified. Support for displaying 4-byte autonomous system numbers in asplain notation was added and the default display format is now asplain.

12.2(33)SRE

This command was modified. The command output was modified to show the backup path and the best external path information. Support for the best external route and backup path was added. Support for displaying 4-byte autonomous system numbers in asplain and asdot notation was added.


Usage Guidelines

The show ip bgp command is used to display the contents of the BGP routing table. The output can be filtered to display entries for a specific prefix, prefix length, and prefixes injected through a prefix list, route map, or conditional advertisement.

In Cisco IOS Release 12.0(32)SY8, 12.0(33)S3, 12.2(33)SRE, 12.2(33)SXI1, Cisco IOS XE Release 2.4, and later releases, the Cisco implementation of 4-byte autonomous system numbers uses asplain—65538 for example—as the default regular expression match and output display format for autonomous system numbers, but you can configure 4-byte autonomous system numbers in both the asplain format and the asdot format as described in RFC 5396. To change the default regular expression match and output display of 4-byte autonomous system numbers to asdot format, use the bgp asnotation dot command followed by the clear ip bgp * command to perform a hard reset of all current BGP sessions.

In Cisco IOS Release 12.0(32)S12, 12.4(24)T, and Cisco IOS XE Release 2.3, the Cisco implementation of 4-byte autonomous system numbers uses asdot—1.2 for example—as the only configuration format, regular expression match, and output display, with no asplain support.

oer-paths Keyword

In Cisco IOS Release 12.3(8)T, and later releases, BGP prefixes that are monitored and controlled by OER are displayed by entering the show ip bgp command with the oer-paths keyword.

Examples

show ip bgp: Example

show ip bgp (4-Byte Autonomous System Numbers): Example

show ip bgp ip-address: Example

show ip bgp all: Example

show ip bgp longer-prefixes: Example

show ip bgp shorter-prefixes: Example

show ip bgp prefix-list: Example

show ip bgp route-map: Example

show ip bgp: Example

The following example output shows the BGP routing table:

Router# show ip bgp

BGP table version is 22, local router ID is 10.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
              r RIB-failure, S Stale, m multipath, b backup-path, x best-external
Origin codes: i - IGP, e - EGP, ? - incomplete
   Network          Next Hop            Metric LocPrf Weight Path
*> 10.1.1.1/32      0.0.0.0                  0         32768 i
*>i10.2.2.2/32      172.16.1.2               0    100      0 i
*bi10.9.9.9/32      192.168.3.2              0    100      0 10 10 i
*>                  192.168.1.2                            0 10 10 i
* i172.16.1.0/24    172.16.1.2               0    100      0 i
*>                  0.0.0.0                  0         32768 i
*> 192.168.1.0      0.0.0.0                  0         32768 i
*>i192.168.3.0      172.16.1.2               0    100      0 i
*bi192.168.9.0      192.168.3.2              0    100      0 10 10 i
*>                  192.168.1.2                            0 10 10 i
*bi192.168.13.0     192.168.3.2              0    100      0 10 10 i
*>                  192.168.1.2                            0 10 10 i

Table 46 describes the significant fields shown in the display.

Table 46 show ip bgp Field Descriptions 

Field
Description

BGP table version

Internal version number of the table. This number is incremented whenever the table changes.

local router ID

IP address of the router.

Status codes

Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:

s—The table entry is suppressed.

d—The table entry is dampened.

h—The table entry history.

*—The table entry is valid.

>—The table entry is the best entry to use for that network.

i—The table entry was learned via an internal BGP (iBGP) session.

r—The table entry is a RIB-failure.

S—The table entry is stale.

m—The table entry has multipath to use for that network.

b—The table entry has backup path to use for that network.

x—The table entry has best external route to use for the network.

Origin codes

Origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:

i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.

e—Entry originated from an Exterior Gateway Protocol (EGP).

?—Origin of the path is not clear. Usually, this is a router that is redistributed into BGP from an IGP.

Network

IP address of a network entity.

Next Hop

IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP routes to this network.

Metric

If shown, the value of the interautonomous system metric.

LocPrf

Local preference value as set with the set local-preference route-map configuration command. The default value is 100.

Weight

Weight of the route as set via autonomous system filters.

Path

Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.

(stale)

Indicates that the following path for the specified autonomous system is marked as "stale" during a graceful restart process.


show ip bgp (4-Byte Autonomous System Numbers): Example

The following example output shows the BGP routing table with 4-byte autonomous system numbers, 65536 and 65550, shown under the Path field. This example requires Cisco IOS Release 12.0(32)SY8, 12.0(33)S3, 12.2(33)SRE, 12.2(33)SXI1, Cisco IOS XE Release 2.4, or a later release.

RouterB# show ip bgp

BGP table version is 4, local router ID is 172.17.1.99
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
              r RIB-failure, S Stale
Origin codes: i - IGP, e - EGP, ? - incomplete

   Network          Next Hop            Metric LocPrf Weight Path
*> 10.1.1.0/24      192.168.1.2              0             0 65536  i
*> 10.2.2.0/24      192.168.3.2              0             0 65550  i
*> 172.17.1.0/24    0.0.0.0                  0         32768 i

show ip bgp ip-address: Example

The following example displays information about the 192.168.1.0 entry in the BGP routing table:

Router# show ip bgp 192.168.1.0 

BGP routing table entry for 192.168.1.0/24, version 22
Paths: (2 available, best #2, table default)
  Additional-path
  Advertised to update-groups:
     3
  10 10
    192.168.3.2 from 172.16.1.2 (10.2.2.2)
      Origin IGP, metric 0, localpref 100, valid, internal, backup/repair
  10 10
    192.168.1.2 from 192.168.1.2 (10.3.3.3)
      Origin IGP, localpref 100, valid, external, best , recursive-via-connected

Router# show ip bgp 10.3.3.3 255.255.255.255

BGP routing table entry for 10.3.3.3/32, version 35
Paths: (3 available, best #2, table default)
Multipath: eBGP
Flag: 0x860
  Advertised to update-groups:
     1
  200
    10.71.8.165 from 10.71.8.165 (192.168.0.102)
      Origin incomplete, localpref 100, valid, external, backup/repair
      Only allowed to recurse through connected route
  200
    10.71.11.165 from 10.71.11.165 (192.168.0.102)
      Origin incomplete, localpref 100, weight 100, valid, external, best
      Only allowed to recurse through connected route
  200
    10.71.10.165 from 10.71.10.165 (192.168.0.104)
      Origin incomplete, localpref 100, valid, external,
      Only allowed to recurse through connected route 

Table 47 describes the significant fields shown in the display.

Table 47 show ip bgp Field Descriptions 

Field
Description

BGP routing table entry for

IP address or network number of the routing table entry.

version

Internal version number of the table. This number is incremented whenever the table changes.

Paths

The number of available paths, and the number of installed best paths. This line displays "Default-IP-Routing-Table" when the best path is installed in the IP routing table.

Multipath

This field is displayed when multipath loadsharing is enabled. This field will indicate if the multipaths are iBGP or eBGP.

Advertised to update-groups

The number of each update group for which advertisements are processed.

Origin

Origin of the entry. The origin can be IGP, EGP, or incomplete. This line displays the configured metric (0 if no metric is configured), the local preference value (100 is default), and the status and type of route (internal, external, multipath, best).

Extended Community

This field is displayed if the route carries an extended community attribute. The attribute code is displayed on this line. Information about the extended community is displayed on a subsequent line.


show ip bgp all: Example

The following example output from the show ip bgp command entered with the all keyword. Information about all configured address families is displayed.

Router# show ip bgp all

For address family: IPv4 Unicast   *****
BGP table version is 27, local router ID is 10.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
              r RIB-failure
Origin codes: i - IGP, e - EGP, ? - incomplete

   Network          Next Hop            Metric LocPrf Weight Path
*> 10.1.1.0/24      0.0.0.0                  0         32768 ?
*> 10.13.13.0/24    0.0.0.0                  0         32768 ?
*> 10.15.15.0/24    0.0.0.0                  0         32768 ?
*>i10.18.18.0/24    172.16.14.105         1388  91351      0 100 e
*>i10.100.0.0/16    172.16.14.107          262    272      0 1 2 3 i
*>i10.100.0.0/16    172.16.14.105         1388  91351      0 100 e
*>i10.101.0.0/16    172.16.14.105         1388  91351      0 100 e
*>i10.103.0.0/16    172.16.14.101         1388    173    173 100 e
*>i10.104.0.0/16    172.16.14.101         1388    173    173 100 e
*>i10.100.0.0/16    172.16.14.106         2219  20889      0 53285 33299 51178 47751 e
*>i10.101.0.0/16    172.16.14.106         2219  20889      0 53285 33299 51178 47751 e
*  10.100.0.0/16    172.16.14.109         2309             0 200 300 e
*>                  172.16.14.108         1388             0 100 e
*  10.101.0.0/16    172.16.14.109         2309             0 200 300 e
*>                  172.16.14.108         1388             0 100 e
*> 10.102.0.0/16    172.16.14.108         1388             0 100 e
*> 172.16.14.0/24   0.0.0.0                  0         32768 ?
*> 192.168.5.0      0.0.0.0                  0         32768 ?
*> 10.80.0.0/16     172.16.14.108         1388             0 50 e
*> 10.80.0.0/16     172.16.14.108         1388             0 50 e

For address family: VPNv4 Unicast   *****
BGP table version is 21, local router ID is 10.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
              r RIB-failure
Origin codes: i - IGP, e - EGP, ? - incomplete

   Network          Next Hop            Metric LocPrf Weight Path
Route Distinguisher: 1:1 (default for vrf vpn1)
*> 10.1.1.0/24      192.168.4.3           1622             0 100 53285 33299 51178 
{27016,57039,16690} e
*> 10.1.2.0/24      192.168.4.3           1622             0 100 53285 33299 51178 
{27016,57039,16690} e
*> 10.1.3.0/24      192.168.4.3           1622             0 100 53285 33299 51178 
{27016,57039,16690} e
*> 10.1.4.0/24      192.168.4.3           1622             0 100 53285 33299 51178 
{27016,57039,16690} e
*> 10.1.5.0/24      192.168.4.3           1622             0 100 53285 33299 51178 
{27016,57039,16690} e
*>i172.17.1.0/24    10.3.3.3                 10     30      0 53285 33299 51178 47751 ?
*>i172.17.2.0/24    10.3.3.3                 10     30      0 53285 33299 51178 47751 ?
*>i172.17.3.0/24    10.3.3.3                 10     30      0 53285 33299 51178 47751 ?
*>i172.17.4.0/24    10.3.3.3                 10     30      0 53285 33299 51178 47751 ?
*>i172.17.5.0/24    10.3.3.3                 10     30      0 53285 33299 51178 47751 ?

For address family: IPv4 Multicast   *****
BGP table version is 11, local router ID is 10.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
              r RIB-failure
Origin codes: i - IGP, e - EGP, ? - incomplete

   Network          Next Hop            Metric LocPrf Weight Path
*> 10.40.40.0/26    172.16.14.110        2219             0 21 22 {51178,47751,27016} e
*                   10.1.1.1              1622             0 15 20 1 {2} e
*> 10.40.40.64/26   172.16.14.110        2219             0 21 22 {51178,47751,27016} e
*                   10.1.1.1              1622             0 15 20 1 {2} e
*> 10.40.40.128/26  172.16.14.110        2219             0 21 22 {51178,47751,27016} e
*                   10.1.1.1              2563             0 15 20 1 {2} e
*> 10.40.40.192/26  10.1.1.1              2563             0 15 20 1 {2} e
*> 10.40.41.0/26    10.1.1.1              1209             0 15 20 1 {2} e
*>i10.102.0.0/16    10.1.1.1               300    500      0 5 4 {101,102} e
*>i10.103.0.0/16    10.1.1.1               300    500      0 5 4 {101,102} e

For address family: NSAP Unicast *****
BGP table version is 1, local router ID is 10.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
              r RIB-failure
Origin codes: i - IGP, e - EGP, ? - incomplete

   Network          Next Hop            Metric LocPrf Weight Path
* i45.0000.0002.0001.000c.00
                    49.0001.0000.0000.0a00
                                                  100      0 ?
* i46.0001.0000.0000.0000.0a00
                    49.0001.0000.0000.0a00
                                                  100      0 ?
* i47.0001.0000.0000.000b.00
                    49.0001.0000.0000.0a00
                                                  100      0 ?
* i47.0001.0000.0000.000e.00
                    49.0001.0000.0000.0a00

show ip bgp longer-prefixes: Example

The following is example output from the show ip bgp command entered with the longer-prefixes keyword:

Router# show ip bgp 10.92.0.0 255.255.0.0 longer-prefixes

BGP table version is 1738, local router ID is 192.168.72.24
Status codes: s suppressed, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete

   Network          Next Hop          Metric LocPrf Weight Path
*> 10.92.0.0         10.92.72.30        8896         32768 ?
*                    10.92.72.30                         0 109 108 ?
*> 10.92.1.0         10.92.72.30        8796         32768 ?
*                    10.92.72.30                         0 109 108 ?
*> 10.92.11.0        10.92.72.30       42482         32768 ?
*                    10.92.72.30                         0 109 108 ?
*> 10.92.14.0        10.92.72.30        8796         32768 ?
*                    10.92.72.30                         0 109 108 ?
*> 10.92.15.0        10.92.72.30        8696         32768 ?
*                    10.92.72.30                         0 109 108 ?
*> 10.92.16.0        10.92.72.30        1400         32768 ?
*                    10.92.72.30                         0 109 108 ?
*> 10.92.17.0        10.92.72.30        1400         32768 ?
*                    10.92.72.30                         0 109 108 ?
*> 10.92.18.0        10.92.72.30        8876         32768 ?
*                    10.92.72.30                         0 109 108 ?
*> 10.92.19.0        10.92.72.30        8876         32768 ?
*                    10.92.72.30                         0 109 108 ?

show ip bgp shorter-prefixes: Example

The following is example output from the show ip bgp command entered with the shorter-prefixes keyword. An 8-bit prefix length is specified.

Router# show ip bgp 172.16.0.0/16 shorter-prefixes 8

*> 172.16.0.0         10.0.0.2                               0 ?
*                     10.0.0.2                 0             0 200 ?

show ip bgp prefix-list: Example

The following is example output from the show ip bgp command entered with the prefix-list keyword:

Router# show ip bgp prefix-list ROUTE

BGP table version is 39, local router ID is 10.0.0.1
Status codes:s suppressed, d damped, h history, * valid, > best, i -
internal
Origin codes:i - IGP, e - EGP, ? - incomplete

   Network          Next Hop            Metric LocPrf Weight Path
*> 192.168.1.0      10.0.0.2                               0 ?
*                   10.0.0.2                 0             0 200 ?

show ip bgp route-map: Example

The following is example output from the show ip bgp command entered with the route-map keyword:

Router# show ip bgp route-map LEARNED_PATH

BGP table version is 40, local router ID is 10.0.0.1
Status codes:s suppressed, d damped, h history, * valid, > best, i -
internal
Origin codes:i - IGP, e - EGP, ? - incomplete

   Network          Next Hop            Metric LocPrf Weight Path
*> 192.168.1.0      10.0.0.2                               0 ?
*                   10.0.0.2                 0             0 200 ?

Related Commands

Command
Description

bgp asnotation dot

Changes the default display and the regular expression match format of BGP 4-byte autonomous system numbers from asplain (decimal values) to dot notation.

router bgp

Configures the BGP routing process.


show ip bgp labels

To display information about Multiprotocol Label Switching (MPLS) labels from the external Border Gateway Protocol (eBGP) route table, use the show ip bgp labels command in privileged EXEC mode.

show ip bgp labels

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(21)ST

This command was introduced.

12.0(22)S

This command was integrated into Cisco IOS Release 12.0(22)S.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB and implemented on the Cisco 10000 series router.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.


Usage Guidelines

Use this command to display eBGP labels associated with an Autonomous System Boundary Router (ASBR).

This command displays labels for BGP routes in the default table only. To display labels in the Virtual Private Network (VPN) routing and forwarding (VRF) tables, use the show ip bgp vpnv4 {all | vrf vrf-name} command with the optional labels keyword.

Examples

The following example shows output for an ASBR using BGP as a label distribution protocol:

Router# show ip bgp labels

Network          Next Hop         In Label/Out Label
10.3.0.0/16       0.0.0.0          imp-null/exp-null
10.15.15.15/32   10.15.15.15      18/exp-null
10.16.16.16/32   0.0.0.0          imp-null/exp-null
10.17.17.17/32   10.0.0.1         20/exp-null
10.18.18.18/32   10.0.0.1         24/31
10.18.18.18/32   10.0.0.1         24/33

Table 48 describes the significant fields shown in the display.

Table 48 show ip bgp labels Field Descriptions 

Field
Description

Network

Displays the network address from the eGBP table.

Next Hop

Specifies the eBGP next hop address.

In Label

Displays the label (if any) assigned by this router.

Out Label

Displays the label assigned by the BGP next hop router.


Related Commands

Command
Description

show ip bgp vpnv4

Displays VPN address information from the BGP table.


show ip bgp neighbors

To display information about Border Gateway Protocol (BGP) and TCP connections to neighbors, use the show ip bgp neighbors command in user or privileged EXEC mode.

show ip bgp neighbors [ip-address [advertised-routes | dampened-routes | flap-statistics |
paths [reg-exp] | received prefix-filter | received-routes | routes | policy [detail]]]

Syntax Description

ip-address

(Optional) IP address of a neighbor. If this argument is omitted, information about all neighbors is displayed.

advertised-routes

(Optional) Displays all routes that have been advertised to neighbors.

dampened-routes

(Optional) Displays the dampened routes received from the specified neighbor.

flap-statistics

(Optional) Displays the flap statistics of the routes learned from the specified neighbor (for external BGP peers only).

paths reg-exp

(Optional) Displays autonomous system paths learned from the specified neighbor. An optional regular expression can be used to filter the output.

received prefix-filter

(Optional) Displays the prefix-list (outbound route filter [ORF]) sent from the specified neighbor.

received-routes

(Optional) Displays all received routes (both accepted and rejected) from the specified neighbor.

routes

(Optional) Displays all routes that are received and accepted. The output displayed when this keyword is entered is a subset of the output displayed by the received-routes keyword.

policy

(Optional) Displays the policies applied to this neighbor per address family.

detail

(Optional) Displays detailed policy information such as route maps, prefix lists, community lists, access control lists (ACLs), and autonomous system path filter lists.


Command Default

The output of this command displays information for all neighbors.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

0S Release
Modification

12.0(18)S

The output was modified to display the no-prepend configuration option, and this command was integrated into Cisco IOS Release 12.0(18)S.

12.0(21)ST

The output was modified to display Multiprotocol Label Switching (MPLS) label information.

12.0(22)S

Support for the BGP graceful restart capability was integrated into the output. Support for the Cisco 12000 series routers (Engine 0 and Engine 2) was also added.

12.0(25)S

The policy and detail keywords were added.

12.0(27)S

The command output was modified to support the BGP TTL Security Check feature and to display explicit-null label information.

12.0(31)S

Support for the Bidirectional Forwarding Detection (BFD) feature was integrated into the output.

12.0(32)S12

This command was modified. Support for displaying 4-byte autonomous system numbers in asdot notation only was added.

12.0(32)SY8

This command was modified. Support for displaying 4-byte autonomous system numbers in asplain and asdot notation was added.

12.0(33)S3

This command was modified. Support for displaying 4-byte autonomous system numbers in asplain notation was added and the default display format is now asplain.

S Release
Modification

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(17b)SXA

This command was integrated into Cisco IOS Release 12.2(17b)SXA.

12.2(18)SXE

Support for the Bidirectional Forwarding Detection (BFD) feature was integrated into the output.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA, and the output was modified to support BGP TCP path MTU discovery.

12.2(33)SRB

Support for the policy and detail keywords was integrated into Cisco IOS Release 12.2(33)SRB.

12.2(33)SXH

The output was modified to support BGP dynamic neighbors.

12.2(33)SRC

The output was modified to support BGP graceful restart per peer.

12.2(33)SB

The output was modified to support the BFD and the BGP graceful restart per peer features, and support for the policy and detail keywords was integrated into Cisco IOS Release 12.2(33)SB.

12.2(33)SXI1

This command was modified. Support for displaying 4-byte autonomous system numbers in asplain and asdot notation was added.

12.2(33)SRE

This command was modified. The command output was modified to support the BGP best external and BGP additional path features. Support for displaying 4-byte autonomous system numbers in asplain and asdot notation was added.

Mainline and T Release
Modification

10.0

This command was introduced.

11.2

The received-routes keyword was added.

12.2(4)T

The received and prefix-filter keywords were added, and this command was integrated into Cisco IOS Release 12.2(4)T.

12.2(15)T

Support for the BGP graceful restart capability was integrated into the output.

12.3(7)T

The command output was modified to support the BGP TTL Security Check feature and to display explicit-null label information.

12.4(4)T

Support for the Bidirectional Forwarding Detection (BFD) feature was integrated into the output.

12.4(11)T

Support for the policy and detail keywords was integrated into Cisco IOS Release 12.4(11)T.

12.4(20)T

The output was modified to support BGP TCP path MTU discovery.

12.4(24)T

This command was modified. Support for displaying 4-byte autonomous system numbers in asdot notation only was added.

Cisco IOS XE Release 2
Modification

Cisco IOS XE Release 2.1

This command was integrated into Cisco IOS XE Release 2.1.

Cisco IOS XE Release 2.4

This command was modified. Support for displaying 4-byte autonomous system numbers in asplain notation was added and the default display format is now asplain.


Usage Guidelines

Use the show ip bgp neighbors command to display BGP and TCP connection information for neighbor sessions. For BGP, this includes detailed neighbor attribute, capability, path, and prefix information. For TCP, this includes statistics related to BGP neighbor session establishment and maintenance.

Prefix activity is displayed based on the number of prefixes that are advertised and withdrawn. Policy denials display the number of routes that were advertised but then ignored based on the function or attribute that is displayed in the output.

In Cisco IOS Release 12.0(32)SY8, 12.0(33)S3, 12.2(33)SRE, 12.2(33)SXI1, Cisco IOS XE Release 2.4, and later releases, the Cisco implementation of 4-byte autonomous system numbers uses asplain—65538 for example—as the default regular expression match and output display format for autonomous system numbers, but you can configure 4-byte autonomous system numbers in both the a