Cisco Discovery Protocol Command Reference, Cisco IOS XE Release 3SE (Catalyst 3850 Switches)
cdp advertise-v2 through show cdp traffic
Download this chapter
cdp advertise-v2 through show cdp trafficcdp advertise-v2 through show cdp traffic
Download the complete book
Cisco Discovery Protocol Command Reference, Cisco IOS XE Release 3SE (Catalyst 3850 Switches)Cisco Discovery Protocol Command Reference, Cisco IOS XE Release 3SE (Catalyst 3850 Switches) (PDF - 770 KB)
 Feedback

cdp advertise-v2 through show cdp traffic

cdp advertise-v2

To enable Cisco Discovery Protocol Version 2 (CDPv2) advertising functionality on a device, use the cdp advertise-v2 command in global configuration mode. To disable advertising CDPv2 functionality, use the no form of the command.

cdp advertise-v2

no cdp advertise-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

cdp enable

Enables CDP on a supported interface.

cdp run

Reenables CDP on a Cisco device.

cdp enable

To enable Cisco Discovery Protocol (CDP) on an interface, use the cdp enable command in interface configuration mode. To disable CDP on an interface, use the noform of this command.

cdp enable

no cdp enable

Syntax Description

This command has no arguments or keywords.

Command Default

Enabled at the global level and on all supported interfaces.

Command Modes


Interface 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 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 cdp enable, cdp timer, and cdp run commands affect the operation of the IP on demand routing feature (that is, the router odr global configuration command). For more information on the router odr 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 the Ethernet 0 interface 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# config terminal
Router(config)# interface ethernet 0
Router(config-if)# no cdp enable

Related Commands

Command

Description

cdp run

Reenables CDP on a Cisco device.

cdp timer

Specifies how often the Cisco IOS software sends CDP updates.

router odr

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 the cdp holdtime command in global configuration mode. To revert to the default setting, use the noform of this command.

cdp holdtime seconds

no cdp holdtime

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 cdp timer 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

cdp timer

Specifies how often the Cisco IOS software sends CDP updates.

show cdp

Displays global CDP information, including timer and hold-time information.

cdp run

To enable Cisco Discovery Protocol, use the cdp runcommand in global configuration mode. To disable Cisco Discovery Protocol, use the noform of this command.

cdp run

no cdp run

Syntax Description

This command has no arguments or keywords.

Command Default

Enabled on all platforms except the Cisco 10000 Series Edge Services Router

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

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 no cdp enable command in interface configuration mode.

The show running-config command lists no cdp run when Cisco Discovery Protocol is disabled globally, which is not the default behavior. As a result of changes made for the Cisco 10000 platform, show running-config will list cdp run when Cisco Discovery Protocol is enabled globally.


Note

Because on-demand routing (ODR) uses Cisco Discovery Protocol, the cdp enable, cdp timer, and cdp run commands affect the operation of the router odr global configuration command. For more information about the router odr 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, then the user attempts to enable it on the Ethernet 0 interface: 

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

cdp enable

Enables Cisco Discovery Protocol on a supported interface.

cdp holdtime

Specifies the amount of time a receiving device should hold a Cisco Discovery Protocol packet before discarding it.

cdp timer

Specifies how often the Cisco IOS software sends Cisco Discovery Protocol updates.

router odr

Enables ODR on the hub router.

cdp timer

To specify how often the Cisco IOS software sends Cisco Discovery Protocol (CDP) updates, use the cdp timer command in global configuration mode. To revert to the default setting, use the noform of this command.

cdp timer seconds

no cdp timer

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 cdp enable, cdp timer, and cdp run commands affect the operation of the IP on demand routing feature (that is, the router odr global configuration command). For more information on the router odr 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

cdp enable

Enables CDP on a supported interface.

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.

router odr

Enables ODR on the hub router.

show cdp

Displays global CDP information, including timer and hold-time information.

clear cdp counters

To reset Cisco Discovery Protocol (CDP) traffic counters to zero, use the clear cdp counterscommand in privileged EXEC mode.

clear cdp counters

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 show cdp trafficoutput shows that all of the traffic counters have been reset to zero.

Router# clear cdp counters
Router# show cdp traffic
CDP counters:
        Packets output: 0, Input: 0
        Hdr syntax: 0, Chksum error: 0, Encaps failed: 0
        No memory: 0, Invalid packet: 0, Fragmented: 0

Related Commands

Command

Description

clear cdp table

Clears the table that contains CDP information about neighbors.

show cdp traffic

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 clear cdp table command in privileged EXEC mode.

clear cdp table

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 show cdp neighbors command 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

show cdp neighbors

Displays information about neighbors.

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 [ vlan vlan ]

Syntax Description

vlan vlan

(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 vlan vlan 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 cdp timerglobal 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 holdtimeglobal 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 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 cdp entry


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

 
	 


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



        Syntax Description
      
 
		

 
					 
 
						 
						  * 
						 
					 

 
				  		
 
					 
 Displays all of the CDP neighbors.
					 

 
				  		



 
					 
 
						 
						  device-name 
						 
						 
						  * 
						 
					 

 
				  		
 
					 
 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 
						show 
						  cdp 
						  entry 
						  dev* 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 the 
		  show 
			 cdp 
			 entrycommand. 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 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 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 
		  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: 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 
						 
					 

 
				  		




 
					 
 
						 
						  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.


              		




                

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 show cdp interfacecommand. 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 interfacecommand 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, use the 
		  show 
			 cdp 
			 neighbors command in privileged EXEC mode.
		

 
	 


 
		
show
cdp
neighbors
 [ type
number ] 
 [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 
		  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
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 
		  show 
			 cdp 
			 neighbors 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 
		  show 
			 cdp 
			 neighbors 
		   
			 detailcommand. Additional detail is shown about neighbors, including network addresses, enabled protocols, and software version. 
		

 
		
Router# show cdp neighbors detail
Device ID: device.cisco.com
Entry address(es):
  IPv6 address: FE80::203:E3FF:FE6A:BF81  (link-local)
  IPv6 address: 4000::BC:0:0:C0A8:BC06  (global unicast)
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), Version 12.2(25)SEB4, RELE)
advertisement version: 2
Duplex Mode: half
Native VLAN: 42
VTP Management Domain: ‘Accounting Group’


 
		
 The table below describes the fields shown in the display. 
		

 
		

Table 4 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. 
				  

 
						



 
				  
 IPv6 address: FE80::203:E3FF:FE6A:BF81 (link-local) 
				  

 
						
 
				  
 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 
						 
					 

 
				  		




 
					 
 
						 
						  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 
			 trafficcommand 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.
					 

 
				  		



 
					 
 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 
		  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


 
		
 The table below describes the significant fields shown in the display.
		

 
		

Table 5 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.