/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Copyright by The HDF Group. * * 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, October 30, 1998 * * Purpose: This file is included by all HDF5 library source files to * define common things which are not defined in the HDF5 API. * The configuration constants like H5_HAVE_UNISTD_H etc. are * defined in H5config.h which is included by H5public.h. * */ #ifndef H5private_H #define H5private_H #include "H5public.h" /* Include Public Definitions */ #include #include #include #include #include #include #include #include #include #include #include #include /* POSIX headers */ #ifdef H5_HAVE_SYS_TIME_H #include #endif #ifdef H5_HAVE_UNISTD_H #include #endif #ifdef H5_HAVE_PWD_H #include #endif #ifdef H5_HAVE_WAITPID #include #endif /* Include the Pthreads header, if necessary */ #if defined(H5_HAVE_THREADSAFE) && defined(H5_HAVE_PTHREAD_H) #include #endif /* * The `struct stat' data type for stat() and fstat(). This is a POSIX file * but often appears on non-POSIX systems also. The `struct stat' is required * for HDF5 to compile, although only a few fields are actually used. */ #ifdef H5_HAVE_SYS_STAT_H #include #endif /* * flock() in sys/file.h is used for the implementation of file locking. */ #if defined(H5_HAVE_FLOCK) && defined(H5_HAVE_SYS_FILE_H) #include #endif /* * Resource usage is not Posix.1 but HDF5 uses it anyway for some performance * and debugging code if available. */ #ifdef H5_HAVE_SYS_RESOURCE_H #include #endif /* * Unix ioctls. These are used by h5ls (and perhaps others) to determine a * reasonable output width. */ #ifdef H5_HAVE_SYS_IOCTL_H #include #endif /* * Dynamic library handling. These are needed for dynamically loading I/O * filters and VFDs. */ #ifdef H5_HAVE_DLFCN_H #include #endif #ifdef H5_HAVE_DIRENT_H #include #endif /* Define the default VFD for this platform. Since the removal of the * Windows VFD, this is sec2 for all platforms. * * Note well: if you change the default, then be sure to change * H5_default_vfd_init() to call that default's initializer. Also, * make sure that the initializer for each *non*-default VFD calls * H5_init_library(); also, make sure that the initializer for default * VFD does *not* call H5_init_library(). */ #define H5_DEFAULT_VFD H5FD_SEC2 /* Define the default VOL driver */ #define H5_DEFAULT_VOL H5VL_NATIVE #ifdef H5_HAVE_WIN32_API /* The following two defines must be before any windows headers are included */ #define WIN32_LEAN_AND_MEAN /* Exclude rarely-used stuff from Windows headers */ #define NOGDI /* Exclude Graphic Display Interface macros */ #include #include /* For _getcwd() */ #include /* POSIX I/O */ #include /* For GetUserName() */ #include /* For StrStrIA */ #ifdef H5_HAVE_THREADSAFE #include /* For _beginthread() */ #endif #endif /*H5_HAVE_WIN32_API*/ #ifndef F_OK #define F_OK 00 #define W_OK 02 #define R_OK 04 #endif /* uthash is an external, header-only hash table implementation. * * We include the file directly in src/ and #define a few functions * to use our internal memory calls. */ #define uthash_malloc(sz) H5MM_malloc(sz) #define uthash_free(ptr, sz) H5MM_free(ptr) /* Ignoring sz is intentional */ #define HASH_NONFATAL_OOM 1 /* Don't abort() on out-of-memory */ #include "uthash.h" /* * NT doesn't define SIGBUS, but since NT only runs on processors * that do not have alignment constraints a SIGBUS would never be * raised, so we just replace it with SIGILL (which also should * never be raised by the hdf5 library). */ #ifndef SIGBUS #define SIGBUS SIGILL #endif /* * Does the compiler support the __attribute__(()) syntax? It's no * big deal if we don't. * * Note that Solaris Studio supports attribute, but does not support the * attributes we use. * * When using H5_ATTR_FALLTHROUGH, you should also include a comment that * says FALLTHROUGH to reduce warnings on compilers that don't use * attributes but do respect fall-through comments. * * H5_ATTR_CONST is redefined in tools/h5repack/dynlib_rpk.c to quiet * gcc warnings (it has to use the public API and can't include this * file). Be sure to update that file if the #ifdefs change here. */ /* clang-format off */ #if defined(H5_HAVE_ATTRIBUTE) && !defined(__SUNPRO_C) # define H5_ATTR_FORMAT(X, Y, Z) __attribute__((format(X, Y, Z))) # define H5_ATTR_UNUSED __attribute__((unused)) # ifdef H5_HAVE_PARALLEL # define H5_ATTR_PARALLEL_UNUSED __attribute__((unused)) # define H5_ATTR_PARALLEL_USED /*void*/ # else # define H5_ATTR_PARALLEL_UNUSED /*void*/ # define H5_ATTR_PARALLEL_USED __attribute__((unused)) # endif # ifdef H5_NO_DEPRECATED_SYMBOLS # define H5_ATTR_DEPRECATED_USED H5_ATTR_UNUSED # else # define H5_ATTR_DEPRECATED_USED /*void*/ # endif # ifdef H5_DEBUG_API # define H5_ATTR_DEBUG_API_USED /*void*/ # else # define H5_ATTR_DEBUG_API_USED H5_ATTR_UNUSED # endif /* H5_DEBUG_API */ # ifndef NDEBUG # define H5_ATTR_NDEBUG_UNUSED /*void*/ # else # define H5_ATTR_NDEBUG_UNUSED H5_ATTR_UNUSED # endif # define H5_ATTR_NORETURN __attribute__((noreturn)) # define H5_ATTR_CONST __attribute__((const)) # define H5_ATTR_PURE __attribute__((pure)) # if defined(__clang__) || defined(__GNUC__) && __GNUC__ >= 7 && !defined(__INTEL_COMPILER) # define H5_ATTR_FALLTHROUGH __attribute__((fallthrough)); # else # define H5_ATTR_FALLTHROUGH /* FALLTHROUGH */ # endif # if defined(__GNUC__) && !defined(__INTEL_COMPILER) # define H5_ATTR_MALLOC __attribute__((malloc)) # else # define H5_ATTR_MALLOC /*void*/ # endif /* Turns off optimizations for a function. Goes after the return type. * Not generally needed in the library, but ancient versions of clang * (7.3.3, possibly others) have trouble with some of the onion VFD decode * functions and need the optimizer turned off. This macro can go away when * we figure out what's going on and can engineer another solution. */ # if defined(__clang__) # define H5_ATTR_NO_OPTIMIZE __attribute__((optnone)) # else # define H5_ATTR_NO_OPTIMIZE /*void*/ # endif #else # define H5_ATTR_FORMAT(X, Y, Z) /*void*/ # define H5_ATTR_UNUSED /*void*/ # define H5_ATTR_NDEBUG_UNUSED /*void*/ # define H5_ATTR_DEBUG_API_USED /*void*/ # define H5_ATTR_DEPRECATED_USED /*void*/ # define H5_ATTR_PARALLEL_UNUSED /*void*/ # define H5_ATTR_PARALLEL_USED /*void*/ # define H5_ATTR_NORETURN /*void*/ # define H5_ATTR_CONST /*void*/ # define H5_ATTR_PURE /*void*/ # define H5_ATTR_FALLTHROUGH /*void*/ # define H5_ATTR_MALLOC /*void*/ # define H5_ATTR_NO_OPTIMIZE /*void*/ #endif /* clang-format on */ /* * Networking headers used by the mirror VFD and related tests and utilities. */ #ifdef H5_HAVE_ARPA_INET_H #include #endif #ifdef H5_HAVE_NETDB_H #include #endif #ifdef H5_HAVE_NETINET_IN_H #include #endif #ifdef H5_HAVE_SYS_SOCKET_H #include #endif /* * Status return values for the `herr_t' type. * Since some unix/c routines use 0 and -1 (or more precisely, non-negative * vs. negative) as their return code, and some assumption had been made in * the code about that, it is important to keep these constants the same * values. When checking the success or failure of an integer-valued * function, remember to compare against zero and not one of these two * values. */ #define SUCCEED 0 #define FAIL (-1) /* The HDF5 library uses the symbol `ERR` frequently. So do * header files for libraries such as curses(3), terminfo(3), etc. * Remove its definition here to avoid clashes with HDF5. */ #ifdef ERR #undef ERR #endif /* number of members in an array */ #ifndef NELMTS #define NELMTS(X) (sizeof(X) / sizeof(X[0])) #endif /* minimum of two, three, or four values */ #undef MIN #define MIN(a, b) (((a) < (b)) ? (a) : (b)) #define MIN2(a, b) MIN(a, b) #define MIN3(a, b, c) MIN(a, MIN(b, c)) #define MIN4(a, b, c, d) MIN(MIN(a, b), MIN(c, d)) /* maximum of two, three, or four values */ #undef MAX #define MAX(a, b) (((a) > (b)) ? (a) : (b)) #define MAX2(a, b) MAX(a, b) #define MAX3(a, b, c) MAX(a, MAX(b, c)) #define MAX4(a, b, c, d) MAX(MAX(a, b), MAX(c, d)) /* limit the middle value to be within a range (inclusive) */ #define RANGE(LO, X, HI) MAX(LO, MIN(X, HI)) /* absolute value */ #ifndef ABS #define ABS(a) (((a) >= 0) ? (a) : -(a)) #endif /* sign of argument */ #ifndef SIGN #define SIGN(a) ((a) > 0 ? 1 : (a) < 0 ? -1 : 0) #endif /* test for number that is a power of 2 */ /* (from: http://graphics.stanford.edu/~seander/bithacks.html#DetermineIfPowerOf2) */ #define POWER_OF_TWO(n) (!(n & (n - 1)) && n) /* Raise an integer to a power of 2 */ #define H5_EXP2(n) (1 << (n)) /* * HDF Boolean type. */ #ifndef FALSE #define FALSE false #endif #ifndef TRUE #define TRUE true #endif /* * The max value for ssize_t. * * Only needed where ssize_t isn't a thing (e.g., Windows) */ #ifndef SSIZE_MAX #define SSIZE_MAX ((ssize_t)(((size_t)1 << (8 * sizeof(ssize_t) - 1)) - 1)) #endif /* * Maximum & minimum values for HDF5 typedefs. */ #define HSIZET_MAX ((hsize_t)ULLONG_MAX) #define HSSIZET_MAX ((hssize_t)LLONG_MAX) #define HSSIZET_MIN (~(HSSIZET_MAX)) #ifdef H5_HAVE_PARALLEL /* Define a type for safely sending size_t values with MPI */ #if SIZE_MAX == UCHAR_MAX #define H5_SIZE_T_AS_MPI_TYPE MPI_UNSIGNED_CHAR #elif SIZE_MAX == USHRT_MAX #define H5_SIZE_T_AS_MPI_TYPE MPI_UNSIGNED_SHORT #elif SIZE_MAX == UINT_MAX #define H5_SIZE_T_AS_MPI_TYPE MPI_UNSIGNED #elif SIZE_MAX == ULONG_MAX #define H5_SIZE_T_AS_MPI_TYPE MPI_UNSIGNED_LONG #elif SIZE_MAX == ULLONG_MAX #define H5_SIZE_T_AS_MPI_TYPE MPI_UNSIGNED_LONG_LONG #else #error "no suitable MPI type for size_t" #endif #endif /* H5_HAVE_PARALLEL */ /* * Types and max sizes for POSIX I/O. * OS X (Darwin) is odd since the max I/O size does not match the types. */ #if defined(H5_HAVE_WIN32_API) #define h5_posix_io_t unsigned int #define h5_posix_io_ret_t int #define H5_POSIX_MAX_IO_BYTES INT_MAX #elif defined(H5_HAVE_DARWIN) #define h5_posix_io_t size_t #define h5_posix_io_ret_t ssize_t #define H5_POSIX_MAX_IO_BYTES INT_MAX #else #define h5_posix_io_t size_t #define h5_posix_io_ret_t ssize_t #define H5_POSIX_MAX_IO_BYTES SSIZE_MAX #endif /* POSIX I/O mode used as the third parameter to open/_open * when creating a new file (O_CREAT is set). */ #if defined(H5_HAVE_WIN32_API) #define H5_POSIX_CREATE_MODE_RW (_S_IREAD | _S_IWRITE) #else #define H5_POSIX_CREATE_MODE_RW 0666 #endif /* Represents an empty asynchronous request handle. * Used in the VOL code. */ #define H5_REQUEST_NULL NULL /* * Methods to compare the equality of floating-point values: * * 1. H5_XXX_ABS_EQUAL - check if the difference is smaller than the * Epsilon value. The Epsilon values, FLT_EPSILON, DBL_EPSILON, * and LDBL_EPSILON, are defined by compiler in float.h. * * 2. H5_XXX_REL_EQUAL - check if the relative difference is smaller than a * predefined value M. See if two values are relatively equal. * It's the developer's responsibility not to pass in the value 0, which * may cause the equation to fail. */ #define H5_FLT_ABS_EQUAL(X, Y) (HDfabsf((X) - (Y)) < FLT_EPSILON) #define H5_DBL_ABS_EQUAL(X, Y) (HDfabs((X) - (Y)) < DBL_EPSILON) #define H5_LDBL_ABS_EQUAL(X, Y) (HDfabsl((X) - (Y)) < LDBL_EPSILON) #define H5_FLT_REL_EQUAL(X, Y, M) (HDfabsf(((Y) - (X)) / (X)) < (M)) #define H5_DBL_REL_EQUAL(X, Y, M) (HDfabs(((Y) - (X)) / (X)) < (M)) #define H5_LDBL_REL_EQUAL(X, Y, M) (HDfabsl(((Y) - (X)) / (X)) < (M)) /* KiB, MiB, GiB, TiB, PiB, EiB - Used in profiling and timing code */ #define H5_KB (1024.0F) #define H5_MB (1024.0F * 1024.0F) #define H5_GB (1024.0F * 1024.0F * 1024.0F) #define H5_TB (1024.0F * 1024.0F * 1024.0F * 1024.0F) #define H5_PB (1024.0F * 1024.0F * 1024.0F * 1024.0F * 1024.0F) #define H5_EB (1024.0F * 1024.0F * 1024.0F * 1024.0F * 1024.0F * 1024.0F) #ifndef H5_HAVE_FLOCK /* flock() operations. Used in the source so we have to define them when * the call is not available (e.g.: Windows). These should NOT be used * with system-provided flock() calls since the values will come from the * header file. */ #define LOCK_SH 0x01 #define LOCK_EX 0x02 #define LOCK_NB 0x04 #define LOCK_UN 0x08 #endif /* H5_HAVE_FLOCK */ /* Macros for enabling/disabling particular GCC / clang warnings * * These are duplicated in H5FDmulti.c (we don't want to put them in the * public header and the multi VFD can't use private headers). If you make * changes here, be sure to update those as well. * * (see the following web-sites for more info: * http://www.dbp-consulting.com/tutorials/SuppressingGCCWarnings.html * http://gcc.gnu.org/onlinedocs/gcc/Diagnostic-Pragmas.html#Diagnostic-Pragmas */ #define H5_DIAG_JOINSTR(x, y) x y #define H5_DIAG_DO_PRAGMA(x) _Pragma(#x) #define H5_DIAG_PRAGMA(x) H5_DIAG_DO_PRAGMA(GCC diagnostic x) #define H5_DIAG_OFF(x) H5_DIAG_PRAGMA(push) H5_DIAG_PRAGMA(ignored H5_DIAG_JOINSTR("-W", x)) #define H5_DIAG_ON(x) H5_DIAG_PRAGMA(pop) /* Macros for enabling/disabling particular GCC-only warnings. * These pragmas are only implemented usefully in gcc 4.6+ */ #if (((__GNUC__ * 100) + __GNUC_MINOR__) >= 406) #define H5_GCC_DIAG_OFF(x) H5_DIAG_OFF(x) #define H5_GCC_DIAG_ON(x) H5_DIAG_ON(x) #else #define H5_GCC_DIAG_OFF(x) #define H5_GCC_DIAG_ON(x) #endif /* Macros for enabling/disabling particular clang-only warnings. */ #if defined(__clang__) #define H5_CLANG_DIAG_OFF(x) H5_DIAG_OFF(x) #define H5_CLANG_DIAG_ON(x) H5_DIAG_ON(x) #else #define H5_CLANG_DIAG_OFF(x) #define H5_CLANG_DIAG_ON(x) #endif /* Macros for enabling/disabling particular GCC / clang warnings. * These macros should be used for warnings supported by both gcc and clang. */ #if (((__GNUC__ * 100) + __GNUC_MINOR__) >= 406) || defined(__clang__) #define H5_GCC_CLANG_DIAG_OFF(x) H5_DIAG_OFF(x) #define H5_GCC_CLANG_DIAG_ON(x) H5_DIAG_ON(x) #else #define H5_GCC_CLANG_DIAG_OFF(x) #define H5_GCC_CLANG_DIAG_ON(x) #endif /* Function pointer typedef for qsort */ typedef int (*H5_sort_func_cb_t)(const void *, const void *); /* Typedefs and functions for timing certain parts of the library. */ /* A set of elapsed/user/system times emitted as a time point by the * platform-independent timers. */ typedef struct { double user; /* User time in seconds */ double system; /* System time in seconds */ double elapsed; /* Elapsed (wall clock) time in seconds */ } H5_timevals_t; /* Timer structure for platform-independent timers */ typedef struct { H5_timevals_t initial; /* Current interval start time */ H5_timevals_t final_interval; /* Last interval elapsed time */ H5_timevals_t total; /* Total elapsed time for all intervals */ hbool_t is_running; /* Whether timer is running */ } H5_timer_t; /* Returns library bandwidth as a pretty string */ H5_DLL void H5_bandwidth(char *buf /*out*/, size_t bufsize, double nbytes, double nseconds); /* Timer functionality */ H5_DLL time_t H5_now(void); H5_DLL uint64_t H5_now_usec(void); H5_DLL herr_t H5_timer_init(H5_timer_t *timer /*in,out*/); H5_DLL herr_t H5_timer_start(H5_timer_t *timer /*in,out*/); H5_DLL herr_t H5_timer_stop(H5_timer_t *timer /*in,out*/); H5_DLL herr_t H5_timer_get_times(H5_timer_t timer, H5_timevals_t *times /*in,out*/); H5_DLL herr_t H5_timer_get_total_times(H5_timer_t timer, H5_timevals_t *times /*in,out*/); H5_DLL char *H5_timer_get_time_string(double seconds); H5_DLL char *H5_strcasestr(const char *haystack, const char *needle); /* Depth of object copy */ typedef enum { H5_COPY_SHALLOW, /* Shallow copy from source to destination, just copy field pointers */ H5_COPY_DEEP /* Deep copy from source to destination, including duplicating fields pointed to */ } H5_copy_depth_t; /* Common object copying udata (right now only used for groups and datasets) */ typedef struct H5O_copy_file_ud_common_t { struct H5O_pline_t *src_pline; /* Copy of filter pipeline for object */ } H5O_copy_file_ud_common_t; /* Unique object "position" */ typedef struct { unsigned long fileno; /* The unique identifier for the file of the object */ haddr_t addr; /* The unique address of the object's header in that file */ } H5_obj_t; #define H5_SIZEOF_H5_STAT_SIZE_T H5_SIZEOF_OFF_T /* Put all Windows-specific definitions in H5win32defs.h so we * can (mostly) assume a POSIX platform. Not all of the POSIX calls * will have a Windows equivalent so some #ifdef protection is still * necessary (e.g., fork()). */ #include "H5win32defs.h" /* Platform-independent definitions for struct stat and off_t */ #ifndef H5_HAVE_WIN32_API /* These definitions differ in Windows and are defined in * H5win32defs for that platform. */ typedef struct stat h5_stat_t; typedef off_t h5_stat_size_t; #define HDoff_t off_t #endif /* Redefine all the POSIX and C functions. We should never see an * undecorated POSIX or C function (or any other non-HDF5 function) * in the source. */ #ifndef HDabort #define HDabort() abort() #endif #ifndef HDabs #define HDabs(X) abs(X) #endif #ifndef HDaccept #define HDaccept(A, B, C) accept((A), (B), (C)) #endif #ifndef HDaccess #define HDaccess(F, M) access(F, M) #endif #ifndef HDacos #define HDacos(X) acos(X) #endif #ifndef HDalarm #define HDalarm(N) alarm(N) #endif #ifndef HDasctime #define HDasctime(T) asctime(T) #endif #ifndef HDasin #define HDasin(X) asin(X) #endif #ifndef HDasprintf #define HDasprintf asprintf /*varargs*/ #endif #ifndef HDassert #define HDassert(X) assert(X) #endif #ifndef HDatan #define HDatan(X) atan(X) #endif #ifndef HDatan2 #define HDatan2(X, Y) atan2(X, Y) #endif #ifndef HDatexit #define HDatexit(F) atexit(F) #endif #ifndef HDatof #define HDatof(S) atof(S) #endif #ifndef HDatoi #define HDatoi(S) atoi(S) #endif #ifndef HDatol #define HDatol(S) atol(S) #endif #ifndef HDatoll #define HDatoll(S) atoll(S) #endif #ifndef HDbind #define HDbind(A, B, C) bind((A), (B), (C)) #endif #ifndef HDbsearch #define HDbsearch(K, B, N, Z, F) bsearch(K, B, N, Z, F) #endif #ifndef HDcalloc #define HDcalloc(N, Z) calloc(N, Z) #endif #ifndef HDceil #define HDceil(X) ceil(X) #endif #ifndef HDcfgetispeed #define HDcfgetispeed(T) cfgetispeed(T) #endif #ifndef HDcfgetospeed #define HDcfgetospeed(T) cfgetospeed(T) #endif #ifndef HDcfsetispeed #define HDcfsetispeed(T, S) cfsetispeed(T, S) #endif #ifndef HDcfsetospeed #define HDcfsetospeed(T, S) cfsetospeed(T, S) #endif #ifndef HDchdir #define HDchdir(S) chdir(S) #endif #ifndef HDchmod #define HDchmod(S, M) chmod(S, M) #endif #ifndef HDchown #define HDchown(S, O, G) chown(S, O, G) #endif #ifndef HDclearerr #define HDclearerr(F) clearerr(F) #endif #ifndef HDclock #define HDclock() clock() #endif #ifndef HDclock_gettime #define HDclock_gettime(CID, TS) clock_gettime(CID, TS) #endif #ifndef HDclose #define HDclose(F) close(F) #endif #ifndef HDclosedir #define HDclosedir(D) closedir(D) #endif #ifndef HDconnect #define HDconnect(A, B, C) connect((A), (B), (C)) #endif #ifndef HDcos #define HDcos(X) cos(X) #endif #ifndef HDcosh #define HDcosh(X) cosh(X) #endif #ifndef HDcreat #define HDcreat(S, M) creat(S, M) #endif #ifndef HDctermid #define HDctermid(S) ctermid(S) #endif #ifndef HDctime #define HDctime(T) ctime(T) #endif #ifndef HDcuserid #define HDcuserid(S) cuserid(S) #endif #ifndef HDdifftime #define HDdifftime(X, Y) difftime(X, Y) #endif #ifndef HDdiv #define HDdiv(X, Y) div(X, Y) #endif #ifndef HDdup #define HDdup(F) dup(F) #endif #ifndef HDdup2 #define HDdup2(F, I) dup2(F, I) #endif #ifndef HDexecv #define HDexecv(S, AV) execv(S, AV) #endif #ifndef HDexecve #define HDexecve(S, AV, E) execve(S, AV, E) #endif #ifndef HDexecvp #define HDexecvp(S, AV) execvp(S, AV) #endif #ifndef HDexit #define HDexit(N) exit(N) #endif #ifndef HD_exit #define HD_exit(N) _exit(N) #endif #ifndef HDexp #define HDexp(X) exp(X) #endif #ifndef HDexp2 #define HDexp2(X) exp2(X) #endif #ifndef HDfabs #define HDfabs(X) fabs(X) #endif #ifndef HDfabsf #define HDfabsf(X) fabsf(X) #endif #ifndef HDfabsl #define HDfabsl(X) fabsl(X) #endif #ifndef HDfclose #define HDfclose(F) fclose(F) #endif #ifndef HDfcntl #define HDfcntl(F, C, ...) fcntl(F, C, __VA_ARGS__) #endif #ifndef HDfdopen #define HDfdopen(N, S) fdopen(N, S) #endif #ifndef HDfeof #define HDfeof(F) feof(F) #endif #ifndef HDferror #define HDferror(F) ferror(F) #endif #ifndef HDfflush #define HDfflush(F) fflush(F) #endif #ifndef HDfgetc #define HDfgetc(F) fgetc(F) #endif #ifndef HDfgetpos #define HDfgetpos(F, P) fgetpos(F, P) #endif #ifndef HDfgets #define HDfgets(S, N, F) fgets(S, N, F) #endif #ifndef HDfileno #define HDfileno(F) fileno(F) #endif /* Since flock is so prevalent, always build these functions * when possible to avoid them becoming dead code. */ #ifdef H5_HAVE_FCNTL H5_DLL int Pflock(int fd, int operation); #endif H5_DLL H5_ATTR_CONST int Nflock(int fd, int operation); #ifndef HDflock /* NOTE: flock(2) is not present on all POSIX systems. * If it is not present, we try a flock() equivalent based on * fcntl(2), then fall back to a function that always succeeds * if it is not present at all (Windows uses a separate Wflock() * function). */ #if defined(H5_HAVE_FLOCK) #define HDflock(F, L) flock(F, L) #elif defined(H5_HAVE_FCNTL) #define HDflock(F, L) Pflock(F, L) #else #define HDflock(F, L) Nflock(F, L) #endif #endif /* HDflock */ #ifndef HDfloor #define HDfloor(X) floor(X) #endif #ifndef HDfmod #define HDfmod(X, Y) fmod(X, Y) #endif #ifndef HDfopen #define HDfopen(S, M) fopen(S, M) #endif #ifndef HDfork #define HDfork() fork() #endif #ifndef HDfprintf #define HDfprintf fprintf #endif #ifndef HDfpathconf #define HDfpathconf(F, N) fpathconf(F, N) #endif #ifndef HDfputc #define HDfputc(C, F) fputc(C, F) #endif #ifndef HDfputs #define HDfputs(S, F) fputs(S, F) #endif #ifndef HDfread #define HDfread(M, Z, N, F) fread(M, Z, N, F) #endif #ifndef HDfree #define HDfree(M) free(M) #endif #ifndef HDfreopen #define HDfreopen(S, M, F) freopen(S, M, F) #endif #ifndef HDfrexp #define HDfrexp(X, N) frexp(X, N) #endif #ifndef HDfrexpf #define HDfrexpf(X, N) frexpf(X, N) #endif #ifndef HDfrexpl #define HDfrexpl(X, N) frexpl(X, N) #endif #ifndef HDfscanf #define HDfscanf fscanf #endif #ifndef HDfseek #define HDfseek(F, O, W) fseeko(F, O, W) #endif #ifndef HDfsetpos #define HDfsetpos(F, P) fsetpos(F, P) #endif #ifndef HDfstat #define HDfstat(F, B) fstat(F, B) #endif #ifndef HDftell #define HDftell(F) ftell(F) #endif #ifndef HDftruncate #define HDftruncate(F, L) ftruncate(F, L) #endif #ifndef HDfwrite #define HDfwrite(M, Z, N, F) fwrite(M, Z, N, F) #endif #ifndef HDgetc #define HDgetc(F) getc(F) #endif #ifndef HDgetchar #define HDgetchar() getchar() #endif #ifndef HDgetcwd #define HDgetcwd(S, Z) getcwd(S, Z) #endif #ifndef HDgetdcwd #define HDgetdcwd(D, S, Z) getcwd(S, Z) #endif /* Windows only - set to zero on other systems */ #ifndef HDgetdrive #define HDgetdrive() 0 #endif #ifndef HDgetegid #define HDgetegid() getegid() #endif #ifndef HDgetenv #define HDgetenv(S) getenv(S) #endif #ifndef HDgeteuid #define HDgeteuid() geteuid() #endif #ifndef HDgetgid #define HDgetgid() getgid() #endif #ifndef HDgetgrgid #define HDgetgrgid(G) getgrgid(G) #endif #ifndef HDgetgrnam #define HDgetgrnam(S) getgrnam(S) #endif #ifndef HDgetgroups #define HDgetgroups(Z, G) getgroups(Z, G) #endif #ifndef HDgethostbyaddr #define HDgethostbyaddr(A, B, C) gethostbyaddr((A), (B), (C)) #endif #ifndef HDgethostname #define HDgethostname(N, L) gethostname(N, L) #endif #ifndef HDgetpgrp #define HDgetpgrp() getpgrp() #endif #ifndef HDgetpid #define HDgetpid() getpid() #endif #ifndef HDgetppid #define HDgetppid() getppid() #endif #ifndef HDgetpwnam #define HDgetpwnam(S) getpwnam(S) #endif #ifndef HDgetpwuid #define HDgetpwuid(U) getpwuid(U) #endif #ifndef HDgetrusage #define HDgetrusage(X, S) getrusage(X, S) #endif /* Don't define HDgets - gets() was deprecated in C99 and removed in C11 */ #ifdef HDgets #undef HDgets #endif #ifndef HDgettimeofday #define HDgettimeofday(S, P) gettimeofday(S, P) #endif #ifndef HDgetuid #define HDgetuid() getuid() #endif #ifndef HDgmtime #define HDgmtime(T) gmtime(T) #endif #ifndef HDhtonl #define HDhtonl(X) htonl((X)) #endif #ifndef HDhtons #define HDhtons(X) htons((X)) #endif #ifndef HDinet_addr #define HDinet_addr(C) inet_addr((C)) #endif #ifndef HDinet_ntoa #define HDinet_ntoa(C) inet_ntoa((C)) #endif #ifndef HDisalnum #define HDisalnum(C) isalnum((int)(C)) /* Cast for Solaris warning */ #endif #ifndef HDisalpha #define HDisalpha(C) isalpha((int)(C)) /* Cast for Solaris warning */ #endif #ifndef HDisatty #define HDisatty(F) isatty(F) #endif #ifndef HDiscntrl #define HDiscntrl(C) iscntrl((int)(C)) /* Cast for solaris warning */ #endif #ifndef HDisdigit #define HDisdigit(C) isdigit((int)(C)) /* Cast for Solaris warning */ #endif #ifndef HDisgraph #define HDisgraph(C) isgraph((int)(C)) /* Cast for Solaris warning*/ #endif #ifndef HDislower #define HDislower(C) islower((int)(C)) /* Cast for Solaris warning */ #endif #ifndef HDisnan #define HDisnan(X) isnan(X) #endif #ifndef HDisprint #define HDisprint(C) isprint((int)(C)) /* Cast for Solaris warning */ #endif #ifndef HDispunct #define HDispunct(C) ispunct((int)(C)) /* Cast for Solaris warning */ #endif #ifndef HDisspace #define HDisspace(C) isspace((int)(C)) /* Cast for Solaris warning */ #endif #ifndef HDisupper #define HDisupper(C) isupper((int)(C)) /* Cast for Solaris warning */ #endif #ifndef HDisxdigit #define HDisxdigit(C) isxdigit((int)(C)) /* Cast for Solaris warning */ #endif #ifndef HDkill #define HDkill(P, S) kill(P, S) #endif #ifndef HDlabs #define HDlabs(X) labs(X) #endif #ifndef HDldexp #define HDldexp(X, N) ldexp(X, N) #endif #ifndef HDldiv #define HDldiv(X, Y) ldiv(X, Y) #endif #ifndef HDlink #define HDlink(OLD, NEW) link(OLD, NEW) #endif #ifndef HDlisten #define HDlisten(A, B) listen((A), (B)) #endif #ifndef HDllround #define HDllround(V) llround(V) #endif #ifndef HDllroundf #define HDllroundf(V) llroundf(V) #endif #ifndef HDllroundl #define HDllroundl(V) llroundl(V) #endif #ifndef HDlocaleconv #define HDlocaleconv() localeconv() #endif #ifndef HDlocaltime #define HDlocaltime(T) localtime(T) #endif #ifndef HDlog #define HDlog(X) log(X) #endif #ifndef HDlog2 #define HDlog2(X) log2(X) #endif #ifndef HDlog10 #define HDlog10(X) log10(X) #endif #ifndef HDlongjmp #define HDlongjmp(J, N) longjmp(J, N) #endif #ifndef HDlround #define HDlround(V) lround(V) #endif #ifndef HDlroundf #define HDlroundf(V) lroundf(V) #endif #ifndef HDlroundl #define HDlroundl(V) lroundl(V) #endif #ifndef HDlseek #define HDlseek(F, O, W) lseek(F, O, W) #endif #ifndef HDlstat #define HDlstat(S, B) lstat(S, B) #endif #ifndef HDmalloc #define HDmalloc(Z) malloc(Z) #endif #ifndef HDposix_memalign #define HDposix_memalign(P, A, Z) posix_memalign(P, A, Z) #endif #ifndef HDmblen #define HDmblen(S, N) mblen(S, N) #endif #ifndef HDmbstowcs #define HDmbstowcs(P, S, Z) mbstowcs(P, S, Z) #endif #ifndef HDmbtowc #define HDmbtowc(P, S, Z) mbtowc(P, S, Z) #endif #ifndef HDmemchr #define HDmemchr(S, C, Z) memchr(S, C, Z) #endif #ifndef HDmemcmp #define HDmemcmp(X, Y, Z) memcmp(X, Y, Z) #endif #ifndef HDmemcpy #define HDmemcpy(X, Y, Z) memcpy(X, Y, Z) #endif #ifndef HDmemmove #define HDmemmove(X, Y, Z) memmove((char *)(X), (const char *)(Y), Z) #endif #ifndef HDmemset #define HDmemset(X, C, Z) memset(X, C, Z) #endif #ifndef HDmkdir #define HDmkdir(S, M) mkdir(S, M) #endif #ifndef HDmkfifo #define HDmkfifo(S, M) mkfifo(S, M) #endif #ifndef HDmktime #define HDmktime(T) mktime(T) #endif #ifndef HDmodf #define HDmodf(X, Y) modf(X, Y) #endif #ifndef HDnanosleep #define HDnanosleep(N, O) nanosleep(N, O) #endif #ifndef HDntohl #define HDntohl(A) ntohl((A)) #endif #ifndef HDntohs #define HDntohs(A) ntohs((A)) #endif #ifndef HDopen #define HDopen(F, ...) open(F, __VA_ARGS__) #endif #ifndef HDopendir #define HDopendir(S) opendir(S) #endif #ifndef HDpathconf #define HDpathconf(S, N) pathconf(S, N) #endif #ifndef HDpause #define HDpause() pause() #endif #ifndef HDperror #define HDperror(S) perror(S) #endif #ifndef HDpipe #define HDpipe(F) pipe(F) #endif #ifndef HDpow #define HDpow(X, Y) pow(X, Y) #endif #ifndef HDpowf #define HDpowf(X, Y) powf(X, Y) #endif #ifndef HDpread #define HDpread(F, B, C, O) pread(F, B, C, O) #endif #ifndef HDprintf #define HDprintf printf /*varargs*/ #endif #ifndef HDputc #define HDputc(C, F) putc(C, F) #endif #ifndef HDputchar #define HDputchar(C) putchar(C) #endif #ifndef HDputs #define HDputs(S) puts(S) #endif #ifndef HDpwrite #define HDpwrite(F, B, C, O) pwrite(F, B, C, O) #endif #ifndef HDqsort #define HDqsort(M, N, Z, F) qsort(M, N, Z, F) #endif #ifndef HDraise #define HDraise(N) raise(N) #endif /* clang-format off */ #ifdef H5_HAVE_RAND_R # ifndef HDrandom # define HDrandom() HDrand() # endif H5_DLL int HDrand(void); # ifndef HDsrandom # define HDsrandom(S) HDsrand(S) # endif H5_DLL void HDsrand(unsigned int seed); #elif defined(H5_HAVE_RANDOM) # ifndef HDrand # define HDrand() random() # endif # ifndef HDrandom # define HDrandom() random() # endif # ifndef HDsrand # define HDsrand(S) srandom(S) # endif # ifndef HDsrandom # define HDsrandom(S) srandom(S) # endif #else # ifndef HDrand # define HDrand() rand() # endif # ifndef HDrandom # define HDrandom() rand() # endif # ifndef HDsrand # define HDsrand(S) srand(S) # endif # ifndef HDsrandom # define HDsrandom(S) srand(S) # endif #endif /* clang-format on */ #ifndef HDread #define HDread(F, M, Z) read(F, M, Z) #endif #ifndef HDreaddir #define HDreaddir(D) readdir(D) #endif #ifndef HDrealloc #define HDrealloc(M, Z) realloc(M, Z) #endif #ifndef HDrealpath #define HDrealpath(F1, F2) realpath(F1, F2) #endif #ifndef HDremove #define HDremove(S) remove(S) #endif #ifndef HDrename #define HDrename(OLD, NEW) rename(OLD, NEW) #endif #ifndef HDrewind #define HDrewind(F) rewind(F) #endif #ifndef HDrewinddir #define HDrewinddir(D) rewinddir(D) #endif #ifndef HDround #define HDround(V) round(V) #endif #ifndef HDroundf #define HDroundf(V) roundf(V) #endif #ifndef HDroundl #define HDroundl(V) roundl(V) #endif #ifndef HDrmdir #define HDrmdir(S) rmdir(S) #endif #ifndef HDscanf #define HDscanf scanf /*varargs*/ #endif #ifndef HDselect #define HDselect(N, RD, WR, ER, T) select(N, RD, WR, ER, T) #endif #ifndef HDsetbuf #define HDsetbuf(F, S) setbuf(F, S) #endif #ifndef HDsetenv #define HDsetenv(N, V, O) setenv(N, V, O) #endif #ifndef HDsetgid #define HDsetgid(G) setgid(G) #endif #ifndef HDsetjmp #define HDsetjmp(J) setjmp(J) #endif #ifndef HDsetlocale #define HDsetlocale(N, S) setlocale(N, S) #endif #ifndef HDsetpgid #define HDsetpgid(P, PG) setpgid(P, PG) #endif #ifndef HDsetsid #define HDsetsid() setsid() #endif #ifndef HDsetsockopt #define HDsetsockopt(A, B, C, D, E) setsockopt((A), (B), (C), (D), (E)) #endif #ifndef HDsetuid #define HDsetuid(U) setuid(U) #endif #ifndef HDsetvbuf #define HDsetvbuf(F, S, M, Z) setvbuf(F, S, M, Z) #endif #ifndef HDshutdown #define HDshutdown(A, B) shutdown((A), (B)) #endif #ifndef HDsigaction #define HDsigaction(S, A, O) sigaction((S), (A), (O)) #endif #ifndef HDsigaddset #define HDsigaddset(S, N) sigaddset(S, N) #endif #ifndef HDsigdelset #define HDsigdelset(S, N) sigdelset(S, N) #endif #ifndef HDsigemptyset #define HDsigemptyset(S) sigemptyset(S) #endif #ifndef HDsigfillset #define HDsigfillset(S) sigfillset(S) #endif #ifndef HDsigismember #define HDsigismember(S, N) sigismember(S, N) #endif #ifndef HDsiglongjmp #define HDsiglongjmp(J, N) siglongjmp(J, N) #endif #ifndef HDsignal #define HDsignal(N, F) signal(N, F) #endif #ifndef HDsigpending #define HDsigpending(S) sigpending(S) #endif #ifndef HDsigprocmask #define HDsigprocmask(H, S, O) sigprocmask(H, S, O) #endif #ifndef HDsigsetjmp #define HDsigsetjmp(J, N) sigsetjmp(J, N) #endif #ifndef HDsigsuspend #define HDsigsuspend(S) sigsuspend(S) #endif #ifndef HDsin #define HDsin(X) sin(X) #endif #ifndef HDsinh #define HDsinh(X) sinh(X) #endif #ifndef HDsleep #define HDsleep(N) sleep(N) #endif #ifndef HDsnprintf #define HDsnprintf snprintf /*varargs*/ #endif #ifndef HDsocket #define HDsocket(A, B, C) socket((A), (B), (C)) #endif #ifndef HDsprintf #define HDsprintf sprintf /*varargs*/ #endif #ifndef HDsqrt #define HDsqrt(X) sqrt(X) #endif #ifndef HDsscanf #define HDsscanf sscanf /*varargs*/ #endif #ifndef HDstat #define HDstat(S, B) stat(S, B) #endif #ifndef HDstrcat #define HDstrcat(X, Y) strcat(X, Y) #endif #ifndef HDstrcasestr #if defined(H5_HAVE_STRCASESTR) #define HDstrcasestr(X, Y) strcasestr(X, Y) #else #define HDstrcasestr(X, Y) H5_strcasestr(X, Y) #endif #endif #ifndef HDstrchr #define HDstrchr(S, C) strchr(S, C) #endif #ifndef HDstrcmp #define HDstrcmp(X, Y) strcmp(X, Y) #endif #ifndef HDstrcasecmp #define HDstrcasecmp(X, Y) strcasecmp(X, Y) #endif #ifndef HDstrcoll #define HDstrcoll(X, Y) strcoll(X, Y) #endif #ifndef HDstrcpy #define HDstrcpy(X, Y) strcpy(X, Y) #endif #ifndef HDstrcspn #define HDstrcspn(X, Y) strcspn(X, Y) #endif #ifndef HDstrdup #define HDstrdup(S) strdup(S) #endif #ifndef HDstrerror #define HDstrerror(N) strerror(N) #endif #ifndef HDstrftime #define HDstrftime(S, Z, F, T) strftime(S, Z, F, T) #endif #ifndef HDstrlen #define HDstrlen(S) strlen(S) #endif #ifndef HDstrnlen #define HDstrnlen(S, L) strnlen(S, L) #endif #ifndef HDstrncat #define HDstrncat(X, Y, Z) strncat(X, Y, Z) #endif #ifndef HDstrncmp #define HDstrncmp(X, Y, Z) strncmp(X, Y, Z) #endif #ifndef HDstrncpy #define HDstrncpy(X, Y, Z) strncpy(X, Y, Z) #endif #ifndef HDstrndup #define HDstrndup(S, N) strndup(S, N) #endif #ifndef HDstrpbrk #define HDstrpbrk(X, Y) strpbrk(X, Y) #endif #ifndef HDstrrchr #define HDstrrchr(S, C) strrchr(S, C) #endif #ifndef HDstrspn #define HDstrspn(X, Y) strspn(X, Y) #endif #ifndef HDstrstr #define HDstrstr(X, Y) strstr(X, Y) #endif #ifndef HDstrtod #define HDstrtod(S, R) strtod(S, R) #endif #ifndef HDstrtok #define HDstrtok(X, Y) strtok(X, Y) #endif #ifndef HDstrtok_r #define HDstrtok_r(X, Y, Z) strtok_r(X, Y, Z) #endif #ifndef HDstrtol #define HDstrtol(S, R, N) strtol(S, R, N) #endif #ifndef HDstrtoll #define HDstrtoll(S, R, N) strtoll(S, R, N) #endif #ifndef HDstrtoul #define HDstrtoul(S, R, N) strtoul(S, R, N) #endif #ifndef HDstrtoull #define HDstrtoull(S, R, N) strtoull(S, R, N) #endif #ifndef HDstrtoumax #define HDstrtoumax(S, R, N) strtoumax(S, R, N) #endif #ifndef HDstrxfrm #define HDstrxfrm(X, Y, Z) strxfrm(X, Y, Z) #endif #ifndef HDsymlink #define HDsymlink(F1, F2) symlink(F1, F2) #endif #ifndef HDsysconf #define HDsysconf(N) sysconf(N) #endif #ifndef HDsystem #define HDsystem(S) system(S) #endif #ifndef HDtan #define HDtan(X) tan(X) #endif #ifndef HDtanh #define HDtanh(X) tanh(X) #endif #ifndef HDtcdrain #define HDtcdrain(F) tcdrain(F) #endif #ifndef HDtcflow #define HDtcflow(F, A) tcflow(F, A) #endif #ifndef HDtcflush #define HDtcflush(F, N) tcflush(F, N) #endif #ifndef HDtcgetattr #define HDtcgetattr(F, T) tcgetattr(F, T) #endif #ifndef HDtcgetpgrp #define HDtcgetpgrp(F) tcgetpgrp(F) #endif #ifndef HDtcsendbreak #define HDtcsendbreak(F, N) tcsendbreak(F, N) #endif #ifndef HDtcsetattr #define HDtcsetattr(F, O, T) tcsetattr(F, O, T) #endif #ifndef HDtcsetpgrp #define HDtcsetpgrp(F, N) tcsetpgrp(F, N) #endif #ifndef HDtime #define HDtime(T) time(T) #endif #ifndef HDtimes #define HDtimes(T) times(T) #endif #ifndef HDtmpfile #define HDtmpfile() tmpfile() #endif #ifndef HDtmpnam #define HDtmpnam(S) tmpnam(S) #endif #ifndef HDtolower #define HDtolower(C) tolower(C) #endif #ifndef HDtoupper #define HDtoupper(C) toupper(C) #endif #ifndef HDttyname #define HDttyname(F) ttyname(F) #endif #ifndef HDtzset #define HDtzset() tzset() #endif #ifndef HDumask #define HDumask(N) umask(N) #endif #ifndef HDuname #define HDuname(S) uname(S) #endif #ifndef HDungetc #define HDungetc(C, F) ungetc(C, F) #endif #ifndef HDunlink #define HDunlink(S) unlink(S) #endif #ifndef HDunsetenv #define HDunsetenv(S) unsetenv(S) #endif #ifndef HDutime #define HDutime(S, T) utime(S, T) #endif #ifndef HDvasprintf #ifdef H5_HAVE_VASPRINTF #define HDvasprintf(RET, FMT, A) vasprintf(RET, FMT, A) #else H5_DLL int HDvasprintf(char **bufp, const char *fmt, va_list _ap); #endif #endif #ifndef HDva_arg #define HDva_arg(A, T) va_arg(A, T) #endif #ifndef HDva_copy #define HDva_copy(D, S) va_copy(D, S) #endif #ifndef HDva_end #define HDva_end(A) va_end(A) #endif #ifndef HDva_start #define HDva_start(A, P) va_start(A, P) #endif #ifndef HDvfprintf #define HDvfprintf(F, FMT, A) vfprintf(F, FMT, A) #endif #ifndef HDvprintf #define HDvprintf(FMT, A) vprintf(FMT, A) #endif #ifndef HDvsprintf #define HDvsprintf(S, FMT, A) vsprintf(S, FMT, A) #endif #ifndef HDvsnprintf #define HDvsnprintf(S, N, FMT, A) vsnprintf(S, N, FMT, A) #endif #ifndef HDwait #define HDwait(W) wait(W) #endif #ifndef HDwaitpid #define HDwaitpid(P, W, O) waitpid(P, W, O) #endif #ifndef HDwcstombs #define HDwcstombs(S, P, Z) wcstombs(S, P, Z) #endif #ifndef HDwctomb #define HDwctomb(S, C) wctomb(S, C) #endif #ifndef HDwrite #define HDwrite(F, M, Z) write(F, M, Z) #endif /* Macro for "stringizing" an integer in the C preprocessor (use H5_TOSTRING) */ /* (use H5_TOSTRING, H5_STRINGIZE is just part of the implementation) */ #define H5_STRINGIZE(x) #x #define H5_TOSTRING(x) H5_STRINGIZE(x) /* Macro for "glueing" together items, for re-scanning macros */ #define H5_GLUE(x, y) x##y #define H5_GLUE3(x, y, z) x##y##z #define H5_GLUE4(w, x, y, z) w##x##y##z /* * A macro for detecting over/under-flow when casting between types */ #ifndef NDEBUG #define H5_CHECK_OVERFLOW(var, vartype, casttype) \ { \ casttype _tmp_overflow = (casttype)(var); \ HDassert((var) == (vartype)_tmp_overflow); \ } #else /* NDEBUG */ #define H5_CHECK_OVERFLOW(var, vartype, casttype) #endif /* NDEBUG */ /* * A macro for detecting over/under-flow when assigning between types */ #ifndef NDEBUG #define ASSIGN_TO_SMALLER_SIZE(dst, dsttype, src, srctype) \ { \ srctype _tmp_src = (srctype)(src); \ dsttype _tmp_dst = (dsttype)(_tmp_src); \ HDassert(_tmp_src == (srctype)_tmp_dst); \ (dst) = _tmp_dst; \ } #define ASSIGN_TO_LARGER_SIZE_SAME_SIGNED(dst, dsttype, src, srctype) (dst) = (dsttype)(src); #define ASSIGN_TO_LARGER_SIZE_SIGNED_TO_UNSIGNED(dst, dsttype, src, srctype) \ { \ srctype _tmp_src = (srctype)(src); \ dsttype _tmp_dst = (dsttype)(_tmp_src); \ HDassert(_tmp_src >= 0); \ HDassert(_tmp_src == (srctype)_tmp_dst); \ (dst) = _tmp_dst; \ } #define ASSIGN_TO_LARGER_SIZE_UNSIGNED_TO_SIGNED(dst, dsttype, src, srctype) (dst) = (dsttype)(src); #define ASSIGN_TO_SAME_SIZE_UNSIGNED_TO_SIGNED(dst, dsttype, src, srctype) \ { \ srctype _tmp_src = (srctype)(src); \ dsttype _tmp_dst = (dsttype)(_tmp_src); \ HDassert(_tmp_dst >= 0); \ HDassert(_tmp_src == (srctype)_tmp_dst); \ (dst) = _tmp_dst; \ } #define ASSIGN_TO_SAME_SIZE_SIGNED_TO_UNSIGNED(dst, dsttype, src, srctype) \ { \ srctype _tmp_src = (srctype)(src); \ dsttype _tmp_dst = (dsttype)(_tmp_src); \ HDassert(_tmp_src >= 0); \ HDassert(_tmp_src == (srctype)_tmp_dst); \ (dst) = _tmp_dst; \ } #define ASSIGN_TO_SAME_SIZE_SAME_SIGNED(dst, dsttype, src, srctype) (dst) = (dsttype)(src); /* Include the generated overflow header file */ #include "H5overflow.h" /* Assign a variable to one of a different size (think safer dst = (dsttype)src"). * The code generated by the macro checks for overflows. * * Use w##x##y##z instead of H5_GLUE4(w, x, y, z) because srctype * or dsttype on some systems (e.g., NetBSD 8 and earlier) may * supply some standard types using a macro---e.g., * #define uint8_t __uint8_t. The preprocessor will expand the * macros before it evaluates H5_GLUE4(), and that will generate * an unexpected name such as ASSIGN___uint8_t_TO___uint16_t. * The preprocessor does not expand macros in w##x##y##z, so * that will always generate the expected name. */ #define H5_CHECKED_ASSIGN(dst, dsttype, src, srctype) \ ASSIGN_##srctype##_TO_##dsttype(dst, dsttype, src, srctype) #else /* NDEBUG */ #define H5_CHECKED_ASSIGN(dst, dsttype, src, srctype) (dst) = (dsttype)(src); #endif /* NDEBUG */ #if defined(H5_HAVE_WINDOW_PATH) /* directory delimiter for Windows: slash and backslash are acceptable on Windows */ #define H5_DIR_SLASH_SEPC '/' #define H5_DIR_SEPC '\\' #define H5_DIR_SEPS "\\" #define H5_CHECK_DELIMITER(SS) ((SS == H5_DIR_SEPC) || (SS == H5_DIR_SLASH_SEPC)) #define H5_CHECK_ABSOLUTE(NAME) ((HDisalpha(NAME[0])) && (NAME[1] == ':') && (H5_CHECK_DELIMITER(NAME[2]))) #define H5_CHECK_ABS_DRIVE(NAME) ((HDisalpha(NAME[0])) && (NAME[1] == ':')) #define H5_CHECK_ABS_PATH(NAME) (H5_CHECK_DELIMITER(NAME[0])) #define H5_GET_LAST_DELIMITER(NAME, ptr) \ { \ char *slash, *backslash; \ \ slash = HDstrrchr(NAME, H5_DIR_SLASH_SEPC); \ backslash = HDstrrchr(NAME, H5_DIR_SEPC); \ if (backslash > slash) \ (ptr = backslash); \ else \ (ptr = slash); \ } #else /* H5_HAVE_WINDOW_PATH */ #define H5_DIR_SEPC '/' #define H5_DIR_SEPS "/" #define H5_CHECK_DELIMITER(SS) (SS == H5_DIR_SEPC) #define H5_CHECK_ABSOLUTE(NAME) (H5_CHECK_DELIMITER(*NAME)) #define H5_CHECK_ABS_DRIVE(NAME) (0) #define H5_CHECK_ABS_PATH(NAME) (0) #define H5_GET_LAST_DELIMITER(NAME, ptr) ptr = HDstrrchr(NAME, H5_DIR_SEPC); #endif /* H5_HAVE_WINDOW_PATH */ #define H5_COLON_SEPC ':' /* * These macros check whether debugging has been requested for a certain * package at run-time. Code for debugging is conditionally compiled by * defining constants like `H5X_DEBUG'. In order to see the output though * the code must be enabled at run-time with an environment variable * HDF5_DEBUG which is a list of packages to debug. * * Note: If you add/remove items from this enum then be sure to update the * information about the package in H5_init_library(). */ typedef enum { H5_PKG_A, /* Attributes */ H5_PKG_AC, /* Metadata cache */ H5_PKG_B, /* B-trees */ H5_PKG_D, /* Datasets */ H5_PKG_E, /* Error handling */ H5_PKG_F, /* Files */ H5_PKG_G, /* Groups */ H5_PKG_HG, /* Global heaps */ H5_PKG_HL, /* Local heaps */ H5_PKG_I, /* IDs */ H5_PKG_M, /* Maps */ H5_PKG_MF, /* File memory management */ H5_PKG_MM, /* Core memory management */ H5_PKG_O, /* Object headers */ H5_PKG_P, /* Property lists */ H5_PKG_S, /* Dataspaces */ H5_PKG_T, /* Datatypes */ H5_PKG_V, /* Vector functions */ H5_PKG_VL, /* VOL functions */ H5_PKG_Z, /* Raw data filters */ H5_NPKGS /* Must be last */ } H5_pkg_t; typedef struct H5_debug_open_stream_t { FILE *stream; /* Open output stream */ struct H5_debug_open_stream_t *next; /* Next open output stream */ } H5_debug_open_stream_t; typedef struct H5_debug_t { FILE *trace; /*API trace output stream */ hbool_t ttop; /*Show only top-level calls? */ hbool_t ttimes; /*Show trace event times? */ struct { const char *name; /*package name */ FILE *stream; /*output stream or NULL */ } pkg[H5_NPKGS]; H5_debug_open_stream_t *open_stream; /* Stack of open output streams */ } H5_debug_t; #ifdef H5_HAVE_PARALLEL /* * Check that the MPI library version is at least version * `mpi_version` and subversion `mpi_subversion` */ #define H5_CHECK_MPI_VERSION(mpi_version, mpi_subversion) \ ((MPI_VERSION > (mpi_version)) || \ ((MPI_VERSION == (mpi_version)) && (MPI_SUBVERSION >= (mpi_subversion)))) extern hbool_t H5_coll_api_sanity_check_g; #endif /* H5_HAVE_PARALLEL */ extern H5_debug_t H5_debug_g; #define H5DEBUG(X) (H5_debug_g.pkg[H5_PKG_##X].stream) /* Do not use const else AIX strings does not show it. */ extern char H5libhdf5_settings[]; /* embedded library information */ /*------------------------------------------------------------------------- * Purpose: These macros are inserted automatically just after the * FUNC_ENTER() macro of API functions and are used to trace * application program execution. Unless H5_DEBUG_API has been * defined they are no-ops. * * Arguments: R - Return type encoded as a string * T - Argument types encoded as a string * A0-An - Arguments. The number at the end of the macro name * indicates the number of arguments. * *------------------------------------------------------------------------- */ #ifdef H5_DEBUG_API #define H5TRACE_DECL \ const char *RTYPE = NULL; \ double CALLTIME; #define H5TRACE0(R, T) \ RTYPE = R; \ CALLTIME = H5_trace(NULL, __func__, T) #define H5TRACE1(R, T, A0) \ RTYPE = R; \ CALLTIME = H5_trace(NULL, __func__, T, #A0, A0) #define H5TRACE2(R, T, A0, A1) \ RTYPE = R; \ CALLTIME = H5_trace(NULL, __func__, T, #A0, A0, #A1, A1) #define H5TRACE3(R, T, A0, A1, A2) \ RTYPE = R; \ CALLTIME = H5_trace(NULL, __func__, T, #A0, A0, #A1, A1, #A2, A2) #define H5TRACE4(R, T, A0, A1, A2, A3) \ RTYPE = R; \ CALLTIME = H5_trace(NULL, __func__, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3) #define H5TRACE5(R, T, A0, A1, A2, A3, A4) \ RTYPE = R; \ CALLTIME = H5_trace(NULL, __func__, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4) #define H5TRACE6(R, T, A0, A1, A2, A3, A4, A5) \ RTYPE = R; \ CALLTIME = H5_trace(NULL, __func__, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4, #A5, A5) #define H5TRACE7(R, T, A0, A1, A2, A3, A4, A5, A6) \ RTYPE = R; \ CALLTIME = H5_trace(NULL, __func__, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4, #A5, A5, #A6, A6) #define H5TRACE8(R, T, A0, A1, A2, A3, A4, A5, A6, A7) \ RTYPE = R; \ CALLTIME = \ H5_trace(NULL, __func__, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4, #A5, A5, #A6, A6, #A7, A7) #define H5TRACE9(R, T, A0, A1, A2, A3, A4, A5, A6, A7, A8) \ RTYPE = R; \ CALLTIME = H5_trace(NULL, __func__, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4, #A5, A5, #A6, A6, \ #A7, A7, #A8, A8) #define H5TRACE10(R, T, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9) \ RTYPE = R; \ CALLTIME = H5_trace(NULL, __func__, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4, #A5, A5, #A6, A6, \ #A7, A7, #A8, A8, #A9, A9) #define H5TRACE11(R, T, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10) \ RTYPE = R; \ CALLTIME = H5_trace(NULL, __func__, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4, #A5, A5, #A6, A6, \ #A7, A7, #A8, A8, #A9, A9, #A10, A10) #define H5TRACE12(R, T, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11) \ RTYPE = R; \ CALLTIME = H5_trace(NULL, __func__, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4, #A5, A5, #A6, A6, \ #A7, A7, #A8, A8, #A9, A9, #A10, A10, #A11, A11) #define H5TRACE_RETURN(V) \ if (RTYPE) { \ H5_trace(&CALLTIME, __func__, RTYPE, NULL, V); \ RTYPE = NULL; \ } #else #define H5TRACE_DECL /*void*/ #define H5TRACE0(R, T) /*void*/ #define H5TRACE1(R, T, A0) /*void*/ #define H5TRACE2(R, T, A0, A1) /*void*/ #define H5TRACE3(R, T, A0, A1, A2) /*void*/ #define H5TRACE4(R, T, A0, A1, A2, A3) /*void*/ #define H5TRACE5(R, T, A0, A1, A2, A3, A4) /*void*/ #define H5TRACE6(R, T, A0, A1, A2, A3, A4, A5) /*void*/ #define H5TRACE7(R, T, A0, A1, A2, A3, A4, A5, A6) /*void*/ #define H5TRACE8(R, T, A0, A1, A2, A3, A4, A5, A6, A7) /*void*/ #define H5TRACE9(R, T, A0, A1, A2, A3, A4, A5, A6, A7, A8) /*void*/ #define H5TRACE10(R, T, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9) /*void*/ #define H5TRACE11(R, T, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10) /*void*/ #define H5TRACE12(R, T, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11) /*void*/ #define H5TRACE_RETURN(V) /*void*/ #endif /* H5_DEBUG_API */ /* Argument tracing macros (defined all the time) */ #define H5ARG_TRACE0(C, T) C, T #define H5ARG_TRACE1(C, T, A0) C, T, #A0, A0 #define H5ARG_TRACE2(C, T, A0, A1) C, T, #A0, A0, #A1, A1 #define H5ARG_TRACE3(C, T, A0, A1, A2) C, T, #A0, A0, #A1, A1, #A2, A2 #define H5ARG_TRACE4(C, T, A0, A1, A2, A3) C, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3 #define H5ARG_TRACE5(C, T, A0, A1, A2, A3, A4) C, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4 #define H5ARG_TRACE6(C, T, A0, A1, A2, A3, A4, A5) C, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4, #A5, A5 #define H5ARG_TRACE7(C, T, A0, A1, A2, A3, A4, A5, A6) \ C, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4, #A5, A5, #A6, A6 #define H5ARG_TRACE8(C, T, A0, A1, A2, A3, A4, A5, A6, A7) \ C, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4, #A5, A5, #A6, A6, #A7, A7 #define H5ARG_TRACE9(C, T, A0, A1, A2, A3, A4, A5, A6, A7, A8) \ C, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4, #A5, A5, #A6, A6, #A7, A7, #A8, A8 #define H5ARG_TRACE10(C, T, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9) \ C, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4, #A5, A5, #A6, A6, #A7, A7, #A8, A8, #A9, A9 #define H5ARG_TRACE11(C, T, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10) \ C, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4, #A5, A5, #A6, A6, #A7, A7, #A8, A8, #A9, A9, #A10, A10 #define H5ARG_TRACE12(C, T, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11) \ C, T, #A0, A0, #A1, A1, #A2, A2, #A3, A3, #A4, A4, #A5, A5, #A6, A6, #A7, A7, #A8, A8, #A9, A9, #A10, \ A10, #A11, A11 struct H5RS_str_t; H5_DLL double H5_trace(const double *calltime, const char *func, const char *type, ...); H5_DLL herr_t H5_trace_args(struct H5RS_str_t *rs, const char *type, va_list ap); /*------------------------------------------------------------------------- * Purpose: Register function entry for library initialization and code * profiling. * * Notes: Every file must have a file-scope variable called * `initialize_interface_g' of type hbool_t which is initialized * to FALSE. * * Don't use local variable initializers which contain * calls to other library functions since the initializer * would happen before the FUNC_ENTER() gets called. Don't * use initializers that require special cleanup code to * execute if FUNC_ENTER() fails since a failing FUNC_ENTER() * returns immediately without branching to the `done' label. * * Programmer: Quincey Koziol * *------------------------------------------------------------------------- */ /* `S' is the name of a function which is being tested to check if it's * an API function. * * BADNESS: * - Underscore at positions 2 or 3 (0-indexed string). Handles * H5_ and H5X_. * - Underscore at position 4 if position 3 is uppercase or a digit. * Handles H5XY_. */ #define H5_IS_API(S) \ ('_' != ((const char *)S)[2] /* underscore at position 2 */ \ && '_' != ((const char *)S)[3] /* underscore at position 3 */ \ && !( /* NOT */ \ ((const char *)S)[4] /* pos 4 exists */ \ && (HDisupper(S[3]) || HDisdigit(S[3])) /* pos 3 dig | uc */ \ && '_' == ((const char *)S)[4] /* pos 4 underscore */ \ )) /* `S' is the name of a function which is being tested to check if it's */ /* a public API function */ #define H5_IS_PUB(S) \ (((HDisdigit(S[1]) || HDisupper(S[1])) && HDislower(S[2])) || \ ((HDisdigit(S[2]) || HDisupper(S[2])) && HDislower(S[3])) || \ (!S[4] || ((HDisdigit(S[3]) || HDisupper(S[3])) && HDislower(S[4])))) /* `S' is the name of a function which is being tested to check if it's */ /* a private library function */ #define H5_IS_PRIV(S) \ (((HDisdigit(S[1]) || HDisupper(S[1])) && '_' == S[2] && HDislower(S[3])) || \ ((HDisdigit(S[2]) || HDisupper(S[2])) && '_' == S[3] && HDislower(S[4])) || \ ((HDisdigit(S[3]) || HDisupper(S[3])) && '_' == S[4] && HDislower(S[5]))) /* `S' is the name of a function which is being tested to check if it's */ /* a package private function */ #define H5_IS_PKG(S) \ (((HDisdigit(S[1]) || HDisupper(S[1])) && '_' == S[2] && '_' == S[3] && HDislower(S[4])) || \ ((HDisdigit(S[2]) || HDisupper(S[2])) && '_' == S[3] && '_' == S[4] && HDislower(S[5])) || \ ((HDisdigit(S[3]) || HDisupper(S[3])) && '_' == S[4] && '_' == S[5] && HDislower(S[6]))) /* global library version information string */ extern char H5_lib_vers_info_g[]; #include "H5TSprivate.h" /* Lock headers */ #ifdef H5_HAVE_THREADSAFE /* replacement structure for original global variable */ typedef struct H5_api_struct { H5TS_mutex_t init_lock; /* API entrance mutex */ hbool_t H5_libinit_g; /* Has the library been initialized? */ hbool_t H5_libterm_g; /* Is the library being shutdown? */ } H5_api_t; /* Macros for accessing the global variables */ #define H5_INIT_GLOBAL (H5_g.H5_libinit_g) #define H5_TERM_GLOBAL (H5_g.H5_libterm_g) /* Macro for first thread initialization */ #ifdef H5_HAVE_WIN_THREADS #define H5_FIRST_THREAD_INIT InitOnceExecuteOnce(&H5TS_first_init_g, H5TS_win32_process_enter, NULL, NULL); #else #define H5_FIRST_THREAD_INIT pthread_once(&H5TS_first_init_g, H5TS_pthread_first_thread_init); #endif /* Macros for threadsafe HDF-5 Phase I locks */ #define H5_API_LOCK H5TS_mutex_lock(&H5_g.init_lock); #define H5_API_UNLOCK H5TS_mutex_unlock(&H5_g.init_lock); /* Macros for thread cancellation-safe mechanism */ #define H5_API_UNSET_CANCEL H5TS_cancel_count_inc(); #define H5_API_SET_CANCEL H5TS_cancel_count_dec(); extern H5_api_t H5_g; #else /* H5_HAVE_THREADSAFE */ /* disable any first thread init mechanism */ #define H5_FIRST_THREAD_INIT /* disable locks (sequential version) */ #define H5_API_LOCK #define H5_API_UNLOCK /* disable cancellability (sequential version) */ #define H5_API_UNSET_CANCEL #define H5_API_SET_CANCEL /* extern global variables */ extern hbool_t H5_libinit_g; /* Has the library been initialized? */ extern hbool_t H5_libterm_g; /* Is the library being shutdown? */ /* Macros for accessing the global variables */ #define H5_INIT_GLOBAL (H5_libinit_g) #define H5_TERM_GLOBAL (H5_libterm_g) #endif /* H5_HAVE_THREADSAFE */ /* Extern global to determine if we should use selection I/O if available (this * variable should be removed once selection I/O performs as well as the * previous scalar I/O implementation * * NOTE: Must be exposed via H5_DLLVAR so parallel tests pass on Windows. */ H5_DLLVAR hbool_t H5_use_selection_io_g; #ifdef H5_HAVE_CODESTACK /* Include required function stack header */ #include "H5CSprivate.h" #define H5_PUSH_FUNC H5CS_push(__func__); #define H5_POP_FUNC H5CS_pop(); #else /* H5_HAVE_CODESTACK */ #define H5_PUSH_FUNC /* void */ #define H5_POP_FUNC /* void */ #endif /* H5_HAVE_CODESTACK */ /* Forward declaration of H5CXpush() / H5CXpop() */ /* (Including H5CXprivate.h creates bad circular dependencies - QAK, 3/18/2018) */ H5_DLL herr_t H5CX_push(void); H5_DLL herr_t H5CX_pop(hbool_t update_dxpl_props); #ifndef NDEBUG #define FUNC_ENTER_CHECK_NAME(asrt) \ { \ static hbool_t func_check = FALSE; \ \ if (!func_check) { \ /* Check function naming status */ \ HDassert(asrt && \ "Function naming conventions are incorrect - check H5_IS_API|PUB|PRIV|PKG macros in " \ "H5private.h (this is usually due to an incorrect number of underscores)"); \ \ /* Don't check again */ \ func_check = TRUE; \ } /* end if */ \ } /* end scope */ #else /* NDEBUG */ #define FUNC_ENTER_CHECK_NAME(asrt) #endif /* NDEBUG */ #define FUNC_ENTER_COMMON(asrt) \ hbool_t err_occurred = FALSE; \ \ FUNC_ENTER_CHECK_NAME(asrt); #define FUNC_ENTER_COMMON_NOERR(asrt) FUNC_ENTER_CHECK_NAME(asrt); /* Threadsafety initialization code for API routines */ #define FUNC_ENTER_API_THREADSAFE \ /* Initialize the thread-safe code */ \ H5_FIRST_THREAD_INIT \ \ /* Grab the mutex for the library */ \ H5_API_UNSET_CANCEL \ H5_API_LOCK /* Local variables for API routines */ #define FUNC_ENTER_API_VARS H5TRACE_DECL #define FUNC_ENTER_API_COMMON \ FUNC_ENTER_API_VARS \ FUNC_ENTER_COMMON(H5_IS_API(__func__)); \ FUNC_ENTER_API_THREADSAFE; #define FUNC_ENTER_API_INIT(err) \ /* Initialize the library */ \ if (!H5_INIT_GLOBAL && !H5_TERM_GLOBAL) { \ if (H5_init_library() < 0) \ HGOTO_ERROR(H5E_FUNC, H5E_CANTINIT, err, "library initialization failed") \ } #define FUNC_ENTER_API_PUSH(err) \ /* Push the name of this function on the function stack */ \ H5_PUSH_FUNC \ \ /* Push the API context */ \ if (H5CX_push() < 0) \ HGOTO_ERROR(H5E_FUNC, H5E_CANTSET, err, "can't set API context") \ else \ api_ctx_pushed = TRUE; /* Use this macro for all "normal" API functions */ #define FUNC_ENTER_API(err) \ { \ { \ hbool_t api_ctx_pushed = FALSE; \ \ FUNC_ENTER_API_COMMON \ FUNC_ENTER_API_INIT(err); \ FUNC_ENTER_API_PUSH(err); \ /* Clear thread error stack entering public functions */ \ H5E_clear_stack(NULL); \ { /* * Use this macro for API functions that shouldn't clear the error stack * like H5Eprint and H5Ewalk. */ #define FUNC_ENTER_API_NOCLEAR(err) \ { \ { \ hbool_t api_ctx_pushed = FALSE; \ \ FUNC_ENTER_API_COMMON \ FUNC_ENTER_API_INIT(err); \ FUNC_ENTER_API_PUSH(err); \ { /* * Use this macro for API functions that shouldn't perform _any_ initialization * of the library or an interface, just perform tracing, etc. Examples * are: H5allocate_memory, H5is_library_threadsafe, public VOL callback * wrappers (e.g. H5VLfile_create, H5VLdataset_read, etc.), etc. * */ #define FUNC_ENTER_API_NOINIT \ { \ { \ { \ FUNC_ENTER_API_COMMON \ H5_PUSH_FUNC \ { /* * Use this macro for API functions that shouldn't perform _any_ initialization * of the library or an interface or push themselves on the function * stack, just perform tracing, etc. Examples * are: H5close, H5check_version, etc. * */ #define FUNC_ENTER_API_NOINIT_NOERR_NOFS \ { \ { \ { \ { \ FUNC_ENTER_API_VARS \ FUNC_ENTER_COMMON_NOERR(H5_IS_API(__func__)); \ FUNC_ENTER_API_THREADSAFE; \ { /* * Use this macro for API functions that should only perform initialization * of the library or an interface, but not push any state (API context, * function name, etc.) examples are: H5open. * */ #define FUNC_ENTER_API_NOPUSH(err) \ { \ { \ { \ { \ { \ FUNC_ENTER_COMMON(H5_IS_API(__func__)); \ FUNC_ENTER_API_THREADSAFE; \ FUNC_ENTER_API_INIT(err); \ { /* * Use this macro for API functions that shouldn't perform _any_ initialization * of the library or an interface, or push themselves on the function * stack, or perform tracing, etc. This macro _only_ sanity checks the * API name itself. Examples are: H5TSmutex_acquire, * */ #define FUNC_ENTER_API_NAMECHECK_ONLY \ { \ { \ { \ { \ { \ { \ FUNC_ENTER_COMMON_NOERR(H5_IS_API(__func__)); \ { /* Use this macro for all "normal" non-API functions */ #define FUNC_ENTER_NOAPI(err) \ { \ FUNC_ENTER_COMMON(!H5_IS_API(__func__)); \ H5_PUSH_FUNC \ { /* Use this macro for all non-API functions, which propagate errors, but don't issue them */ #define FUNC_ENTER_NOAPI_NOERR \ { \ FUNC_ENTER_COMMON_NOERR(!H5_IS_API(__func__)); \ H5_PUSH_FUNC \ { /* * Use this macro for non-API functions which fall into these categories: * - static functions, since they must be called from a function in the * interface, the library and interface must already be * initialized. * - functions which are called during library shutdown, since we don't * want to re-initialize the library. */ #define FUNC_ENTER_NOAPI_NOINIT \ { \ FUNC_ENTER_COMMON(!H5_IS_API(__func__)); \ H5_PUSH_FUNC \ { /* * Use this macro for non-API functions which fall into these categories: * - static functions, since they must be called from a function in the * interface, the library and interface must already be * initialized. * - functions which are called during library shutdown, since we don't * want to re-initialize the library. * - functions that propagate, but don't issue errors */ #define FUNC_ENTER_NOAPI_NOINIT_NOERR \ { \ FUNC_ENTER_COMMON_NOERR(!H5_IS_API(__func__)); \ H5_PUSH_FUNC \ { /* * Use this macro for non-API functions which fall into these categories: * - functions which shouldn't push their name on the function stack * (so far, just the H5CS routines themselves) * */ #define FUNC_ENTER_NOAPI_NOFS \ { \ FUNC_ENTER_COMMON(!H5_IS_API(__func__)); \ \ { /* * Use this macro for non-API functions which fall into these categories: * - functions which shouldn't push their name on the function stack * (so far, just the H5CS routines themselves) * * This macro is used for functions which fit the above categories _and_ * also don't use the 'FUNC' variable (i.e. don't push errors on the error stack) * */ #define FUNC_ENTER_NOAPI_NOERR_NOFS \ { \ FUNC_ENTER_COMMON_NOERR(!H5_IS_API(__func__)); \ { /* * Use this macro for non-API functions that shouldn't perform _any_ initialization * of the library or an interface, or push themselves on the function * stack, or perform tracing, etc. This macro _only_ sanity checks the * API name itself. Examples are private routines in the H5TS package. * */ #define FUNC_ENTER_NOAPI_NAMECHECK_ONLY \ { \ FUNC_ENTER_COMMON_NOERR(!H5_IS_API(__func__)); /* Use the following two macros as replacements for the FUNC_ENTER_NOAPI * and FUNC_ENTER_NOAPI_NOINIT macros when the function needs to set * up a metadata tag. */ #define FUNC_ENTER_NOAPI_TAG(tag, err) \ { \ haddr_t prev_tag = HADDR_UNDEF; \ \ FUNC_ENTER_COMMON(!H5_IS_API(__func__)); \ H5AC_tag(tag, &prev_tag); \ H5_PUSH_FUNC \ { #define FUNC_ENTER_NOAPI_NOINIT_TAG(tag) \ { \ haddr_t prev_tag = HADDR_UNDEF; \ \ FUNC_ENTER_COMMON(!H5_IS_API(__func__)); \ H5AC_tag(tag, &prev_tag); \ H5_PUSH_FUNC \ { /* Use this macro for all "normal" package-level functions */ #define FUNC_ENTER_PACKAGE \ { \ FUNC_ENTER_COMMON(H5_IS_PKG(__func__)); \ H5_PUSH_FUNC \ { /* Use this macro for package-level functions which propgate errors, but don't issue them */ #define FUNC_ENTER_PACKAGE_NOERR \ { \ FUNC_ENTER_COMMON_NOERR(H5_IS_PKG(__func__)); \ H5_PUSH_FUNC \ { /* Use the following macro as replacement for the FUNC_ENTER_PACKAGE * macro when the function needs to set up a metadata tag. */ #define FUNC_ENTER_PACKAGE_TAG(tag) \ { \ haddr_t prev_tag = HADDR_UNDEF; \ \ FUNC_ENTER_COMMON(H5_IS_PKG(__func__)); \ H5AC_tag(tag, &prev_tag); \ H5_PUSH_FUNC \ { /* Use this macro for staticly-scoped functions which propgate errors, but don't issue them */ /* And that shouldn't push their name on the function stack */ #define FUNC_ENTER_PACKAGE_NOERR_NOFS \ { \ FUNC_ENTER_COMMON_NOERR(H5_IS_PKG(__func__)); \ { /* * Use this macro for non-API functions that shouldn't perform _any_ initialization * of the library or an interface, or push themselves on the function * stack, or perform tracing, etc. This macro _only_ sanity checks the * API name itself. Examples are static routines in the H5TS package. * */ #define FUNC_ENTER_PACKAGE_NAMECHECK_ONLY \ { \ FUNC_ENTER_COMMON_NOERR(H5_IS_PKG(__func__)); /*------------------------------------------------------------------------- * Purpose: Register function exit for code profiling. This should be * the last statement executed by a function. * * Programmer: Quincey Koziol * *------------------------------------------------------------------------- */ /* Threadsafety termination code for API routines */ #define FUNC_LEAVE_API_THREADSAFE \ H5_API_UNLOCK \ H5_API_SET_CANCEL #define FUNC_LEAVE_API_COMMON(ret_value) H5TRACE_RETURN(ret_value); #define FUNC_LEAVE_API(ret_value) \ ; \ } /*end scope from end of FUNC_ENTER*/ \ FUNC_LEAVE_API_COMMON(ret_value); \ if (api_ctx_pushed) { \ (void)H5CX_pop(TRUE); \ api_ctx_pushed = FALSE; \ } \ H5_POP_FUNC \ if (err_occurred) \ (void)H5E_dump_api_stack(TRUE); \ FUNC_LEAVE_API_THREADSAFE \ return (ret_value); \ } \ } /*end scope from beginning of FUNC_ENTER*/ /* Use this macro to match the FUNC_ENTER_API_NOINIT macro */ #define FUNC_LEAVE_API_NOINIT(ret_value) \ ; \ } /*end scope from end of FUNC_ENTER*/ \ FUNC_LEAVE_API_COMMON(ret_value); \ H5_POP_FUNC \ if (err_occurred) \ (void)H5E_dump_api_stack(TRUE); \ FUNC_LEAVE_API_THREADSAFE \ return (ret_value); \ } \ } \ } /*end scope from beginning of FUNC_ENTER*/ /* Use this macro to match the FUNC_ENTER_API_NOINIT_NOERR_NOFS macro */ #define FUNC_LEAVE_API_NOFS(ret_value) \ ; \ } /*end scope from end of FUNC_ENTER*/ \ FUNC_LEAVE_API_COMMON(ret_value); \ FUNC_LEAVE_API_THREADSAFE \ return (ret_value); \ } \ } \ } \ } /*end scope from beginning of FUNC_ENTER*/ /* Use this macro to match the FUNC_ENTER_API_NOPUSH macro */ #define FUNC_LEAVE_API_NOPUSH(ret_value) \ ; \ } /*end scope from end of FUNC_ENTER*/ \ if (err_occurred) \ (void)H5E_dump_api_stack(TRUE); \ FUNC_LEAVE_API_THREADSAFE \ return (ret_value); \ } \ } \ } \ } \ } /*end scope from beginning of FUNC_ENTER*/ /* Use this macro to match the FUNC_ENTER_API_NAMECHECK_ONLY macro */ #define FUNC_LEAVE_API_NAMECHECK_ONLY(ret_value) \ ; \ } /*end scope from end of FUNC_ENTER*/ \ return (ret_value); \ } \ } \ } \ } \ } \ } /*end scope from beginning of FUNC_ENTER*/ #define FUNC_LEAVE_NOAPI(ret_value) \ ; \ } /*end scope from end of FUNC_ENTER*/ \ H5_POP_FUNC \ return (ret_value); \ } /*end scope from beginning of FUNC_ENTER*/ #define FUNC_LEAVE_NOAPI_VOID \ ; \ } /*end scope from end of FUNC_ENTER*/ \ H5_POP_FUNC \ return; \ } /*end scope from beginning of FUNC_ENTER*/ /* * Use this macro for non-API functions which fall into these categories: * - functions which didn't push their name on the function stack * (so far, just the H5CS routines themselves) */ #define FUNC_LEAVE_NOAPI_NOFS(ret_value) \ ; \ } /*end scope from end of FUNC_ENTER*/ \ return (ret_value); \ } /*end scope from beginning of FUNC_ENTER*/ /* Use these macros to match the FUNC_ENTER_NOAPI_NAMECHECK_ONLY macro */ #define FUNC_LEAVE_NOAPI_NAMECHECK_ONLY(ret_value) \ return (ret_value); \ } /*end scope from beginning of FUNC_ENTER*/ #define FUNC_LEAVE_NOAPI_VOID_NAMECHECK_ONLY \ return; \ } /*end scope from beginning of FUNC_ENTER*/ /* Use this macro when exiting a function that set up a metadata tag */ #define FUNC_LEAVE_NOAPI_TAG(ret_value) \ ; \ } /*end scope from end of FUNC_ENTER*/ \ H5AC_tag(prev_tag, NULL); \ H5_POP_FUNC \ return (ret_value); \ } /*end scope from beginning of FUNC_ENTER*/ /* Macro to begin/end tagging (when FUNC_ENTER_*TAG macros are insufficient). * Make sure to use HGOTO_ERROR_TAG and HGOTO_DONE_TAG between these macros! */ #define H5_BEGIN_TAG(tag) \ { \ haddr_t prv_tag = HADDR_UNDEF; \ H5AC_tag(tag, &prv_tag); #define H5_END_TAG \ H5AC_tag(prv_tag, NULL); \ } /* Compile-time "assert" macro */ #define HDcompile_assert(e) ((void)sizeof(char[!!(e) ? 1 : -1])) /* Variants that are correct, but generate compile-time warnings in some circumstances: #define HDcompile_assert(e) do { enum { compile_assert__ = 1 / (e) }; } while(0) #define HDcompile_assert(e) do { typedef struct { unsigned int b: (e); } x; } while(0) */ /* Private typedefs */ /* Union for const/non-const pointer for use by functions that manipulate * pointers but do not write to their targets or return pointers to const * specified locations. Also used for I/O functions that work for read and * write - these functions are expected to never write to these locations in the * write case. This helps us avoid compiler warnings. */ typedef union { void *vp; const void *cvp; } H5_flexible_const_ptr_t; /* Private functions, not part of the publicly documented API */ H5_DLL herr_t H5_init_library(void); H5_DLL void H5_term_library(void); /* Functions to terminate interfaces */ H5_DLL int H5A_term_package(void); H5_DLL int H5A_top_term_package(void); H5_DLL int H5AC_term_package(void); H5_DLL int H5CX_term_package(void); H5_DLL int H5D_term_package(void); H5_DLL int H5D_top_term_package(void); H5_DLL int H5E_term_package(void); H5_DLL int H5ES_term_package(void); H5_DLL int H5F_term_package(void); H5_DLL int H5FD_term_package(void); H5_DLL int H5FL_term_package(void); H5_DLL int H5FS_term_package(void); H5_DLL int H5G_term_package(void); H5_DLL int H5G_top_term_package(void); H5_DLL int H5I_term_package(void); H5_DLL int H5L_term_package(void); H5_DLL int H5M_term_package(void); H5_DLL int H5M_top_term_package(void); H5_DLL int H5P_term_package(void); H5_DLL int H5PL_term_package(void); H5_DLL int H5R_term_package(void); H5_DLL int H5R_top_term_package(void); H5_DLL int H5S_term_package(void); H5_DLL int H5S_top_term_package(void); H5_DLL int H5SL_term_package(void); H5_DLL int H5T_term_package(void); H5_DLL int H5T_top_term_package(void); H5_DLL int H5VL_term_package(void); H5_DLL int H5Z_term_package(void); /* Checksum functions */ H5_DLL uint32_t H5_checksum_fletcher32(const void *data, size_t len); H5_DLL uint32_t H5_checksum_crc(const void *data, size_t len); H5_DLL uint32_t H5_checksum_lookup3(const void *data, size_t len, uint32_t initval); H5_DLL uint32_t H5_checksum_metadata(const void *data, size_t len, uint32_t initval); H5_DLL uint32_t H5_hash_string(const char *str); /* Time related routines */ H5_DLL time_t H5_make_time(struct tm *tm); H5_DLL void H5_nanosleep(uint64_t nanosec); H5_DLL double H5_get_time(void); /* Functions for building paths, etc. */ H5_DLL herr_t H5_build_extpath(const char *name, char **extpath /*out*/); H5_DLL herr_t H5_combine_path(const char *path1, const char *path2, char **full_name /*out*/); H5_DLL herr_t H5_dirname(const char *path, char **dirname /*out*/); H5_DLL herr_t H5_basename(const char *path, char **basename /*out*/); /* getopt(3) equivalent that papers over the lack of long options on BSD * and lack of Windows support. */ H5_DLLVAR int H5_opterr; /* get_option prints errors if this is on */ H5_DLLVAR int H5_optind; /* token pointer */ H5_DLLVAR const char *H5_optarg; /* flag argument (or value) */ enum h5_arg_level { no_arg = 0, /* doesn't take an argument */ require_arg, /* requires an argument */ optional_arg /* argument is optional */ }; /* * get_option determines which options are specified on the command line and * returns a pointer to any arguments possibly associated with the option in * the ``H5_optarg'' variable. get_option returns the shortname equivalent of * the option. The long options are specified in the following way: * * struct h5_long_options foo[] = { * { "filename", require_arg, 'f' }, * { "append", no_arg, 'a' }, * { "width", require_arg, 'w' }, * { NULL, 0, 0 } * }; * * Long named options can have arguments specified as either: * * ``--param=arg'' or ``--param arg'' * * Short named options can have arguments specified as either: * * ``-w80'' or ``-w 80'' * * and can have more than one short named option specified at one time: * * -aw80 * * in which case those options which expect an argument need to come at the * end. */ struct h5_long_options { const char *name; /* Name of the long option */ enum h5_arg_level has_arg; /* Whether we should look for an arg */ char shortval; /* The shortname equivalent of long arg * this gets returned from get_option */ }; H5_DLL int H5_get_option(int argc, const char *const *argv, const char *opt, const struct h5_long_options *l_opt); #ifdef H5_HAVE_PARALLEL /* Generic MPI functions */ H5_DLL hsize_t H5_mpi_set_bigio_count(hsize_t new_count); H5_DLL hsize_t H5_mpi_get_bigio_count(void); H5_DLL herr_t H5_mpi_comm_dup(MPI_Comm comm, MPI_Comm *comm_new); H5_DLL herr_t H5_mpi_info_dup(MPI_Info info, MPI_Info *info_new); H5_DLL herr_t H5_mpi_comm_free(MPI_Comm *comm); H5_DLL herr_t H5_mpi_info_free(MPI_Info *info); H5_DLL herr_t H5_mpi_comm_cmp(MPI_Comm comm1, MPI_Comm comm2, int *result); H5_DLL herr_t H5_mpi_info_cmp(MPI_Info info1, MPI_Info info2, int *result); H5_DLL herr_t H5_mpio_create_large_type(hsize_t num_elements, MPI_Aint stride_bytes, MPI_Datatype old_type, MPI_Datatype *new_type); H5_DLL herr_t H5_mpio_gatherv_alloc(void *send_buf, int send_count, MPI_Datatype send_type, const int recv_counts[], const int displacements[], MPI_Datatype recv_type, hbool_t allgather, int root, MPI_Comm comm, int mpi_rank, int mpi_size, void **out_buf, size_t *out_buf_num_entries); H5_DLL herr_t H5_mpio_gatherv_alloc_simple(void *send_buf, int send_count, MPI_Datatype send_type, MPI_Datatype recv_type, hbool_t allgather, int root, MPI_Comm comm, int mpi_rank, int mpi_size, void **out_buf, size_t *out_buf_num_entries); H5_DLL herr_t H5_mpio_get_file_sync_required(MPI_File fh, hbool_t *file_sync_required); #endif /* H5_HAVE_PARALLEL */ /* Functions for debugging */ H5_DLL herr_t H5_buffer_dump(FILE *stream, int indent, const uint8_t *buf, const uint8_t *marker, size_t buf_offset, size_t buf_size); #endif /* H5private_H */