UDPDUMP(1)

πŸ’… UDPDUMP(1) πŸ’…

okay so bestie, you found udpdump β€” that's the tool name, and it lives in section 1 of the manual (the "commands you just type in your terminal" section, iykyk). buckle up, this one's actually so cute and useful 🫢


✨ NAME ✨

udpdump β€” it's a UDP receiver 🎧 that catches packets flying in from network devices (Aruba routers, looking at you πŸ‘€) and exports them in PCAP format. literally a glow-up for your datagrams.


🌸 SYNOPSIS 🌸

udpdump [ --help ] [ --version ] [ --extcap-interfaces ]
[ --extcap-dlts ] [ --extcap-interface=<interface> ] [ --extcap-config ]
[ --capture ] [ --fifo=<path to file or pipe> ] [ --port=<port> ]
[ --payload=<type> ]

πŸ’– DESCRIPTION πŸ’–

so udpdump is an extcap tool β€” that's the whole vibe πŸ’« β€” and what it does is give you a UDP receiver that listens for exported datagrams coming from literally any source (Aruba routers being the classic example πŸŽ€) and then exports them all pretty in PCAP format.

this gives you two (2) basic functionalities, bestie, and they're both icons:

  • first one πŸ‘‘ β€” you get a listener that prevents the localhost from sending back an ICMP port-unreachable packet. no unwanted clapback. periodt.
  • second one 🧚 β€” it strips out the lower layers (layer 2, IP, UDP) because honestly? they're useless here. they were only ever used as the export vector. we don't need them, we're thriving without them πŸ’…

the format of the exported datagrams is EXPORTED_PDU, exactly as specified in:

https://gitlab.com/wireshark/wireshark/-/raw/master/epan/exported_pdu.h

(yeah that's a real link, go read it if you're feeling academic πŸ“š)


⭐ OPTIONS ⭐

  • --help β€” prints the program arguments. your little cheat sheet πŸ“
  • --version β€” prints the program version. so you know what era of udpdump you're in πŸ•°οΈ
  • --extcap-interfaces β€” lists the available interfaces. window shopping for interfaces, slay πŸ›οΈ
  • --extcap-interface=<interface> β€” uses the interface you specified. pick your fave πŸ’«
  • --extcap-dlts β€” lists the DLTs of the specified interface. yes bestie, DLTs. get into it πŸ”₯
  • --extcap-config β€” lists the configuration options of the specified interface. the settings menu, basically πŸŽ›οΈ
  • --capture β€” starts capturing from the specified interface and saves it in the place specified by --fifo. it's giving main character energy 🎬
  • --fifo=<path to file or pipe> β€” saves the captured packet to a file, or sends it through a pipe. your choice, you're the CEO 🫢
  • --port=<port> β€” sets the listener port. port 5555 is the default, so if you don't say anything, it's 5555. no cap πŸ”’
  • --payload=<type> β€” sets the payload of the exported PDU. default: data πŸ’Ύ

πŸ¦‹ EXAMPLES πŸ¦‹

to see program arguments:

udpdump --help

to see program version:

udpdump --version

to see interfaces:

udpdump --extcap-interfaces

example output πŸ‘‡

interface {value=udpdump}{display=UDP Listener remote capture}

to see interface DLTs:

udpdump --extcap-interface=udpdump --extcap-dlts

example output πŸ‘‡

dlt {number=252}{name=udpdump}{display=Exported PDUs}

to see interface configuration options:

udpdump --extcap-interface=udpdump --extcap-config

example output πŸ‘‡

arg {number=0}{call=--port}{display=Listen port}{type=unsigned}{range=1,65535}{default=5555}{tooltip=The port the receiver listens on}

to capture:

udpdump --extcap-interface=randpkt --fifo=/tmp/randpkt.pcapng --capture
note πŸ“Œ β€” to stop capturing, press CTRL+C / kill / terminate the application. seriously bestie, it will just keep going otherwise πŸ’€

🌈 SEE ALSO 🌈

wireshark(1), tshark(1), dumpcap(1), extcap(4)

(the whole friend group tbh πŸ’œ)


πŸ“ NOTES πŸ“

udpdump is part of the Wireshark distribution. the latest version of Wireshark can be found at https://www.wireshark.org β€” go get the freshest one ✨

HTML versions of the Wireshark project man pages are available at https://www.wireshark.org/docs/man-pages 🌸


πŸ‘‘ AUTHORS πŸ‘‘

Original Author β€” Dario Lombardo <lomato[AT]gmail.com> πŸ’Œ


and that's the whole page, bestie πŸŽ€ written under the UDPDUMP(1) banner, dated 2026-10-08 β€” so go forth, listen on 5555, and eat, no crumbs left πŸ”₯πŸ’…πŸ’–

πŸ“¦ where this page comes from