queuelat(8)

queuelat8

Queue latency test program

Usage

queuelat [{-c | --cycles N}] [{-f | --freq F}] [{-h | --help}] [{-m | --max-len LEN}] [{-p | --packets F}] [{-q | --queue-len N}] [{-t | --timeout TIME}]

# SPDX-License-Identifier: GPL-2.0-or-later

Overview

queuelat simulates a network queue checking for latency violations in packet processing.

Options

A summary of options is included below.

-c, --cycles=N

Estimated number of cycles it takes to process one packet. This value should come from the envisioned packet forwarding application being simulated.

-f, --freq=F

TSC frequency in MHz.

-h, --help

Show help

-m, --max-len=N

Maximum allowed latency, in nanoseconds. If latency to process any packet exceeds this value, the program quits, writing a message to the trace buffer.

-p, --packets=F

Million packets per second that arrive for processing.

-q, --queue-len=N

Minimum queue length to print in the trace

-t, --timeout=TIME

Timeout in seconds to quit the program.

Releases

4 releases since Debian 11 (Bullseye); the text changed 2 times.

  1. 11
  2. 12–13
  3. Arch

--cycles since Debian 12 (Bookworm); --freq since Debian 12 (Bookworm); --help since Debian 12 (Bookworm); --max-len since Debian 12 (Bookworm); --packets since Debian 12 (Bookworm); --queue-len since Debian 12 (Bookworm); --timeout since Debian 12 (Bookworm); -q since Debian 12 (Bookworm).

Author

queuelat was written by Marcelo Tosatti <[email protected]>

From rt-tests 2.11-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.