1273929Sjmmv/* Copyright (c) 2008 The NetBSD Foundation, Inc. 2240116Smarcel * All rights reserved. 3240116Smarcel * 4240116Smarcel * Redistribution and use in source and binary forms, with or without 5240116Smarcel * modification, are permitted provided that the following conditions 6240116Smarcel * are met: 7240116Smarcel * 1. Redistributions of source code must retain the above copyright 8240116Smarcel * notice, this list of conditions and the following disclaimer. 9240116Smarcel * 2. Redistributions in binary form must reproduce the above copyright 10240116Smarcel * notice, this list of conditions and the following disclaimer in the 11240116Smarcel * documentation and/or other materials provided with the distribution. 12240116Smarcel * 13240116Smarcel * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND 14240116Smarcel * CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, 15240116Smarcel * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 16240116Smarcel * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 17240116Smarcel * IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY 18240116Smarcel * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19240116Smarcel * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE 20240116Smarcel * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 21240116Smarcel * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 22240116Smarcel * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 23240116Smarcel * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN 24273929Sjmmv * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ 25240116Smarcel 26240116Smarcel#if !defined(ATF_C_TC_H) 27240116Smarcel#define ATF_C_TC_H 28240116Smarcel 29240116Smarcel#include <stdbool.h> 30240116Smarcel#include <stddef.h> 31240116Smarcel 32240116Smarcel#include <atf-c/defs.h> 33240116Smarcel#include <atf-c/error_fwd.h> 34240116Smarcel 35240116Smarcelstruct atf_tc; 36240116Smarcel 37240116Smarceltypedef void (*atf_tc_head_t)(struct atf_tc *); 38240116Smarceltypedef void (*atf_tc_body_t)(const struct atf_tc *); 39240116Smarceltypedef void (*atf_tc_cleanup_t)(const struct atf_tc *); 40240116Smarcel 41240116Smarcel/* --------------------------------------------------------------------- 42240116Smarcel * The "atf_tc_pack" type. 43240116Smarcel * --------------------------------------------------------------------- */ 44240116Smarcel 45240116Smarcel/* For static initialization only. */ 46240116Smarcelstruct atf_tc_pack { 47240116Smarcel const char *m_ident; 48240116Smarcel 49240116Smarcel const char *const *m_config; 50240116Smarcel 51240116Smarcel atf_tc_head_t m_head; 52240116Smarcel atf_tc_body_t m_body; 53240116Smarcel atf_tc_cleanup_t m_cleanup; 54240116Smarcel}; 55240116Smarceltypedef const struct atf_tc_pack atf_tc_pack_t; 56240116Smarcel 57240116Smarcel/* --------------------------------------------------------------------- 58240116Smarcel * The "atf_tc" type. 59240116Smarcel * --------------------------------------------------------------------- */ 60240116Smarcel 61240116Smarcelstruct atf_tc_impl; 62240116Smarcelstruct atf_tc { 63240116Smarcel struct atf_tc_impl *pimpl; 64240116Smarcel}; 65240116Smarceltypedef struct atf_tc atf_tc_t; 66240116Smarcel 67240116Smarcel/* Constructors/destructors. */ 68240116Smarcelatf_error_t atf_tc_init(atf_tc_t *, const char *, atf_tc_head_t, 69240116Smarcel atf_tc_body_t, atf_tc_cleanup_t, 70240116Smarcel const char *const *); 71240116Smarcelatf_error_t atf_tc_init_pack(atf_tc_t *, atf_tc_pack_t *, 72240116Smarcel const char *const *); 73240116Smarcelvoid atf_tc_fini(atf_tc_t *); 74240116Smarcel 75240116Smarcel/* Getters. */ 76240116Smarcelconst char *atf_tc_get_ident(const atf_tc_t *); 77240116Smarcelconst char *atf_tc_get_config_var(const atf_tc_t *, const char *); 78240116Smarcelconst char *atf_tc_get_config_var_wd(const atf_tc_t *, const char *, 79240116Smarcel const char *); 80240116Smarcelbool atf_tc_get_config_var_as_bool(const atf_tc_t *, const char *); 81240116Smarcelbool atf_tc_get_config_var_as_bool_wd(const atf_tc_t *, const char *, 82240116Smarcel const bool); 83240116Smarcellong atf_tc_get_config_var_as_long(const atf_tc_t *, const char *); 84240116Smarcellong atf_tc_get_config_var_as_long_wd(const atf_tc_t *, const char *, 85240116Smarcel const long); 86240116Smarcelconst char *atf_tc_get_md_var(const atf_tc_t *, const char *); 87240116Smarcelchar **atf_tc_get_md_vars(const atf_tc_t *); 88240116Smarcelbool atf_tc_has_config_var(const atf_tc_t *, const char *); 89240116Smarcelbool atf_tc_has_md_var(const atf_tc_t *, const char *); 90240116Smarcel 91240116Smarcel/* Modifiers. */ 92240116Smarcelatf_error_t atf_tc_set_md_var(atf_tc_t *, const char *, const char *, ...); 93240116Smarcel 94240116Smarcel/* --------------------------------------------------------------------- 95240116Smarcel * Free functions. 96240116Smarcel * --------------------------------------------------------------------- */ 97240116Smarcel 98240116Smarcelatf_error_t atf_tc_run(const atf_tc_t *, const char *); 99240116Smarcelatf_error_t atf_tc_cleanup(const atf_tc_t *); 100240116Smarcel 101240116Smarcel/* To be run from test case bodies only. */ 102240116Smarcelvoid atf_tc_fail(const char *, ...) 103240116Smarcel ATF_DEFS_ATTRIBUTE_FORMAT_PRINTF(1, 2) 104240116Smarcel ATF_DEFS_ATTRIBUTE_NORETURN; 105240116Smarcelvoid atf_tc_fail_nonfatal(const char *, ...) 106240116Smarcel ATF_DEFS_ATTRIBUTE_FORMAT_PRINTF(1, 2); 107240116Smarcelvoid atf_tc_pass(void) 108240116Smarcel ATF_DEFS_ATTRIBUTE_NORETURN; 109240116Smarcelvoid atf_tc_require_prog(const char *); 110240116Smarcelvoid atf_tc_skip(const char *, ...) 111240116Smarcel ATF_DEFS_ATTRIBUTE_FORMAT_PRINTF(1, 2) 112240116Smarcel ATF_DEFS_ATTRIBUTE_NORETURN; 113240116Smarcelvoid atf_tc_expect_pass(void); 114240116Smarcelvoid atf_tc_expect_fail(const char *, ...) 115240116Smarcel ATF_DEFS_ATTRIBUTE_FORMAT_PRINTF(1, 2); 116240116Smarcelvoid atf_tc_expect_exit(const int, const char *, ...) 117240116Smarcel ATF_DEFS_ATTRIBUTE_FORMAT_PRINTF(2, 3); 118240116Smarcelvoid atf_tc_expect_signal(const int, const char *, ...) 119240116Smarcel ATF_DEFS_ATTRIBUTE_FORMAT_PRINTF(2, 3); 120240116Smarcelvoid atf_tc_expect_death(const char *, ...) 121240116Smarcel ATF_DEFS_ATTRIBUTE_FORMAT_PRINTF(1, 2); 122240116Smarcelvoid atf_tc_expect_timeout(const char *, ...) 123240116Smarcel ATF_DEFS_ATTRIBUTE_FORMAT_PRINTF(1, 2); 124240116Smarcel 125240116Smarcel/* To be run from test case bodies only; internal to macros.h. */ 126240116Smarcelvoid atf_tc_fail_check(const char *, const size_t, const char *, ...) 127240116Smarcel ATF_DEFS_ATTRIBUTE_FORMAT_PRINTF(3, 4); 128240116Smarcelvoid atf_tc_fail_requirement(const char *, const size_t, const char *, ...) 129240116Smarcel ATF_DEFS_ATTRIBUTE_FORMAT_PRINTF(3, 4) 130240116Smarcel ATF_DEFS_ATTRIBUTE_NORETURN; 131240116Smarcelvoid atf_tc_check_errno(const char *, const size_t, const int, 132240116Smarcel const char *, const bool); 133240116Smarcelvoid atf_tc_require_errno(const char *, const size_t, const int, 134240116Smarcel const char *, const bool); 135240116Smarcel 136273929Sjmmv#endif /* !defined(ATF_C_TC_H) */ 137