summaryrefslogtreecommitdiffstats
path: root/src/H5Eprivate.h
blob: 8e809c47c09064ffa2e95c6436218db42711b589 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
/****************************************************************************
 * NCSA HDF                                                                 *
 * Software Development Group                                               *
 * National Center for Supercomputing Applications                          *
 * University of Illinois at Urbana-Champaign                               *
 * 605 E. Springfield, Champaign IL 61820                                   *
 *                                                                          *
 * For conditions of distribution and use, see the accompanying             *
 * hdf/COPYING file.                                                        *
 *                                                                          *
 ****************************************************************************/

/* $Id$ */

/*
 *  Header file for error values, etc.
 */
#ifndef _H5Eprivate_H
#define _H5Eprivate_H
#include <H5Epublic.h>

/* Private headers needed by this file */
#include <H5private.h>

/*
   ======================================================================
   Error codes

   NOTE: Remember to update the error_messages[] structure later in this file
   whenever errors are added/deleted from this list.
   ======================================================================
 */

/* HERROR macro, used to facilitate error reporting.  Assumes that
   there's a variable called FUNC which holds the function name.
   Assume that func and file are both stored in static space, or at
   least be not corrupted in the meanwhile. */

#define HERROR(maj, min, str) H5Epush (H5E_thrdid_g, maj, min,		      \
				       FUNC, __FILE__, __LINE__, str)

/* HRETURN_ERROR macro, used to facilitate error reporting.  Makes
   same assumptions as HERROR.  IN ADDITION, this macro causes
   a return from the calling routine */

#define HRETURN_ERROR(maj, min, ret_val, str) {				      \
   HERROR (maj, min, str);						      \
   PABLO_TRACE_OFF (PABLO_MASK, pablo_func_id);				      \
   return (ret_val);							      \
}

/* HRETURN macro, similar to HRETURN_ERROR() except for success */

#define HRETURN(ret_val) {						      \
   PABLO_TRACE_OFF (PABLO_MASK, pablo_func_id);				      \
   return (ret_val);							      \
}

/* HGOTO_ERROR macro, used to facilitate error reporting.  Makes
   same assumptions as HERROR.  IN ADDITION, this macro causes
   a jump to the label 'done' which should be in every fucntion
   Also there is an assumption of a variable 'ret_value' */

#define HGOTO_ERROR(maj, min, ret_val, str) {				      \
   HERROR (maj, min,  str);						      \
   ret_value = ret_val;							      \
   goto done;								      \
}

/* HGOTO_DONE macro, used to facilitate the new error reporting model.  
   This macro is just a wrapper to set the return value and jump to the 'done'
   label.  Also assumption of a variable 'ret_value' */

#define HGOTO_DONE(ret_val) {ret_value = ret_val; goto done;}

/* H5ECLEAR macro, used to facilitate the new error reporting model.  
   This macro is just a wrapper to clear the error stack with the thread
   error ID */

#define H5ECLEAR H5Eclear(H5E_thrdid_g)

/* Maximum length of function name to push onto error stack */
#define MAX_FUNC_NAME	32

/* 
 * error_messages is the list of error messages in the system, kept as
 * error_code-message pairs.  
 */
typedef struct H5E_major_mesg_t {
   H5E_major_t error_code;
   const char *str;
} H5E_major_mesg_t;

typedef struct H5E_minor_mesg_t {
   H5E_minor_t error_code;
   const char *str;
} H5E_minor_mesg_t;

/* Function pointer to report errors through */
struct H5E_t; /*forward decl*/
typedef herr_t (*H5E_push_t)(struct H5E_t *estack, H5E_major_t maj_num,
			     H5E_minor_t min_num, const char *function_name,
			     const char *file_name, intn line,
			     const char *desc);

/*
 * We use a stack to hold the errors plus we keep track of the function, file
 * and line where the error occurs.
 */

/* the structure of the error stack element */
typedef struct H5E_error_t {
   H5E_major_t	maj_num;	/* Major error number			*/
   H5E_minor_t	min_num;    	/* Minor error number			*/
   char 	func_name[MAX_FUNC_NAME]; /* function where error occur */
   const char	*file_name;    	/* file where error occur		*/
   intn        	line;         	/* line in file where error occurs	*/
   char       	*desc;         	/* optional supplied description	*/
} H5E_error_t;

/* Structure to store error information for a thread */
typedef struct H5E_t {
   uintn	nelmts;         /* Num elements allocated in the stack	*/
   uintn	top;          	/* Index of the next open stack element	*/
   H5E_error_t	*stack;   	/* Pointer to the error stack		*/
   H5E_push_t	push;		/* Func that pushes new error on stack	*/
} H5E_t;

/* Private global variables in H5E.c */
extern hid_t H5E_thrdid_g;     	/* Thread-specific "global" error-handler ID */
extern hbool_t install_atexit;	/* Whether to install the atexit routine */

herr_t H5E_close (H5E_t *estack);
herr_t H5E_clear (H5E_t *estack);
herr_t H5E_print (H5E_t *estack, FILE *file);
herr_t H5E_push (H5E_t *estack, H5E_major_t maj_num, H5E_minor_t min_num,
		 const char *function_name, const char *file_name, intn line,
		 const char *desc);




#endif