blob: 708b14005a74bade593ba6c095889477cb00b9bf (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
From: Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
Subject: man page for pip_stress
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>
---
Makefile | 1 +
src/pi_tests/pip_stress.8 | 25 +++++++++++++++++++++++++
2 files changed, 26 insertions(+)
--- /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>.
--- a/Makefile
+++ b/Makefile
@@ -170,6 +170,7 @@
gzip -c src/backfire/backfire.4 >"$(DESTDIR)$(mandir)/man4/backfire.4.gz"
gzip -c src/cyclictest/cyclictest.8 >"$(DESTDIR)$(mandir)/man8/cyclictest.8.gz"
gzip -c src/pi_tests/pi_stress.8 >"$(DESTDIR)$(mandir)/man8/pi_stress.8.gz"
+ gzip -c src/pi_tests/pip_stress.8 >"$(DESTDIR)$(mandir)/man8/pip_stress.8.gz"
gzip -c src/ptsematest/ptsematest.8 >"$(DESTDIR)$(mandir)/man8/ptsematest.8.gz"
gzip -c src/sigwaittest/sigwaittest.8 >"$(DESTDIR)$(mandir)/man8/sigwaittest.8.gz"
gzip -c src/svsematest/svsematest.8 >"$(DESTDIR)$(mandir)/man8/svsematest.8.gz"
|