189 lines
7.7 KiB
C
189 lines
7.7 KiB
C
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* 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://support.hdfgroup.org/ftp/HDF5/releases. *
|
|
* If you do not have access to either file, you may request a copy from *
|
|
* help@hdfgroup.org. *
|
|
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
|
|
|
|
/*
|
|
* Header file for error values, etc.
|
|
*/
|
|
#ifndef _H5Eprivate_H
|
|
#define _H5Eprivate_H
|
|
|
|
#include "H5Epublic.h"
|
|
|
|
/* Private headers needed by this file */
|
|
#include "H5private.h"
|
|
|
|
/* Typedef for error stack (defined in H5Epkg.h) */
|
|
typedef struct H5E_t H5E_t;
|
|
|
|
/*
|
|
* HERROR macro, used to facilitate error reporting between a FUNC_ENTER()
|
|
* and a FUNC_LEAVE() within a function body. The arguments are the major
|
|
* error number, the minor error number, and a description of the error.
|
|
*/
|
|
#define HERROR(maj_id, min_id, ...) H5E_printf_stack(NULL, __FILE__, FUNC, __LINE__, H5E_ERR_CLS_g, maj_id, min_id, __VA_ARGS__)
|
|
|
|
/*
|
|
* HCOMMON_ERROR macro, used by HDONE_ERROR and HGOTO_ERROR
|
|
* (Shouldn't need to be used outside this header file)
|
|
*/
|
|
#define HCOMMON_ERROR(maj, min, ...) \
|
|
HERROR(maj, min, __VA_ARGS__); \
|
|
err_occurred = TRUE; \
|
|
err_occurred = err_occurred; /* Shut GCC warnings up! */
|
|
|
|
/*
|
|
* HDONE_ERROR macro, used to facilitate error reporting between a
|
|
* FUNC_ENTER() and a FUNC_LEAVE() within a function body, but _AFTER_ the
|
|
* "done:" label. The arguments are
|
|
* the major error number, the minor error number, a return value, and a
|
|
* description of the error.
|
|
* (This macro can also be used to push an error and set the return value
|
|
* without jumping to any labels)
|
|
*/
|
|
#define HDONE_ERROR(maj, min, ret_val, ...) { \
|
|
HCOMMON_ERROR(maj, min, __VA_ARGS__); \
|
|
ret_value = ret_val; \
|
|
}
|
|
|
|
/*
|
|
* HGOTO_ERROR macro, used to facilitate error reporting between a
|
|
* FUNC_ENTER() and a FUNC_LEAVE() within a function body. The arguments are
|
|
* the major error number, the minor error number, the return value, and an
|
|
* error string. The return value is assigned to a variable `ret_value' and
|
|
* control branches to the `done' label.
|
|
*/
|
|
#define HGOTO_ERROR(maj, min, ret_val, ...) { \
|
|
HCOMMON_ERROR(maj, min, __VA_ARGS__); \
|
|
HGOTO_DONE(ret_val) \
|
|
}
|
|
|
|
/*
|
|
* HGOTO_ERROR_TAG macro, used like HGOTO_ERROR between H5_BEGIN_TAG and
|
|
* H5_END_TAG statements. Resets the metadata tag before leaving the function.
|
|
*/
|
|
#define HGOTO_ERROR_TAG(maj, min, ret_val, ...) { \
|
|
H5AC_tag(prv_tag, NULL); \
|
|
HCOMMON_ERROR(maj, min, __VA_ARGS__); \
|
|
HGOTO_DONE(ret_val) \
|
|
}
|
|
|
|
/*
|
|
* HGOTO_DONE macro, used to facilitate normal return between a FUNC_ENTER()
|
|
* and a FUNC_LEAVE() within a function body. The argument is the return
|
|
* value which is assigned to the `ret_value' variable. Control branches to
|
|
* the `done' label.
|
|
*/
|
|
#define HGOTO_DONE(ret_val) {ret_value = ret_val; goto done;}
|
|
|
|
/*
|
|
* HGOTO_DONE_TAG macro, used like HGOTO_DONE between H5_BEGIN_TAG and
|
|
* H5_END_TAG statements. Resets the metadata tag before leaving the function.
|
|
*/
|
|
#define HGOTO_DONE_TAG(ret_val) { \
|
|
H5AC_tag(prv_tag, NULL); \
|
|
HGOTO_DONE(ret_val) \
|
|
}
|
|
|
|
/*
|
|
* Macros handling system error messages as described in C standard.
|
|
* These macros assume errnum is a valid system error code.
|
|
*/
|
|
|
|
/* Retrieve the error code description string and push it onto the error
|
|
* stack.
|
|
*/
|
|
#define HSYS_DONE_ERROR(majorcode, minorcode, retcode, str) { \
|
|
int myerrno = errno; \
|
|
HDONE_ERROR(majorcode, minorcode, retcode, "%s, errno = %d, error message = '%s'", str, myerrno, HDstrerror(myerrno)); \
|
|
}
|
|
#define HSYS_GOTO_ERROR(majorcode, minorcode, retcode, str) { \
|
|
int myerrno = errno; \
|
|
HGOTO_ERROR(majorcode, minorcode, retcode, "%s, errno = %d, error message = '%s'", str, myerrno, HDstrerror(myerrno)); \
|
|
}
|
|
|
|
#ifdef H5_HAVE_PARALLEL
|
|
/*
|
|
* MPI error handling macros.
|
|
*/
|
|
|
|
extern char H5E_mpi_error_str[MPI_MAX_ERROR_STRING];
|
|
extern int H5E_mpi_error_str_len;
|
|
|
|
#define HMPI_ERROR(mpierr){ \
|
|
MPI_Error_string(mpierr, H5E_mpi_error_str, &H5E_mpi_error_str_len); \
|
|
HERROR(H5E_INTERNAL, H5E_MPIERRSTR, "%s", H5E_mpi_error_str); \
|
|
}
|
|
#define HMPI_DONE_ERROR(retcode, str, mpierr){ \
|
|
HMPI_ERROR(mpierr); \
|
|
HDONE_ERROR(H5E_INTERNAL, H5E_MPI, retcode, str); \
|
|
}
|
|
#define HMPI_GOTO_ERROR(retcode, str, mpierr){ \
|
|
HMPI_ERROR(mpierr); \
|
|
HGOTO_ERROR(H5E_INTERNAL, H5E_MPI, retcode, str); \
|
|
}
|
|
#endif /* H5_HAVE_PARALLEL */
|
|
|
|
|
|
/******************************************************************************/
|
|
/* Revisions to Error Macros, to go with Revisions to FUNC_ENTER/LEAVE Macros */
|
|
/******************************************************************************/
|
|
|
|
/*
|
|
* H5E_PRINTF macro, used to facilitate error reporting between a BEGIN_FUNC()
|
|
* and an END_FUNC() within a function body. The arguments are the minor
|
|
* error number, a description of the error (as a printf-like format string),
|
|
* and an optional set of arguments for the printf format arguments.
|
|
*/
|
|
#define H5E_PRINTF(...) H5E_printf_stack(NULL, __FILE__, FUNC, __LINE__, H5E_ERR_CLS_g, H5_MY_PKG_ERR, __VA_ARGS__)
|
|
|
|
/*
|
|
* H5_LEAVE macro, used to facilitate control flow between a
|
|
* BEGIN_FUNC() and an END_FUNC() within a function body. The argument is
|
|
* the return value.
|
|
* The return value is assigned to a variable `ret_value' and control branches
|
|
* to the `catch_except' label, if we're not already past it.
|
|
*/
|
|
#define H5_LEAVE(v) { \
|
|
ret_value = v; \
|
|
if(!past_catch) \
|
|
goto catch_except; \
|
|
}
|
|
|
|
/*
|
|
* H5E_THROW macro, used to facilitate error reporting between a
|
|
* FUNC_ENTER() and a FUNC_LEAVE() within a function body. The arguments are
|
|
* the minor error number, and an error string.
|
|
* The return value is assigned to a variable `ret_value' and control branches
|
|
* to the `catch_except' label, if we're not already past it.
|
|
*/
|
|
#define H5E_THROW(...) { \
|
|
H5E_PRINTF(__VA_ARGS__); \
|
|
H5_LEAVE(fail_value) \
|
|
}
|
|
|
|
/* Macro for "catching" flow of control when an error occurs. Note that the
|
|
* H5_LEAVE macro won't jump back here once it's past this point.
|
|
*/
|
|
#define CATCH catch_except:; past_catch = TRUE;
|
|
|
|
|
|
/* Library-private functions defined in H5E package */
|
|
H5_DLL herr_t H5E_init(void);
|
|
H5_DLL herr_t H5E_printf_stack(H5E_t *estack, const char *file, const char *func,
|
|
unsigned line, hid_t cls_id, hid_t maj_id, hid_t min_id, const char *fmt, ...) H5_ATTR_FORMAT(printf, 8, 9);
|
|
H5_DLL herr_t H5E_clear_stack(H5E_t *estack);
|
|
H5_DLL herr_t H5E_dump_api_stack(hbool_t is_api);
|
|
|
|
#endif /* _H5Eprivate_H */
|
|
|