Package: rt-tests / 1.0-3

manpage_pip_stress.patch Patch series | download
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"