granicus.if.org Git - strace/blob - test/README.md

   1 This directory contains some corner case demo files.  Most of them are
   2 quite old and probably will be of little interest to the casual reader.
   3 For automated tests, see [../tests](../tests) directory.
   4
   5 To run a demo:
   6 * Run make
   7 * Run resulting executable(s) under strace
   8 * Check strace output and/or program's output and exitcode
   9
  10 To add a new demo:
  11 * Add its .c source to this dir
  12 * Add it to "all" and "clean" targets in Makefile
  13 * Add it to .gitignore file
  14
  15 Please spend some time making your demo understandable.
  16 For example, it may print an explanation how it should be used
  17 (which strace options to use, and what to look for in strace output).
  18
  19 If possible, make it so that your demo detects error/bug
  20 it is intended to demonstrate, and prints error message and exits with 1
  21 if the bug is detected, instead of relying on user to peruse strace output.