talloc: allow replacement allocator
[ccan] / ccan / failtest / _info
1 #include <stdio.h>
2 #include <string.h>
3 #include "config.h"
4
5 /**
6  * failtest - unit test helpers for testing malloc and other failures.
7  *
8  * The failtest module overrides various standard functions, and forks
9  * your unit test at those points to test failure paths.  The failing
10  * child are expected to fail (eg. when malloc fails), but should not
11  * leak memory or crash.
12  *
13  * The unit test is a normal CCAN tap-style test, except it should
14  * start by calling failtest_init() and end by calling
15  * failtest_exit().  
16  *
17  * You can control what functions fail: see failtest_hook.
18  *
19  * Example:
20  *      #include <stdio.h>
21  *      #include <stdlib.h>
22  *      #include <string.h>
23  *      #include <ccan/tap/tap.h>
24  *      #include <ccan/failtest/failtest_override.h>
25  *      #include <ccan/failtest/failtest.h>
26  *
27  *      int main(int argc, char *argv[])
28  *      {
29  *              void *a, *b;
30  *
31  *              failtest_init(argc, argv);
32  *              plan_tests(3);
33  *
34  *              // Simple malloc test.
35  *              a = malloc(100);
36  *              if (ok1(a)) {
37  *                      // Fill the memory.
38  *                      memset(a, 'x', 100);
39  *                      b = realloc(a, 200);
40  *                      if (ok1(b)) {
41  *                              // Fill the rest of the memory.
42  *                              memset(b + 100, 'y', 100);
43  *                              // Check it got a copy of a as expected.
44  *                              ok1(strspn(b, "x") == 100);
45  *                              free(b);
46  *                      } else {
47  *                              // Easy to miss: free a on realloc failure!
48  *                              free(a);
49  *                      }
50  *              }
51  *              failtest_exit(exit_status());
52  *      }
53  *
54  * License: LGPL
55  * Author: Rusty Russell <rusty@rustcorp.com.au>
56  */
57 int main(int argc, char *argv[])
58 {
59         if (argc != 2)
60                 return 1;
61
62         if (strcmp(argv[1], "depends") == 0) {
63                 printf("ccan/compiler\n");
64                 printf("ccan/read_write_all\n");
65                 return 0;
66         }
67
68         return 1;
69 }