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

NAME

6       randpktdump - Provide an interface to generate random captures using
7       randpkt
8

SYNOPSIS

10       randpktdump [ --help ] [ --version ] [ --extcap-interfaces ]
11       [ --extcap-dlts ] [ --extcap-interface=<interface> ]
12       [ --extcap-config ] [ --capture ] [ --fifo=<path to file or pipe> ]
13       [ --maxbytes=<bytes> ] [ --random-type=<true|false> ]
14       [ --all-random=<true|false> ] [ --type=<packet type> ]
15

DESCRIPTION

17       randpktdump is a extcap tool that provides access to the random packet
18       generator (randpkt). It is mainly used for testing and educational
19       purpose.
20

OPTIONS

22       --help
23           Print program arguments.
24
25       --version
26           Print program version.
27
28       --extcap-interfaces
29           List available interfaces.
30
31       --extcap-interface=<interface>
32           Use specified interfaces.
33
34       --extcap-dlts
35           List DLTs of specified interface.
36
37       --extcap-config
38           List configuration options of specified interface.
39
40       --capture
41           Start capturing from specified interface save saved it in place
42           specified by --fifo.
43
44       --fifo=<path to file or pipe>
45           Save captured packet to file or send it through pipe.
46
47       --maxbytes=<bytes>
48           Set the max number of bytes per packet.
49
50       --random-type
51           Choose a random packet type for all packets if set to true.
52
53       --all-random
54           Choose a different random packet type for each packet if set to
55           true.
56
57       --type=<packet type>
58           Use the selected packet type. To list all the available packet
59           type, run randpktdump --help.
60

EXAMPLES

62       To see program arguments:
63
64           randpktdump --help
65
66       To see program version:
67
68           randpktdump --version
69
70       To see interfaces:
71
72           randpktdump --extcap-interfaces
73
74         Example output:
75           interface {value=randpkt}{display=Random packet generator}
76
77       To see interface DLTs:
78
79           randpktdump --extcap-interface=randpkt --extcap-dlts
80
81         Example output:
82           dlt {number=1}{name=randpkt}{display=Ethernet}
83
84       To see interface configuration options:
85
86           randpktdump --extcap-interface=randpkt --extcap-config
87
88         Example output:
89           arg {number=0}{call=--maxbytes}{display=Max bytes in a packet}{type=unsigned}{range=1,5000}{default=5000}{tooltip=The max number of bytes in a packet}
90           arg {number=1}{call=--count}{display=Number of packets}{type=long}{default=1000}{tooltip=Number of packets to generate (-1 for infinite)}
91           arg {number=2}{call=--random-type}{display=Random type}{type=boolean}{default=false}{tooltip=The packets type is randomly choosen}
92           arg {number=3}{call=--all-random}{display=All random packets}{type=boolean}{default=false}{tooltip=Packet type for each packet is randomly choosen}
93           arg {number=4}{call=--type}{display=Type of packet}{type=selector}{tooltip=Type of packet to generate}
94           value {arg=4}{value=arp}{display=Address Resolution Protocol}
95           [...]
96           value {arg=4}{value=usb-linux}{display=Universal Serial Bus with Linux specific header}
97
98       To capture:
99
100           randpktdump --extcap-interface=randpkt --fifo=/tmp/randpkt.pcapng --capture
101
102       NOTE: To stop capturing CTRL+C/kill/terminate application.
103

SEE ALSO

105       wireshark(1), tshark(1), dumpcap(1), extcap(4), randpkt(1)
106

NOTES

108       randpktdump is part of the Wireshark distribution.  The latest version
109       of Wireshark can be found at <https://www.wireshark.org>.
110
111       HTML versions of the Wireshark project man pages are available at:
112       <https://www.wireshark.org/docs/man-pages>.
113

AUTHORS

115         Original Author
116         ---------------
117         Dario Lombardo             <lomato[AT]gmail.com>
118
119
120
1212.6.2                             2018-07-18                    RANDPKTDUMP(1)
Impressum