carta
cyclicdeadline(8)

cyclicdeadline8

This program is used to test the deadline scheduler (sched_deadline) using a cyclictest style program

Usage

cyclicdeadline [-a [CPUSET]] [-D TIME] [-h] [-i INTV] [--json FILENAME] [-s STEP] [-t NUM] [-q]

# SPDX-License-Identifier: GPL-2.0-only

Overview

cyclicdeadline is a cyclictest style program for testing the deadline scheduler

Options

-a --affinity [CPUSET]

Comma / hypen separated list of CPUs to run deadline tasks on

-D --duration TIME

Specify a length for the test to run Append 'm', 'h', or 'd' to specify minutes, hours, or days

-h --help

Show this help menu

-i --interval INTV

The shortest deadline for the tasks in us. (default 1000us)

--json=FILENAME

Write final results into FILENAME, JSON formatted.

-s --step STEP

The amount to increase the deadline for each task in us. (default 500us)

-t --threads NUM

The number of threads to run as deadline (default 1)

-q, --quiet

Print a summary only on exit. Useful for automated tests, where only the summary output needs to be captured.

-b, --breaktrace=USEC

Send break trace command when latency > USEC

--tracemark

write a trace mark when -b latency is exceeded.

History

  • Arch Linux 2026-11-01: the text shown here
  • Debian 13 (Trixie) to Debian 12 (Bookworm)

Author

cyclicdeadline was written by Steven Rostedt <[email protected]>

This manual page was written by John Kacur <[email protected]>

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