cdpctl Command
Purpose
Controls the cdpd daemon that receives the incoming data packets or messages by using the Cisco Discovery Protocol (CDP) and discovers the physically connected Cisco devices.
Syntax
cdpctl subcommand device_name
Description
The CDP is a Layer 2 (data link layer) protocol that is media-independent and
network-independent. The CDP is used by networking applications that run on Cisco devices to
discover other Cisco devices that are directly connected to the device. Starting from AIX 7 with 7200-05, the CDP functions are implemented
on an AIX® logical partition by using the
cdpd daemon to receive the incoming data packets or messages by using the CDP.
The System Resource Controller (SRC) subsystem starts the cdpd daemon when you
run the following command:
startsrc -s cdpd
The cdpctl
command controls the cdpd daemon by configuring the network interface on an AIX logical partition to receive the incoming data packets or
messages by using the CDP that contains information about physically connected Cisco devices. The
cdpctl command also discovers the physically connected Cisco devices and the
associated configuration settings by detecting the data packets or messages that are broadcast from
the connected Cisco devices. Note: The CDP functions are implemented on AIX operating system to receive CDP messages and to discover physically connected
devices only. The CDP data packets can be received only by physical interfaces that are connected to
the Cisco device and not by virtual interfaces.
Subcommands
- list
- Displays list of network interfaces on the AIX logical partition that are CDP-capable. CDP-capable network interface means that the network interface can be configured to receive incoming data packets or messages by using CDP.
- add
- Adds a CDP-capable Cisco device or network interface to the AIX logical partition.
- show portlist
- Displays list of network interfaces that are configured to receive incoming data packets or messages by using CDP.
- show port
- Displays CDP information (such as switch and router capabilities) that is received on configured CDP-capable network interfaces.
- remove
- Removes the configured network interface from receiving any incoming data packets or messages by using the CDP from the connected Cisco devices.
Examples
- To display the usage of the cdpctl command, enter the following
command:
cdpctl
- To list all the CDP-capable devices and network interfaces in the AIX logical partition, enter the following command:
An output that is similar to the following example is displayed:cdpctl list
CDP capturable devices on the system: en0 en2
- To add a network interface to the AIX logical partition that can receive data packets or
messages from the physically connected Cisco devices by using the CDP, enter the following
command:
An output that is similar to the following example is displayed:cdpctl add en0
Successfully added port en0 Waiting for CDP advertise (default 60 seconds)...... Device ID : sw-yyyyyycisco92300.xxx.xxxx.xxx.com(XXXXXXXKQ) Address : 9.x.y.z Port ID : Ethernet1/49 Capabilities : Router Level 3 : Level 2 Switch : IGMP snooping Cisco switch OS Version : Cisco Nexus Operating System (NX-OS) Software, Version 9.2(3) Platform : N9K-C92300YC Native VLAN ID : 1 Trusted Bitmap : N/A AVVID untrusted ports : N/A Duplex : Full MTU : 1500 System Name : sw-xxxxxx92300 System Object ID : N/A Management Addresses : 9.x.y.z
- To list the network interfaces on the AIX logical partition that are configured to receive data
packets and messages by using CDP, enter the following
command:
An output that is similar to the following example is displayed:cdpctl show portlist
en0 en1
Files
- /usr/sbin/cdpd
- Contains the cdpd daemon.
- /usr/sbin/cdpctl
- Contains the cdpctl command.