1UDPDUMP(1)              The Wireshark Network Analyzer              UDPDUMP(1)
2
3
4

NAME

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

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

27       --help
28           Print program arguments.
29
30       --version
31           Print program version.
32
33       --extcap-interfaces
34           List available interfaces.
35
36       --extcap-interface=<interface>
37           Use specified interfaces.
38
39       --extcap-dlts
40           List DLTs of specified interface.
41
42       --extcap-config
43           List configuration options of specified interface.
44
45       --capture
46           Start capturing from specified interface save saved it in place
47           specified by --fifo.
48
49       --fifo=<path to file or pipe>
50           Save captured packet to file or send it through pipe.
51
52       --port=<port>
53           Set the listener port. Port 5555 is the default.
54
55       --payload=<type>
56           Set the payload of the exported PDU. Default: data.
57

EXAMPLES

59       To see program arguments:
60
61           udpdump --help
62
63       To see program version:
64
65           udpdump --version
66
67       To see interfaces:
68
69           udpdump --extcap-interfaces
70
71         Example output:
72           interface {value=udpdump}{display=UDP Listener remote capture}
73
74       To see interface DLTs:
75
76           udpdump --extcap-interface=udpdump --extcap-dlts
77
78         Example output:
79           dlt {number=252}{name=udpdump}{display=Exported PDUs}
80
81       To see interface configuration options:
82
83           udpdump --extcap-interface=udpdump --extcap-config
84
85         Example output:
86           arg {number=0}{call=--port}{display=Listen port}{type=unsigned}{range=1,65535}{default=5555}{tooltip=The port the receiver listens on}
87
88       To capture:
89
90           udpdump --extcap-interface=randpkt --fifo=/tmp/randpkt.pcapng --capture
91
92       NOTE: To stop capturing CTRL+C/kill/terminate application.
93

SEE ALSO

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

NOTES

98       udpdump is part of the Wireshark distribution.  The latest version of
99       Wireshark can be found at <https://www.wireshark.org>.
100
101       HTML versions of the Wireshark project man pages are available at:
102       <https://www.wireshark.org/docs/man-pages>.
103

AUTHORS

105         Original Author
106         ---------------
107         Dario Lombardo             <lomato[AT]gmail.com>
108
109
110
1113.4.4                             2021-03-16                        UDPDUMP(1)
Impressum