CISCO-CDP-MIB

All MIBs › CISCO-CDP-MIB

Organization: Cisco System Inc.

Last Updated: 2005-03-21

Category: Cisco Devices, Device Management

Description: Manages the Cisco Discovery Protocol (CDP), providing information about directly connected neighboring network devices.

IPNetwork Monitor uses several OIDs from this MIB in network discovery and polling the applicable devices. Start monitoring CISCO-CDP-MIB with a free 30-day trial of IPNetwork Monitor.

What Is CISCO-CDP-MIB?

CISCO-CDP-MIB is a well-known Cisco MIB for the Cisco Discovery Protocol (CDP), a Layer 2 protocol that lets Cisco (and CDP-capable) devices discover directly connected neighbors and exchange basic identity and capability information. It exposes per-interface CDP configuration (enable state, message/advertisement interval) and a neighbor cache table holding information learned from adjacent devices, plus extended per-interface trust and CoS settings. Its monitoring value is primarily topology and neighbor-discovery visibility rather than classic hardware health: administrators poll the cdpCache to build an accurate picture of physical network topology, verify that CDP is enabled on the expected interfaces (cdpInterfaceEnable) with the correct advertisement timing (cdpInterfaceMessageInterval), and check trust/CoS settings on interfaces carrying voice traffic. It depends on the standard IF-MIB ifIndex convention to associate CDP data with physical interfaces. It is typically deployed on essentially all Cisco switches and routers as a baseline discovery and topology-mapping tool used by network management systems. This is a heavily searched Cisco MIB, since cisco-cdp-mib is the standard reference for monitoring Cisco Discovery Protocol neighbor information via SNMP.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-CDP-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Cisco switches and routers
any CDP-capable Cisco network device

Monitoring Examples

An operator would walk cdpInterfaceTable / cdpInterfaceEntry to confirm cdpInterfaceEnable is true on interfaces expected to advertise CDP, and separately query cdpCache to see the neighbor device names, platforms, and addresses learned on each local port, useful for auto-discovering network topology. A disappearing entry from cdpCache for a previously-seen neighbor would indicate that a downstream device went down or a cable was unplugged.

What Can Be Monitored

CDP enable state per interface
CDP advertisement interval
neighbor device cache (topology)
interface trust/CoS settings for untrusted ports

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From CISCO-TC

CiscoNetworkAddress
CiscoNetworkProtocol

From CISCO-VTP-MIB

VlanIndex

From IF-MIB

ifIndex

OBJECT-TYPE

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Integer32
MODULE-IDENTITY
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

DisplayString
TimeStamp
TruthValue

OIDs

OID symbolic	OID numeric	Type	Access	Description
cdpCache	1.3.6.1.4.1.9.9.23.1.2
ADR cdpCacheAddress	1.3.6.1.4.1.9.9.23.1.2.1.1.4	CiscoNetworkAddress	read-only	The (first) network-layer address of the device as reported in the Address TLV of the most recently received CDP message. For example, if the corresponding instance of cacheAddressType had the value 'ip(1)', then this object would be an IPv4-address. If the neighbor device is SNMP-manageable, it is supposed to generate its CDP messages such that this address is one at which it will receive SNMP messages. Use cdpCtAddressTable to extract the remaining addresses from the Address TLV received most recently.
CIS cdpCacheAddressType	1.3.6.1.4.1.9.9.23.1.2.1.1.3	CiscoNetworkProtocol	read-only	An indication of the type of address contained in the corresponding instance of cdpCacheAddress.
U32 cdpCacheApplianceID	1.3.6.1.4.1.9.9.23.1.2.1.1.13	Unsigned32	read-only	The remote device's Appliance ID, as reported in the most recent CDP message. This object is not instantiated if no Appliance VLAN-ID field (TLV) was reported in the most recently received CDP message.
OCT cdpCacheCapabilities	1.3.6.1.4.1.9.9.23.1.2.1.1.9	OCTET STRING	read-only	The Device's Functional Capabilities as reported in the most recent CDP message. For latest set of specific values, see the latest version of the CDP specification. The zero-length string indicates no Capabilities field (TLV) was reported in the most recent CDP message.
STR cdpCacheDeviceId	1.3.6.1.4.1.9.9.23.1.2.1.1.6	DisplayString	read-only	The Device-ID string as reported in the most recent CDP message. The zero-length string indicates no Device-ID field (TLV) was reported in the most recent CDP message.
I32 cdpCacheDeviceIndex	1.3.6.1.4.1.9.9.23.1.2.1.1.2	Integer32	not-accessible	A unique value for each device from which CDP messages are being received.
STR cdpCacheDevicePort	1.3.6.1.4.1.9.9.23.1.2.1.1.7	DisplayString	read-only	The Port-ID string as reported in the most recent CDP message. This will typically be the value of the ifName object (e.g., 'Ethernet0'). The zero-length string indicates no Port-ID field (TLV) was reported in the most recent CDP message.
INT cdpCacheDuplex	1.3.6.1.4.1.9.9.23.1.2.1.1.12	INTEGER	read-only	The remote device's interface's duplex mode, as reported in the most recent CDP message. The value unknown(1) indicates no duplex mode field (TLV) was reported in the most recent CDP message.
cdpCacheEntry	1.3.6.1.4.1.9.9.23.1.2.1.1		not-accessible	An entry (conceptual row) in the cdpCacheTable, containing the information received via CDP on one interface from one device. Entries appear when a CDP advertisement is received from a neighbor device. Entries disappear when CDP is disabled on the interface, or globally.
I32 cdpCacheIfIndex	1.3.6.1.4.1.9.9.23.1.2.1.1.1	Integer32	not-accessible	Normally, the ifIndex value of the local interface. For 802.3 Repeaters for which the repeater ports do not have ifIndex values assigned, this value is a unique value for the port, and greater than any ifIndex value supported by the repeater; the specific port number in this case, is given by the corresponding value of cdpInterfacePort.
TIM cdpCacheLastChange	1.3.6.1.4.1.9.9.23.1.2.1.1.24	TimeStamp	read-only	Indicates the time when this cache entry was last changed. This object is initialised to the current time when the entry gets created and updated to the current time whenever the value of any (other) object instance in the corresponding row is modified.
U32 cdpCacheMTU	1.3.6.1.4.1.9.9.23.1.2.1.1.16	Unsigned32	read-only	Indicates the size of the largest datagram that can be sent/received by remote device, as reported in the most recent CDP message. This object is not instantiated if no MTU field (TLV) was reported in the most recently received CDP message.
VLA cdpCacheNativeVLAN	1.3.6.1.4.1.9.9.23.1.2.1.1.11	VlanIndex	read-only	The remote device's interface's native VLAN, as reported in the most recent CDP message. The value 0 indicates no native VLAN field (TLV) was reported in the most recent CDP message.
STR cdpCachePhysLocation	1.3.6.1.4.1.9.9.23.1.2.1.1.23	DisplayString	read-only	Indicates the physical location, as reported by the most recent CDP message, of a connector which is on, or physically connected to, the remote device's interface over which the CDP packet is sent. This object is not instantiated if no Physical Location field (TLV) was reported by the most recently received CDP message.
STR cdpCachePlatform	1.3.6.1.4.1.9.9.23.1.2.1.1.8	DisplayString	read-only	The Device's Hardware Platform as reported in the most recent CDP message. The zero-length string indicates that no Platform field (TLV) was reported in the most recent CDP message.
U32 cdpCachePowerConsumption	1.3.6.1.4.1.9.9.23.1.2.1.1.15	Unsigned32	read-only	The amount of power consumed by remote device, as reported in the most recent CDP message. This object is not instantiated if no Power Consumption field (TLV) was reported in the most recently received CDP message.
ADR cdpCachePrimaryMgmtAddr	1.3.6.1.4.1.9.9.23.1.2.1.1.20	CiscoNetworkAddress	read-only	This object indicates the (first) network layer address at which the device will accept SNMP messages as reported in the first address in the Management-Address TLV of the most recently received CDP message. If the corresponding instance of cdpCachePrimaryMgmtAddrType has the value 'ip(1)', then this object would be an IP-address. If the remote device is not currently manageable via any network protocol, then it reports the special value of the IPv4 address 0.0.0.0, and that address is recorded in this object. If the most recently received CDP message did not contain the Management-Address TLV, then this object is not instanstiated.
CIS cdpCachePrimaryMgmtAddrType	1.3.6.1.4.1.9.9.23.1.2.1.1.19	CiscoNetworkProtocol	read-only	An indication of the type of address contained in the corresponding instance of cdpCachePrimaryMgmtAddress.
ADR cdpCacheSecondaryMgmtAddr	1.3.6.1.4.1.9.9.23.1.2.1.1.22	CiscoNetworkAddress	read-only	This object indicates the alternate network layer address at which the device will accept SNMP messages as reported in the second address in the Management-Address TLV of the most recently received CDP message. If the corresponding instance of cdpCacheSecondaryMgmtAddrType has the value 'ip(1)', then this object would be an IP-address. If the remote device reports the special value of the IPv4 address 0.0.0.0, that address is recorded in this object. If the most recently received CDP message did not contain the Management-Address TLV, or if that TLV contained only one address, then this object is not instanstiated.
CIS cdpCacheSecondaryMgmtAddrType	1.3.6.1.4.1.9.9.23.1.2.1.1.21	CiscoNetworkProtocol	read-only	An indication of the type of address contained in the corresponding instance of cdpCacheSecondaryMgmtAddress.
STR cdpCacheSysName	1.3.6.1.4.1.9.9.23.1.2.1.1.17	DisplayString	read-only	Indicates the value of the remote device's sysName MIB object. By convention, it is the device's fully qualified domain name. This object is not instantiated if no sysName field (TLV) was reported in the most recently received CDP message.
OID cdpCacheSysObjectID	1.3.6.1.4.1.9.9.23.1.2.1.1.18	OBJECT IDENTIFIER	read-only	Indicates the value of the remote device's sysObjectID MIB object. This object is not instantiated if no sysObjectID field (TLV) was reported in the most recently received CDP message.
cdpCacheTable	1.3.6.1.4.1.9.9.23.1.2.1		not-accessible	The (conceptual) table containing the cached information obtained via receiving CDP messages.
STR cdpCacheVersion	1.3.6.1.4.1.9.9.23.1.2.1.1.5	DisplayString	read-only	The Version string as reported in the most recent CDP message. The zero-length string indicates no Version field (TLV) was reported in the most recent CDP message.
U32 cdpCacheVlanID	1.3.6.1.4.1.9.9.23.1.2.1.1.14	Unsigned32	read-only	The remote device's VoIP VLAN ID, as reported in the most recent CDP message. This object is not instantiated if no Appliance VLAN-ID field (TLV) was reported in the most recently received CDP message.
STR cdpCacheVTPMgmtDomain	1.3.6.1.4.1.9.9.23.1.2.1.1.10	DisplayString	read-only	The VTP Management Domain for the remote device's interface, as reported in the most recently received CDP message. This object is not instantiated if no VTP Management Domain field (TLV) was reported in the most recently received CDP message.
ADR cdpCtAddress	1.3.6.1.4.1.9.9.23.1.2.2.1.5	CiscoNetworkAddress	read-only	The N-th network-layer address of the device as reported in the most recent CDP message's Address TLV, where N-1 is given by the value of cdpCtAddressIndex. For example, if the the corresponding instance of cdpCtAddressType had the value 'ip(1)', then this object would be an IPv4-address. NOTE - The 1st address received in the Address TLV is available using cdpCacheAddress
cdpCtAddressEntry	1.3.6.1.4.1.9.9.23.1.2.2.1		not-accessible	An entry (conceptual row) in the cdpCtAddressTable, containing the information on one address received via CDP on one interface from one device. Entries appear when a CDP advertisement is received from a neighbor device, with an Address TLV. Entries disappear when CDP is disabled on the interface, or globally. An entry or entries would also disappear if the most recently received CDP packet contain fewer address entries in the Address TLV, than are currently present in the CDP cache.
I32 cdpCtAddressIndex	1.3.6.1.4.1.9.9.23.1.2.2.1.3	Integer32	not-accessible	The index of the address entry for a given cdpCacheIfIndex,cdpCacheDeviceIndex pair. It has the value N-1 for the N-th address in the Address TLV
cdpCtAddressTable	1.3.6.1.4.1.9.9.23.1.2.2		not-accessible	The (conceptual) table containing the list of network-layer addresses of a neighbor interface, as reported in the Address TLV of the most recently received CDP message. The first address included in the Address TLV is saved in cdpCacheAddress. This table contains the remainder of the addresses in the Address TLV.
CIS cdpCtAddressType	1.3.6.1.4.1.9.9.23.1.2.2.1.4	CiscoNetworkProtocol	read-only	An indication of the type of address contained in the corresponding instance of cdpCtAddress.
cdpGlobal	1.3.6.1.4.1.9.9.23.1.3
STR cdpGlobalDeviceId	1.3.6.1.4.1.9.9.23.1.3.4	DisplayString	read-only	The device ID advertised by this device. The format of this device id is characterized by the value of cdpGlobalDeviceIdFormat object.
INT cdpGlobalDeviceIdFormat	1.3.6.1.4.1.9.9.23.1.3.7	INTEGER	read-write	An indication of the format of Device-Id contained in the corresponding instance of cdpGlobalDeviceId. User can only specify the formats that the device is capable of as denoted in cdpGlobalDeviceIdFormatCpb object. serialNumber(1) indicates that the value of cdpGlobalDeviceId object is in the form of an ASCII string contain the device serial number. macAddress(2) indicates that the value of cdpGlobalDeviceId object is in the form of Layer 2 MAC address. other(3) indicates that the value of cdpGlobalDeviceId object is in the form of a platform specific ASCII string contain info that identifies the device. For example: ASCII string contains serialNumber appended/prepened with system name.
BIT cdpGlobalDeviceIdFormatCpb	1.3.6.1.4.1.9.9.23.1.3.6	Bits	read-only	Indicate the Device-Id format capability of the device. serialNumber(0) indicates that the device supports using serial number as the format for its DeviceId. macAddress(1) indicates that the device supports using layer 2 MAC address as the format for its DeviceId. other(2) indicates that the device supports using its platform specific format as the format for its DeviceId.
INT cdpGlobalHoldTime	1.3.6.1.4.1.9.9.23.1.3.3	INTEGER	read-write	The time for the receiving device holds CDP message. The default value is 180 seconds.
TIM cdpGlobalLastChange	1.3.6.1.4.1.9.9.23.1.3.5	TimeStamp	read-only	Indicates the time when the cache table was last changed. It is the most recent time at which any row was last created, modified or deleted.
INT cdpGlobalMessageInterval	1.3.6.1.4.1.9.9.23.1.3.2	INTEGER	read-write	The interval at which CDP messages are to be generated. The default value is 60 seconds.
T/F cdpGlobalRun	1.3.6.1.4.1.9.9.23.1.3.1	TruthValue	read-write	An indication of whether the Cisco Discovery Protocol is currently running. Entries in cdpCacheTable are deleted when CDP is disabled.
cdpInterface	1.3.6.1.4.1.9.9.23.1.1
U32 cdpInterfaceCosForUntrustedPort	1.3.6.1.4.1.9.9.23.1.1.2.1.2	Unsigned32	read-write	Indicates the value to be sent by COS for Untrusted Ports TLV.
T/F cdpInterfaceEnable	1.3.6.1.4.1.9.9.23.1.1.1.1.2	TruthValue	read-write	An indication of whether the Cisco Discovery Protocol is currently running on this interface. This variable has no effect when CDP is disabled (cdpGlobalRun = FALSE).
cdpInterfaceEntry	1.3.6.1.4.1.9.9.23.1.1.1.1		not-accessible	An entry (conceptual row) in the cdpInterfaceTable, containing the status of CDP on an interface.
INT cdpInterfaceExtendedTrust	1.3.6.1.4.1.9.9.23.1.1.2.1.1	INTEGER	read-write	Indicates the value to be sent by Extended Trust TLV. If trusted(1) is configured, the value of Extended Trust TLV is one byte in length with its least significant bit equal to 1 to indicate extended trust. All other bits are 0. If noTrust(2) is configured, the value of Extended Trust TLV is one byte in length with its least significant bit equal to 0 to indicate no extended trust. All other bits are 0.
cdpInterfaceExtEntry	1.3.6.1.4.1.9.9.23.1.1.2.1		not-accessible	An entry in the cdpInterfaceExtTable contains the values configured for Extented Trust TLV and COS (Class of Service) for Untrusted Ports TLV on an interface which supports the sending of these TLVs.
cdpInterfaceExtTable	1.3.6.1.4.1.9.9.23.1.1.2		not-accessible	This table contains the additional CDP configuration on the device's interfaces.
I32 cdpInterfaceGroup	1.3.6.1.4.1.9.9.23.1.1.1.1.4	Integer32	read-only	This object is only relevant to interfaces which are repeater ports on 802.3 repeaters. In this situation, it indicates the RFC1516 group number of the repeater port which corresponds to this interface.
I32 cdpInterfaceIfIndex	1.3.6.1.4.1.9.9.23.1.1.1.1.1	Integer32	not-accessible	The ifIndex value of the local interface. For 802.3 Repeaters on which the repeater ports do not have ifIndex values assigned, this value is a unique value for the port, and greater than any ifIndex value supported by the repeater; in this case, the specific port is indicated by corresponding values of cdpInterfaceGroup and cdpInterfacePort, where these values correspond to the group number and port number values of RFC 1516.
INT cdpInterfaceMessageInterval	1.3.6.1.4.1.9.9.23.1.1.1.1.3	INTEGER	read-write	The interval at which CDP messages are to be generated on this interface. The default value is 60 seconds.
STR cdpInterfaceName	1.3.6.1.4.1.9.9.23.1.1.1.1.6	DisplayString	read-only	The name of the local interface as advertised by CDP in the Port-ID TLV
I32 cdpInterfacePort	1.3.6.1.4.1.9.9.23.1.1.1.1.5	Integer32	read-only	This object is only relevant to interfaces which are repeater ports on 802.3 repeaters. In this situation, it indicates the RFC1516 port number of the repeater port which corresponds to this interface.
cdpInterfaceTable	1.3.6.1.4.1.9.9.23.1.1.1		not-accessible	The (conceptual) table containing the status of CDP on the device's interfaces.
ciscoCdpCtAddressGroup	1.3.6.1.4.1.9.9.23.2.2.8			A collection of objects for use with the Cisco Discovery Protocol to obtain the addresses from the Address TLV of a received CDP packet.
ciscoCdpMIB	1.3.6.1.4.1.9.9.23			The MIB module for management of the Cisco Discovery Protocol in Cisco devices.
ciscoCdpMIBCompliance	1.3.6.1.4.1.9.9.23.2.1.1			The compliance statement for the CDP MIB.
ciscoCdpMIBCompliance5	1.3.6.1.4.1.9.9.23.2.1.5			The compliance statement for the CDP MIB.
ciscoCdpMIBCompliances	1.3.6.1.4.1.9.9.23.2.1
ciscoCdpMIBComplianceV11R01	1.3.6.1.4.1.9.9.23.2.1.2			The compliance statement for the CDP MIB.
ciscoCdpMIBComplianceV11R02	1.3.6.1.4.1.9.9.23.2.1.3			The compliance statement for the CDP MIB.
ciscoCdpMIBComplianceV12R02	1.3.6.1.4.1.9.9.23.2.1.4			The compliance statement for the CDP MIB.
ciscoCdpMIBComplianceV12R03	1.3.6.1.4.1.9.9.23.2.1.6			The compliance statement for the CDP MIB.
ciscoCdpMIBConformance	1.3.6.1.4.1.9.9.23.2
ciscoCdpMIBGroup	1.3.6.1.4.1.9.9.23.2.2.1			A collection of objects for use with the Cisco Discovery Protocol.
ciscoCdpMIBGroups	1.3.6.1.4.1.9.9.23.2.2
ciscoCdpMIBGroupV11R01	1.3.6.1.4.1.9.9.23.2.2.2			A collection of objects for use with the Cisco Discovery Protocol.
ciscoCdpMIBGroupV11R02	1.3.6.1.4.1.9.9.23.2.2.3			A collection of objects for use with the Cisco Discovery Protocol.
ciscoCdpMIBGroupV12R02	1.3.6.1.4.1.9.9.23.2.2.5			A collection of objects for use with the Cisco Discovery Protocol.
ciscoCdpMIBGroupV12R03	1.3.6.1.4.1.9.9.23.2.2.9			A collection of objects for use with the Cisco Discovery Protocol.
ciscoCdpMIBObjects	1.3.6.1.4.1.9.9.23.1
ciscoCdpV2IfExtGroup	1.3.6.1.4.1.9.9.23.2.2.7			A collection of objects for use with the Cisco Discovery Protocol version 2 to configure the value for Extended Trust TLV and COS for Untrusted Port TLV.
ciscoCdpV2MIBGroup	1.3.6.1.4.1.9.9.23.2.2.6			A collection of objects for use with the Cisco Discovery Protocol version 2.

RFC description

Manages Cisco Discovery Protocol (CDP) for neighbor device discovery and protocol advertisement on interfaces.

Start monitoring Cisco switches and routers (Cisco Discovery Protocol) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download CISCO-CDP-MIB

What Is CISCO-CDP-MIB?

Supported Devices

Monitoring Examples

What Can Be Monitored

This MIB depends on

Related MIBs

RFC description