rt-tests/SOURCES/rt-tests-ssdd-Add-a-simple-...

66 lines
2.0 KiB
Diff

From e86709cd38349514dddbef0bf2b43c1d459797d3 Mon Sep 17 00:00:00 2001
From: John Kacur <jkacur@redhat.com>
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 <jkacur@redhat.com>
---
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 <joe.korty@concurrent-rt.com>
+.PP
+This manual page was written by John Kacur <jkacur@redhat.com>
+
--
2.20.1