scapy-cdp 0.1.0

Send Cisco Discovery Protocol packets with Scapy

CDP Sender Module

Overview

scapy-cdp provides a small command line utility to send Cisco Discovery Protocol (CDP) packets using Scapy. It installs a cdp-sender command that transmits a CDP packet every 60 seconds. The module works well on Linux systems, including Raspberry Pi.

Installation

Install the package with pip:

sudo pip3 install scapy-cdp

This creates the /usr/local/bin/cdp-sender executable.

Usage

Display available options:

sudo cdp-sender --help

Example:

sudo cdp-sender --interface eth0 --device-id MyDevice --software-version "1.2.3" --platform "MyPlatform"

Settings can also come from a JSON configuration file:

{
  "interface": "eth0",
  "device_id": "MyDevice",
  "software_version": "1.2.3",
  "platform": "MyPlatform",
  "ttl": 120,
  "capabilities": "0x0038"
}

Run with the configuration file:

sudo cdp-sender --config config.json

Systemd Service

Create /etc/systemd/system/cdp_sender.service:

[Unit]
Description=CDP Sender Service
After=network.target

[Service]
ExecStart=/usr/local/bin/cdp-sender
Restart=always
User=root

[Install]
WantedBy=multi-user.target

Then enable and start the service:

sudo systemctl daemon-reload
sudo systemctl enable cdp_sender
sudo systemctl start cdp_sender

Cron Alternative

To run the script every minute with cron:

sudo crontab -e

Add this line:

* * * * * /usr/local/bin/cdp-sender

License

MIT