1RANDPKTDUMP(1)                                                  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> ] [ --count=<num> ] [ --delay=<ms> ]
14       [ --random-type=<true|false> ] [ --all-random=<true|false> ]
15       [ --type=<packet type> ]
16

DESCRIPTION

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

OPTIONS

23       --help
24
25           Print program arguments.
26
27       --version
28
29           Print program version.
30
31       --extcap-interfaces
32
33           List available interfaces.
34
35       --extcap-interface=<interface>
36
37           Use specified interfaces.
38
39       --extcap-dlts
40
41           List DLTs of specified interface.
42
43       --extcap-config
44
45           List configuration options of specified interface.
46
47       --capture
48
49           Start capturing from specified interface save saved it in place
50           specified by --fifo.
51
52       --fifo=<path to file or pipe>
53
54           Save captured packet to file or send it through pipe.
55
56       --maxbytes=<bytes>
57
58           Set the max number of bytes per packet.
59
60       --count=<num>
61
62           Number of packets to generate (-1 for infinite).
63
64       --delay=<ms>
65
66           Wait a number of milliseconds after writing each packet.
67
68       --random-type
69
70           Choose a random packet type for all packets if set to true.
71
72       --all-random
73
74           Choose a different random packet type for each packet if set to
75           true.
76
77       --type=<packet type>
78
79           Use the selected packet type. To list all the available packet
80           type, run randpktdump --help.
81

EXAMPLES

83       To see program arguments:
84
85           randpktdump --help
86
87       To see program version:
88
89           randpktdump --version
90
91       To see interfaces:
92
93           randpktdump --extcap-interfaces
94
95       Example output
96
97           interface {value=randpkt}{display=Random packet generator}
98
99       To see interface DLTs:
100
101           randpktdump --extcap-interface=randpkt --extcap-dlts
102
103       Example output
104
105           dlt {number=1}{name=randpkt}{display=Ethernet}
106
107       To see interface configuration options:
108
109           randpktdump --extcap-interface=randpkt --extcap-config
110
111       Example output
112
113           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}
114           arg {number=1}{call=--count}{display=Number of packets}{type=long}{default=1000}{tooltip=Number of packets to generate (-1 for infinite)}
115           arg {number=2}{call=--delay}{display=Packet delay (ms)}{type=long}{default=0}{tooltip=Milliseconds to wait after writing each packet}
116           arg {number=3}{call=--random-type}{display=Random type}{type=boolflag}{default=false}{tooltip=The packets type is randomly chosen}
117           arg {number=4}{call=--all-random}{display=All random packets}{type=boolflag}{default=false}{tooltip=Packet type for each packet is randomly chosen}
118           arg {number=5}{call=--type}{display=Type of packet}{type=selector}{tooltip=Type of packet to generate}
119           value {arg=5}{value=arp}{display=Address Resolution Protocol}
120           [...]
121           value {arg=5}{value=usb-linux}{display=Universal Serial Bus with Linux specific header}
122
123       To capture:
124
125           randpktdump --extcap-interface=randpkt --fifo=/tmp/randpkt.pcapng --capture
126
127           Note
128           To stop capturing CTRL+C/kill/terminate the application.
129

SEE ALSO

131       wireshark(1), tshark(1), dumpcap(1), extcap(4), randpkt(1)
132

NOTES

134       randpktdump is part of the Wireshark distribution. The latest version
135       of Wireshark can be found at https://www.wireshark.org.
136
137       HTML versions of the Wireshark project man pages are available at
138       https://www.wireshark.org/docs/man-pages.
139

AUTHORS

141       Original Author
142       Dario Lombardo <lomato[AT]gmail.com>
143
144
145
146                                  2023-08-31                    RANDPKTDUMP(1)
Impressum