NDNDUMP(8)

💅 NDNDUMP(8) — ndndump, the traffic analysis tool 💅

🌸 NAME 🌸

okay so ndndump is literally a traffic analysis tool. That's the whole vibe: it captures NDN packets on the wire and shows you a quick little summary about each one. 🫶

✨ USAGE ✨

ndndump [-hvV] [-i INTERFACE] [-r FILE] [-f FILTER] [PCAP-FILTER]

🦋 DESCRIPTION 🦋

Bestie, listen: ndndump is a traffic analysis tool that captures NDN packets on the wire and displays brief information about them. Iconic. 💅

Currently, ndndump can extract Interest, Data, and Nack packets from:

• Ethernet frame
• PPP link (e.g., pcap trace from ndnSIM)
• IPv4 UDP unicast tunnel
• IPv4 UDP multicast group
• IPv4 TCP tunnel, when Interest/Data/Nack is aligned to the beginning of a TCP segment

For more complex scenarios — including when NDN packets span multiple IP fragments or multiple TCP segments — it is recommended to use the NDN Wireshark dissector, either via wireshark(1) or tshark(1). That's the move, fr fr. 🌈

💅 OPTIONS 💅

• -h, --help — Print help and exit. So helpful, so slay. ✨
• -i INTERFACE, --interface=INTERFACE — Listen on INTERFACE. If unspecified, ndndump searches the system interface list for the lowest numbered, configured up interface (excluding loopback). On Linux, a value of "any" can be used to capture packets from all interfaces. Note that captures on the "any" pseudo-interface will not be done in promiscuous mode. 👀
• -r FILE, --read=FILE — Read packets from FILE, which can be created by tcpdump(8) with its -w option, or by similar programs. 🎀
• -f FILTER, --filter=FILTER — Print a packet only if its name matches the regular expression FILTER. regex bestie behavior. 🧚
• -p, --no-promiscuous-mode — Do not put the interface into promiscuous mode. respectful interface vibes. 💅
• -t, --no-timestamp — Do not print a timestamp for each packet. no clock check. ⏰
• -v, --verbose — Produce verbose output. yap mode: on. 🗣️
• -V, --version — Print ndndump and libpcap version strings and exit. 💜
• PCAP-FILTER — PCAP-FILTER is an expression in pcap-filter(7) format that selects which packets will be analyzed. If no PCAP-FILTER is given, a default filter is used. The default filter can be seen with the --help <#cmdoption-h> option. 👑

🔥 EXAMPLES 🔥

Capture on eth1 and print packets containing "ping":

ndndump -i eth1 -f '.*ping.*'

💖 Copyright 💖

Copyright © 2014-2024 Named Data Networking Project.

---

💖 Source/version and date sign-off: NDN Essential Tools, version 24.07, dated 1980-01-01. That's the manual, bestie — go capture some packets and slay. 🎀✨