From e86709cd38349514dddbef0bf2b43c1d459797d3 Mon Sep 17 00:00:00 2001 From: John Kacur Date: Fri, 14 Jun 2019 15:03:26 +0200 Subject: [PATCH] rt-tests: ssdd: Add a simple manpage for ssdd Add a simple manpage to rt-tests for ssdd, and modify the manpage to install it Signed-off-by: John Kacur --- Makefile | 1 + src/ssdd/ssdd.8 | 29 +++++++++++++++++++++++++++++ 2 files changed, 30 insertions(+) create mode 100644 src/ssdd/ssdd.8 diff --git a/Makefile b/Makefile index ea80923918f7..0258fe9b6dfd 100644 --- a/Makefile +++ b/Makefile @@ -194,6 +194,7 @@ install: all install_hwlatdetect gzip -c src/pi_tests/pip_stress.8 >"$(DESTDIR)$(mandir)/man8/pip_stress.8.gz" gzip -c src/queuelat/queuelat.8 >"$(DESTDIR)$(mandir)/man8/queuelat.8.gz" gzip -c src/sched_deadline/deadline_test.8 >"$(DESTDIR)$(mandir)/man8/deadline_test.8.gz" + gzip -c src/ssdd/ssdd.8 >"$(DESTDIR)$(mandir)/man8/ssdd.8.gz" .PHONY: install_hwlatdetect install_hwlatdetect: hwlatdetect diff --git a/src/ssdd/ssdd.8 b/src/ssdd/ssdd.8 new file mode 100644 index 000000000000..44638489f0d1 --- /dev/null +++ b/src/ssdd/ssdd.8 @@ -0,0 +1,29 @@ +.TH SSDD 8 "June 13, 2019" +.SH NAME +ssdd \- have a tracer do a bunch of PTRACE_SINGLESTEPs +.SH SYNOPSIS +.B ssdd +.RI "[nforks] [niters]" +.SH DESCRIPTION +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. +.SH OPTIONS +.B nforks +number of tracer/tracee pairs to fork off. +Default is 10. +.br +.TP +.B niters +number of PTRACE_SINGLESTEP iterations to +do before declaring success, for each tracer/ +tracee pair set up. Default is 10,000. + +.SH AUTHOR +ssdd was written by Joe Korty +.PP +This manual page was written by John Kacur + -- 2.20.1