macros_test.c revision 275988
1/* Copyright (c) 2008 The NetBSD Foundation, Inc.
2 * All rights reserved.
3 *
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
6 * are met:
7 * 1. Redistributions of source code must retain the above copyright
8 *    notice, this list of conditions and the following disclaimer.
9 * 2. Redistributions in binary form must reproduce the above copyright
10 *    notice, this list of conditions and the following disclaimer in the
11 *    documentation and/or other materials provided with the distribution.
12 *
13 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND
14 * CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
15 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
16 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
17 * IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY
18 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
20 * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
21 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
22 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
23 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
24 * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.  */
25
26#include "atf-c/macros.h"
27
28#include <sys/types.h>
29#include <sys/wait.h>
30
31#include <errno.h>
32#include <fcntl.h>
33#include <stdarg.h>
34#include <stdbool.h>
35#include <stdio.h>
36#include <stdlib.h>
37#include <string.h>
38#include <unistd.h>
39
40#include <atf-c.h>
41
42#include "atf-c/detail/fs.h"
43#include "atf-c/detail/process.h"
44#include "atf-c/detail/test_helpers.h"
45#include "atf-c/detail/text.h"
46
47/* ---------------------------------------------------------------------
48 * Auxiliary functions.
49 * --------------------------------------------------------------------- */
50
51static
52void
53create_ctl_file(const char *name)
54{
55    atf_fs_path_t p;
56
57    RE(atf_fs_path_init_fmt(&p, "%s", name));
58    ATF_REQUIRE(open(atf_fs_path_cstring(&p),
59                   O_CREAT | O_WRONLY | O_TRUNC, 0644) != -1);
60    atf_fs_path_fini(&p);
61}
62
63static
64bool
65exists(const char *p)
66{
67    bool b;
68    atf_fs_path_t pp;
69
70    RE(atf_fs_path_init_fmt(&pp, "%s", p));
71    RE(atf_fs_exists(&pp, &b));
72    atf_fs_path_fini(&pp);
73
74    return b;
75}
76
77static
78void
79init_and_run_h_tc(const char *name, void (*head)(atf_tc_t *),
80                  void (*body)(const atf_tc_t *))
81{
82    atf_tc_t tc;
83    const char *const config[] = { NULL };
84
85    RE(atf_tc_init(&tc, name, head, body, NULL, config));
86    run_h_tc(&tc, "output", "error", "result");
87    atf_tc_fini(&tc);
88}
89
90/* ---------------------------------------------------------------------
91 * Helper test cases.
92 * --------------------------------------------------------------------- */
93
94#define H_DEF(id, macro) \
95    ATF_TC_HEAD(h_ ## id, tc) \
96    { \
97        atf_tc_set_md_var(tc, "descr", "Helper test case"); \
98    } \
99    ATF_TC_BODY(h_ ## id, tc) \
100    { \
101        create_ctl_file("before"); \
102        macro; \
103        create_ctl_file("after"); \
104    }
105
106#define H_CHECK_HEAD_NAME(id) ATF_TC_HEAD_NAME(h_check_ ## id)
107#define H_CHECK_BODY_NAME(id) ATF_TC_BODY_NAME(h_check_ ## id)
108#define H_CHECK(id, condition) \
109    H_DEF(check_ ## id, ATF_CHECK(condition))
110
111#define H_CHECK_MSG_HEAD_NAME(id) ATF_TC_HEAD_NAME(h_check_msg_ ## id)
112#define H_CHECK_MSG_BODY_NAME(id) ATF_TC_BODY_NAME(h_check_msg_ ## id)
113#define H_CHECK_MSG(id, condition, msg) \
114    H_DEF(check_msg_ ## id, ATF_CHECK_MSG(condition, msg))
115
116#define H_CHECK_EQ_HEAD_NAME(id) ATF_TC_HEAD_NAME(h_check_eq_ ## id)
117#define H_CHECK_EQ_BODY_NAME(id) ATF_TC_BODY_NAME(h_check_eq_ ## id)
118#define H_CHECK_EQ(id, v1, v2) \
119    H_DEF(check_eq_ ## id, ATF_CHECK_EQ(v1, v2))
120
121#define H_CHECK_STREQ_HEAD_NAME(id) ATF_TC_HEAD_NAME(h_check_streq_ ## id)
122#define H_CHECK_STREQ_BODY_NAME(id) ATF_TC_BODY_NAME(h_check_streq_ ## id)
123#define H_CHECK_STREQ(id, v1, v2) \
124    H_DEF(check_streq_ ## id, ATF_CHECK_STREQ(v1, v2))
125
126#define H_CHECK_MATCH_HEAD_NAME(id) ATF_TC_HEAD_NAME(h_check_match_ ## id)
127#define H_CHECK_MATCH_BODY_NAME(id) ATF_TC_BODY_NAME(h_check_match_ ## id)
128#define H_CHECK_MATCH(id, v1, v2) \
129    H_DEF(check_match_ ## id, ATF_CHECK_MATCH(v1, v2))
130
131#define H_CHECK_EQ_MSG_HEAD_NAME(id) \
132    ATF_TC_HEAD_NAME(h_check_eq_msg_ ## id)
133#define H_CHECK_EQ_MSG_BODY_NAME(id) \
134    ATF_TC_BODY_NAME(h_check_eq_msg_ ## id)
135#define H_CHECK_EQ_MSG(id, v1, v2, msg) \
136    H_DEF(check_eq_msg_ ## id, ATF_CHECK_EQ_MSG(v1, v2, msg))
137
138#define H_CHECK_STREQ_MSG_HEAD_NAME(id) \
139    ATF_TC_HEAD_NAME(h_check_streq_msg_ ## id)
140#define H_CHECK_STREQ_MSG_BODY_NAME(id) \
141    ATF_TC_BODY_NAME(h_check_streq_msg_ ## id)
142#define H_CHECK_STREQ_MSG(id, v1, v2, msg) \
143    H_DEF(check_streq_msg_ ## id, ATF_CHECK_STREQ_MSG(v1, v2, msg))
144
145#define H_CHECK_MATCH_MSG_HEAD_NAME(id) \
146    ATF_TC_HEAD_NAME(h_check_match_msg_ ## id)
147#define H_CHECK_MATCH_MSG_BODY_NAME(id) \
148    ATF_TC_BODY_NAME(h_check_match_msg_ ## id)
149#define H_CHECK_MATCH_MSG(id, v1, v2, msg) \
150    H_DEF(check_match_msg_ ## id, ATF_CHECK_MATCH_MSG(v1, v2, msg))
151
152#define H_CHECK_ERRNO_HEAD_NAME(id) ATF_TC_HEAD_NAME(h_check_errno_ ## id)
153#define H_CHECK_ERRNO_BODY_NAME(id) ATF_TC_BODY_NAME(h_check_errno_ ## id)
154#define H_CHECK_ERRNO(id, exp_errno, bool_expr) \
155    H_DEF(check_errno_ ## id, ATF_CHECK_ERRNO(exp_errno, bool_expr))
156
157#define H_REQUIRE_HEAD_NAME(id) ATF_TC_HEAD_NAME(h_require_ ## id)
158#define H_REQUIRE_BODY_NAME(id) ATF_TC_BODY_NAME(h_require_ ## id)
159#define H_REQUIRE(id, condition) \
160    H_DEF(require_ ## id, ATF_REQUIRE(condition))
161
162#define H_REQUIRE_MSG_HEAD_NAME(id) ATF_TC_HEAD_NAME(h_require_msg_ ## id)
163#define H_REQUIRE_MSG_BODY_NAME(id) ATF_TC_BODY_NAME(h_require_msg_ ## id)
164#define H_REQUIRE_MSG(id, condition, msg) \
165    H_DEF(require_msg_ ## id, ATF_REQUIRE_MSG(condition, msg))
166
167#define H_REQUIRE_EQ_HEAD_NAME(id) ATF_TC_HEAD_NAME(h_require_eq_ ## id)
168#define H_REQUIRE_EQ_BODY_NAME(id) ATF_TC_BODY_NAME(h_require_eq_ ## id)
169#define H_REQUIRE_EQ(id, v1, v2) \
170    H_DEF(require_eq_ ## id, ATF_REQUIRE_EQ(v1, v2))
171
172#define H_REQUIRE_STREQ_HEAD_NAME(id) ATF_TC_HEAD_NAME(h_require_streq_ ## id)
173#define H_REQUIRE_STREQ_BODY_NAME(id) ATF_TC_BODY_NAME(h_require_streq_ ## id)
174#define H_REQUIRE_STREQ(id, v1, v2) \
175    H_DEF(require_streq_ ## id, ATF_REQUIRE_STREQ(v1, v2))
176
177#define H_REQUIRE_MATCH_HEAD_NAME(id) ATF_TC_HEAD_NAME(h_require_match_ ## id)
178#define H_REQUIRE_MATCH_BODY_NAME(id) ATF_TC_BODY_NAME(h_require_match_ ## id)
179#define H_REQUIRE_MATCH(id, v1, v2) \
180    H_DEF(require_match_ ## id, ATF_REQUIRE_MATCH(v1, v2))
181
182#define H_REQUIRE_EQ_MSG_HEAD_NAME(id) \
183    ATF_TC_HEAD_NAME(h_require_eq_msg_ ## id)
184#define H_REQUIRE_EQ_MSG_BODY_NAME(id) \
185    ATF_TC_BODY_NAME(h_require_eq_msg_ ## id)
186#define H_REQUIRE_EQ_MSG(id, v1, v2, msg) \
187    H_DEF(require_eq_msg_ ## id, ATF_REQUIRE_EQ_MSG(v1, v2, msg))
188
189#define H_REQUIRE_STREQ_MSG_HEAD_NAME(id) \
190    ATF_TC_HEAD_NAME(h_require_streq_msg_ ## id)
191#define H_REQUIRE_STREQ_MSG_BODY_NAME(id) \
192    ATF_TC_BODY_NAME(h_require_streq_msg_ ## id)
193#define H_REQUIRE_STREQ_MSG(id, v1, v2, msg) \
194    H_DEF(require_streq_msg_ ## id, ATF_REQUIRE_STREQ_MSG(v1, v2, msg))
195
196#define H_REQUIRE_MATCH_MSG_HEAD_NAME(id) \
197    ATF_TC_HEAD_NAME(h_require_match_msg_ ## id)
198#define H_REQUIRE_MATCH_MSG_BODY_NAME(id) \
199    ATF_TC_BODY_NAME(h_require_match_msg_ ## id)
200#define H_REQUIRE_MATCH_MSG(id, v1, v2, msg) \
201    H_DEF(require_match_msg_ ## id, ATF_REQUIRE_MATCH_MSG(v1, v2, msg))
202
203#define H_REQUIRE_ERRNO_HEAD_NAME(id) ATF_TC_HEAD_NAME(h_require_errno_ ## id)
204#define H_REQUIRE_ERRNO_BODY_NAME(id) ATF_TC_BODY_NAME(h_require_errno_ ## id)
205#define H_REQUIRE_ERRNO(id, exp_errno, bool_expr) \
206    H_DEF(require_errno_ ## id, ATF_REQUIRE_ERRNO(exp_errno, bool_expr))
207
208/* ---------------------------------------------------------------------
209 * Test cases for the ATF_{CHECK,REQUIRE}_ERRNO macros.
210 * --------------------------------------------------------------------- */
211
212static int
213errno_fail_stub(const int raised_errno)
214{
215    errno = raised_errno;
216    return -1;
217}
218
219static int
220errno_ok_stub(void)
221{
222    return 0;
223}
224
225H_CHECK_ERRNO(no_error, -1, errno_ok_stub() == -1);
226H_CHECK_ERRNO(errno_ok, 2, errno_fail_stub(2) == -1);
227H_CHECK_ERRNO(errno_fail, 3, errno_fail_stub(4) == -1);
228
229H_REQUIRE_ERRNO(no_error, -1, errno_ok_stub() == -1);
230H_REQUIRE_ERRNO(errno_ok, 2, errno_fail_stub(2) == -1);
231H_REQUIRE_ERRNO(errno_fail, 3, errno_fail_stub(4) == -1);
232
233ATF_TC(check_errno);
234ATF_TC_HEAD(check_errno, tc)
235{
236    atf_tc_set_md_var(tc, "descr", "Tests the ATF_CHECK_ERRNO macro");
237}
238ATF_TC_BODY(check_errno, tc)
239{
240    struct test {
241        void (*head)(atf_tc_t *);
242        void (*body)(const atf_tc_t *);
243        bool ok;
244        const char *exp_regex;
245    } *t, tests[] = {
246        { H_CHECK_ERRNO_HEAD_NAME(no_error),
247          H_CHECK_ERRNO_BODY_NAME(no_error),
248          false, "Expected true value in errno_ok_stub\\(\\) == -1" },
249        { H_CHECK_ERRNO_HEAD_NAME(errno_ok),
250          H_CHECK_ERRNO_BODY_NAME(errno_ok),
251          true, NULL },
252        { H_CHECK_ERRNO_HEAD_NAME(errno_fail),
253          H_CHECK_ERRNO_BODY_NAME(errno_fail),
254          false, "Expected errno 3, got 4, in errno_fail_stub\\(4\\) == -1" },
255        { NULL, NULL, false, NULL }
256    };
257
258    for (t = &tests[0]; t->head != NULL; t++) {
259        init_and_run_h_tc("h_check_errno", t->head, t->body);
260
261        ATF_REQUIRE(exists("before"));
262        ATF_REQUIRE(exists("after"));
263
264        if (t->ok) {
265            ATF_REQUIRE(atf_utils_grep_file("^passed", "result"));
266        } else {
267            ATF_REQUIRE(atf_utils_grep_file("^failed", "result"));
268            ATF_REQUIRE(atf_utils_grep_file(
269                "macros_test.c:[0-9]+: %s$", "error", t->exp_regex));
270        }
271
272        ATF_REQUIRE(unlink("before") != -1);
273        ATF_REQUIRE(unlink("after") != -1);
274    }
275}
276
277ATF_TC(require_errno);
278ATF_TC_HEAD(require_errno, tc)
279{
280    atf_tc_set_md_var(tc, "descr", "Tests the ATF_REQUIRE_ERRNO macro");
281}
282ATF_TC_BODY(require_errno, tc)
283{
284    struct test {
285        void (*head)(atf_tc_t *);
286        void (*body)(const atf_tc_t *);
287        bool ok;
288        const char *exp_regex;
289    } *t, tests[] = {
290        { H_REQUIRE_ERRNO_HEAD_NAME(no_error),
291          H_REQUIRE_ERRNO_BODY_NAME(no_error),
292          false, "Expected true value in errno_ok_stub\\(\\) == -1" },
293        { H_REQUIRE_ERRNO_HEAD_NAME(errno_ok),
294          H_REQUIRE_ERRNO_BODY_NAME(errno_ok),
295          true, NULL },
296        { H_REQUIRE_ERRNO_HEAD_NAME(errno_fail),
297          H_REQUIRE_ERRNO_BODY_NAME(errno_fail),
298          false, "Expected errno 3, got 4, in errno_fail_stub\\(4\\) == -1" },
299        { NULL, NULL, false, NULL }
300    };
301
302    for (t = &tests[0]; t->head != NULL; t++) {
303        init_and_run_h_tc("h_require_errno", t->head, t->body);
304
305        ATF_REQUIRE(exists("before"));
306        if (t->ok) {
307            ATF_REQUIRE(atf_utils_grep_file("^passed", "result"));
308            ATF_REQUIRE(exists("after"));
309        } else {
310            ATF_REQUIRE(atf_utils_grep_file(
311                "^failed: .*macros_test.c:[0-9]+: %s$", "result",
312                t->exp_regex));
313            ATF_REQUIRE(!exists("after"));
314        }
315
316        ATF_REQUIRE(unlink("before") != -1);
317        if (t->ok)
318            ATF_REQUIRE(unlink("after") != -1);
319    }
320}
321
322/* ---------------------------------------------------------------------
323 * Test cases for the ATF_CHECK and ATF_CHECK_MSG macros.
324 * --------------------------------------------------------------------- */
325
326H_CHECK(0, 0);
327H_CHECK(1, 1);
328H_CHECK_MSG(0, 0, "expected a false value");
329H_CHECK_MSG(1, 1, "expected a true value");
330
331ATF_TC(check);
332ATF_TC_HEAD(check, tc)
333{
334    atf_tc_set_md_var(tc, "descr", "Tests the ATF_CHECK and "
335                      "ATF_CHECK_MSG macros");
336}
337ATF_TC_BODY(check, tc)
338{
339    struct test {
340        void (*head)(atf_tc_t *);
341        void (*body)(const atf_tc_t *);
342        bool value;
343        const char *msg;
344        bool ok;
345    } *t, tests[] = {
346        { H_CHECK_HEAD_NAME(0), H_CHECK_BODY_NAME(0), 0,
347          "0 not met", false },
348        { H_CHECK_HEAD_NAME(1), H_CHECK_BODY_NAME(1), 1,
349          "1 not met", true },
350        { H_CHECK_MSG_HEAD_NAME(0), H_CHECK_MSG_BODY_NAME(0), 0,
351          "expected a false value", false },
352        { H_CHECK_MSG_HEAD_NAME(1), H_CHECK_MSG_BODY_NAME(1), 1,
353          "expected a true value", true },
354        { NULL, NULL, false, NULL, false }
355    };
356
357    for (t = &tests[0]; t->head != NULL; t++) {
358        printf("Checking with a %d value\n", t->value);
359
360        init_and_run_h_tc("h_check", t->head, t->body);
361
362        ATF_REQUIRE(exists("before"));
363        ATF_REQUIRE(exists("after"));
364
365        if (t->ok) {
366            ATF_REQUIRE(atf_utils_grep_file("^passed", "result"));
367        } else {
368            ATF_REQUIRE(atf_utils_grep_file("^failed", "result"));
369            ATF_REQUIRE(atf_utils_grep_file("Check failed: .*"
370                "macros_test.c:[0-9]+: %s$", "error", t->msg));
371        }
372
373        ATF_REQUIRE(unlink("before") != -1);
374        ATF_REQUIRE(unlink("after") != -1);
375    }
376}
377
378/* ---------------------------------------------------------------------
379 * Test cases for the ATF_CHECK_*EQ_ macros.
380 * --------------------------------------------------------------------- */
381
382struct check_eq_test {
383    void (*head)(atf_tc_t *);
384    void (*body)(const atf_tc_t *);
385    const char *v1;
386    const char *v2;
387    const char *msg;
388    bool ok;
389};
390
391static
392void
393do_check_eq_tests(const struct check_eq_test *tests)
394{
395    const struct check_eq_test *t;
396
397    for (t = &tests[0]; t->head != NULL; t++) {
398        printf("Checking with %s, %s and expecting %s\n", t->v1, t->v2,
399               t->ok ? "true" : "false");
400
401        init_and_run_h_tc("h_check", t->head, t->body);
402
403        ATF_CHECK(exists("before"));
404        ATF_CHECK(exists("after"));
405
406        if (t->ok) {
407            ATF_REQUIRE(atf_utils_grep_file("^passed", "result"));
408        } else {
409            ATF_REQUIRE(atf_utils_grep_file("^failed", "result"));
410            ATF_CHECK(atf_utils_grep_file("Check failed: .*"
411                "macros_test.c:[0-9]+: %s$", "error", t->msg));
412        }
413
414        ATF_CHECK(unlink("before") != -1);
415        ATF_CHECK(unlink("after") != -1);
416    }
417}
418
419H_CHECK_EQ(1_1, 1, 1);
420H_CHECK_EQ(1_2, 1, 2);
421H_CHECK_EQ(2_1, 2, 1);
422H_CHECK_EQ(2_2, 2, 2);
423H_CHECK_EQ_MSG(1_1, 1, 1, "1 does not match 1");
424H_CHECK_EQ_MSG(1_2, 1, 2, "1 does not match 2");
425H_CHECK_EQ_MSG(2_1, 2, 1, "2 does not match 1");
426H_CHECK_EQ_MSG(2_2, 2, 2, "2 does not match 2");
427
428ATF_TC(check_eq);
429ATF_TC_HEAD(check_eq, tc)
430{
431    atf_tc_set_md_var(tc, "descr", "Tests the ATF_CHECK_EQ and "
432                      "ATF_CHECK_EQ_MSG macros");
433}
434ATF_TC_BODY(check_eq, tc)
435{
436    struct check_eq_test tests[] = {
437        { H_CHECK_EQ_HEAD_NAME(1_1), H_CHECK_EQ_BODY_NAME(1_1),
438          "1", "1", "1 != 1", true },
439        { H_CHECK_EQ_HEAD_NAME(1_2), H_CHECK_EQ_BODY_NAME(1_2),
440          "1", "2", "1 != 2", false },
441        { H_CHECK_EQ_HEAD_NAME(2_1), H_CHECK_EQ_BODY_NAME(2_1),
442          "2", "1", "2 != 1", false },
443        { H_CHECK_EQ_HEAD_NAME(2_2), H_CHECK_EQ_BODY_NAME(2_2),
444          "2", "2", "2 != 2", true },
445        { H_CHECK_EQ_MSG_HEAD_NAME(1_1), H_CHECK_EQ_MSG_BODY_NAME(1_1),
446          "1", "1", "1 != 1: 1 does not match 1", true },
447        { H_CHECK_EQ_MSG_HEAD_NAME(1_2), H_CHECK_EQ_MSG_BODY_NAME(1_2),
448          "1", "2", "1 != 2: 1 does not match 2", false },
449        { H_CHECK_EQ_MSG_HEAD_NAME(2_1), H_CHECK_EQ_MSG_BODY_NAME(2_1),
450          "2", "1", "2 != 1: 2 does not match 1", false },
451        { H_CHECK_EQ_MSG_HEAD_NAME(2_2), H_CHECK_EQ_MSG_BODY_NAME(2_2),
452          "2", "2", "2 != 2: 2 does not match 2", true },
453        { NULL, NULL, 0, 0, "", false }
454    };
455    do_check_eq_tests(tests);
456}
457
458H_CHECK_STREQ(1_1, "1", "1");
459H_CHECK_STREQ(1_2, "1", "2");
460H_CHECK_STREQ(2_1, "2", "1");
461H_CHECK_STREQ(2_2, "2", "2");
462H_CHECK_STREQ_MSG(1_1, "1", "1", "1 does not match 1");
463H_CHECK_STREQ_MSG(1_2, "1", "2", "1 does not match 2");
464H_CHECK_STREQ_MSG(2_1, "2", "1", "2 does not match 1");
465H_CHECK_STREQ_MSG(2_2, "2", "2", "2 does not match 2");
466#define CHECK_STREQ_VAR1 "5"
467#define CHECK_STREQ_VAR2 "9"
468const char *check_streq_var1 = CHECK_STREQ_VAR1;
469const char *check_streq_var2 = CHECK_STREQ_VAR2;
470H_CHECK_STREQ(vars, check_streq_var1, check_streq_var2);
471
472ATF_TC(check_streq);
473ATF_TC_HEAD(check_streq, tc)
474{
475    atf_tc_set_md_var(tc, "descr", "Tests the ATF_CHECK_STREQ and "
476                      "ATF_CHECK_STREQ_MSG macros");
477}
478ATF_TC_BODY(check_streq, tc)
479{
480    struct check_eq_test tests[] = {
481        { H_CHECK_STREQ_HEAD_NAME(1_1), H_CHECK_STREQ_BODY_NAME(1_1),
482          "1", "1", "\"1\" != \"1\" \\(1 != 1\\)", true },
483        { H_CHECK_STREQ_HEAD_NAME(1_2), H_CHECK_STREQ_BODY_NAME(1_2),
484          "1", "2", "\"1\" != \"2\" \\(1 != 2\\)", false },
485        { H_CHECK_STREQ_HEAD_NAME(2_1), H_CHECK_STREQ_BODY_NAME(2_1),
486          "2", "1", "\"2\" != \"1\" \\(2 != 1\\)", false },
487        { H_CHECK_STREQ_HEAD_NAME(2_2), H_CHECK_STREQ_BODY_NAME(2_2),
488          "2", "2", "\"2\" != \"2\" \\(2 != 2\\)", true },
489        { H_CHECK_STREQ_MSG_HEAD_NAME(1_1),
490          H_CHECK_STREQ_MSG_BODY_NAME(1_1),
491          "1", "1", "\"1\" != \"1\" \\(1 != 1\\): 1 does not match 1", true },
492        { H_CHECK_STREQ_MSG_HEAD_NAME(1_2),
493          H_CHECK_STREQ_MSG_BODY_NAME(1_2),
494          "1", "2", "\"1\" != \"2\" \\(1 != 2\\): 1 does not match 2", false },
495        { H_CHECK_STREQ_MSG_HEAD_NAME(2_1),
496          H_CHECK_STREQ_MSG_BODY_NAME(2_1),
497          "2", "1", "\"2\" != \"1\" \\(2 != 1\\): 2 does not match 1", false },
498        { H_CHECK_STREQ_MSG_HEAD_NAME(2_2),
499          H_CHECK_STREQ_MSG_BODY_NAME(2_2),
500          "2", "2", "\"2\" != \"2\" \\(2 != 2\\): 2 does not match 2", true },
501        { H_CHECK_STREQ_HEAD_NAME(vars), H_CHECK_STREQ_BODY_NAME(vars),
502          check_streq_var1, check_streq_var2,
503          "check_streq_var1 != check_streq_var2 \\("
504          CHECK_STREQ_VAR1 " != " CHECK_STREQ_VAR2 "\\)", false },
505        { NULL, NULL, 0, 0, "", false }
506    };
507    do_check_eq_tests(tests);
508}
509
510/* ---------------------------------------------------------------------
511 * Test cases for the ATF_CHECK_MATCH and ATF_CHECK_MATCH_MSG macros.
512 * --------------------------------------------------------------------- */
513
514H_CHECK_MATCH(yes, "hello [a-z]+", "abc hello world");
515H_CHECK_MATCH(no, "hello [a-z]+", "abc hello WORLD");
516H_CHECK_MATCH_MSG(yes, "hello [a-z]+", "abc hello world", "lowercase");
517H_CHECK_MATCH_MSG(no, "hello [a-z]+", "abc hello WORLD", "uppercase");
518
519ATF_TC(check_match);
520ATF_TC_HEAD(check_match, tc)
521{
522    atf_tc_set_md_var(tc, "descr", "Tests the ATF_CHECK_MATCH and "
523                      "ATF_CHECK_MATCH_MSG macros");
524}
525ATF_TC_BODY(check_match, tc)
526{
527    struct check_eq_test tests[] = {
528        { H_CHECK_MATCH_HEAD_NAME(yes), H_CHECK_MATCH_BODY_NAME(yes),
529          "hello [a-z]+", "abc hello world", "", true },
530        { H_CHECK_MATCH_HEAD_NAME(no), H_CHECK_MATCH_BODY_NAME(no),
531          "hello [a-z]+", "abc hello WORLD",
532          "'hello \\[a-z\\]\\+' not matched in 'abc hello WORLD'", false },
533        { H_CHECK_MATCH_MSG_HEAD_NAME(yes), H_CHECK_MATCH_MSG_BODY_NAME(yes),
534          "hello [a-z]+", "abc hello world", "", true },
535        { H_CHECK_MATCH_MSG_HEAD_NAME(no), H_CHECK_MATCH_MSG_BODY_NAME(no),
536          "hello [a-z]+", "abc hello WORLD",
537          "'hello \\[a-z\\]\\+' not matched in 'abc hello WORLD': uppercase",
538          false },
539        { NULL, NULL, 0, 0, "", false }
540    };
541    do_check_eq_tests(tests);
542}
543
544/* ---------------------------------------------------------------------
545 * Test cases for the ATF_REQUIRE and ATF_REQUIRE_MSG macros.
546 * --------------------------------------------------------------------- */
547
548H_REQUIRE(0, 0);
549H_REQUIRE(1, 1);
550H_REQUIRE_MSG(0, 0, "expected a false value");
551H_REQUIRE_MSG(1, 1, "expected a true value");
552
553ATF_TC(require);
554ATF_TC_HEAD(require, tc)
555{
556    atf_tc_set_md_var(tc, "descr", "Tests the ATF_REQUIRE and "
557                      "ATF_REQUIRE_MSG macros");
558}
559ATF_TC_BODY(require, tc)
560{
561    struct test {
562        void (*head)(atf_tc_t *);
563        void (*body)(const atf_tc_t *);
564        bool value;
565        const char *msg;
566        bool ok;
567    } *t, tests[] = {
568        { H_REQUIRE_HEAD_NAME(0), H_REQUIRE_BODY_NAME(0), 0,
569          "0 not met", false },
570        { H_REQUIRE_HEAD_NAME(1), H_REQUIRE_BODY_NAME(1), 1,
571          "1 not met", true },
572        { H_REQUIRE_MSG_HEAD_NAME(0), H_REQUIRE_MSG_BODY_NAME(0), 0,
573          "expected a false value", false },
574        { H_REQUIRE_MSG_HEAD_NAME(1), H_REQUIRE_MSG_BODY_NAME(1), 1,
575          "expected a true value", true },
576        { NULL, NULL, false, NULL, false }
577    };
578
579    for (t = &tests[0]; t->head != NULL; t++) {
580        printf("Checking with a %d value\n", t->value);
581
582        init_and_run_h_tc("h_require", t->head, t->body);
583
584        ATF_REQUIRE(exists("before"));
585        if (t->ok) {
586            ATF_REQUIRE(atf_utils_grep_file("^passed", "result"));
587            ATF_REQUIRE(exists("after"));
588        } else {
589            ATF_REQUIRE(atf_utils_grep_file(
590                "^failed: .*macros_test.c:[0-9]+: %s$", "result", t->msg));
591            ATF_REQUIRE(!exists("after"));
592        }
593
594        ATF_REQUIRE(unlink("before") != -1);
595        if (t->ok)
596            ATF_REQUIRE(unlink("after") != -1);
597    }
598}
599
600/* ---------------------------------------------------------------------
601 * Test cases for the ATF_REQUIRE_*EQ_ macros.
602 * --------------------------------------------------------------------- */
603
604struct require_eq_test {
605    void (*head)(atf_tc_t *);
606    void (*body)(const atf_tc_t *);
607    const char *v1;
608    const char *v2;
609    const char *msg;
610    bool ok;
611};
612
613static
614void
615do_require_eq_tests(const struct require_eq_test *tests)
616{
617    const struct require_eq_test *t;
618
619    for (t = &tests[0]; t->head != NULL; t++) {
620        printf("Checking with %s, %s and expecting %s\n", t->v1, t->v2,
621               t->ok ? "true" : "false");
622
623        init_and_run_h_tc("h_require", t->head, t->body);
624
625        ATF_REQUIRE(exists("before"));
626        if (t->ok) {
627            ATF_REQUIRE(atf_utils_grep_file("^passed", "result"));
628            ATF_REQUIRE(exists("after"));
629        } else {
630            ATF_REQUIRE(atf_utils_grep_file("^failed: .*macros_test.c"
631                ":[0-9]+: %s$", "result", t->msg));
632            ATF_REQUIRE(!exists("after"));
633        }
634
635        ATF_REQUIRE(unlink("before") != -1);
636        if (t->ok)
637            ATF_REQUIRE(unlink("after") != -1);
638    }
639}
640
641H_REQUIRE_EQ(1_1, 1, 1);
642H_REQUIRE_EQ(1_2, 1, 2);
643H_REQUIRE_EQ(2_1, 2, 1);
644H_REQUIRE_EQ(2_2, 2, 2);
645H_REQUIRE_EQ_MSG(1_1, 1, 1, "1 does not match 1");
646H_REQUIRE_EQ_MSG(1_2, 1, 2, "1 does not match 2");
647H_REQUIRE_EQ_MSG(2_1, 2, 1, "2 does not match 1");
648H_REQUIRE_EQ_MSG(2_2, 2, 2, "2 does not match 2");
649
650ATF_TC(require_eq);
651ATF_TC_HEAD(require_eq, tc)
652{
653    atf_tc_set_md_var(tc, "descr", "Tests the ATF_REQUIRE_EQ and "
654                      "ATF_REQUIRE_EQ_MSG macros");
655}
656ATF_TC_BODY(require_eq, tc)
657{
658    struct require_eq_test tests[] = {
659        { H_REQUIRE_EQ_HEAD_NAME(1_1), H_REQUIRE_EQ_BODY_NAME(1_1),
660          "1", "1", "1 != 1", true },
661        { H_REQUIRE_EQ_HEAD_NAME(1_2), H_REQUIRE_EQ_BODY_NAME(1_2),
662          "1", "2", "1 != 2", false },
663        { H_REQUIRE_EQ_HEAD_NAME(2_1), H_REQUIRE_EQ_BODY_NAME(2_1),
664          "2", "1", "2 != 1", false },
665        { H_REQUIRE_EQ_HEAD_NAME(2_2), H_REQUIRE_EQ_BODY_NAME(2_2),
666          "2", "2", "2 != 2", true },
667        { H_REQUIRE_EQ_MSG_HEAD_NAME(1_1), H_REQUIRE_EQ_MSG_BODY_NAME(1_1),
668          "1", "1", "1 != 1: 1 does not match 1", true },
669        { H_REQUIRE_EQ_MSG_HEAD_NAME(1_2), H_REQUIRE_EQ_MSG_BODY_NAME(1_2),
670          "1", "2", "1 != 2: 1 does not match 2", false },
671        { H_REQUIRE_EQ_MSG_HEAD_NAME(2_1), H_REQUIRE_EQ_MSG_BODY_NAME(2_1),
672          "2", "1", "2 != 1: 2 does not match 1", false },
673        { H_REQUIRE_EQ_MSG_HEAD_NAME(2_2), H_REQUIRE_EQ_MSG_BODY_NAME(2_2),
674          "2", "2", "2 != 2: 2 does not match 2", true },
675        { NULL, NULL, 0, 0, "", false }
676    };
677    do_require_eq_tests(tests);
678}
679
680H_REQUIRE_STREQ(1_1, "1", "1");
681H_REQUIRE_STREQ(1_2, "1", "2");
682H_REQUIRE_STREQ(2_1, "2", "1");
683H_REQUIRE_STREQ(2_2, "2", "2");
684H_REQUIRE_STREQ_MSG(1_1, "1", "1", "1 does not match 1");
685H_REQUIRE_STREQ_MSG(1_2, "1", "2", "1 does not match 2");
686H_REQUIRE_STREQ_MSG(2_1, "2", "1", "2 does not match 1");
687H_REQUIRE_STREQ_MSG(2_2, "2", "2", "2 does not match 2");
688#define REQUIRE_STREQ_VAR1 "5"
689#define REQUIRE_STREQ_VAR2 "9"
690const char *require_streq_var1 = REQUIRE_STREQ_VAR1;
691const char *require_streq_var2 = REQUIRE_STREQ_VAR2;
692H_REQUIRE_STREQ(vars, require_streq_var1, require_streq_var2);
693
694ATF_TC(require_streq);
695ATF_TC_HEAD(require_streq, tc)
696{
697    atf_tc_set_md_var(tc, "descr", "Tests the ATF_REQUIRE_STREQ and "
698                      "ATF_REQUIRE_STREQ_MSG macros");
699}
700ATF_TC_BODY(require_streq, tc)
701{
702    struct require_eq_test tests[] = {
703        { H_REQUIRE_STREQ_HEAD_NAME(1_1), H_REQUIRE_STREQ_BODY_NAME(1_1),
704          "1", "1", "\"1\" != \"1\" \\(1 != 1\\)", true },
705        { H_REQUIRE_STREQ_HEAD_NAME(1_2), H_REQUIRE_STREQ_BODY_NAME(1_2),
706          "1", "2", "\"1\" != \"2\" \\(1 != 2\\)", false },
707        { H_REQUIRE_STREQ_HEAD_NAME(2_1), H_REQUIRE_STREQ_BODY_NAME(2_1),
708          "2", "1", "\"2\" != \"1\" \\(2 != 1\\)", false },
709        { H_REQUIRE_STREQ_HEAD_NAME(2_2), H_REQUIRE_STREQ_BODY_NAME(2_2),
710          "2", "2", "\"2\" != \"2\" \\(2 != 2\\)", true },
711        { H_REQUIRE_STREQ_MSG_HEAD_NAME(1_1),
712          H_REQUIRE_STREQ_MSG_BODY_NAME(1_1),
713          "1", "1", "\"1\" != \"1\" \\(1 != 1\\): 1 does not match 1", true },
714        { H_REQUIRE_STREQ_MSG_HEAD_NAME(1_2),
715          H_REQUIRE_STREQ_MSG_BODY_NAME(1_2),
716          "1", "2", "\"1\" != \"2\" \\(1 != 2\\): 1 does not match 2", false },
717        { H_REQUIRE_STREQ_MSG_HEAD_NAME(2_1),
718          H_REQUIRE_STREQ_MSG_BODY_NAME(2_1),
719          "2", "1", "\"2\" != \"1\" \\(2 != 1\\): 2 does not match 1", false },
720        { H_REQUIRE_STREQ_MSG_HEAD_NAME(2_2),
721          H_REQUIRE_STREQ_MSG_BODY_NAME(2_2),
722          "2", "2", "\"2\" != \"2\" \\(2 != 2\\): 2 does not match 2", true },
723        { H_REQUIRE_STREQ_HEAD_NAME(vars), H_REQUIRE_STREQ_BODY_NAME(vars),
724          require_streq_var1, require_streq_var2,
725          "require_streq_var1 != require_streq_var2 \\("
726          REQUIRE_STREQ_VAR1 " != " REQUIRE_STREQ_VAR2 "\\)", false },
727        { NULL, NULL, 0, 0, "", false }
728    };
729    do_require_eq_tests(tests);
730}
731
732/* ---------------------------------------------------------------------
733 * Test cases for the ATF_REQUIRE_MATCH and ATF_REQUIRE_MATCH_MSG macros.
734 * --------------------------------------------------------------------- */
735
736H_REQUIRE_MATCH(yes, "hello [a-z]+", "abc hello world");
737H_REQUIRE_MATCH(no, "hello [a-z]+", "abc hello WORLD");
738H_REQUIRE_MATCH_MSG(yes, "hello [a-z]+", "abc hello world", "lowercase");
739H_REQUIRE_MATCH_MSG(no, "hello [a-z]+", "abc hello WORLD", "uppercase");
740
741ATF_TC(require_match);
742ATF_TC_HEAD(require_match, tc)
743{
744    atf_tc_set_md_var(tc, "descr", "Tests the ATF_REQUIRE_MATCH and "
745                      "ATF_REQUIRE_MATCH_MSG macros");
746}
747ATF_TC_BODY(require_match, tc)
748{
749    struct require_eq_test tests[] = {
750        { H_REQUIRE_MATCH_HEAD_NAME(yes), H_REQUIRE_MATCH_BODY_NAME(yes),
751          "hello [a-z]+", "abc hello world", "", true },
752        { H_REQUIRE_MATCH_HEAD_NAME(no), H_REQUIRE_MATCH_BODY_NAME(no),
753          "hello [a-z]+", "abc hello WORLD",
754          "'hello \\[a-z\\]\\+' not matched in 'abc hello WORLD'", false },
755        { H_REQUIRE_MATCH_MSG_HEAD_NAME(yes),
756          H_REQUIRE_MATCH_MSG_BODY_NAME(yes),
757          "hello [a-z]+", "abc hello world", "", true },
758        { H_REQUIRE_MATCH_MSG_HEAD_NAME(no), H_REQUIRE_MATCH_MSG_BODY_NAME(no),
759          "hello [a-z]+", "abc hello WORLD",
760          "'hello \\[a-z\\]\\+' not matched in 'abc hello WORLD': uppercase",
761          false },
762        { NULL, NULL, 0, 0, "", false }
763    };
764    do_require_eq_tests(tests);
765}
766
767/* ---------------------------------------------------------------------
768 * Miscellaneous test cases covering several macros.
769 * --------------------------------------------------------------------- */
770
771static
772bool
773aux_bool(const char *fmt ATF_DEFS_ATTRIBUTE_UNUSED)
774{
775    return false;
776}
777
778static
779const char *
780aux_str(const char *fmt ATF_DEFS_ATTRIBUTE_UNUSED)
781{
782    return "foo";
783}
784
785H_CHECK(msg, aux_bool("%d"));
786H_REQUIRE(msg, aux_bool("%d"));
787H_CHECK_STREQ(msg, aux_str("%d"), "");
788H_REQUIRE_STREQ(msg, aux_str("%d"), "");
789
790ATF_TC(msg_embedded_fmt);
791ATF_TC_HEAD(msg_embedded_fmt, tc)
792{
793    atf_tc_set_md_var(tc, "descr", "Tests that format strings passed "
794                      "as part of the automatically-generated messages "
795                      "do not get expanded");
796}
797ATF_TC_BODY(msg_embedded_fmt, tc)
798{
799    struct test {
800        void (*head)(atf_tc_t *);
801        void (*body)(const atf_tc_t *);
802        bool fatal;
803        const char *msg;
804    } *t, tests[] = {
805       {  H_CHECK_HEAD_NAME(msg), H_CHECK_BODY_NAME(msg), false,
806          "aux_bool\\(\"%d\"\\) not met" },
807       {  H_REQUIRE_HEAD_NAME(msg), H_REQUIRE_BODY_NAME(msg), true,
808          "aux_bool\\(\"%d\"\\) not met" },
809       {  H_CHECK_STREQ_HEAD_NAME(msg), H_CHECK_STREQ_BODY_NAME(msg), false,
810          "aux_str\\(\"%d\"\\) != \"\" \\(foo != \\)" },
811       {  H_REQUIRE_STREQ_HEAD_NAME(msg), H_REQUIRE_STREQ_BODY_NAME(msg), true,
812          "aux_str\\(\"%d\"\\) != \"\" \\(foo != \\)" },
813       { NULL, NULL, false, NULL }
814    };
815
816    for (t = &tests[0]; t->head != NULL; t++) {
817        printf("Checking with an expected '%s' message\n", t->msg);
818
819        init_and_run_h_tc("h_check", t->head, t->body);
820
821        if (t->fatal) {
822            bool matched =
823                atf_utils_grep_file(
824                    "^failed: .*macros_test.c:[0-9]+: %s$", "result", t->msg);
825            ATF_CHECK_MSG(matched, "couldn't find error string in result");
826        } else {
827            bool matched = atf_utils_grep_file("Check failed: .*"
828                "macros_test.c:[0-9]+: %s$", "error", t->msg);
829            ATF_CHECK_MSG(matched, "couldn't find error string in output");
830        }
831    }
832}
833
834/* ---------------------------------------------------------------------
835 * Tests cases for the header file.
836 * --------------------------------------------------------------------- */
837
838BUILD_TC(use, "macros_h_test.c",
839         "Tests that the macros provided by the atf-c/macros.h file "
840         "do not cause syntax errors when used",
841         "Build of macros_h_test.c failed; some macros in atf-c/macros.h "
842         "are broken");
843
844ATF_TC(detect_unused_tests);
845ATF_TC_HEAD(detect_unused_tests, tc)
846{
847    atf_tc_set_md_var(tc, "descr",
848                      "Tests that defining an unused test case raises a "
849                      "warning (and thus an error)");
850}
851ATF_TC_BODY(detect_unused_tests, tc)
852{
853    const char* validate_compiler =
854        "struct test_struct { int dummy; };\n"
855        "#define define_unused static struct test_struct unused\n"
856        "define_unused;\n";
857
858    atf_utils_create_file("compiler_test.c", "%s", validate_compiler);
859    if (build_check_c_o("compiler_test.c"))
860        atf_tc_expect_fail("Compiler does not raise a warning on an unused "
861                           "static global variable declared by a macro");
862
863    if (build_check_c_o_srcdir(tc, "unused_test.c"))
864        atf_tc_fail("Build of unused_test.c passed; unused test cases are "
865                    "not properly detected");
866}
867
868/* ---------------------------------------------------------------------
869 * Main.
870 * --------------------------------------------------------------------- */
871
872ATF_TP_ADD_TCS(tp)
873{
874    ATF_TP_ADD_TC(tp, check);
875    ATF_TP_ADD_TC(tp, check_eq);
876    ATF_TP_ADD_TC(tp, check_streq);
877    ATF_TP_ADD_TC(tp, check_errno);
878    ATF_TP_ADD_TC(tp, check_match);
879
880    ATF_TP_ADD_TC(tp, require);
881    ATF_TP_ADD_TC(tp, require_eq);
882    ATF_TP_ADD_TC(tp, require_streq);
883    ATF_TP_ADD_TC(tp, require_errno);
884    ATF_TP_ADD_TC(tp, require_match);
885
886    ATF_TP_ADD_TC(tp, msg_embedded_fmt);
887
888    /* Add the test cases for the header file. */
889    ATF_TP_ADD_TC(tp, use);
890    ATF_TP_ADD_TC(tp, detect_unused_tests);
891
892    return atf_no_error();
893}
894