carta
ssdd(8)

ssdd8

Have a tracer do a bunch of ptrace_singlesteps

Usage

ssdd [{-f | --forks NUM}] [{-h | --help}] [{-i | --iters NUM}] [--json FILENAME]

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

Overview

Have a tracer do a bunch of PTRACE_SINGLESTEPs against a tracee as fast as possible. Create several of these tracer/tracee pairs and see if they can be made to interfere with each other. The tracer waits on each PTRACE_SINGLESTEP with a waitpid(2) and checks that waitpid's return values for correctness.

Options

-f, --forks=NUM

number of tracer/tracee pairs to fork off.
Default is 10.

-h, --help

Display usage

-i, --iters=NUM

number of PTRACE_SINGLESTEP iterations to do before declaring success, for each tracer tracee pair set up.
Default is 10,000.
NUM must be at least 1

--json=FILENAME

Write final results into FILENAME, JSON formatted.

History

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

--forks since Debian 12 (Bookworm); --help since Debian 12 (Bookworm); --iters since Debian 12 (Bookworm); --json since Debian 12 (Bookworm); -f since Debian 12 (Bookworm); -h since Debian 12 (Bookworm); -i since Debian 12 (Bookworm).

Author

ssdd was written by Joe Korty <[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.