/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Copyright by The HDF Group. * * Copyright by the Board of Trustees of the University of Illinois. * * All rights reserved. * * * * This file is part of HDF5. The full HDF5 copyright notice, including * * terms governing use, modification, and redistribution, is contained in * * the COPYING file, which can be found at the root of the source code * * distribution tree, or in https://www.hdfgroup.org/licenses. * * If you do not have access to either file, you may request a copy from * * help@hdfgroup.org. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ /* * Programmer: Robb Matzke * Friday, November 20, 1998 * * Purpose: Test support stuff. */ #ifndef H5TEST_H #define H5TEST_H /* * Include required headers. This file tests internal library functions, * so we include the private headers here. */ #include "hdf5.h" #include "H5private.h" #include "H5Eprivate.h" /* * Predefined test verbosity levels. * * Convention: * * The higher the verbosity value, the more information printed. * So, output for higher verbosity also include output of all lower * verbosity. * * Value Description * 0 None: No informational message. * 1 "All tests passed" * 2 Header of overall test * 3 Default: header and results of individual test * 4 * 5 Low: Major category of tests. * 6 * 7 Medium: Minor category of tests such as functions called. * 8 * 9 High: Highest level. All information. */ #define VERBO_NONE 0 /* None */ #define VERBO_DEF 3 /* Default */ #define VERBO_LO 5 /* Low */ #define VERBO_MED 7 /* Medium */ #define VERBO_HI 9 /* High */ /* * Verbose queries * Only None needs an exact match. The rest are at least as much. */ /* A macro version of HDGetTestVerbosity(). */ /* Should be used internally by the libtest.a only. */ #define HDGetTestVerbosity() (TestVerbosity) #define VERBOSE_NONE (HDGetTestVerbosity() == VERBO_NONE) #define VERBOSE_DEF (HDGetTestVerbosity() >= VERBO_DEF) #define VERBOSE_LO (HDGetTestVerbosity() >= VERBO_LO) #define VERBOSE_MED (HDGetTestVerbosity() >= VERBO_MED) #define VERBOSE_HI (HDGetTestVerbosity() >= VERBO_HI) /* * Test controls definitions. */ #define SKIPTEST 1 /* Skip this test */ #define ONLYTEST 2 /* Do only this test */ #define BEGINTEST 3 /* Skip all tests before this test */ /* * This contains the filename prefix specified as command line option for * the parallel test files. */ H5TEST_DLLVAR char *paraprefix; #ifdef H5_HAVE_PARALLEL H5TEST_DLLVAR MPI_Info h5_io_info_g; /* MPI INFO object for IO */ #endif /* * Print the current location on the standard output stream. */ #define AT() HDprintf(" at %s:%d in %s()...\n", __FILE__, __LINE__, FUNC); /* * The name of the test is printed by saying TESTING("something") which will * result in the string `Testing something' being flushed to standard output. * If a test passes, fails, or is skipped then the PASSED(), H5_FAILED(), or * SKIPPED() macro should be called. After H5_FAILED() or SKIPPED() the caller * should print additional information to stdout indented by at least four * spaces. If the h5_errors() is used for automatic error handling then * the H5_FAILED() macro is invoked automatically when an API function fails. */ #define TESTING(WHAT) \ { \ HDprintf("Testing %-62s", WHAT); \ HDfflush(stdout); \ } #define TESTING_2(WHAT) \ { \ HDprintf(" Testing %-60s", WHAT); \ HDfflush(stdout); \ } #define PASSED() \ do { \ HDputs(" PASSED"); \ HDfflush(stdout); \ } while (0) #define H5_FAILED() \ { \ HDputs("*FAILED*"); \ HDfflush(stdout); \ } #define H5_WARNING() \ { \ HDputs("*WARNING*"); \ HDfflush(stdout); \ } #define SKIPPED() \ { \ HDputs(" -SKIP-"); \ HDfflush(stdout); \ } #define PUTS_ERROR(s) \ { \ HDputs(s); \ AT(); \ goto error; \ } #define TEST_ERROR \ { \ H5_FAILED(); \ AT(); \ goto error; \ } #define STACK_ERROR \ { \ H5Eprint2(H5E_DEFAULT, stdout); \ goto error; \ } #define FAIL_STACK_ERROR \ { \ H5_FAILED(); \ AT(); \ H5Eprint2(H5E_DEFAULT, stdout); \ goto error; \ } #define FAIL_PUTS_ERROR(s) \ { \ H5_FAILED(); \ AT(); \ HDputs(s); \ goto error; \ } /* * Alarm definitions to wait up (terminate) a test that runs too long. */ #define H5_ALARM_SEC 1200 /* default is 20 minutes */ #define ALARM_ON TestAlarmOn() #define ALARM_OFF HDalarm(0) /* Flags for h5_fileaccess_flags() */ #define H5_FILEACCESS_VFD 0x01 /* Macros to create and fill 2D arrays with a single heap allocation. * These can be used to replace large stack and global arrays which raise * warnings. * * The macros make a single heap allocation large enough to hold all the * pointers and the data elements. The first part of the allocation holds * the pointers, and the second part holds the data as a contiguous block * in row-major order. * * To pass the data block to calls like H5Dread(), pass a pointer to the * first array element as the data pointer (e.g., array[0] in a 2D array). * * The fill macro just fills the array with an increasing count value. * * Usage: * * int **array; * * H5TEST_ALLOCATE_2D_ARRAY(array, int, 5, 10); * * H5TEST_FILL_2D_ARRAY(array, int, 5, 10); * * (do stuff) * * HDfree(array); */ #define H5TEST_ALLOCATE_2D_ARRAY(ARR, TYPE, DIMS_I, DIMS_J) \ do { \ /* Prefix with h5taa to avoid shadow warnings */ \ size_t h5taa_pointers_size = 0; \ size_t h5taa_data_size = 0; \ int h5taa_i; \ \ h5taa_pointers_size = (DIMS_I) * sizeof(TYPE *); \ h5taa_data_size = (DIMS_I) * (DIMS_J) * sizeof(TYPE); \ \ ARR = (TYPE **)HDmalloc(h5taa_pointers_size + h5taa_data_size); \ \ ARR[0] = (TYPE *)(ARR + (DIMS_I)); \ \ for (h5taa_i = 1; h5taa_i < (DIMS_I); h5taa_i++) \ ARR[h5taa_i] = ARR[h5taa_i - 1] + (DIMS_J); \ } while (0) #define H5TEST_FILL_2D_ARRAY(ARR, TYPE, DIMS_I, DIMS_J) \ do { \ /* Prefix with h5tfa to avoid shadow warnings */ \ int h5tfa_i = 0; \ int h5tfa_j = 0; \ TYPE h5tfa_count = 0; \ \ for (h5tfa_i = 0; h5tfa_i < (DIMS_I); h5tfa_i++) \ for (h5tfa_j = 0; h5tfa_j < (DIMS_J); h5tfa_j++) { \ ARR[h5tfa_i][h5tfa_j] = h5tfa_count; \ h5tfa_count++; \ } \ } while (0) #ifdef __cplusplus extern "C" { #endif /* * Ugly hack to cast away const for freeing const-qualified pointers. * Should only be used sparingly, where the alternative (like keeping * an equivalent non-const pointer around) is far messier. */ #ifndef h5_free_const #define h5_free_const(mem) HDfree((void *)(uintptr_t)mem) #endif /* Generally useful testing routines */ H5TEST_DLL void h5_clean_files(const char *base_name[], hid_t fapl); H5TEST_DLL int h5_cleanup(const char *base_name[], hid_t fapl); H5TEST_DLL char *h5_fixname(const char *base_name, hid_t fapl, char *fullname, size_t size); H5TEST_DLL char *h5_fixname_no_suffix(const char *base_name, hid_t fapl, char *fullname, size_t size); H5TEST_DLL char *h5_fixname_printf(const char *base_name, hid_t fapl, char *fullname, size_t size); H5TEST_DLL hid_t h5_fileaccess(void); H5TEST_DLL hid_t h5_fileaccess_flags(unsigned flags); H5TEST_DLL void h5_no_hwconv(void); H5TEST_DLL const char *h5_rmprefix(const char *filename); H5TEST_DLL void h5_reset(void); H5TEST_DLL void h5_restore_err(void); H5TEST_DLL void h5_show_hostname(void); H5TEST_DLL h5_stat_size_t h5_get_file_size(const char *filename, hid_t fapl); H5TEST_DLL int print_func(const char *format, ...); H5TEST_DLL int h5_make_local_copy(const char *origfilename, const char *local_copy_name); H5TEST_DLL herr_t h5_verify_cached_stabs(const char *base_name[], hid_t fapl); H5TEST_DLL H5FD_class_t *h5_get_dummy_vfd_class(void); H5TEST_DLL const char *h5_get_version_string(H5F_libver_t libver); H5TEST_DLL int h5_compare_file_bytes(char *fname1, char *fname2); H5TEST_DLL int h5_duplicate_file_by_bytes(const char *orig, const char *dest); H5TEST_DLL herr_t h5_check_if_file_locking_enabled(hbool_t *are_enabled); /* Functions that will replace components of a FAPL */ H5TEST_DLL herr_t h5_get_vfd_fapl(hid_t fapl_id); /* h5_clean_files() replacements */ H5TEST_DLL void h5_delete_test_file(const char *base_name, hid_t fapl); H5TEST_DLL void h5_delete_all_test_files(const char *base_name[], hid_t fapl); /* h5_reset() replacement */ H5TEST_DLL void h5_test_init(void); /* h5_cleanup() replacement */ H5TEST_DLL void h5_test_shutdown(void); /* Routines for operating on the list of tests (for the "all in one" tests) */ H5TEST_DLL void TestUsage(void); H5TEST_DLL void AddTest(const char *TheName, void (*TheCall)(void), void (*Cleanup)(void), const char *TheDescr, const void *Parameters); H5TEST_DLL void TestInfo(const char *ProgName); H5TEST_DLL void TestParseCmdLine(int argc, char *argv[]); H5TEST_DLL void PerformTests(void); H5TEST_DLL void TestSummary(void); H5TEST_DLL void TestCleanup(void); H5TEST_DLL void TestShutdown(void); H5TEST_DLL void TestInit(const char *ProgName, void (*private_usage)(void), int (*private_parser)(int ac, char *av[])); H5TEST_DLL int GetTestVerbosity(void); H5TEST_DLL int SetTestVerbosity(int newval); H5TEST_DLL int GetTestSummary(void); H5TEST_DLL int GetTestCleanup(void); H5TEST_DLL int SetTestNoCleanup(void); H5TEST_DLL int GetTestExpress(void); H5TEST_DLL int SetTestExpress(int newval); H5TEST_DLL void ParseTestVerbosity(char *argv); H5TEST_DLL int GetTestNumErrs(void); H5TEST_DLL void IncTestNumErrs(void); H5TEST_DLL const void *GetTestParameters(void); H5TEST_DLL int TestErrPrintf(const char *format, ...) H5_ATTR_FORMAT(printf, 1, 2); H5TEST_DLL void SetTest(const char *testname, int action); H5TEST_DLL void TestAlarmOn(void); H5TEST_DLL void TestAlarmOff(void); #ifdef H5_HAVE_FILTER_SZIP H5TEST_DLL int h5_szip_can_encode(void); #endif /* H5_HAVE_FILTER_SZIP */ #ifdef H5_HAVE_PARALLEL H5TEST_DLL int h5_set_info_object(void); H5TEST_DLL void h5_dump_info_object(MPI_Info info); H5TEST_DLL char *getenv_all(MPI_Comm comm, int root, const char *name); #endif /* Extern global variables */ H5TEST_DLLVAR int TestVerbosity; H5TEST_DLL void h5_send_message(const char *file, const char *arg1, const char *arg2); H5TEST_DLL herr_t h5_wait_message(const char *file); #ifdef __cplusplus } #endif #endif