To enable Cisco Discovery Protocol Version 2 (CDPv2) advertising functionality on a device, use the cdpadvertise-v2 command in global configuration mode. To disable advertising CDPv2 functionality, use the no form of the command.
cdpadvertise-v2
nocdpadvertise-v2
Syntax Description
This command has no arguments or keywords.
Command Default
Enabled
Command Modes
Global configuration
Command History
Release
Modification
12.0(3)T
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
CDP Version 2 has three additional type-length values (TLVs): VTP Management Domain Name, Native VLAN, and full/half-Duplex.
Examples
In the following example, CDP Version 2 advertisements are disabled on the router:
Router# show cdp
Global CDP information:
Sending CDP packets every 60 seconds
Sending a holdtime value of 180 seconds
Sending CDPv2 advertisements is enabled
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# no cdp advertise-v2
Router(config)# end
Router# show cdp
Global CDP information:
Sending CDP packets every 60 seconds
Sending a holdtime value of 180 seconds
Sending CDPv2 advertisements is not enabled
Router#
Related Commands
Command
Description
cdpenable
Enables CDP on a supported interface.
cdprun
Reenables CDP on a Cisco device.
cdp enable
To enable Cisco Discovery Protocol (CDP) on an interface, use the cdpenable command in interface configuration mode. To disable CDP on an interface, use the noform of this command.
cdpenable
nocdpenable
Syntax Description
This command has no arguments or keywords.
Command Default
This command is enabled at the global configuration level and is supported on all interfaces.
Command Modes
Interface configuration (config-if)
Command History
Release
Modification
10.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
15.1(2)SNG
This command was implemented on Cisco ASR 901 Series Aggregation Services Routers.
Usage Guidelines
CDP is enabled by default at the global level and on each supported interface in order to send or receive CDP information. However, some interfaces, such as ATM interfaces, do not support CDP.
Note
The cdpenable, cdptimer, andcdprun commands affect the operation of the IP on demand routing feature (that is, the routerodr global configuration command). For more information on the routerodr command, see the “On-Demand Routing Commands” chapter in the Cisco IOS IP Command Reference
, Volume 2 of 3: Routing Protocols
document.
Examples
In the following example, CDP is disabled on Ethernet interface 0 only:
Router# show cdp
Global CDP information:
Sending CDP packets every 60 seconds
Sending a holdtime value of 180 seconds
Sending CDPv2 advertisements is enabled
Router# configure terminal
Router(config)# interface ethernet 0
Router(config-if)# no cdp enable
Related Commands
Command
Description
cdprun
Reenables CDP on a Cisco device.
cdptimer
Specifies how often the Cisco IOS software sends CDP updates.
routerodr
Enables on-demand routing on a hub router.
cdp holdtime
To specify the amount of time the receiving device should hold a Cisco Discovery Protocol (CDP) packet from the router before discarding it, use thecdpholdtime command in global configuration mode. To revert to the default setting, use the noform of this command.
cdpholdtimeseconds
nocdpholdtime
Syntax Description
seconds
Specifies the hold time to be sent in the CDP update packets. The default is 180 seconds.
Command Default
180 seconds
Command Modes
Global configuration
Command History
Release
Modification
10.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
CDP packets are sent with a time to live, or hold time, value. The receiving device will discard the CDP information in the CDP packet after the hold time has elapsed.
You can set the hold time lower than the default setting of 180 seconds if you want the receiving devices to update their CDP information more rapidly.
The CDP hold time must be set to a higher number of seconds than the time between CDP transmissions, which is set using the cdptimer command.
Examples
In the following example, the CDP packets being sent from the router are configured with a hold time of 60 seconds.
Router(config)# cdp holdtime 60
Related Commands
Command
Description
cdptimer
Specifies how often the Cisco IOS software sends CDP updates.
showcdp
Displays global CDP information, including timer and hold-time information.
cdp log mismatch duplex
To display the log of duplex mismatches generated by the Cisco Discovery Protocol on Ethernet interfaces, use the cdplogmismatchduplex command in global configuration mode or in interface configuration mode. To disable the display of duplex messages, use the no form of this command.
cdplogmismatchduplex
nocdplogmismatchduplex
Syntax Description
This command has no arguments or keywords.
Command Default
Duplex mismatches are displayed for all Ethernet interfaces by default.
Command Modes
Global configuration
Interface configuration
Command History
Release
Modification
12.0
This command was introduced.
Usage Guidelines
Duplex mismatches can occur only on Ethernet interfaces.
When you enter the cdplogmismatchduplex command in global configuration mode, duplex mismatches are displayed for all Ethernet interfaces on the device. If the command is disabled in global configuration mode, the command cannot be configured in interface configuration mode. When you enter the cdplogmismatchduplex command in interface configuration mode, only duplex mismatches for the specified Ethernet interface are displayed.
To enable reporting of duplex mismatches, issue the cdplogmismatchduplex command in global configuration mode. If the command was previously disabled under a specified interface, issue the command in interface configuration mode for that interface.
To disable reporting of duplex mismatches globally, issue the nocdplogmismatchduplex command in global configuration mode. To disable reporting duplex mismatches for a specified Ethernet interface, use the nocdplogmismatchduplex command in interface configuration mode.
Examples
The following example shows how to enable the display of duplex messages from all Ethernet interfaces on a router:
Router(config)#
cdp log mismatch duplex
The following example shows how to enable the display of duplex messages that may be generated from only Ethernet interface 2/1:
The following is sample output from the showrunning-config command. The bold text in the output shows that the cdplogmismatchduplexcommand is disabled globally.
Router# show running-config
version 12.2
hostname Router
!
interface Ethernet2/0
no ip address
duplex half
interface Ethernet2/1
no ip address
duplex half
!
no cdp log mismatch duplex
!
line con 0
line aux 0
The following is sample output from the showrunning-config command. The bold text in the output shows that the cdplogmismatchduplex command is disabled under a specific interface.
Router# show running-config
version 12.2
hostname Router
!
interface Ethernet2/0
no ip address
duplex half
no cdp log mismatch duplex
interface Ethernet2/1
no ip address
duplex half
!!
line con 0
line aux 0
line vty 0 4
Related Commands
Command
Description
cdpenable
Enables Cisco Discovery Protocol on a supported interface.
cdprun
Reenables Cisco Discovery Protocol on a Cisco device.
cdp run
To enable Cisco Discovery Protocol, use thecdpruncommand in global configuration mode. To disable Cisco Discovery Protocol, use the
noform of this command.
cdprun
nocdprun
Syntax Description
This command has no arguments or keywords.
Command Default
This command is enabled on all the platforms except for the Cisco 10000 Series Edge Services Router platform.
Command Modes
Global configuration (config)
Command History
Release
Modification
10.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
15.1(2)SNG
This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.
Usage Guidelines
Cisco Discovery Protocol is enabled by default on all platforms except the Cisco 10000 Series Edge Services Router, which means Cisco IOS software receives Cisco Discovery Protocol information. Cisco Discovery Protocol also is enabled on supported interfaces by default. To disable Cisco Discovery Protocol on an interface, use the
nocdpenable command in interface configuration mode.
The
showrunning-config command lists
nocdprun when Cisco Discovery Protocol is disabled globally, which is not the default behavior. As a result of changes made for the Cisco 10000 platform, the
showrunning-config command will list the
cdprun command when Cisco Discovery Protocol is enabled globally.
Note
Because on-demand routing (ODR) uses Cisco Discovery Protocol, the
cdpenable,
cdptimer, andcdprun commands affect the operation of the
routerodr global configuration command. For more information about the
routerodr command, see the Cisco IOS IP Command Reference, Volume 2 of 3: Routing Protocols document.
Examples
In the following example, Cisco Discovery Protocol is disabled globally, and then the user attempts to enable it on the Ethernet interface 0:
Router(config)# no cdp run
Router(config)# end
Router# show cdp
% CDP is not enabled
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# interface ethernet0
Router(config-if)# cdp enable
% Cannot enable CDP on this interface, since CDP is not running
Router(config-if)#
Related Commands
Command
Description
cdpenable
Enables Cisco Discovery Protocol on a supported interface.
cdpholdtime
Specifies the amount of time that a receiving device should hold a Cisco Discovery Protocol packet before discarding it.
cdptimer
Specifies how often the Cisco IOS software sends Cisco Discovery Protocol updates.
routerodr
Enables ODR on the hub router.
cdp source-interface
To configure the Cisco Discovery Protocol source interface, use the
cdp source-interface command in global configuration mode.
cdpsource-interfacetypenumber
nocdpsource-interface
Syntax Description
type
Type of interface to be configured.
number
Port, connector, or interface card number. These numbers were assigned at the time of installation or when added to a system, and can be displayed with the
showinterfaces command.
Command Default
No Cisco Discovery Protocol source-interface is specified.
Command Modes
Global configuration
Command History
Release
Modification
12.2(11)T
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
Use of this command ensures that Cisco Discovery Protocol packets use the IP address that has been previously assigned to an interface. Without this command, Cisco Discovery Protocol uses the IP address of the first available interface.
The conditions that an interface should satisfy to be the source interface are as follows:
It should have an IP address.
Its status should be UP.
It should not be an IP unnumbered interface.
When Cisco Discovery Protocol is enabled and the Cisco Discovery Protocol source interface has not been configured, then Cisco Discovery Protocol uses the IP address of the first available interface.
Examples
The following example configures Cisco Discovery Protocol to use the IP address that has been assigned to interface loopback 1.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cdp source-interface loopback 1
Router(config)# exit
Router#
Related Commands
Command
Description
cdpenable
Enables Cisco Discovery Protocol on a supported interface.
cdprun
Reenables Cisco Discovery Protocol on a Cisco device.
cdp timer
To specify how often the Cisco IOS software sends Cisco Discovery Protocol (CDP) updates, use the
cdptimer command in global configuration mode. To revert to the default setting, use the
noform of this command.
cdptimerseconds
nocdptimer
Syntax Description
seconds
Integer that specifies how often, in seconds, the Cisco IOS software sends CDP updates. The default is 60 seconds.
Command Default
The default setting is 60 seconds.
Command Modes
Global configuration
Command History
Release
Modification
10.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
The trade-off with sending more frequent CDP updates to provide up-to-date information, is that bandwidth is used more often.
Note
The
cdpenable,
cdptimer, andcdprun commands affect the operation of the IP on demand routing feature (that is, the
routerodr global configuration command). For more information on the
routerodr command, see the “On-Demand Routing Commands” chapter in the Cisco IOS IP Command Reference, Volume 2 of 3: Routing Protocols document.
Examples
In the following example, CDP updates are sent every 80 seconds, less frequently than the default setting of 60 seconds. You might want to make this change if you are concerned about preserving bandwidth.
cdp timer 80
Related Commands
Command
Description
cdpenable
Enables CDP on a supported interface.
cdpholdtime
Specifies the amount of time the receiving device should hold a CDP packet from your router before discarding it.
cdptimer
Specifies how often the Cisco IOS software sends CDP updates.
routerodr
Enables ODR on the hub router.
showcdp
Displays global CDP information, including timer and hold-time information.
cdp tlv
To configure location support in Cisco Discovery Protocol (CDP), use the cdptlv command in global configuration mode or interface configuration mode. To disable the location support configuration, use the no form of this command.
(Optional) Configures application TLV type information. The range is from 1001 to 65535.
valuevalue
Configures application TLV value information.
Command Default
Application TLVs, location TLVs, and location-server TLVs in CDP are enabled.
Command Modes
Global configuration (config)
Interface configuration (config-if)
Command History
Release
Modification
12.2(55)SE
This command was introduced.
Usage Guidelines
To enable location-based services, information on the exact location of endpoint devices in the network is very essential. The information on the location of endpoint devices is delivered through Cisco devices using the CDP mechanism. To enable location support at the global level, use the cdptlv command in global configuration mode. To enable location support on interfaces, use the cdptlv command in interface configuration mode. If application TLVs are enabled on all interfaces, the TLVs are sent on all interfaces. Location TLVs in CDP are enabled by default. You can disable the storage of location TLVs by using the nocdptlvlocation command. When you use the cdptlvlocation command in global configuration mode, CDP starts sending periodic location information when the location TLV is enabled and the location information is available. When you use the cdptlvlocation command in interface configuration mode, TLVs are sent along with the CDP messages periodically.
Examples
The following example shows how to configure location support for application TLVs in CDP at the global level:
Router(config)# cdp tlv app
The following example shows how to configure location support for application TLVs in CDP at an interface level:
To reset Cisco Discovery Protocol (CDP) traffic counters to zero, use the clearcdpcounterscommand in privileged EXEC mode.
clearcdpcounters
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
Modification
10.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples
The following example clears the CDP counters. The showcdptrafficoutput shows that all of the traffic counters have been reset to zero.
Clears the table that contains CDP information about neighbors.
showcdptraffic
Displays traffic information from the CDP table.
clear cdp table
To clear the table that contains Cisco Discovery Protocol (CDP) information about neighbors, use the clearcdptable command in privileged EXEC mode.
clearcdptable
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
Modification
10.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples
The following example clears the CDP table. The output of the showcdpneighborscommand shows that all information has been deleted from the table.
Router# clear cdp table
CDP-AD: Deleted table entry for neon.cisco.com, interface Ethernet0
CDP-AD: Deleted table entry for neon.cisco.com, interface Serial0
Router# show cdp neighbors
Capability Codes: R - Router, T - Trans Bridge, B - Source Route Bridge
S - Switch, H - Host, I - IGMP
Device ID Local Intrfce Holdtme Capability Platform Port ID
Related Commands
Command
Description
showcdpneighbors
Displays information about neighbors.
show cdp
To display global Cisco Discovery Protocol (CDP) information, including timer and hold-time information, use the
showcdp command in privileged EXEC mode.
showcdp
[ vlanvlan ]
Syntax Description
vlanvlan
(Optional) Specifies a VLAN. Limits the display of switch port information to the specified VLAN. Range: 1 to 4094.
Command Default
No default behavior or values.
Command Modes
EXEC (#)
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.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.2(33)SXI
This command was changed to add the optional
vlanvlan keyword and argument.
Usage Guidelines
Cisco IOS Release 12.2(33)SXI and later releases allow you to limit the display of switch port information to the specified VLAN.
Examples
The following example shows that the current router is sending CDP advertisements every 1 minute (the default setting for the
cdptimerglobal configuration command). Also shown is that the current router directs its neighbors to hold its CDP advertisements for 3 minutes (the default for the
cdpholdtimeglobal 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
The following example shows how to limit the displayed CDP information to a specific VLAN:
Router# show cdp vlan 11
Global CDP information:
Sending CDP packets every 60 seconds
Sending a holdtime value of 180 seconds
Sending CDPv2 advertisements is enabled
The table below describes the significant fields shown in the display.
Table 1 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
cdptimer 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
cdpholdtime 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
cdpadvertisev2 global configuration command.
Related Commands
Command
Description
cdpadvertise-v2
Enables CDP Version 2 advertising functionality on a device.
cdpholdtime
Specifies the amount of time the receiving device should hold a CDP packet from your router before discarding it.
cdptimer
Specifies how often the Cisco IOS software sends CDP updates.
showcdpentry
Displays information about a specific neighbor device listed in the CDP table.
showcdpinterface
Displays information about the interfaces on which CDP is enabled.
showcdpneighbors
Displays detailed information about neighboring devices discovered using CDP.
showcdptraffic
Displays information about traffic between devices gathered using CDP.
show cdp entry
To display information about a specific neighboring device discovered using Cisco Discovery Protocol (CDP), use the
showcdpentrycommand in privileged EXEC mode.
Name of the neighbor about which you want information. You can enter an optional asterisk (*) at the end of a
device-name as a wildcard. For example, entering
showcdpentrydev* will match all device names that begin with
dev.
version
(Optional) Limits the display to information about the version of software running on the router.
protocol
(Optional) Limits the display to information about the protocols enabled on a router.
Command Modes
Privileged EXEC
Command History
Release
Modification
10.3
This command was introduced.
12.2(8)T
Support for IPv6 address and address type information was added.
12.2(14)S
This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples
The following is sample output from theshowcdpentrycommand. Information about the neighbor
device.cisco.com is displayed, including device ID, protocols and addresses, platform, interface, hold time, and version.
Router# show cdp entry device.cisco.com
Device ID: device.cisco.com
Entry address(es):
IP address: 10.1.17.24
IPv6 address: FE80::203:E3FF:FE6A:BF81 (link-local)
IPv6 address: 4000::BC:0:0:C0A8:BC06 (global unicast)
CLNS address: 490001.1111.1111.1111.00
Platform: cisco 3640, Capabilities: Router
Interface: Ethernet0/1, Port ID (outgoing port): Ethernet0/1
Holdtime : 160 sec
Version :
Cisco Internetwork Operating System Software
IOS (tm) 3600 Software (C3640-A2IS-M), Experimental Version 12.2
Copyright (c) 1986-2001 by cisco Systems, Inc.
Compiled Wed 08-Aug-01 12:39 by joeuser
The table below describes the significant fields shown in the example.
Table 2 show cdp entry Field Descriptions
Field
Definition
Device ID: device.cisco.com
Name or ID of the device.
Entry address(es):
The IP, IPv6 link-local, IPv6 global unicast, and CLNS addresses.
Platform:
Platform information specific to the device.
Interface: Ethernet0/1, Port ID (outgoing port): Ethernet0/1
Information about the interface and port ID interface.
Holdtime:
Holdtime length in seconds.
Version:
Information about the software version.
The following is sample output from theshowcdpentryversion command. Only information about the version of software running ondevice.cisco.com is displayed.
Router# show cdp entry device.cisco.com version
Version information for device.cisco.com:
Cisco Internetwork Operating System Software
IOS (tm) 3600 Software (C3640-A2IS-M), Experimental Version 12.2
Copyright (c) 1986-2001 by cisco Systems, Inc.
Compiled Wed 08-Aug-01 12:39 by joeuser
The following is sample output from the
showcdpentryprotocol 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: 10.1.17.24
IPv6 address: FE80::203:E3FF:FE6A:BF81 (link-local)
IPv6 address: 4000::BC:0:0:C0A8:BC06 (global unicast)
CLNS address: 490001.1111.1111.1111.00
Related Commands
Command
Description
showcdp
Displays global CDP information, including timer and hold-time information.
showcdpinterface
Displays information about the interfaces on which CDP is enabled.
showcdpneighbors
Displays detailed information about neighboring devices discovered using CDP.
showcdptraffic
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 showcdpinterface command in privileged EXEC mode.
showcdpinterface
[ typenumber ]
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.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples
The following is sample output from theshowcdpinterfacecommand. 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 theshowcdpinterfacecommand 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
showcdp
Displays global CDP information, including timer and hold-time information.
showcdpentry
Displays information about a specific neighbor device or all neighboring devices discovered using CDP.
showcdpneighbors
Displays detailed information about neighboring devices discovered using CDP.
showcdptraffic
Displays traffic information from the CDP table.
show cdp neighbors
To display detailed information about neighboring devices discovered using Cisco Discovery Protocol, use the
showcdpneighbors command in privileged EXEC mode.
showcdpneighbors
[ typenumber ]
[detail]
Syntax Description
type
(Optional) Interface type that is connected to the neighbors about which you want information; possible valid values are
ethernet,
fastethernet,
gigabitethernet,
tengigabitethernet,
port-channel,and
vlan.
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
This command was modified. The output of this command using the
detail keyword was expanded to include Cisco Discovery Protocol Version 2 information.
12.2(8)T
This command was modified. Support for IPv6 address and address type information was added.
12.2(14)S
This command was integrated into Cisco IOS Release 12.2(14)S. Support for IPv6 address and address type information was added.
12.2(14)SX
This command is supported in the Cisco IOS Release 12.2(14)SX. Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB
This command was modified. Support for this command was introduced on the Supervisor Engine 2.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.4(25d)JAX
This command was integrated into Cisco IOS Release 12.4(25d)JAX. The output of this command was modified to display the host router's neighbor wireless LAN-Gigabit Ethernet port as “WGi” instead of “Gig”.
Usage Guidelines
The
vlan keyword is supported in Cisco 7600 series routers that are configured with a Supervisor Engine 2.
The
port-channel values are from 0 to 282; values from 257 to 282 are supported on the call switching module (CSM) and the firewall services module (FWSM) only.
Examples
The following is sample output from the
showcdpneighbors 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
device1 Eth 0 133 R 4500 Eth 0
device2 Eth 0 152 R AS5200 Eth 0
device3 Eth 0 144 R 3640 Eth0/0
device4 Eth 0 141 RP1 Eth 0/0
device5 Eth 0 164 7206 Eth 1/0
The following sample output from the
showcdpneighbors command displays details of the wireless LAN-Gigabit Ethernet port:
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
device6 Gig 0 157 R S I C887VA-W- WGi 0
The table below describes the fields shown in the display.
Table 3 show cdp neighbors Field Descriptions
Field
Definition
Capability Codes
The type of device that can be discovered.
Device ID
The name of the neighbor device and either the MAC address or the serial number of this device.
Local Intrfce
The local interface through which this neighbor is connected.
Holdtme
The remaining amount of time (in seconds) the current device will hold the Cisco Discovery Protocol advertisement from a sending router before discarding it.
Capability
The type of the device listed in the CDP Neighbors table. Possible values are as follows:
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 interface and port number of the neighboring device.
The following is sample output for one neighbor from the
showcdpneighborsdetailcommand. Additional detail is shown about neighbors, including network addresses, enabled protocols, and software version.
The network address of the neighbor device. The address can be in IP, IPv6, IPX, AppleTalk, DECnet, or Connectionless Network Service (CLNS) protocol conventions.
IPv6 addresses are followed by one of the following IPv6 address types:
global unicast
link-local
multicast
site-local
V4 compatible
Note
For Cisco IOS Releases12.2(33)SXH3, Release 12.2(33)SXI and later releases, the command will not display the AppleTalk address.
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 local interface through which this neighbor is connected.
Port ID
The interface and port number of the neighboring device.
Holdtime
The remaining amount of time (in seconds) the current device will hold the CDP advertisement from a sending router before discarding it.
Version
The software version of the neighbor device.
advertisement version:
Version of CDP that is being used for CDP advertisements.
Duplex Mode
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.
Related Commands
Command
Description
showcdp
Displays global CDP information, including timer and hold-time information.
showcdpentry
Displays information about a specific neighbor device listed in the CDP table.
showcdpinterface
Displays information about the interfaces on which CDP is enabled.
showcdptraffic
Displays information about traffic between devices gathered using CDP.
show cdp tlv
To display information about Cisco Discovery Protocol (CDP) Type-Length-Values (TLVs), use the
showcdptlvcommand in privileged EXEC mode.
(Optional) Displays location information for all TLVs.
civic
(Optional) Displays civic location information.
elin
(Optional) Displays emergency location identifier number (ELIN) location information.
location-server
Displays location-server information stored in CDP for one interface or for all interfaces.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
12.2(55)SE
This command was introduced.
Usage Guidelines
You can use the
showcdptlv command to verify the TLVs configured on CDP. The
showcdptlv command displays location-specific information for an interface, if an interface is specified; otherwise, it displays location-specific information for all interfaces. You can also choose to display location-specific information for civic, ELIN, or all TLVs.
Examples
The following example shows how to display location-specific information for all TLVs:
Router# show cdp tlv location civic interface gigabitEthernet 3/0/2
No CIVIC Location received from neighbor(switch1)
Interface (GigabitEthernet3/0/2), Civic country code: US
CA type: 3, Len: 9, Value: bangalore
CA type: 24, Len: 6, Value: 560087
CA type: 25, Len: 18, Value: CessnaBusinessPark
CA type: 34, Len: 13, Value: OuterRingRoad
The table below describes the significant fields shown in the display.
Table 5 show cdp tlv Field Descriptions
Field
Description
Interface
Displays the interface on which location support is configured.
CA type
Displays the civic address (CA) type.
Len
Displays the variable length of the civic address.
Value
Displays the application TLV value information.
Related Commands
Command
Description
cdptlv
Configures location support in CDP.
show cdp traffic
To display information about traffic between devices gathered using Cisco Discovery Protocol (CDP), use the
showcdptrafficcommand in privileged EXEC mode.
showcdptraffic
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
Modification
10.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples
The following is sample output from the
showcdptraffic 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
The table below describes the significant fields shown in the display.
Table 6 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
showcdp
Displays global CDP information, including timer and hold-time information.
showcdpentry
Displays information about a specific neighbor device listed in the CDP table.
showcdpinterface
Displays information about the interfaces on which CDP is enabled.
showcdpneighbors
Displays detailed information about neighboring devices discovered using CDP.