Skip to contentSkip to conversation

rt-tests: ssdd: Add a simple manpage for ssdd

PATCH New John Kacur 1 participant 1 message Jun 14, 2019 Kbuild

lore
Share & tools
lore

John Kacur

author
#0 lore raw

PATCH 1/1 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

---
 Makefile        |  1 +
 src/ssdd/ssdd.8 | 29 +++++++++++++++++++++++++++++
 2 files changed, 30 insertions(+)
 create mode 100644 src/ssdd/ssdd.8
Makefile +1 -0
index ea80923918f7..0258fe9b6dfd 100644
@@ -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
src/ssdd/ssdd.8 new file +29 -0
new file mode 100644
index 000000000000..44638489f0d1
@@ -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 <[email protected]>
+.PP
+This manual page was written by John Kacur <[email protected]>
+
Signature · 1 line
2.20.1