2003-04-01 01:59:04 +08:00
|
|
|
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
|
|
* 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 files COPYING and Copyright.html. COPYING can be found at the root *
|
|
|
|
* of the source code distribution tree; Copyright.html can be found at the *
|
|
|
|
* root level of an installed copy of the electronic HDF5 document set and *
|
|
|
|
* is linked from the top-level documents page. It can also be found at *
|
|
|
|
* http://hdf.ncsa.uiuc.edu/HDF5/doc/Copyright.html. If you do not have *
|
|
|
|
* access to either file, you may request a copy from hdfhelp@ncsa.uiuc.edu. *
|
|
|
|
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
|
|
|
|
|
1998-11-21 11:36:51 +08:00
|
|
|
/*
|
|
|
|
* Programmer: Robb Matzke <matzke@llnl.gov>
|
|
|
|
* Friday, November 20, 1998
|
|
|
|
*
|
|
|
|
* Purpose: Test support stuff.
|
|
|
|
*/
|
|
|
|
#ifndef _H5TEST_H
|
|
|
|
#define _H5TEST_H
|
|
|
|
|
|
|
|
#undef NDEBUG
|
2001-04-04 02:09:16 +08:00
|
|
|
#include "hdf5.h"
|
|
|
|
#include "H5private.h"
|
1998-11-21 11:36:51 +08:00
|
|
|
|
2002-04-28 16:34:17 +08:00
|
|
|
#ifdef H5_STDC_HEADERS
|
1998-11-21 11:36:51 +08:00
|
|
|
# include <signal.h>
|
2004-01-10 09:41:13 +08:00
|
|
|
# include <stdarg.h>
|
1998-11-21 11:36:51 +08:00
|
|
|
#endif
|
|
|
|
|
2004-01-23 04:57:34 +08:00
|
|
|
/*
|
|
|
|
* 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 */
|
|
|
|
|
2004-01-23 07:05:55 +08:00
|
|
|
/*
|
|
|
|
* Verbose queries
|
|
|
|
* Only None needs an exact match. The rest are at least as much.
|
|
|
|
*/
|
|
|
|
#define VERBOSE_NONE (GetTestVerbosity()==VERBO_NONE)
|
|
|
|
#define VERBOSE_DEF (GetTestVerbosity()>=VERBO_DEF)
|
|
|
|
#define VERBOSE_LO (GetTestVerbosity()>=VERBO_LO)
|
|
|
|
#define VERBOSE_MED (GetTestVerbosity()>=VERBO_MED)
|
|
|
|
#define VERBOSE_HI (GetTestVerbosity()>=VERBO_HI)
|
|
|
|
|
2000-01-26 12:20:36 +08:00
|
|
|
/*
|
|
|
|
* This contains the filename prefix specificied as command line option for
|
|
|
|
* the parallel test files.
|
|
|
|
*/
|
|
|
|
extern char *paraprefix;
|
2002-05-22 02:49:44 +08:00
|
|
|
#ifdef H5_HAVE_PARALLEL
|
2002-05-30 02:40:29 +08:00
|
|
|
extern MPI_Info h5_io_info_g; /* MPI INFO object for IO */
|
2002-05-22 02:49:44 +08:00
|
|
|
#endif
|
2000-01-26 12:20:36 +08:00
|
|
|
|
2003-04-14 19:21:18 +08:00
|
|
|
/*
|
|
|
|
* Print the current location on the standard output stream.
|
|
|
|
*/
|
|
|
|
#define AT() printf (" at %s:%d in %s()...\n", \
|
|
|
|
__FILE__, __LINE__, __FUNCTION__);
|
|
|
|
|
1998-11-21 11:36:51 +08:00
|
|
|
/*
|
|
|
|
* The name of the test is printed by saying TESTING("something") which will
|
|
|
|
* result in the string `Testing something' being flushed to standard output.
|
2001-01-26 01:03:29 +08:00
|
|
|
* 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
|
1998-11-21 11:36:51 +08:00
|
|
|
* should print additional information to stdout indented by at least four
|
|
|
|
* spaces. If the h5_errors() is used for automatic error handling then
|
2001-01-26 01:03:29 +08:00
|
|
|
* the H5_FAILED() macro is invoked automatically when an API function fails.
|
1998-11-21 11:36:51 +08:00
|
|
|
*/
|
2003-04-12 00:37:18 +08:00
|
|
|
#define TESTING(WHAT) {printf("Testing %-62s",WHAT); fflush(stdout);}
|
1999-10-01 00:14:14 +08:00
|
|
|
#define PASSED() {puts(" PASSED");fflush(stdout);}
|
2001-01-26 01:03:29 +08:00
|
|
|
#define H5_FAILED() {puts("*FAILED*");fflush(stdout);}
|
1999-10-01 00:14:14 +08:00
|
|
|
#define SKIPPED() {puts(" -SKIP-");fflush(stdout);}
|
2003-04-14 19:21:18 +08:00
|
|
|
#define TEST_ERROR {H5_FAILED(); AT(); goto error;}
|
1998-11-21 11:36:51 +08:00
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
2004-01-07 01:53:13 +08:00
|
|
|
/* Generally useful testing routines */
|
2003-05-13 22:28:09 +08:00
|
|
|
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,
|
1998-11-21 11:36:51 +08:00
|
|
|
size_t size);
|
2003-05-13 22:28:09 +08:00
|
|
|
H5TEST_DLL hid_t h5_fileaccess(void);
|
|
|
|
H5TEST_DLL void h5_no_hwconv(void);
|
|
|
|
H5TEST_DLL void h5_reset(void);
|
|
|
|
H5TEST_DLL void h5_show_hostname(void);
|
2004-01-07 01:53:13 +08:00
|
|
|
H5TEST_DLL off_t h5_get_file_size(const char *filename);
|
|
|
|
H5TEST_DLL int print_func(const char *format, ...);
|
|
|
|
|
2004-03-23 12:43:12 +08:00
|
|
|
/* 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),
|
2004-03-31 07:35:16 +08:00
|
|
|
void (*Cleanup) (void), const char *TheDescr,
|
|
|
|
const void *Parameters);
|
2004-03-23 12:43:12 +08:00
|
|
|
H5TEST_DLL void TestInfo(const char *ProgName);
|
|
|
|
H5TEST_DLL void TestParseCmdLine(int argc, char *argv[], int *Summary, int *CleanUp);
|
|
|
|
H5TEST_DLL void PerformTests(void);
|
|
|
|
H5TEST_DLL void TestSummary(void);
|
|
|
|
H5TEST_DLL void TestCleanup(void);
|
|
|
|
H5TEST_DLL void TestInit(void);
|
|
|
|
H5TEST_DLL int GetTestVerbosity(void);
|
|
|
|
H5TEST_DLL int SetTestVerbosity(int newval);
|
|
|
|
H5TEST_DLL void ParseTestVerbosity(char *argv);
|
|
|
|
H5TEST_DLL int GetTestNumErrs(void);
|
2004-04-02 06:51:47 +08:00
|
|
|
H5TEST_DLL void *GetTestParameters(void);
|
2004-03-23 12:43:12 +08:00
|
|
|
H5TEST_DLL int TestErrPrintf(const char *format, ...);
|
|
|
|
|
2002-06-13 02:24:25 +08:00
|
|
|
#ifdef H5_HAVE_PARALLEL
|
2004-01-07 01:53:13 +08:00
|
|
|
H5TEST_DLL int h5_set_info_object(void);
|
|
|
|
H5TEST_DLL void h5_dump_info_object(MPI_Info info);
|
2002-05-22 02:49:44 +08:00
|
|
|
#endif
|
1998-11-21 11:36:51 +08:00
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
#endif
|