SSDD(8)

💖 ssdd(8) — System Manager's Manual 💖

okay bestie, welcome to ssdd, a lil section 8 system manager's manual page. it's giving "let's stress-test the kernel and see what breaks" energy and honestly? iconic. 🦋

also, for the record, the license is right there at the top: SPDX-License-Identifier: GPL-2.0-or-later. periodt.

✨ NAME ✨

ssdd — have a tracer do a bunch of PTRACE_SINGLESTEPs

🌸 SYNOPSIS 🌸

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

💅 DESCRIPTION 💅

so the whole vibe here is: you've got a tracer, and it's gonna hit a tracee with a bunch of PTRACE_SINGLESTEPs, and it's gonna do them as fast as possible. like, no chill. maximum speed. 🏃♀️💨

then — and this is the fun part — you spin up several of these tracer/tracee pairs and just watch to see if they can be made to interfere with each other. messy? maybe. entertaining? absolutely. 😭

the tracer waits on each PTRACE_SINGLESTEP with a waitpid(2), and then it checks that waitpid's return values are correct, because we are thorough in this house. 👑

🎀 OPTIONS 🎀

• -f, --forks=NUM — how many tracer/tracee pairs you wanna fork off. the default is 10.
• -h, --help — display usage. the "what do i even type" button. 🫶
• -i, --iters=NUM — how many PTRACE_SINGLESTEP iterations to do before calling it a success, for each tracer/tracee pair you set up. the default is 10,000. and heads up, NUM must be at least 1 — zero is not the move, bestie. 🙈
• --json=FILENAME — write the final results into FILENAME, JSON formatted. slay, structured data. ✨

👑 AUTHOR 👑

ssdd was written by Joe Korty <joe.korty@concurrent-rt.com> 💜

this manual page was written by John Kacur <jkacur@redhat.com> 💜

lowkey reminder bestie: this is the System Manager's Manual version of ssdd(8), dated September 19, 2020. go forth and single-step responsibly. 💖✨🎀🦋🌸💅🫶