Table Of Contents

service slave-log

service tcp-keepalives-in

service tcp-keepalives-out

service tcp-small-servers

service telnet-zero-idle

service timestamps

service udp-small-servers

setup

show aliases

show async bootp

show bootvar

show buffers

show c2600

show c7200

show calendar

show cdp entry

show cdp interface

show cdp neighbors

show cdp traffic

show cdp

show clock

show cls

show cns config connections

show cns config outstanding

show cns config stats

show cns config status

show cns event connections

show cns event gateway

show cns event stats

show cns event status

show cns event subject

show cns image connections

show cns image inventory

show cns image status

show <command> append

show <command> begin

show <command> exclude

show <command> include

show <command> redirect

show <command> tee

service slave-log

To allow slave Versatile Interface Processor (VIP) cards to log important error messages to the console, use the service slave-log command in global configuration mode. To disable slave logging, use the no form of this command.

service slave-log

no service slave-log

Syntax Description

This command has no arguments or keywords.

Defaults

This command is enabled by default.

Command Modes

Global configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

This command allows slave slots to log error messages of level 2 or higher (critical, alerts, and emergencies).

Examples

In the following example, the router is configured to log important messages from the slave cards to the console:

Router(config)# service slave-log 

The following is sample output generated when this command is enabled:

%IPC-5-SLAVELOG: VIP-SLOT2:

 IPC-2-NOMEM: No memory available for IPC system initialization

The first line indicates which slot sent the message. The second line contains the error message.

service tcp-keepalives-in

To generate keepalive packets on idle incoming network connections (initiated by the remote host), use the service tcp-keepalives-in command in global configuration mode. To disable the keepalives, use the no form of this command.

service tcp-keepalives-in

no service tcp-keepalives-in

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration

Command History

Release	Modification
10.0	This command was introduced.

Examples

In the following example, keepalives on incoming TCP connections are generated:

Router(config)# service tcp-keepalives-in 

Related Commands

Command	Description
service tcp-keepalives-out	Generates keepalive packets on idle outgoing network connections (initiated by a user).

service tcp-keepalives-out

To generate keepalive packets on idle outgoing network connections (initiated by a user), use the service tcp-keepalives-out command in global configuration mode. To disable the keepalives, use the no form of this command.

service tcp-keepalives-out

no service tcp-keepalives-out

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration

Command History

Release	Modification
10.0	This command was introduced.

Examples

In the following example, keepalives on outgoing TCP connections are generated:

Router(config)# service tcp-keepalives-out 

Related Commands

Command	Description
service tcp-keepalives-in	Generates keepalive packets on idle incoming network connections (initiated by the remote host).

service tcp-small-servers

To access minor TCP/IP services available from hosts on the network, use the service tcp-small-servers command in global configuration mode. To disable these services, use the no form of the command.

service tcp-small-servers

no service tcp-small-servers

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

By default, the TCP servers for Echo, Discard, Chargen, and Daytime services are disabled.

When the minor TCP/IP servers are disabled, access to the Echo, Discard, Chargen, and Daytime ports cause the Cisco IOS software to send a TCP RESET packet to the sender and discard the original incoming packet.

Examples

The following example enables minor TCP/ IP services available from the network:

Router(config)# service tcp-small-servers 

service telnet-zero-idle

To set the TCP window to zero (0) when the Telnet connection is idle, use the service telnet-zero-idle command in global configuration mode. To disable this service, use the no form of this command.

service telnet-zero-idle

no service telnet-zero-idle

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Normally, data sent to noncurrent Telnet connections is accepted and discarded. When the service telnet-zero-idle command is enabled, if a session is suspended (that is, some other connection is made active or the EXEC is sitting in command mode), the TCP window is set to zero. This action prevents the remote host from sending any more data until the connection is resumed. Use this command when it is important that all messages sent by the host be seen by the users and the users are likely to use multiple sessions.

Do not use this command if your host will eventually time out and log out a TCP user whose window is zero.

Examples

The following example sets the TCP window to zero when the Telnet connection is idle:

Router(config)# service telnet-zero-idle

Related Commands

Command	Description
resume	Switches to another open Telnet, rlogin, LAT, or PAD session.

service timestamps

To configure the system to time-stamp debugging or system logging messages, use one of the service timestamps commands in global configuration mode. To disable this service, use the no form of this command.

service timestamps [debug | log] [ uptime | datetime [msec] [localtime] [show-timezone] [year] ]

no service timestamps [debug | log]

Syntax Description

debug	Indicates that the timestamp should be applied to debugging messages.
log	Indicates that the timestamp should be applied to system logging messages.
uptime	Time stamp with the time since the system was rebooted. The time stamp format for uptime is HHHH:MM:SS.
datetime	Time stamp with the date and time. The time stamp format for datetime is MMM DD HH:MM:SS.
msec	(Optional) Include milliseconds in the time stamp.
localtime	(Optional) Time stamp relative to the local time zone.
year	Include the year in the datetime format.
show-timezone	(Optional) Include the time zone name in the time stamp.

Defaults

No time-stamping.

If the service timestamps command is specified with no arguments or keywords, the default is service timestamps debug uptime.

The default for the service timestamps type datetime command is to format the time in Coordinated Universal Time (UTC), with no milliseconds and no time zone name.

The no service timestamps command by itself disables time stamps for both debug and log messages.

To set the local timezone, use the clock timezone zone hours-offset command in global configuration mode.

Command Modes

Global configuration

Command History

Release	Modification
10.0	This command was introduced.
12.2(15)T	The year keyword was added.

Usage Guidelines

Time stamps can be added to either debugging or logging messages independently. The uptime form of the command adds time stamps in the format HHHH:MM:SS, indicating the time since the system was rebooted. The datetime form of the command adds time stamps in the format MMM DD HH:MM:SS, indicating the date and time according to the system clock.

The timestamp will be preceeded by an asterisk or period if the time is potentially inaccurate. Table 43 describes the symbols that proceed the timestamp.

Table 43 Timestamping Symbols for syslog Messages

Symbol	Description	Example
(blank)	Time is authoritative: the software clock is in sync or has just been set manually	15:29:03.158 UTC Tue Feb 25 2003:
*	Time is not authoritative: the software clock has not been set, or is not in sync with configured Network Time Protocol (NTP) servers.	*15:29:03.158 UTC Tue Feb 25 2003:
.	Time is authoritative, but the Network Time Protocol (NTP) is not synchronized: the software clock was in sync, but has since lost contact with all configured NTP servers.	.15:29:03.158 UTC Tue Feb 25 2003:

Examples

In the following example, the user enables time stamps on debugging messages, showing the time since reboot:

service timestamps debug uptime

In the following example, the user enables time stamps on logging messages, showing the current time and date relative to the local time zone, with the time zone name included:

Router(config)#

! The following line shows timestamp with uptime.

1w0d: %SYS-5-CONFIG_I: Configured from console by console

Router(config)# service timestamps log datetime localtime show-timezone 

Router(config)# end

Router#

! The following line shows timestamp with datetime.

.Mar 22 23:13:25 UTC: %SYS-5-CONFIG_I: Configured from console by console

The following example shows the change from UTC to local time:

Router#

.Mar 22 23:23:10 UTC: %SYS-5-CONFIG_I: Configured from console by console

Router# config terminal 

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

Router(config)# clock timezone PST -8 

Router(config)# end 

Router#

.Mar 22 15:28:02 PST: %SYS-5-CONFIG_I: Configured from console by console

Related Commands

Command	Description
clock set	Manually sets the system clock.
ntp	Controls access to the system's NTP services.
service sequence-numbers	Stamps system logging messages with a sequence number.

service udp-small-servers

To access minor User Datagram Protocol (UDP) services available from hosts on the network, use the service udp-small-servers command in global configuration mode. To disable these services, use the no form of this command.

service udp-small-servers

no service udp-small-servers

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

By default the UPD servers for Echo, Discard, and Chargen services are disabled.

When the servers are disabled, access to Echo, Discard, and Chargen ports causes the Cisco IOS software to send an "ICMP port unreachable" message to the sender and discard the original incoming packet.

Examples

In the following example, the UDP server (UDP services) is enabled:

Router(config)# service udp-small-servers

setup

To enter Setup mode, use the setup command in privileged EXEC mode.

setup

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

Setup mode gives you the option of configuring your system without using the Cisco IOS Command Line Interface (CLI). For some tasks, you may find it easier to use Setup than to enter Cisco IOS commands individually. For example, you might want to use Setup to add a protocol suite, to make major addressing scheme changes, or to configure a newly installed interface. Although you can use the CLI to make these changes, Setup provides you with a high-level view of the configuration and guides you through the configuration process.

If you are not familiar with Cisco products and the CLI, Setup is a particularly valuable tool because it prompts you for the specific information required to configure your system.

---

Note If you use the Setup mode to modify a configuration because you have added or modified the hardware, be sure to verify the physical connections using the show version EXEC command. Also, verify the logical port assignments using the show running-config EXEC command to ensure that you configure the correct port. Refer to the hardware documentation for your platform for more information on physical and logical port assignments.

---

Before using the Setup mode, you should have the following information so that you can configure the system properly:

•Which interfaces you want to configure

•Which routing protocols you wish to enable

•Whether the router is to perform bridging

•Network addresses for the protocols being configured

•Password strategy for your environment

When you enter the setup EXEC command after first-time startup, an interactive dialog called the System Configuration Dialog appears on the system console screen. The System Configuration Dialog guides you through the configuration process. It prompts you first for global parameters and then for interface parameters. The values shown in brackets next to each prompt reflect either the default settings or the last configured setting.

The prompts and the order in which they appear on the screen vary depending on the platform and the interfaces installed in the device.

You must progress through the System Configuration Dialog until you come to the item that you intend to change. To accept default settings for items that you do not want to change, press the Return or Enter key. The default choice is indicated by square brackets (for example, [yes]) before the prompt colon (:).

To exit Setup mode and return to privileged EXEC mode without making changes and without progressing through the entire System Configuration Dialog, press Ctrl-C.

The facility also provides help text for each prompt. To access help text, press the question mark (?) key at a prompt.

When you complete your changes, the system will automatically display the configuration file that was created during the Setup session. It also asks you if you want to use this configuration. If you answer Yes, the configuration is saved to NVRAM as the startup configuration file. If you answer No, the configuration is not saved and the process begins again. There is no default for this prompt; you must answer either Yes or No.

Examples

The following example displays the setup command facility to configure serial interface 0 and to add ARAP and IP/IPX PPP support on the asynchronous interfaces:

Router# setup

         --- System Configuration Dialog ---

At any point you may enter a question mark '?' for help.

Use ctrl-c to abort configuration dialog at any prompt.

Default settings are in square brackets '[]'.

Continue with configuration dialog? [yes]: 

First, would you like to see the current interface summary? [yes]: 

Interface          IP-Address      OK?  Method    Status                 Protocol

Ethernet0          172.16.72.2     YES  manual    up                     up      

Serial0            unassigned      YES  not set   administratively down  down    

Serial1            172.16.72.2     YES  not set   up                     up    

Configuring global parameters:

  Enter host name [Router]: 

The enable secret is a one-way cryptographic secret used

instead of the enable password when it exists.

  Enter enable secret [<Use current secret>]: 

The enable password is used when there is no enable secret

and when using older software and some boot images.

  Enter enable password [ww]: 

  Enter virtual terminal password [ww]: 

  Configure SNMP Network Management? [yes]: 

    Community string [public]: 

  Configure DECnet? [no]: 

  Configure AppleTalk? [yes]: 

    Multizone networks? [no]: yes

  Configure IPX? [yes]: 

  Configure IP? [yes]: 

    Configure IGRP routing? [yes]: 

      Your IGRP autonomous system number [15]: 

  Configure Async lines? [yes]: 

    Async line speed [9600]: 57600

    Configure for HW flow control? [yes]: 

    Configure for modems? [yes/no]: yes

      Configure for default chat script? [yes]: no

    Configure for Dial-in IP SLIP/PPP access? [no]: yes

      Configure for Dynamic IP addresses? [yes]: no 

      Configure Default IP addresses? [no]: yes

      Configure for TCP Header Compression? [yes]: no

      Configure for routing updates on async links? [no]: 

    Configure for Async IPX? [yes]: 

    Configure for Appletalk Remote Access? [yes]: 

      AppleTalk Network for ARAP clients [1]: 20

      Zone name for ARAP clients [ARA Dialins]: 

Configuring interface parameters:

Configuring interface Ethernet0:

  Is this interface in use? [yes]: 

  Configure IP on this interface? [yes]: 

    IP address for this interface [172.16.72.2]: 

    Number of bits in subnet field [8]: 

    Class B network is 172.16.0.0, 8 subnet bits; mask is /24

  Configure AppleTalk on this interface? [yes]: 

    Extended AppleTalk network? [yes]: 

    AppleTalk starting cable range [1]: 

    AppleTalk ending cable range [1]: 

    AppleTalk zone name [Sales]: 

    AppleTalk additional zone name: 

  Configure IPX on this interface? [yes]: 

    IPX network number [1]: 

Configuring interface Serial0:

  Is this interface in use? [no]: yes

  Configure IP on this interface? [no]: yes

  Configure IP unnumbered on this interface? [no]: yes

    Assign to which interface [Ethernet0]: 

  Configure AppleTalk on this interface? [no]: yes

    Extended AppleTalk network? [yes]: 

    AppleTalk starting cable range [2]: 3

    AppleTalk ending cable range [3]: 3

    AppleTalk zone name [myzone]: ZZ Serial

    AppleTalk additional zone name: 

  Configure IPX on this interface? [no]: yes

    IPX network number [2]: 3

Configuring interface Serial1:

  Is this interface in use? [yes]: 

  Configure IP on this interface? [yes]: 

  Configure IP unnumbered on this interface? [yes]: 

    Assign to which interface [Ethernet0]: 

  Configure AppleTalk on this interface? [yes]: 

    Extended AppleTalk network? [yes]: 

    AppleTalk starting cable range [2]: 

    AppleTalk ending cable range [2]: 

    AppleTalk zone name [ZZ Serial]: 

    AppleTalk additional zone name: 

  Configure IPX on this interface? [yes]: 

    IPX network number [2]: 

Configuring interface Async1: 

    IPX network number [4]: 

    Default client IP address for this interface [none]: 172.16.72.4 

Configuring interface Async2:

    IPX network number [5]: 

    Default client IP address for this interface [172.16.72.5]: 

Configuring interface Async3:

    IPX network number [6]: 

    Default client IP address for this interface [172.16.72.6]: 

Configuring interface Async4:

    IPX network number [7]: 

    Default client IP address for this interface [172.16.72.7]: 

Configuring interface Async5:

    IPX network number [8]: 

    Default client IP address for this interface [172.16.72.8]: 

Configuring interface Async6:

    IPX network number [9]: 

    Default client IP address for this interface [172.16.72.9]: 

Configuring interface Async7:

    IPX network number [A]: 

    Default client IP address for this interface [172.16.72.10]: 

Configuring interface Async8:

    IPX network number [B]: 

    Default client IP address for this interface [172.16.72.11]: 

Configuring interface Async9:

    IPX network number [C]:  

    Default client IP address for this interface [172.16.72.12]:  

Configuring interface Async10:

    IPX network number [D]: 

    Default client IP address for this interface [172.16.72.13]: 

Configuring interface Async11:

    IPX network number [E]: 

    Default client IP address for this interface [172.16.72.14]: 

Configuring interface Async12:

    IPX network number [F]: 

    Default client IP address for this interface [172.16.72.15]: 

Configuring interface Async13:

    IPX network number [10]: 

    Default client IP address for this interface [172.16.72.16]: 

Configuring interface Async14:

    IPX network number [11]: 

    Default client IP address for this interface [172.16.72.17]: 

Configuring interface Async15:

    IPX network number [12]: 

    Default client IP address for this interface [172.16.72.18]: 

Configuring interface Async16: 

    IPX network number [13]: 

    Default client IP address for this interface [172.16.72.19]:  

The following configuration command script was created:

hostname Router

enable secret 5 $1$krIg$emfYm/1OwHVspDuS8Gy0K1

enable password ww

line vty 0 4

password ww

snmp-server community public

!

no decnet routing

appletalk routing

ipx routing

ip routing

!

line 1 16

speed 57600

flowcontrol hardware

modem inout

!

arap network 20 ARA Dialins

line 1 16

arap enable

autoselect

!

! Turn off IPX to prevent network conflicts.

interface Ethernet0

no ipx network

interface Serial0

no ipx network

interface Serial1

no ipx network

!

interface Ethernet0

ip address 172.16.72.2 255.255.255.0

appletalk cable-range 1-1 1.204

appletalk zone Sales

ipx network 1

no mop enabled

!

interface Serial0

no shutdown

no ip address

ip unnumbered Ethernet0

appletalk cable-range 3-3

appletalk zone ZZ Serial

ipx network 3

no mop enabled

!

interface Serial1

no ip address

ip unnumbered Ethernet0

appletalk cable-range 2-2 2.2

appletalk zone ZZ Serial

ipx network 2

no mop enabled

!

Interface Async1

ipx network 4

ip unnumbered Ethernet0

peer default ip address 172.16.72.4

async mode interactive

!

Interface Async2

ipx network 5

ip unnumbered Ethernet0

peer default ip address 172.16.72.5

async mode interactive

!

Interface Async3

ipx network 6

ip unnumbered Ethernet0

peer default ip address 172.16.72.6

async mode interactive

!

Interface Async4

ipx network 7

ip unnumbered Ethernet0

peer default ip address 172.16.72.7

async mode interactive

async dynamic address

!

Interface Async5

ipx network 8

ip unnumbered Ethernet0

peer default ip address 172.16.72.8

async mode interactive

!

Interface Async6

ipx network 9

ip unnumbered Ethernet0

peer default ip address 172.16.72.9

async mode interactive

!

Interface Async7

ipx network A

ip unnumbered Ethernet0

peer default ip address 172.16.72.10

async mode interactive

!

Interface Async8

ipx network B

ip unnumbered Ethernet0

peer default ip address 172.16.72.11

async mode interactive

!

Interface Async9

ipx network C

ip unnumbered Ethernet0

peer default ip address 172.16.72.12

async mode interactive

!

Interface Async10

ipx network D

ip unnumbered Ethernet0

peer default ip address 172.16.72.13

async mode interactive

!

Interface Async11

ipx network E

ip unnumbered Ethernet0

peer default ip address 172.16.72.14

async mode interactive

!

Interface Async12

ipx network F

ip unnumbered Ethernet0

peer default ip address 172.16.72.15

async mode interactive

!

Interface Async13

ipx network 10

ip unnumbered Ethernet0

peer default ip address 172.16.72.16

async mode interactive

!

Interface Async14

ipx network 11

ip unnumbered Ethernet0

peer default ip address 172.16.72.17

async mode interactive

!

Interface Async15

ipx network 12

ip unnumbered Ethernet0

peer default ip address 172.16.72.18

async mode interactive

!

Interface Async16

ipx network 13

ip unnumbered Ethernet0

peer default ip address 172.16.72.19

async mode interactive

!

router igrp 15

network 172.16.0.0

!

end

Use this configuration? [yes/no]: yes

Building configuration...

Use the enabled mode 'configure' command to modify this configuration.      

Router#

Related Commands

Command	Description
erase nvram:	Erases a file system.
show running-config	Displays the running configuration file. Command alias for the more system:running-config command.
show startup-config	Displays the startup configuration file. Command alias for the more system:startup-config command.
show version	Displays the configuration of the system hardware, the software version, the names and sources of configuration files, and the boot images.

show aliases

To display all alias commands, or the alias commands in a specified mode, use the show aliases command in EXEC mode.

show aliases [mode]

Syntax Description

mode	(Optional) Name of a specific command or configuration mode. Specifies that only aliases configured for this mode should be displayed.

Command Modes

EXEC

Command History

Release	Modification
10.3	This command was introduced.

Usage Guidelines

When used without the mode argument, this command will display all aliases currently configured on the system. Use the mode argument to display only the aliases configured for the specified command mode.

To display a list of the command mode keywords available for your system, use the show aliases ? command. For a list of command modes, refer to the "Cisco IOS Command Modes" appendix in the Cisco IOS Configuration Fundamentals Configuration Guide.

Examples

The following is sample output from the show aliases exec commands. The aliases configured for commands in EXEC mode are displayed.

Router> show aliases exec

Exec mode aliases:

  h                    help

  lo                   logout

  p                    ping

  r                    resume

  s                    show

  w                    where

Related Commands

Command	Description
alias	Creates a command alias.

show async bootp

To display the extended BOOTP request parameters that have been configured for asynchronous interfaces, use the show async bootp command in privileged EXEC mode.

show async bootp

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
10.0	This command was introduced.

Examples

The following is sample output from the show async bootp command:

Router# show async bootp

The following extended data will be sent in BOOTP responses:

bootfile (for address 192.168.1.1) "pcboot"

bootfile (for address 172.16.1.111) "dirtboot"

subnet-mask 255.255.0.0

time-offset -3600

time-server 192.168.1.1

Table 44 describes the significant fields shown in the display.

Table 44 show async bootp Field Descriptions 

Field	Description
bootfile... "pcboot"	Boot file for address 192.168.1.1 is named pcboot.
subnet-mask 255.255.0.0	Subnet mask.
time-offset -3600	Local time is one hour (3600 seconds) earlier than UTC time.
time-server 192.168.1.1	Address of the time server for the network.

Related Commands

Command	Description
async-bootp	Configures extended BOOTP requests for asynchronous interfaces as defined in RFC 1084.

show bootvar

To display the contents of the BOOT variable, the name of the configuration file pointed to by the CONFIG_FILE variable, the contents of the BOOTLDR variable, and the configuration register setting, use the show bootvar command in EXEC mode.

show bootvar

Syntax Description

This command has no arguments or keywords.

Command Modes

EXEC

Command History

Release	Modification
11.3 AA	This command was introduced.

Usage Guidelines

The show bootvar command replaces the show boot command.

The show bootvar command allows you to view the current settings for the following variables:

•BOOT

•CONFIG_FILE

•BOOTLDR

The BOOT variable specifies a list of bootable images on various devices. The CONFIG_FILE variable specifies the configuration file used during system initialization. The BOOTLDR variable specifies the Flash device and filename containing the rxboot image that ROM uses for booting. You set these variables with the boot system, boot config, and boot bootldr global configuration commands, respectively.

When you use this command on a device with multiple RSP cards (Dual RSPs), this command also shows you the variable settings for both the master and slave RSP card.

Examples

The following is sample output from the show bootvar command:

Router# show bootvar

BOOT variable =

CONFIG_FILE variable = nvram:

Current CONFIG_FILE variable = slot0:router-config

BOOTLDR variable not exist

Configuration register is 0x0

Router#

In the sample output, the BOOT variable contains a null string. That is, a list of bootable images is not specified.

The CONFIG_FILE variable points to the configuration file in NVRAM as the startup (initialization) configuration. The run-time value for the CONFIG_FILE variable points to the router-config file on the Flash memory card inserted in the first slot of the RSP card. That is, during the run-time configuration, you have modified the CONFIG_FILE variable using the boot config command, but you have not saved the run-time configuration to the startup configuration. To save your run-time configuration to the startup configuration, use the copy system:running-config nvram:startup-config command. If you do not save the run-time configuration to the startup configuration, then the system reverts to the saved CONFIG_FILE variable setting for initialization information upon reload. In this sample, the system reverts to NVRAM for the startup configuration file.

The BOOTLDR variable does not yet exist. That is, you have not created the BOOTLDR variable using the boot bootldr global configuration command.

The following example is output from the show bootvar command for a Cisco 7513 router configured for HSA:

Router# show bootvar

BOOT variable =

CONFIG_FILE variable =

Current CONFIG_FILE variable =

BOOTLDR variable does not exist

Configuration register is 0x0

current slave is in slot 7

BOOT variable =

CONFIG_FILE variable =

BOOTLDR variable does not exist

Configuration register is 0x0

Router#

Related Commands

Command	Description
boot bootstrap	Configures the filename that is used to boot a secondary bootstrap image.
boot config	Specifies the device and filename of the configuration file from which the router configures itself during initialization (startup).
boot system	Specifies the system image that the router loads at startup.
show version	Displays the configuration of the system hardware, the software version, the names and sources of configuration files, and the boot images.

show buffers

To display statistics for the buffer pools on the network server, use the show buffers command in user EXEC or privileged EXEC mode.

show buffers [{address hex-address | failures | pool pool-name | {all | assigned | free | old | input-interface interface-type interface-number} [pool pool-name]} [dump | header | packet]]

Syntax Description

address hex-address	(Optional) Displays buffers at a specified address. Specify address in hexadecimal notation.
failures	(Optional) Displays buffer allocation failures.
pool pool-name	(Optional) Displays buffers in a specified buffer pool.
all	(Optional) Displays all buffers.
assigned	(Optional) Displays the buffers in use.
free	(Optional) Displays the buffers available for use.
old	(Optional) Displays buffers older than one minute.
input-interface interface-type interface-number	(Optional) Displays interface pool information. If an interface type is specified and this interface has its own buffer pool, information for that pool is displayed.
dump	(Optional) Displays the buffer header and all data.
header	(Optional) Displays the buffer header only.
packet	(Optional) Displays the buffer header and packet data.

Command Modes

User EXEC
Privileged EXEC

Command History

Release	Modification
10.0	This command was introduced.
12.3	The option to filter display output based on specific buffer pools was expanded.

Usage Guidelines

The peak field in the output of the show buffers command shows the maximum number of buffers created (highest total) and the time when that peak occurred relative to when you issued the show buffers command. Formats include weeks, days, hours, minutes, and seconds. Not all systems report a peak value, which means this field may not display in output.

Examples

The following is sample output from the show buffers command with no arguments, showing all buffer pool information:

Router> show buffers

Buffer elements:

     398 in free list (500 max allowed)

     1266 hits, 0 misses, 0 created

Public buffer pools:

Small buffers, 104 bytes (total 50, permanent 50):

     50 in free list (20 min, 150 max allowed)

     551 hits, 0 misses, 0 trims, 0 created

Middle buffers, 600 bytes (total 25, permanent 25):

     25 in free list (10 min, 150 max allowed)

     39 hits, 0 misses, 0 trims, 0 created

Big buffers, 1524 bytes (total 50, permanent 50):

     49 in free list (5 min, 150 max allowed)

     27 hits, 0 misses, 0 trims, 0 created

VeryBig buffers, 4520 bytes (total 10, permanent 10):

     10 in free list (0 min, 100 max allowed)

     0 hits, 0 misses, 0 trims, 0 created

Large buffers, 5024 bytes (total 0, permanent 0):

     0 in free list (0 min, 10 max allowed)

     0 hits, 0 misses, 0 trims, 0 created

Huge buffers, 18024 bytes (total 0, permanent 0):

     0 in free list (0 min, 4 max allowed)

     0 hits, 0 misses, 0 trims, 0 created

Interface buffer pools:

Ethernet0 buffers, 1524 bytes (total 64, permanent 64):

     16 in free list (0 min, 64 max allowed)

     48 hits, 0 fallbacks

     16 max cache size, 16 in cache

Ethernet1 buffers, 1524 bytes (total 64, permanent 64):

     16 in free list (0 min, 64 max allowed)

     48 hits, 0 fallbacks

     16 max cache size, 16 in cache

Serial0 buffers, 1524 bytes (total 64, permanent 64):

     16 in free list (0 min, 64 max allowed)

     48 hits, 0 fallbacks

     16 max cache size, 16 in cache

Serial1 buffers, 1524 bytes (total 64, permanent 64):

     16 in free list (0 min, 64 max allowed)

     48 hits, 0 fallbacks

     16 max cache size, 16 in cache

TokenRing0 buffers, 4516 bytes (total 48, permanent 48):

     0 in free list (0 min, 48 max allowed)

     48 hits, 0 fallbacks

     16 max cache size, 16 in cache

TokenRing1 buffers, 4516 bytes (total 32, permanent 32):

     32 in free list (0 min, 48 max allowed)

     16 hits, 0 fallbacks

     0 failures (0 no memory)

The following is sample output from the show buffers command with no arguments, showing onlybuffer pool information for Huge buffers. This output shows a highest total of five Huge buffers created five days and 18 hours before the command was issued.

Router> show buffers

Huge buffers, 18024 bytes (total 5, permanent 0, peak 5 @ 5d18h): 
     4 in free list (3 min, 104 max allowed) 
     0 hits, 1 misses, 101 trims, 106 created 
     0 failures (0 no memory)

The following is sample output from the show buffers command with no arguments, showing only buffer pool information for Huge buffers. This output shows a highest total of 184 Huge buffers created one hour, one minute, and 15 seconds before the command was issued.

Router> show buffers

Huge buffers, 65280 bytes (total 4, permanent 2, peak 184 @ 01:01:15):

     4 in free list (0 min, 4 max allowed)

     32521 hits, 143636 misses, 14668 trims, 14670 created

     143554 failures (0 no memory)

The following is sample output from the show buffers command with an interface type and interface number:

Router> show buffers Ethernet 0

Ethernet0 buffers, 1524 bytes (total 64, permanent 64):

     16 in free list (0 min, 64 max allowed)

     48 hits, 0 fallbacks

     16 max cache size, 16 in cache

Table 45 describes the significant fields shown in the display.

Table 45 show buffers Field Descriptions 

Field	Description
Buffer elements	Small structures used as placeholders for buffers in internal operating system queues. Used when a buffer may need to be on more than one queue.
free list	Total number of the currently unallocated buffer elements.
max allowed	Maximum number of buffers that are available for allocation.
hits	Count of successful attempts to allocate a buffer when needed.
misses	Count of buffer allocation attempts that resulted in growing the buffer pool to allocate a buffer.
created	Count of new buffers created to satisfy buffer allocation attempts when the available buffers in the pool have already been allocated.
Public buffer pools:
Small buffers	Buffers that are 104 bytes long.
Middle buffers	Buffers that are 600 bytes long.
Big buffers	Buffers that are 1524 bytes long.
VeryBig buffers	Buffers that are 4520 bytes long.
Large buffers	Buffers that are 5024 bytes long.
Huge buffers	Buffers that are 18,024 bytes long.
total	Total number of this type of buffer.
permanent	Number of these buffers that are permanent.
peak	Maximum number of buffers created (highest total) and the time when that peak occurred. Formats include weeks, days, hours, minutes, and seconds. Not all systems report a peak value, which means this field may not display in output.
free list	Number of available or unallocated buffers in that pool.
min	Minimum number of free or unallocated buffers in the buffer pool.
max allowed	Maximum number of free or unallocated buffers in the buffer pool.
hits	Count of successful attempts to allocate a buffer when needed.
misses	Count of buffer allocation attempts that resulted in growing the buffer pool in order to allocate a buffer.
trims	Count of buffers released to the system because they were not being used. This field is displayed only for dynamic buffer pools, not interface buffer pools, which are static.
created	Count of new buffers created in response to misses. This field is displayed only for dynamic buffer pools, not interface buffer pools, which are static.
Interface buffer pools:
total	Total number of this type of buffer.
permanent	Number of these buffers that are permanent.
free list	Number of available or unallocated buffers in that pool.
min	Minimum number of free or unallocated buffers in the buffer pool.
max allowed	Maximum number of free or unallocated buffers in the buffer pool.
hits	Count of successful attempts to allocate a buffer when needed.
fallbacks	Count of buffer allocation attempts that resulted in falling back to the public buffer pool that is the smallest pool at least as big as the interface buffer pool.
max cache size	Maximum number of buffers from the pool of that interface that can be in the buffer pool cache of that interface. Each interface buffer pool has its own cache. These are not additional to the permanent buffers; they come from the buffer pools of the interface. Some interfaces place all of their buffers from the interface pool into the cache. In this case, it is normal for the free list to display 0.
failures	Total number of times a buffer creation failed. The failure may have occurred because of a number of different reasons, such as low processor memory, low IOMEM, or no buffers in the pool when called from interrupt context.
no memory	Number of times there has been low memory during buffer creation. Low or no memory during buffer creation may not necessarily mean that buffer creation failed; memory can be obtained from an alternate resource such as a fallback pool.

show c2600

To display information for troubleshooting the Cisco 2600 series router, use the show c2600 command in EXEC mode.

show c2600

Syntax Description

This command has no arguments or keywords.

Command Modes

EXEC

Command History

Release	Modification
11.3 XA	This command was introduced.

Usage Guidelines

The show c2600 command provides complex troubleshooting information that pertains to the platform's shared references rather than to a specific interface.

Examples

The following is sample output from the show c2600 command:

Router# show c2600

C2600 Platform Information:

Interrupts:

 Assigned Handlers...

  Vect  Handler   # of Ints   Name

    00  801F224C   00000000   Xilinx bridge error interrupt

    01  801DE768   0D3EE155   MPC860 TIMER INTERRUPT

    02  801E94E0   0000119E   16552 Con/Aux Interrupt

    04  801F0D94   00000000   PA Network Management Int Handler

    05  801E6C34   00000000   Timebase Reference Interrupt

    06  801F0DE4   00002C1A   PA Network IO Int Handler

    07  801F0EA0   0000015D   MPC860 CPM INTERRUPT

    14  801F224C   00000000   Xilinx bridge error interrupt

 IOS Priority Masks...

  Level 00 = [ EF020000 ]

  Level 01 = [ EC020000 ]

  Level 02 = [ E8020000 ]

  Level 03 = [ E0020000 ]

  Level 04 = [ E0020000 ]

  Level 05 = [ E0020000 ]

  Level 06 = [ C0020000 ]

  Level 07 = [ 00000000 ]

 SIU_IRQ_MASK  = FFFFFFFF  SIEN   = EF02xxxx   Current Level = 00

 Spurious IRQs = 00000000  SIPEND = 0000xxxx

 Interrupt Throttling:

  Throttle Count = 00000000   Timer Count      = 00000000

  Netint usec    = 00000000   Netint Mask usec = 000003E8

  Active         =        0   Configured       =        0

  Longest IRQ    = 00000000

IDMA Status:

 Requests = 00000349      Drops                = 00000000

 Complete = 00000349      Post Coalesce Frames = 00000349

 Giant    = 00000000

 Available Blocks = 256/256

ISP Status:

 Version string burned in chip: "A986122997"

 New version after next program operation: "B018020998"

 ISP family type: "2096"

 ISP chip ID: 0x0013

 Device is  programmable

Table 46 describes the significant fields shown in the display.

Table 46 show c2600 Field Descriptions 

Field	Description
Interrupts	Denotes that the next section describes the status of the interrupt services.
Assigned Handlers	Denotes a subsection of the Interrupt section that displays data about the interrupt handlers.
Vect	The processor vector number.
Handler	The execution address of the handler assigned to this vector.
# of Ints	The number of times this handler has been called.
Name	The name of the handler assigned to this vector.
IOS Priority Masks	Denotes the subsection of the Interrupt section that displays internal Cisco IOS priorities. Each item in this subsection indicates a Cisco IOS interrupt level and the bit mask used to mask out interrupt sources when that Cisco IOS level is being processed. Used exclusively for debugging.
SIU_IRQ_MASK	For engineering level debug only.
Spurious IRQs	For engineering level debug only.
Interrupt Throttling:	This subsection describes the behavior of the Interrupt Throttling mechanism on the platform.
Throttle Count	Number of times throttle has become active.
Timer Count	Number of times throttle has deactivated because the maximum masked out time for network interrupt level has been reached.
Netint usec	Maximum time network level is allowed to run (in microseconds).
Netint Mask usec	Maximum time network level interrupt is masked out to allow process level code to run (in microseconds).
Active	Indicates that the network level interrupt is masked or that the router is in interrupt throttle state.
Configured	Indicates that throttling is enabled or configured when set to 1.
Longest IRQ	Duration of longest network level interrupt (in microseconds).
IDMA Status	Monitors the activity of the Internal Direct Memory Access (IDMA) hardware and software. Used to coalesce packets (turn particularized packets into non particularized packets) for transfer to the process level switching mechanism.
Requests	Number of times the IDMA engine is asked to coalesce a packet.
Drops	Number of times the coalescing operation was aborted.
Complete	Number of times the operation was successful.
Post Coalesce Frames	Number of Frames completed post coalesce processing.
Giant	Number of packets too large to coalesce.
Available Blocks	Indicates the status of the request queue, in the format N/M where N is the number of empty slots in queue and M is the total number of slots; for example, 2/256 indicates that the queue has 256 entries and can accept two more requests before it is full.
ISP Status	Provides status of In-System-Programmable (ISP) hardware.
Version string burned in chip	Current version of ISP hardware.
New version after next program operation	Version of ISP hardware after next ISP programming operation.
ISP family type	Device family number of ISP hardware.
ISP chip ID	Internal ID of ISP hardware as designated by the chip manufacturer.
Device is programmable	"Yes" or "No." Indicates if an ISP operation is possible on this board.

Related Commands

Command	Description
show context	Displays information stored in NVRAM when the router crashes.

show c7200

To display information about the CPU and midplane for Cisco 7200 series routers, use the show c7200 command in EXEC mode.

show c7200

Syntax Description

This command has no arguments or keywords.

Command Modes

EXEC

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

You can use the output of this command to determine whether the hardware version level and upgrade is current. The information is generally useful for diagnostic tasks performed by technical support only.

Examples

The following is sample output from the show c7200 command:

Router# show c7200

C7200 Network IO Interrupt Throttling:

 throttle count=0, timer count=0

 active=0, configured=0

 netint usec=3999, netint mask usec=200

C7200 Midplane EEPROM:

        Hardware revision 1.2           Board revision A0

        Serial number     2863311530    Part number    170-43690-170

        Test history      0xAA          RMA number     170-170-170

        MAC=0060.3e28.ee00, MAC Size=1024

        EEPROM format version 1, Model=0x6

        EEPROM contents (hex):

          0x20: 01 06 01 02 AA AA AA AA AA AA AA AA 00 60 3E 28

          0x30: EE 00 04 00 AA AA AA AA AA AA AA 50 AA AA AA AA

C7200 CPU EEPROM:

        Hardware revision 2.0           Board revision A0

        Serial number     3509953       Part number     73-1536-02

        Test history      0x0           RMA number      00-00-00

        EEPROM format version 1

        EEPROM contents (hex):

          0x20: 01 15 02 00 00 35 8E C1 49 06 00 02 00 00 00 00

          0x30: 50 00 00 00 FF FF FF FF FF FF FF FF FF FF FF FF

show calendar

To display the current time and date setting for the hardware clock, use the show calendar command in EXEC mode:

show calendar

Syntax Description

This command has no arguments or keywords.

Command Modes

EXEC

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Some platforms have a hardware clock (calendar) which is separate from the software clock. The hardware clock is battery operated, and runs continuously, even if the router is powered off or rebooted.

You can compare the time and date shown with this command with the time and date listed via the show clock EXEC command to verify that the hardware clock and software clock are synchronized with each other. The time displayed is relative to the configured time zone.

Examples

In the following sample display, the hardware clock indicates the time stamp of 12:13:44 p.m. on Friday, July 19, 1996:

Router> show calendar

12:13:44 PST Fri Jul 19 1996

Related Commands

Command	Description
show clock	Displays the time and date from the system software clock.

show cdp entry

To display information about a specific neighboring device discovered using Cisco Discovery Protocol (CDP), use the show cdp entry command in privileged EXEC mode.

show cdp entry {* | device-name[*] [protocol | version]}

Syntax Description

*	Displays all of the CDP neighbors.
device-name	Name of the neighbor about which you want information.
device-name*	You can enter an asterisk (*) at the end of an entry-name as a wildcard. For example, entering show cdp entry dev* will match all entries which begin with dev.
protocol	(Optional) Limits the display to information about the protocols enabled on a router.
version	(Optional) Limits the display to information about the version of software running on the router.

Command Modes

Privileged EXEC

Command History

Release	Modification
10.3	This command was introduced.

Examples

The following is sample output from the show cdp entry command with no limits. Information about the neighbor device.cisco.com is displayed, including device ID, address and protocol, platform, interface, hold time, and version.

Router# show cdp entry device.cisco.com

-------------------------

Device ID: device.cisco.com

Entry address(es):

  IP address: 192.168.68.18

  CLNS address: 490001.1111.1111.1111.00

  DECnet address: 10.1

Platform: cisco 4500,  Capabilities: Router

Interface: Ethernet0/1,  Port ID (outgoing port): Ethernet0

Holdtime : 125 sec

Version :

Cisco IOS Software

Cisco IOS (tm) 4500 Software (C4500-J-M), Version 12.1(2)

Copyright (c) 1986-2000 by cisco Systems, Inc.

Compiled Mon 07-Apr-00 19:51 by joeuser

The following is sample output from the show cdp entry protocol command. Only information about the protocols enabled on device.cisco.com is displayed.

Router# show cdp entry device.cisco.com protocol

Protocol information for device.cisco.com:

  IP address: 192.168.68.18

  CLNS address: 490001.1111.1111.1111.00

  DECnet address: 10.1

The following is sample output from the show cdp entry version command. Only information about the version of software running on device.cisco.com is displayed.

Router# show cdp entry device.cisco.com version 

Version information for device.cisco.com:

  Cisco IOS Software

Cisco IOS (tm) 4500 Software (C4500-J-M), Version 12.1(2)

Copyright (c) 1986-2000 by cisco Systems, Inc.

Compiled Mon 07-Apr-00 19:51 by joeuser

Related Commands

Command	Description
show cdp	Displays global CDP information, including timer and hold-time information.
show cdp interface	Displays information about the interfaces on which CDP is enabled.
show cdp neighbors	Displays detailed information about neighboring devices discovered using CDP.
show cdp traffic	Displays traffic information from the CDP table.

show cdp interface

To display information about the interfaces on which Cisco Discovery Protocol (CDP) is enabled, use the show cdp interface command in privileged EXEC mode.

show cdp interface [type number]

Syntax Description

type	(Optional) Type of interface about which you want information.
number	(Optional) Number of the interface about which you want information.

Command Modes

Privileged EXEC

Command History

Release	Modification
10.3	This command was introduced.

Examples

The following is sample output from the show cdp interface command. Status information and information about CDP timer and hold-time settings is displayed for all interfaces on which CDP is enabled.

Router# show cdp interface

Serial0 is up, line protocol is up, encapsulation is SMDS

  Sending CDP packets every 60 seconds

  Holdtime is 180 seconds

Ethernet0 is up, line protocol is up, encapsulation is ARPA

  Sending CDP packets every 60 seconds

  Holdtime is 180 seconds

The following is sample output from the show cdp interface command with an interface specified. Status information and information about CDP timer and hold-time settings is displayed for Ethernet interface 0 only.

Router# show cdp interface ethernet 0

Ethernet0 is up, line protocol is up, encapsulation is ARPA

  Sending CDP packets every 60 seconds

  Holdtime is 180 seconds

Related Commands

Command	Description
show cdp	Displays global CDP information, including timer and hold-time information.
show cdp entry	Displays information about a specific neighbor device or all neighboring devices discovered using CDP.
show cdp neighbors	Displays detailed information about neighboring devices discovered using CDP.
show cdp traffic	Displays traffic information from the CDP table.

show cdp neighbors

To display detailed information about neighboring devices discovered using Cisco Discovery Protocol (CDP), use the show cdp neighbors command in privileged EXEC mode.

show cdp neighbors [type number] [detail]

Syntax Description

type	(Optional) Type of the interface connected to the neighbors about which you want information.
number	(Optional) Number of the interface connected to the neighbors about which you want information.
detail	(Optional) Displays detailed information about a neighbor (or neighbors) including network address, enabled protocols, hold time, and software version.

Command Modes

Privileged EXEC

Command History

Release	Modification
10.3	This command was introduced.
12.0(3)T	The output for the detail form of this command was expanded to include CDP Version 2 information.

Examples

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

Router# show cdp neighbors

Capability Codes: R - Router, T - Trans Bridge, B - Source Route Bridge

                  S - Switch, H - Host, I - IGMP, r - Repeater

Device ID        Local Intrfce     Holdtme     Capability  Platform  Port ID

lab-7206         Eth 0             157          R          7206VXR   Fas 0/0/0

lab-as5300-1     Eth 0             163          R          AS5300    Fas 0

lab-as5300-2     Eth 0             159          R          AS5300    Eth 0

lab-as5300-3     Eth 0             122          R          AS5300    Eth 0

lab-as5300-4     Eth 0             132          R          AS5300    Fas 0/0

lab-3621         Eth 0             140         R S         3631-telcoFas 0/0

008024 2758E0    Eth 0             132          T          CAT3000   1/2

Table 47 describes the significant fields shown in the display.

Table 47 show cdp neighbors Field Descriptions  

Field	Definition
Device ID	The configured ID (name), MAC address, or serial number of the neighbor device.
Local Intrfce	(Local Interface) The protocol being used by the connectivity media.
Holdtme	(Holdtime) The remaining amount of time, in seconds, the current device will hold the CDP advertisement from a transmitting router before discarding it.
Capability	The capability code discovered on the device. This is the type of the device listed in the CDP Neighbors table. Possible values are: R—Router T—Transparent bridge B—Source-routing bridge S—Switch H—Host I—IGMP device r—Repeater
Platform	The product number of the device.
Port ID	The protocol and port number of the device.

The following is sample output from the show cdp neighbors detail command.

Router# show cdp neighbors detail

-------------------------

Device ID: lab-7206

Entry address(es):

   IP address: 172.19.169.83

Platform: cisco 7206VXR,  Capabilities: Router

Interface: Ethernet0,  Port ID (outgoing port): FastEthernet0/0/0

Holdtime : 123 sec

Version :

Cisco Internetwork Operating System Software

IOS (tm) 5800 Software (C5800-P4-M), Version 12.1(2)

Copyright (c) 1986-2002 by Cisco Systems, Inc.

advertisement version: 2

Duplex: half

-------------------------

Device ID: lab-as5300-1

Entry address(es):

   IP address: 172.19.169.87

Platform: cisco AS5300,  Capabilities: Router

--More--

.

.

.

Gateway#show cdp neighbors f5/1 detail

Device ID: SEP000427D400ED

Entry address(es): 

  IP address: 1.6.1.81

Platform: Cisco IP Phone 7940,   Capabilities: Host 

Interface: FastEthernet5/1,   Port ID (outgoing port): Port 1

Holdtime : 150 sec

Version :

P00303020204

advertisement version: 2

Duplex: full

Power drawn: 6.300 Watts

Table 48 describes the significant fields shown in the display.

Table 48 show cdp neighbors detail Field Descriptions 

Field	Definition
Device ID	The name of the neighbor device and either the MAC address or the serial number of this device.
Entry address(es)	A list of network addresses of neighbor devices.
[network protocol] address	The network address of the neighbor device. The address can be in IP, IPX, AppleTalk, DECnet, or CLNS protocol conventions.
Platform	The product name and number of the neighbor device.
Capabilities	The device type of the neighbor. This device can be a router, a bridge, a transparent bridge, a source-routing bridge, a switch, a host, an IGMP device, or a repeater.
Interface	The protocol and port number of the port on the current device.
Holdtime	The remaining amount of time, in seconds, the current device will hold the CDP advertisement from a transmitting router before discarding it.
Version:	The software version running on the neighbor device.
advertisement version:	The version of CDP being used for CDP advertisements.
Duplex:	The duplex state of connection between the current device and the neighbor device.
Native VLAN	The ID number of the VLAN on the neighbor device.
VTP Management Domain	A string that is the name of the collective group of VLANs associated with the neighbor device.
Power Drawn:	The maximum requested power. Note For IP Phones the value shown is the maximum requested power (6.3 Watts). This value can be different than the actual power supplied by the routing device (generally 5 watts; shown using the show power command).

Related Commands

Command	Description
show cdp	Displays global CDP information, including timer and hold-time information.
show cdp entry	Displays information about a specific neighbor device listed in the CDP table.
show cdp interface	Displays information about the interfaces on which CDP is enabled.
show cdp traffic	Displays information about traffic between devices gathered using CDP.

show cdp traffic

To display information about traffic between devices gathered using Cisco Discovery Protocol (CDP), use the show cdp traffic command in privileged EXEC mode.

show cdp traffic

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
10.3	This command was introduced.

Examples

The following is sample output from the show cdp traffic command:

Router# show cdp traffic

Total packets output: 543, Input: 333

Hdr syntax: 0, Chksum error: 0, Encaps failed: 0

No memory: 0, Invalid: 0, Fragmented: 0

CDP version 1 advertisements output: 191, Input: 187

CDP version 2 advertisements output: 352, Input: 146

Table 49 describes the significant fields shown in the display.

Table 49 show cdp traffic Field Descriptions 

Field	Definition
Total packets output	The number of CDP advertisements sent by the local device. Note that this value is the sum of the CDP Version 1 advertisements output and CDP Version 2 advertisements output fields.
Input	The number of CDP advertisements received by the local device. Note that this value is the sum of the CDP Version 1 advertisements input and CDP Version 2 advertisements input fields.
Hdr syntax	The number of CDP advertisements with bad headers, received by the local device.
Chksum error	The number of times the checksum (verifying) operation failed on incoming CDP advertisements.
Encaps failed	The number of times CDP failed to send advertisements on an interface because of a failure caused by the bridge port of the local device.
No memory	The number of times the local device did not have enough memory to store the CDP advertisements in the advertisement cache table when the device was attempting to assemble advertisement packets for transmission and parse them when receiving them.
Invalid	The number of invalid CDP advertisements received and sent by the local device.
Fragmented	The number of times fragments or portions of a single CDP advertisement were received by the local device instead of the complete advertisement.
CDP version 1 advertisements output	The number of CDP Version 1 advertisements sent by the local device.
Input	The number of CDP Version 1 advertisements received by the local device.
CDP version 2 advertisements output	The number of CDP Version 2 advertisements sent by the local device.
Input	The number of CDP Version 2 advertisements received by the local device.

Related Commands

Command	Description
show cdp	Displays global CDP information, including timer and hold-time information.
show cdp entry	Displays information about a specific neighbor device listed in the CDP table.
show cdp interface	Displays information about the interfaces on which CDP is enabled.
show cdp neighbors	Displays detailed information about neighboring devices discovered using CDP.

show cdp

To display global Cisco Discovery Protocol (CDP) information, including timer and hold-time information, use the show cdp command in privileged EXEC mode.

show cdp

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
10.3	This command was introduced.
12.0(3)T	The output of this command was modified to include CDP Version 2 information.

Examples

The following example shows that the current router is sending CDP advertisements every 1 minute (the default setting for the cdp timer global configuration command). Also shown is that the current router directs its neighbors to hold its CDP advertisements for 3 minutes (the default for the cdp holdtime global configuration command), and that the router is enabled to send CDP Version 2 advertisements:

router# show cdp

Global CDP information:

Sending CDP packets every 60 seconds

Sending a holdtime value of 180 seconds

Sending CDPv2 advertisements is enabled

Table 50 describes the significant fields shown in the display.

Table 50 show cdp Field Descriptions

Field	Definition
Sending CDP packets every XX seconds	The interval (in seconds) between transmissions of CDP advertisements. This field is controlled by the cdp timer command.
Sending a holdtime value of XX seconds	The amount of time (in seconds) the device directs the neighbor to hold a CDP advertisement before discarding it. This field is controlled by the cdp holdtime command.
Sending CDPv2 advertisements is XX	The state of whether CDP Version-2 type advertisements are enabled to be sent. Possible states are enabled or disabled. This field is controlled by the cdp advertise v2 global configuration command.

Related Commands

Command	Description
cdp advertise-v2	Enables CDP Version 2 advertising functionality on a device.
cdp holdtime	Specifies the amount of time the receiving device should hold a CDP packet from your router before discarding it.
cdp timer	Specifies how often the Cisco IOS software sends CDP updates.
show cdp entry	Displays information about a specific neighbor device listed in the CDP table.
show cdp interface	Displays information about the interfaces on which CDP is enabled.
show cdp neighbors	Displays detailed information about neighboring devices discovered using CDP.
show cdp traffic	Displays information about traffic between devices gathered using CDP.

show clock

To display the time and date from the system software clock, use the show clock command in EXEC mode.

show clock [detail]

Syntax Description

detail

(Optional) Indicates the clock source (NTP, VINES, hardware clock, and so on) and the current summer-time setting (if any).

Command Modes

EXEC

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

The software clock keeps an "authoritative" flag that indicates whether the time is authoritative (believed to be accurate). If the software clock has been set by a timing source (for example, via NTP), the flag is set. If the time is not authoritative, it will be used only for display purposes. Until the clock is authoritative and the "authoritative" flag is set, the flag prevents peers from synchronizing to the software clock.

The symbol that precedes the show clock display indicates the following:

Symbol	Description	Example
*	Time is not authoritative: the software clock is not in sync or has never been set.	*15:29:03.158 UTC Tue Feb 25 2003:
(blank)	Time is authoritative: the software clock is in sync or has just been set manually	15:29:03.158 UTC Tue Feb 25 2003:
.	Time is authoritative, but NTP is not synchronized: the software clock was in sync, but has since lost contact with all configured NTP servers	.15:29:03.158 UTC Tue Feb 25 2003:

These symbols are also used in NTP-based timestamping, such as for syslog (SEM) messages.

---

Note In general, NTP synchronization takes approximately 15 to 20 minutes.

---

Examples

The following sample output shows that the current clock is authoritative and that the time source is NTP:

Router> show clock detail

15:29:03.158 PST Tue Feb 25 2003

Time source is NTP

The following example shows the current clock is authoritative, but NTP is not yet synchronized:

Router> show clock

.16:42:35.597 UTC Tue Feb 25 2003

Related Commands

Command	Description
clock set	Manually sets the software clock.
show calendar	Displays the current time and date setting of the system hardware clock.

show cls

To display the current status of all Cisco link services (CLS) sessions on the router, use the show cls command in EXEC mode.

show cls [brief]

Syntax Description

brief

(Optional) Displays a brief version of the output.

Defaults

Without the brief keyword, displays complete output.

Command Modes

EXEC

Command History

Release	Modification
11.0	This command was introduced in a release prior to Cisco IOS Release 11.0.

Usage Guidelines

The Cisco link service (CLS) is used as the interface between data link users (DLUs), such as DLSw, LAN Network Manager (LNM), downstream physical unit (DSPU), and SNASw, and their corresponding data link circuits (DLCs) such as Logic Link Control (LLC), VDLC, and Qualified Logic Link Control (QLLC). Each DLU registers a particular service access point (SAP) with CLS, and establishes circuits through CLS over the DLC.

The show cls command displays the SAP values associated with the DLU and the circuits established through CLS.

For further information about CLS, use the Cisco IOS Bridging and IBM Networking Configuration Guide.

Examples

The following is sample output from the show cls command:

IBD-4500B# show cls

DLU user:SNASW 

   SSap:0x04  VDLC VDLC650 

    DTE:1234.4000.0001 1234.4000.0002 04 04 

    T1 timer:0   T2 timer:0  Inact timer:0 

    max out:0    max in:0    retry count:10 

    XID retry:10 XID timer:5000  I-Frame:0 

    flow:0       DataIndQ:0   DataReqQ:0 

DLU user:DLSWDLUPEER 

DLU user:DLSWDLU 

   Bridging  VDLC VDLC1000 

   Bridging  VDLC VDLC650

The following is sample output from the show cls brief command:

IBD-4500B# show cls brief

DLU user:SNASW 

   SSap:0x04  VDLC VDLC650 

    DTE:1234.4000.0001 1234.4000.0002 04 04 

DLU user:DLSWDLUPEER 

DLU user:DLSWDLU 

   Bridging  VDLC VDLC1000 

Bridging VDLC VDLC650

The examples show two DLUs—SNASw and DLSw—active in the router. SNASw uses a SAP value of 0x04, and the associated DLC port is VDLC650. SNASw has a circuit established between MAC addresses 1234.4000.0001 and 1234.4000.0002 using source and destination SAPs 04 and 04. DLSw is a bridging protocol and uses VDLC1000 and VDLC650 ports. There are no circuits in place at this time.

In the output from the show cls command (without the brief argument), the values of timers and counters applicable to this circuit are displayed.

Related Commands

Command	Description
stun peer-name	Enables STUN for an IP address and uses Cisco Link Services (CLS) to access the Frame Relay network.

show cns config connections

To display the status of the Cisco Networking Services (CNS) event agent connection, use the show cns config connections command in privileged EXEC mode.

show cns config connections

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(8)T	This command was introduced.

Usage Guidelines

Use the show cns config connections command to determine whether the CNS event agent is connecting to the gateway, connected, or active, and to display the gateway used by the event agent and its IP address and port number.

Examples

The following is sample output from the show cns config connections command:

Router# show cns config connections

The partial configuration agent is enabled.

Configuration server:  10.1.1.1

Port number:           80

Encryption:            disabled

Config id:             test1

Connection Status:     Connection not active.

Related Commands

Command	Description
show cns config outstanding	Displays information about incremental CNS configurations that have started but not yet completed.
show cns config stats	Displays statistics about the CNS configuration agent.

show cns config outstanding

To display information about incremental (partial) Cisco Networking Services (CNS) configurations that have started but not yet completed, use the show cns config outstanding command in privileged EXEC mode.

show cns config outstanding

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(2)T	This command was introduced.
12.2(8)T	This command was implemented on Cisco 2600 series and Cisco 3600 series routers.

Usage Guidelines

Use the show cns config outstanding command to display information about outstanding incremental (partial) configurations that have started but not yet completed, including the following:

•Queue ID (location of configuration in the config queue)

•Identifier (group ID)

•Config ID (identity of configuration within the group)

Examples

The following is sample output from the show cns config outstanding command:

Router# show cns config outstanding

The outstanding configuration information:

queue id   identifier       config-id

1          identifierREAD   config_idREAD

Related Commands

Command	Description
cns config cancel	Cancels an incremental two-phase synchronization configuration.
config-cli	Displays the status of the CNS event agent connection.
show cns config stats	Displays statistics about the CNS configuration agent.

show cns config stats

To display statistics about the CNS configuration agent, use the show cns config stats command in privileged EXEC mode.

show cns config stats

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(2)T	This command was introduced.
12.2(8)T	This command was implemented on Cisco 2600 series and Cisco 3600 series routers.
12.3(1)	Additional output fields were added.

Usage Guidelines

This command displays the following statistics on the CNS configuration agent:

•The number of configurations requests received

•The number of configurations completed

•The number of configurations failed

•The number of configurations pending

•The number of configurations cancelled

•The time stamp of the last configuration received

•The time stamp of the initial configuration received

Examples

The following is sample output from the show cns config stats command:

Router# show cns config stats

6 configuration requests received.

4 configurations completed.

1 configurations failed.

1 configurations pending.

0 configurations cancelled.

The time of last received configuration is *May 5 2003 10:42:15 UTC.

Initial Config received *May 5 2003 10:45:15 UTC.

Related Commands

Command	Description
clear cns config stats	Clears all the statistics about the CNS configuration agent.
show cns config outstanding	Displays information about incremental CNS configurations that have started but not yet completed.

show cns config status

To display the status of the Cisco Networking Services (CNS) Configuration Agent, use the show cns config status command in EXEC mode.

show cns config status

Syntax Description

This command has no arguments or keywords.

Command Modes

EXEC

Command History

Release	Modification
12.2(2)T	This command was introduced.
12.0(18)ST	This command was integrated into Cisco IOS Release 12.0(18)ST.
12.0(22)S	This command was integrated into Cisco IOS Release 12.0 (22)S.

Usage Guidelines

This command displays the status of the Configuration Agent. Use this option to display the following information about the Configuration Agent:

•Status of the Configuration Agent, for example, whether it has been configured properly.

•IP address and port number of the trusted server that the Configuration Agent is using.

•Config ID (identity of configuration within the configuration group).

Related Commands

Command	Description
cns config cancel	Cancels a CNS configuration.
cns config initial	Starts the initial CNS Configuration Agent.
cns config partial	Starts the partial CNS Configuration Agent.
cns config retrieve	Gets the configuration of a routing device using CNS.

show cns event connections

To display the status of the Cisco Networking Services (CNS) event agent connection, use the show cns event connections command in privileged EXEC mode.

show cns event connections

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(8)T	This command was introduced.

Usage Guidelines

Use the show cns event connections command to display the status of the event agent connection—such as whether it is connecting to the gateway, connected, or active—and to display the gateway used by the event agent and its IP address and port number.

Examples

The following example displays the IP address and port number of the primary and backup gateways:

Router# show cns event connections

The currently configured primary event gateway:

        hostname is 10.1.1.1.

        port number is 11011.

Event-Id is Internal test1

Keepalive setting:

        none.

Connection status:

        Connection Established.

The currently configured backup event gateway:

        none.

The currently connected event gateway:

        hostname is 10.1.1.1.

        port number is 11011.

Related Commands

Command	Description
show cns event stats	Displays statistics about the CNS event agent connection.
show cns event subject	Displays a list of subjects about the CNS event agent connection.

show cns event gateway

To display information about the Cisco Networking Services (CNS) Event Agent, use the show cns event gateway command in EXEC mode.

show cns event gateway

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

EXEC

Command History

Release	Modification
12.2(2)T	This command was introduced.
12.0(18)ST	This command was integrated into Cisco IOS Release 12.0 (18)ST

Usage Guidelines

Use this command to display the following information about CNS gateways:

•Primary gateway:

–IP address

–Port number

•Backup gateways:

–IP address

–Port number

•Currently connected gateway:

–IP address

–Port number

Related Commands

Command	Description
cns event	Configures the CNS Event Gateway.

show cns event stats

To display statistics about the CNS event agent connection, use the show cns event stats command in privileged EXEC mode.

show cns event stats

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(2)T	This command was introduced.
12.0(18)ST	This command was integrated into Cisco IOS Release 12.0(18)ST.
12.0(22)S	This command was integrated into Cisco IOS Release 12.0(22)S.
12.2(8)T	This command was implemented on the Cisco 2600 series and the Cisco 3600 series routers.
12.3(1)	Output was changed to display statistics generated since last cleared.

Usage Guidelines

Use this command to display the following statistics for the CNS event agent:

•Number of events received

•Number of events sent

•Number of events not processed successfully

•Number of events in the queue

•Time stamp showing when statistics were last cleared (time stamp is router time)

•Number of events received since the statistics were cleared

•Time stamp of latest event received (time stamp is router time)

•Time stamp of latest event sent

•Number of applications using the Event Agent

•Number of subjects subscribed

Examples

The following example displays statistics for the CNS event agent:

Router# show cns event stats

0 events received.

1 events sent.

0 events not processed.

0 events in the queue.

0 events sent to other IOS applications.

Event agent stats last cleared at Apr 4 2003 00:55:25 UTC

No events received since stats cleared

The time stamp of the last received event is *Mar 30 2003 11:04:08 UTC

The time stamp of the last sent event is *Apr 11 2003 22:21:23 UTC

3 applications are using the event agent.

0 subjects subscribed.

1 subjects produced.

0 subjects replied.

Related Commands

Command	Description
clear cns event stats	Clears all the statistics about the CNS event agent.
cns event	Enables and configures CNS event agent services.
show cns event connections	Displays the status of the CNS event agent connection.
show cns event subject	Displays a list of subjects about the CNS event agent connection.

show cns event status

To display information about the Cisco Networking Services (CNS) Event Agent, use the show cns event status command in EXEC mode.

show cns event status

Syntax Description

This command has no arguments or keywords.

Command Modes

EXEC

Command History

Release	Modification
12.2(2)T	This command was introduced.
12.0(18)ST	This command was integrated into Cisco IOS Release 12.0 (18)ST.

Usage Guidelines

Use this command to display the following information about the CNS Event Agent:

•Status of Event Agent:

–Connected

–Active

•Gateway used by the Event Agent:

–IP address

–Port number

•Device ID

Related Commands

Command	Description
cns event	Configures the CNS Event Gateway.

show cns event subject

To display a list of subjects about the Cisco Networking Services (CNS) event agent connection, use the show cns event subject command in privileged EXEC mode.

show cns event subject [name]

Syntax Description

name	(Optional) Displays a list of applications that are subscribing to this specific subject name.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(2)T	This command was introduced.
12.0(18)ST	This command was integrated into Cisco IOS Release 12.0(18)ST.
12.0(22)S	This command was integrated into Cisco IOS Release 12.0(22)S.
12.2(8)T	This command was implemented on the Cisco 2600 series and the Cisco 3600 series.

Usage Guidelines

Use the show cns event subject command to display a list of subjects of the event agent that are subscribed to by applications.

Examples

The following example displays the IP address and port number of the primary and backup gateways:

Router# show cns event subject

The list of subjects subscribed by applications.

   cisco.cns.mibaccess:request

   cisco.cns.config.load

   cisco.cns.config.reboot

   cisco.cns.exec.cmd

Related Commands

Command	Description
show cns event connections	Displays the status of the CNS event agent connection.
show cns event stats	Displays statistics about the CNS event agent connection.

show cns image connections

To display the status of the Cisco Networking Services (CNS) image management server HTTP connections, use the show cns image connections command in privileged EXEC mode.

show cns image connections

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.3(1)	This command was introduced.

Usage Guidelines

Use the show cns image connections command when troubleshooting HTTP connection problems with the CNS image server. The output displays the following information:

•Number of connection attempts

•Number of connections that were never connected and those that were abruptly disconnected

•Date and time of last successful connection

Examples

The following is sample output from the show cns image connections command:

Router# show cns image connections

CNS Image Agent:  HTTP connections

Connection attempts 1

never connected:0   Abrupt disconnect:0 

Last successful connection at 11:45:02.000 UTC Mon May 6 2003

Related Commands

Command	Description
show cns image inventory	Displays inventory information about the CNS image agent.
show cns image status	Displays status information about the CNS image agent.

show cns image inventory

To provide a dump of Cisco Networking Services (CNS) image inventory information in XML format, use the show cns image inventory command in privileged EXEC mode.

show cns image inventory

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.3(1)	This command was introduced.

Usage Guidelines

To view the XML output in a better format, paste the content into a text file and use an XML viewing tool.

Examples

The following is sample output from the show cns image inventory command:

Router# show cns image inventory

Inventory Report 

<imageInventoryReport><deviceName><imageID>Router</imageID><hostName>Router</ho 

IOS (tm) C2600 Software (C2600-I-M), Experimental Version 12.3(20030414:081500)]

Copyright (c) 1986-2003 by cisco Systems, Inc.

Compiled Mon 14-Apr-03 02:03 by engineer</versionString><imageFile>tftp://10.25>

Related Commands

Command	Description
show cns image connections	Displays connection information for the CNS image agent.
show cns image status	Displays status information about the CNS image agent.

show cns image status

To display status information about the Cisco Networking Services (CNS) image agent, use the show cns image status command in privileged EXEC mode.

show cns image status

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.3(1)	This command was introduced.

Usage Guidelines

Use this command to display the following status information about the CNS image agent:

•Start date and time of last upgrade

•End date and time of last upgrade

•End date and time of last successful upgrade

•End date and time of last failed upgrade

•Number of failed upgrades

•Number of successful upgrades with number of received messages and errors

•Transmit status with number of attempts, successes, and failures

Examples

The following is sample output from the show cns image status command:

Router# show cns image status

Last upgrade started at 11:45:02.000 UTC Mon May 6 2003

Last upgrade ended at 11:56:04.000 UTC Mon May 6 2003 status SUCCESS

Last successful upgrade ended at 00:00:00.000 UTC Mon May 6 2003

Last failed upgrade ended at 00:00:00.000 UTC Wed Apr 16 2003

Number of failed upgrades: 2

Number of successful upgrades: 6

 messages received: 12

 receive errors: 5

Transmit Status

  TX Attempts:4

    Successes:3         Failures 2

Related Commands

Command	Description
show cns image connections	Displays connection information for the CNS image agent.
show cns image inventory	Displays image inventory information in XML format.

show <command> append

To redirect and add the output of any show command to an existing file, use the show command | append command in privileged EXEC mode.

show command | append url

Syntax Description

command

Any Cisco IOS show command.

| append url

The addition of this syntax redirects the command output to the file location specified in the Universal Resource Locator (URL). The pipe (|) is required. The Cisco IOS File System (IFS) uses URLs to specify the location of a file system, directory, and file. Typical URL elements include: prefix:[directory/]filename Prefixes can be local file locations, such as flash: or disk0:. Alternatively, you can specify network locations using the following syntax: ftp:[[//[username[:password]@]location]/directory]/filename tftp:[[//location]/directory]/filename The rcp: prefix is not supported.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(21)S	This command was introduced.
12.2(13)T	This command was integrated into Cisco IOS Release 12.2(13)T.

Usage Guidelines

To display all URL prefixes that are supported for this command, use the show command | append ? command.

This command adds the show command output to the end of the specified file.

Examples

In the following example, output from the show tech-support command is redirected to an existing file on Disk 1 with the file-name of "showoutput.txt." This output is added at the end of any existing data in the file.

Router# show tech-support | append disk1:showoutput.txt

Related Commands

Command	Description
show <command> redirect	Redirects the output of any show command to a specified file.
show <command> tee	Copies the show command output to a file while displaying it on the terminal.

show <command> begin

To begin the output of any show command from a specified string, use the show command | begin command in EXEC mode.

show command | begin regular-expression

Syntax Description

command	Any supported show command.
|	A vertical bar (the "pipe" symbol) indicates that an output processing specification follows.
regular-expression	Any regular expression found in show command output. The show output will begin from the first instance of this string (output prior to this string will not be printed to the screen). The string is case-sensitive. Use parenthesis to indicate a literal use of spaces.
/	Specifies a search at a --More-- prompt that begins unfiltered output with the first line that contains the regular expression.
-	Specifies a filter at a --More-- prompt that only displays output lines that do not contain the regular expression.
+	Specifies a filter at a --More-- prompt that only displays output lines that contain the regular expression.

Command Modes

EXEC

Command History

Release	Modification
8.3	The show command was introduced.
12.0(1)T	This extension of the show command was introduced.

Usage Guidelines

The regular-expression argument is case sensitive and allows for complex matching requirements. Use parenthesis to indicate a literal use of spaces. For example, | begin u indicates that the show output should begin with any line that contains a u; | begin ( u) indicates that the show output should begin with any line that contains a space and a u together (line has a word that begins with a lowercase u).

To search the remaining output of the show command, use the following command at the --More-- prompt:

/regular-expression

You can specify a filtered search at any --More-- prompt. To filter the remaining output of the show command, use one of the following commands at the --More-- prompt:

-regular-expression

+regular-expression

When output volume is large, the search can produce long lists of output. To interrupt the output, press Ctrl-^ (Ctrl-Shift-6) or Ctrl-z.

---

Note Once you specify a filter for a show command, you cannot specify another filter at the next --More-- prompt. The first specified filter remains until the more command output finishes or until you interrupt the output. The use of the keyword begin does not constitute a filter.

---

Because prior output is not saved, you cannot search or filter backward through prior output.

---

Note A few show commands that have long output requirements do not require user input at the --More-- prompt to jump to the next table of output; these types of output require you to enter the same number of Ctrl-^ or Ctrl-Z combinations as there are --More-- prompts to completely abort output.

---

Examples

The following is partial sample output of the show interface | begin command that begins unfiltered output with the first line that contains the regular expression "Ethernet." At the --More-- prompt, the user specifies a filter to show only the lines in the remaining output that contain the regular expression "Serial."

Router# show interface | begin Ethernet

Ethernet0 is up, line protocol is up

Hardware is Lance, address is 0060.837c.6399 (bia 0060.837c.6399)

  Description: ip address is 172.1.2.14 255.255.255.0

  Internet address is 172.1.2.14/24

.

.

.

     0 lost carrier, 0 no carrier

     0 output buffer failures, 0 output buffers swapped out

--More--

+Serial

filtering...

Serial1 is up, line protocol is up

Serial2 is up, line protocol is up

Serial3 is up, line protocol is down

Serial4 is down, line protocol is down

Serial5 is up, line protocol is up

Serial6 is up, line protocol is up

Serial7 is up, line protocol is up

Related Commands

Command	Description
more <url> begin	Begins unfiltered output of the more command with the first line that contains the regular expression you specify.
more <url> exclude	Filters more command output so that it excludes lines that contain a particular regular expression.
more <url> include	Filters more command output so that it displays only lines that contain a particular regular expression.
show <command> exclude	Filters show command output so that it excludes lines that contain a particular regular expression.
show <command> include	Filters show command output so that it displays only lines that contain a particular regular expression.

show <command> exclude

To filter show command output so that it excludes lines that contain a particular regular expression, use the show command | exclude command in EXEC mode.

show command | exclude regular-expression

Syntax Description

command	Any supported show command.
|	A vertical bar (the "pipe" symbol) indicates that an output processing specification follows.
regular-expression	Any regular expression found in show command output.
/	Specifies a search at a --More-- prompt that begins unfiltered output with the first line that contains the regular expression.

Command Modes

EXEC

Command History

Release	Modification
12.0(1)T	This command was introduced.

Usage Guidelines

The regular-expression argument is case sensitive and allows for complex matching requirements.

You can specify a new search at every --More-- prompt. To search the remaining output of the show command, use the following syntax at the --More-- prompt:

/regular-expression

When output volume is large, the search can produce long lists of output. To interrupt the output, press Ctrl-^ (Ctrl-Shift-6) or Ctrl-Z.

Because prior output is not saved, you cannot search or filter backward through prior output.

---

Note A few show commands that have long output requirements do not require user input at the --More-- prompt to jump to the next table of output; these types of output require you to enter the same number of Ctrl-^ or Ctrl-Z combinations as there are --More-- prompts to completely abort output.

---

Examples

The following is partial sample output of the show | exclude command used with the show buffers command. It excludes lines that contain the regular expression "0 misses." At the --More-- prompt, the user searches for the regular expression "Serial0," which continues the filtered output with the first line that contains "Serial0."

Router# show buffers | exclude 0 misses

Buffer elements:

     398 in free list (500 max allowed)

Public buffer pools:

Small buffers, 104 bytes (total 50, permanent 50):

     50 in free list (20 min, 150 max allowed)

     551 hits, 3 misses, 0 trims, 0 created

Big buffers, 1524 bytes (total 50, permanent 50):

     49 in free list (5 min, 150 max allowed)

Very Big buffers, 4520 bytes (total 10, permanent 10):

.

.

.

Huge buffers, 18024 bytes (total 0 permanent 0):

     0 in free list (0 min, 4 max allowed)

--More--

/Serial0

filtering...

Serial0 buffers, 1543 bytes (total 64, permanent 64):

     16 in free list (0 min, 64 max allowed)

     48 hits, 0 fallbacks

Related Commands

Command	Description
more <url> begin	Begins unfiltered output of the more command with the first line that contains the regular expression you specify.
more <url> exclude	Filters more command output so that it excludes lines that contain a particular regular expression.
more <url> include	Filters more command output so that it displays only lines that contain a particular regular expression.
show <command> begin	Searches the output of any show command and displays the output from the first instance of a specified string.
show <command> include	Filters show command output so that it displays only lines that contain a particular regular expression.

show <command> include

To filter show command output so that it only displays lines that contain a particular regular expression, use the show command | include command in EXEC mode.

show command | include regular-expression

Syntax Description

command	Any supported show command.
|	A vertical bar (the "pipe" symbol) indicates that an output processing specification follows.
regular-expression	Any regular expression found in show command output. Use parenthesis to include spaces in the expression.
/	Specifies a search at a --More-- prompt that begins unfiltered output with the first line that contains the regular expression.

Command Modes

EXEC

Command History

Release	Modification
12.0(1)T	This command was introduced.

Usage Guidelines

The regular-expression argument is case sensitive and allows for complex matching requirements.

You can specify a new search at every --More-- prompt. To search the remaining output of the show command, use the following syntax at the --More-- prompt:

/regular-expression

When output volume is large, the search can produce long lists of output. To interrupt the output, press Ctrl-^ (Ctrl-Shift-6) or Ctrl-Z.

Because prior output is not saved, you cannot search or filter backward through prior output.

---

Note A few show commands that have long output requirements do not require user input at the --More-- prompt to jump to the next table of output; these types of output require you to enter the same number of Ctrl-^ or Ctrl-Z combinations as there are --More-- prompts to completely abort output.

---

Examples

The following is partial sample output of the show interface | include command. It displays only lines that contain the regular expression "( is )." The parentheses force the inclusion of the spaces before and after "is." Use of the parenthesis ensures that only lines containing "is" with a space both before and after it will be included in the output. Lines with words like "disconnect" will be excluded because there are not spaces around the instance of the string "is".

Router# show interface | include ( is )

ATM0 is administratively down, line protocol is down

  Hardware is ATMizer BX-50

Dialer1 is up (spoofing), line protocol is up (spoofing)

  Hardware is Unknown

  DTR is pulsed for 1 seconds on reset

Ethernet0 is up, line protocol is up

  Hardware is Lance, address is 0060.837c.6399 (bia 0060.837c.6399)

  Internet address is 172.21.53.199/24

Ethernet1 is up, line protocol is up

  Hardware is Lance, address is 0060.837c.639c (bia 0060.837c.639c)

  Internet address is 5.5.5.99/24

Serial0:0 is down, line protocol is down

  Hardware is DSX1

.

.

.

 --More-- 

At the --More-- prompt, the user searches for the regular expression "Serial0:13", which continues filtered output with the first line that contains "Serial0:13."

/Serial0:13

filtering...

Serial0:13 is down, line protocol is down

  Hardware is DSX1

  Internet address is 11.0.0.2/8

     0 output errors, 0 collisions, 2 interface resets

  Timeslot(s) Used:14, Transmitter delay is 0 flags

Related Commands

Command	Description
more <url> begin	Begins unfiltered output of the more command with the first line that contains the regular expression you specify.
more <url> exclude	Filters more command output so that it excludes lines that contain a particular regular expression.
more <url> include	Filters more command output so that it displays only lines that contain a particular regular expression.
show <command> begin	Searches the output of any show command and displays the output from the first instance of a specified string.
show <command> exclude	Filters show command output so that it excludes lines that contain a particular regular expression.

show <command> redirect

To redirect the output of any show command to a file, use the show command | redirect command in privileged EXEC mode.

show command | redirect url

Syntax Description

command

Any Cisco IOS show command.

| redirect url

The addition of this syntax redirects the command output to the file location specified in the Universal Resource Locator (URL). The pipe (|) is required. The Cisco IOS File System (IFS) uses URLs to specify the location of a file system, directory, and file. Typical URL elements include: prefix:[directory/]filename Prefixes can be local file locations, such as flash: or disk0:. Alternatively, you can specify network locations using the following syntax: ftp:[[//[username[:password]@]location]/directory]/filename tftp:[[//location]/directory]/filename The rcp: prefix is not supported.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(21)S	This command was introduced.
12.2(13)T	This command was integrated into Cisco IOS Release 12.2(13)T.

Usage Guidelines

To display all URL prefixes that are supported for this command, use the show command | redirect ? command.

This command creates a new file at the specified location, or overwrites an existing file.

Examples

In the following example, output from the show tech-support command is write to the file "showtech.txt" on the host at 172.16.101.101 in the directory "//tftpboot/docs/" using FTP:

Router# show tech | redirect 
ftp://USER:MYPASSWORD@172.16.101.101//tftpboot/docs/showtech.txt 

Related Commands

Command	Description
show <command> append	Redirects and appends show command output to the end of an existing file.
show <command> tee	Copies the show command output to a file while displaying it on the terminal.

show <command> tee

To copy the output of any show command to a file while displaying it on the terminal, use the show command | tee command in privileged EXEC mode.

show command | tee [/append] url

Syntax Description

command	Any Cisco IOS show command.
| tee url	The addition of this syntax copies the command output to the file location specified in the Universal Resource Locator (URL). The pipe (|) is required. The Cisco IOS File System (IFS) uses URLs to specify the location of a file system, directory, and file. Typical URL elements include: prefix:[directory/]filename Prefixes can be local file locations, such as flash: or disk0:. Alternatively, you can specify network locations using the following syntax: ftp:[[//[username[:password]@]location]/directory]/filename tftp:[[//location]/directory]/filename The rcp: prefix is not supported.
/append	(Optional) Adds the show command output to the end of an existing file.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0(21)S	This command was introduced.
12.2(13)T	This command was integrated into Cisco IOS Release 12.2(13)T.

Usage Guidelines

To display all URL prefixes that are supported for this command, use the show command | tee ? command.

The tee keyword was chosen to reflect that output is redirected to two locations; the terminal and a file (as a tee plumbing junction redirects water to two different pipes).

Examples

In the following example, output from the show tech-support command is displayed on-screen while it is written to the file "showoutput.txt" at the host 172.16.101.101 using TFTP:

Router# show tech-support | tee tftp://172.16.101.101/docs/showoutput.txt

The following example performs the same function as above, but in this case the output is added at the end of any existing data in the file "showoutput.txt":

Router# show tech-support | tee /append tftp://172.16.101.101/docs/showoutput.txt

Related Commands

Command	Description
show <command> append	Redirects the output of any show command and adds it to the end of existing file.
show <command> redirect	Redirects the output of any show command to a specified file.