summaryrefslogtreecommitdiff
path: root/test/README
diff options
context:
space:
mode:
authorDenys Vlasenko <dvlasenk@redhat.com>2011-06-08 14:08:59 +0200
committerDenys Vlasenko <dvlasenk@redhat.com>2011-06-08 14:08:59 +0200
commit8158e7716c330d21f116ea6c6479f3d559c63f38 (patch)
tree6b0e739bf5725be0ed0ce2b76661f44872230f4f /test/README
parentb63256e69bf3f1a74aadb0e14556490bc8f4ef95 (diff)
downloadstrace-8158e7716c330d21f116ea6c6479f3d559c63f38.tar.gz
Update test/* directory, it seem to be a bit bit-rotted
Added README; modified sigkill_rain.c to be more understandable, made clone.c compile; added wait_must_be_interruptible.c test; updated Makefile and .gitignore. Signed-off-by: Denys Vlasenko <dvlasenk@redhat.com>
Diffstat (limited to 'test/README')
-rw-r--r--test/README17
1 files changed, 17 insertions, 0 deletions
diff --git a/test/README b/test/README
new file mode 100644
index 000000000..7fae09b6f
--- /dev/null
+++ b/test/README
@@ -0,0 +1,17 @@
+To run a test:
+* Run make
+* Run resulting executable(s) under strace
+* Check strace output and/or program's output and exitcode
+
+To add a new test:
+* Add its .c source to this dir
+* Add it to "all" and "clean" targets in Makefile
+* Add it to .gitignore file
+
+Please spend some time making your testcase understandable.
+For example, it may print an explanation how it should be used
+(which strace options to use, and what to look for in strace output).
+
+If possible, make it so that your testcase detects error/bug
+it is intended to test for, and prints error message and exits with 1
+if the bug is detected, instead of relying on user to peruse strace output.