udpdump(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | NOTES | AUTHORS

UDPDUMP(1)                                                     UDPDUMP(1)

NAME         top

       udpdump - Provide a UDP receiver that gets packets from network
       devices (like Aruba routers) and exports them in PCAP format.

SYNOPSIS         top

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

DESCRIPTION         top

       udpdump is a extcap tool that provides a UDP receiver that listens
       for exported datagrams coming from any source (like Aruba routers)
       and exports them in PCAP format. This provides the user two basic
       functionalities: the first one is to have a listener that prevents
       the localhost to send back an ICMP port-unreachable packet. The
       second one is to strip out the lower layers (layer 2, IP, UDP)
       that are useless (are used just as export vector). The format of
       the exported datagrams are EXPORTED_PDU, as specified in
       https://gitlab.com/wireshark/wireshark/-/raw/master/epan/exported_pdu.h

OPTIONS         top

       --help
           Print program arguments.

       --version
           Print program version.

       --extcap-interfaces
           List available interfaces.

       --extcap-interface=<interface>
           Use specified interfaces.

       --extcap-dlts
           List DLTs of specified interface.

       --extcap-config
           List configuration options of specified interface.

       --capture
           Start capturing from specified interface save saved it in
           place specified by --fifo.

       --fifo=<path to file or pipe>
           Save captured packet to file or send it through pipe.

       --port=<port>
           Set the listener port. Port 5555 is the default.

       --payload=<type>
           Set the payload of the exported PDU. Default: data.

EXAMPLES         top

       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 CTRL+C/kill/terminate the application.

SEE ALSO         top

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

NOTES         top

       udpdump is part of the Wireshark distribution. The latest version
       of Wireshark can be found at https://www.wireshark.org.

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

AUTHORS         top

       Original Author
       Dario Lombardo <lomato[AT]gmail.com>.SH COLOPHON This page is part
       of the wireshark (Interactively dump and analyze network traffic)
       project. Information about the project can be found at 
       ⟨https://www.wireshark.org/⟩. If you have a bug report for this
       manual page, see
       ⟨https://gitlab.com/wireshark/wireshark/-/issues⟩. This page was
       obtained from the project's upstream Git repository
       ⟨https://gitlab.com/wireshark/wireshark.git⟩ on 2025-08-11. (At
       that time, the date of the most recent commit that was found in
       the repository was 2025-08-11.) If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       [email protected]

                                2025-03-07                     UDPDUMP(1)