Elements / UDP

FastUDPFlows

creates packets flows with static UDP/IP/Ethernet headers

SYNOPSIS§

FastUDPFlows(RATE, LIMIT, LEN,

 SRCETH, SRCIP,N<>
 DSTETH, DSTIP,N<>
 FLOWS, FLOWSIZE [, CHECKSUM, ACTIVE,N<>
 SEQUENTIAL, DUPLICATE, STOP])

Batching: Batching natively supported
Ports: no inputs, 1 output
Processing: agnostic

DESCRIPTION§

FastUDPFlows is a benchmark tool. At initialization time, FastUDPFlows creates FLOWS number of UDP/IP packets of length LENGTH (min 60), with source ethernet address SRCETH, source IP address SRCIP, destination ethernet address DSTETH, and destination IP address DSTIP. Source and destination ports are randomly generated. The UDP checksum is calculated if CHECKSUM is true; it is true by default. Each time the FastUDPFlows element is called, it selects a flow, increments the reference count on the skbuff created and returns the skbuff object w/o copying or cloning. Therefore, the packet returned by FastUDPFlows should not be modified.

FastUDPFlows sents packets at RATE packets per second. It will send LIMIT number of packets in total. Each flow is limited to FLOWSIZE number of packets. After FLOWSIZE number of packets are sent, the src and dst port will be modified.

After FastUDPFlows has sent LIMIT packets, it will calculate the average send rate (packets per second) between the first and last packets sent and make that available in the rate handler.

By default FastUDPFlows is ACTIVE.

Keyword arguments are:

• SEQUENTIAL. instead of generating random port numbers, generate sequential

  one. Surprisingly this has a huge positive impact on performance.

• DUPLICATE. Duplicate packets instead of doing a shadow clone. If you know

  packets will be modified, you might as well avoid the extra steps.

ELEMENT HANDLERS§

• count (read-only) — Returns the total number of packets that have been generated.
• rate (read/write) — Returns or sets the RATE parameter.
• reset (write) — Reset and restart.
• active (write) — Change ACTIVE

EXAMPLES§

 FastUDPFlows(100000, 500000, 60,
 0:0:0:0:0:0, 1.0.0.1,
 1:1:1:1:1:1, 2.0.0.2,
 100, 10)
 -> ToDevice;

Generated by click-elem2man from ../elements/tcpudp/fastudpflows.hh:12 on 2026/11/02.