summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorUwe Kleine-König <u.kleine-koenig@pengutronix.de>2011-06-27 14:36:58 +0200
committerUwe Kleine-König <u.kleine-koenig@pengutronix.de>2011-06-27 14:36:58 +0200
commit4f5616e043f80d2ec2db242460714497f9c6b0eb (patch)
treefc605f0bac6b82cdd77fdc6a341f34459d2c40bd
parent84376b2a6aecec961b3253770b71e5e539ba0fb0 (diff)
downloadrt-tests-for-clark.tar.gz
rt-tests-for-clark.tar.xz
man page for pip_stressfor-clark
The Debian package checker lintian criticizes that pip_stress doesn't have a man page. So put a short version of the description from the source file into a man page to make lintian happy. Signed-off-by: Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
-rw-r--r--Makefile1
-rw-r--r--src/pi_tests/pip_stress.825
2 files changed, 26 insertions, 0 deletions
diff --git a/Makefile b/Makefile
index 48bef8a..2dd065f 100644
--- a/Makefile
+++ b/Makefile
@@ -122,6 +122,7 @@ install: all
gzip src/backfire/backfire.4 -c >"$(DESTDIR)$(mandir)/man4/backfire.4.gz"
gzip src/cyclictest/cyclictest.8 -c >"$(DESTDIR)$(mandir)/man8/cyclictest.8.gz"
gzip src/pi_tests/pi_stress.8 -c >"$(DESTDIR)$(mandir)/man8/pi_stress.8.gz"
+ gzip src/pi_tests/pip_stress.8 -c >"$(DESTDIR)$(mandir)/man8/pip_stress.8.gz"
gzip src/hwlatdetect/hwlatdetect.8 -c >"$(DESTDIR)$(mandir)/man8/hwlatdetect.8.gz"
gzip src/ptsematest/ptsematest.8 -c >"$(DESTDIR)$(mandir)/man8/ptsematest.8.gz"
gzip src/sigwaittest/sigwaittest.8 -c >"$(DESTDIR)$(mandir)/man8/sigwaittest.8.gz"
diff --git a/src/pi_tests/pip_stress.8 b/src/pi_tests/pip_stress.8
new file mode 100644
index 0000000..b733335
--- /dev/null
+++ b/src/pi_tests/pip_stress.8
@@ -0,0 +1,25 @@
+.TH pip_stress 8 2011-06-24
+.SH NAME
+pip_stress \- test priority inheritance between processes
+.SH SYNOPSIS
+.B pip_stress
+.SH DESCRIPTION
+.B pip_stress
+creates a priority inversion using three processes and a priority inheritance
+mutex shared via shared memory.
+All three processes are bound to run on the same cpu.
+The process with the lowest priority holds a mutex and is prempted by the
+medium priority process that just runs an infinite loop.
+The third process with the highest priority tries to grab the mutex that is
+hold by the low prio process.
+As a priority inheritance mutex is used the low priority process lends the high
+priority process' priority to unlock the mutex and so stops the medium priority
+process blocking the high priority one.
+
+.B pip_stress
+doesn't take any options and quits as soon as the priority inversion is
+resolved which should happen instantly.
+
+.SH AUTHOR
+.B pip_stress
+was written by John Kacur <jkacur@redhat.com>.