summaryrefslogtreecommitdiffstats
path: root/src/H5Eprivate.h
blob: 56d5a22b3c34bfd7633eaf0916133894a1743f42 (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
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 * 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. *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */

/*
 *  Header file for error values, etc.
 */
#ifndef _H5Eprivate_H
#define _H5Eprivate_H

#include "H5Epublic.h"

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

#define H5E_NSLOTS	32	/*number of slots in an error stack	     */
#define H5E_RESERVED_ATOMS  0

/* Error class */
typedef struct H5E_cls_t {
    char *cls_name;             /* Name of error class */
    char *lib_name;             /* Name of library within class */
    char *lib_vers;             /* Version of library */
} H5E_cls_t;

/* Major or minor message */
typedef struct H5E_msg_t {
    char        *msg;           /* Message for error */
    H5E_type_t   type;          /* Type of error (major or minor) */
    H5E_cls_t   *cls;           /* Which error class this message belongs to */
} H5E_msg_t;

/* Error stack */
typedef struct H5E_t {
    size_t nused;		        /* Num slots currently used in stack  */
    H5E_error_t slot[H5E_NSLOTS];	/* Array of error records	     */
    H5E_auto_t  func;                   /* Function for 'automatic' error reporting */
    void *auto_data;                    /* Callback data for 'automatic error reporting */
} H5E_t;

/* Printing information */
typedef struct H5E_print_t {
    FILE        *stream;
    H5E_cls_t   cls;
} H5E_print_t;

/* HDF5 error class */
#define    H5E_CLS_NAME         "HDF5"
#define    H5E_CLS_LIB_NAME     "HDF5"
#define    H5E_CLS_LIB_VERS     ""              /* How to find out version number? */

/* HDF5 error class: major errors */
#define    H5E_MAJ_ARGS_MSG		"Function arguments"
#define    H5E_MAJ_RESOURCE_MSG        "Resource unavailable"
#define    H5E_MAJ_INTERNAL_MSG        "Internal HDF5 error"
#define    H5E_MAJ_FILE_MSG		"File interface"
#define    H5E_MAJ_IO_MSG		        "Low-level I/O layer"
#define    H5E_MAJ_FUNC_MSG		"Function entry/exit"
#define    H5E_MAJ_ATOM_MSG		"Atom layer"
#define    H5E_MAJ_CACHE_MSG		"Meta data cache layer"
#define    H5E_MAJ_BTREE_MSG		"B-tree layer"
#define    H5E_MAJ_SYM_MSG		        "Symbol table layer"
#define    H5E_MAJ_HEAP_MSG		"Heap layer"
#define    H5E_MAJ_OHDR_MSG		"Object header layer"
#define    H5E_MAJ_DATATYPE_MSG	        "Datatype interface"
#define    H5E_MAJ_DATASPACE_MSG	        "Dataspace interface"
#define    H5E_MAJ_DATASET_MSG	        "Dataset interface"
#define    H5E_MAJ_STORAGE_MSG	        "Data storage layer"
#define    H5E_MAJ_PLIST_MSG		"Property list interface"
#define    H5E_MAJ_ATTR_MSG		"Attribute layer"
#define    H5E_MAJ_PLINE_MSG		"Data filters layer"
#define    H5E_MAJ_EFL_MSG 		"External file list"
#define    H5E_MAJ_REFERENCE_MSG	        "References layer"
#define    H5E_MAJ_VFL_MSG		        "Virtual File Layer"
#define    H5E_MAJ_TBBT_MSG		"Threaded, Balanced, Binary Trees"
#define    H5E_MAJ_FPHDF5_MSG	        "Flexible Parallel HDF5"
#define    H5E_MAJ_TST_MSG		        "Ternary Search Trees"
#define    H5E_MAJ_RS_MSG		        "Reference Counted Strings"
#define    H5E_MAJ_ERROR_MSG		        "Error API"

/* HDF5 error class: minor errors */
    /* Argument errors */
#define    H5E_MIN_UNINITIALIZED_MSG "Information is uninitialized"
#define    H5E_MIN_UNSUPPORTED_MSG 	"Feature is unsupported"
#define    H5E_MIN_BADTYPE_MSG 	"Inappropriate type"
#define    H5E_MIN_BADRANGE_MSG 	"Out of range"
#define    H5E_MIN_BADVALUE_MSG 	"Bad value"

    /* Resource errors */
#define    H5E_MIN_NOSPACE_MSG 	"No space available for allocation"
#define    H5E_MIN_CANTCOPY_MSG 	"Unable to copy object"
#define    H5E_MIN_CANTFREE_MSG 	"Unable to free object"
#define    H5E_MIN_ALREADYEXISTS_MSG "Object already exists"
#define    H5E_MIN_CANTLOCK_MSG 	"Unable to lock object"
#define    H5E_MIN_CANTUNLOCK_MSG 	"Unable to unlock object"
#define    H5E_MIN_CANTGC_MSG 	"Unable to garbage collect"

    /* File accessability errors */
#define    H5E_MIN_FILEEXISTS_MSG 	"File already exists"
#define    H5E_MIN_FILEOPEN_MSG 	"File already open"
#define    H5E_MIN_CANTCREATE_MSG 	"Unable to create file"
#define    H5E_MIN_CANTOPENFILE_MSG 	"Unable to open file"
#define    H5E_MIN_CANTCLOSEFILE_MSG 	"Unable to close file"
#define    H5E_MIN_NOTHDF5_MSG 	"Not an HDF5 file"
#define    H5E_MIN_BADFILE_MSG 	"Bad file ID accessed"
#define    H5E_MIN_TRUNCATED_MSG 	"File has been truncated"
#define    H5E_MIN_MOUNT_MSG		"File mount error"

    /* Generic low-level file I/O errors */
#define    H5E_MIN_SEEKERROR_MSG	"Seek failed"
#define    H5E_MIN_READERROR_MSG	"Read failed"
#define    H5E_MIN_WRITEERROR_MSG 	"Write failed"
#define    H5E_MIN_CLOSEERROR_MSG 	"Close failed"
#define    H5E_MIN_OVERFLOW_MSG 	"Address overflowed"
#define    H5E_MIN_FCNTL_MSG         "File control (fcntl) failed"

    /* Function entry/exit interface errors */
#define    H5E_MIN_CANTINIT_MSG 	"Unable to initialize object"
#define    H5E_MIN_ALREADYINIT_MSG 	"Object already initialized"
#define    H5E_MIN_CANTRELEASE_MSG 	"Unable to release object"

    /* Object atom related errors */
#define    H5E_MIN_BADATOM_MSG 	"Unable to find atom information (already closed?)"
#define    H5E_MIN_BADGROUP_MSG 	"Unable to find ID group information"
#define    H5E_MIN_CANTREGISTER_MSG 	"Unable to register new atom"
#define    H5E_MIN_CANTINC_MSG      	"Unable to increment reference count"
#define    H5E_MIN_CANTDEC_MSG      	"Unable to decrement reference count"
#define    H5E_MIN_NOIDS_MSG      	"Out of IDs for group"

    /* Cache related errors */
#define    H5E_MIN_CANTFLUSH_MSG 	"Unable to flush data from cache"
#define    H5E_MIN_CANTLOAD_MSG 	"Unable to load meta data into cache"
#define    H5E_MIN_PROTECT_MSG 	"Protected meta data error"
#define    H5E_MIN_NOTCACHED_MSG 	"Meta data not currently cached"

    /* B-tree related errors */
#define    H5E_MIN_NOTFOUND_MSG 	"Object not found"
#define    H5E_MIN_EXISTS_MSG 	"Object already exists"
#define    H5E_MIN_CANTENCODE_MSG 	"Unable to encode value"
#define    H5E_MIN_CANTDECODE_MSG 	"Unable to decode value"
#define    H5E_MIN_CANTSPLIT_MSG 	"Unable to split node"
#define    H5E_MIN_CANTINSERT_MSG 	"Unable to insert object"
#define    H5E_MIN_CANTLIST_MSG 	"Unable to list node"

    /* Object header related errors */
#define    H5E_MIN_LINKCOUNT_MSG 	"Bad object header link count"
#define    H5E_MIN_VERSION_MSG 	"Wrong version number"
#define    H5E_MIN_ALIGNMENT_MSG 	"Alignment error"
#define    H5E_MIN_BADMESG_MSG 	"Unrecognized message"
#define    H5E_MIN_CANTDELETE_MSG 	"Can't delete message"

    /* Group related errors */
#define    H5E_MIN_CANTOPENOBJ_MSG	"Can't open object"
#define    H5E_MIN_COMPLEN_MSG 	"Name component is too long"
#define    H5E_MIN_CWG_MSG 		"Problem with current working group"
#define    H5E_MIN_LINK_MSG 		"Link count failure"
#define    H5E_MIN_SLINK_MSG		"Symbolic link error"

    /* Datatype conversion errors */
#define    H5E_MIN_CANTCONVERT_MSG	"Can't convert datatypes"
#define    H5E_MIN_BADSIZE_MSG	"Bad size for object"

    /* Dataspace errors */
#define    H5E_MIN_CANTCLIP_MSG	"Can't clip hyperslab region"
#define    H5E_MIN_CANTCOUNT_MSG	"Can't count elements"
#define    H5E_MIN_CANTSELECT_MSG    "Can't select hyperslab"
#define    H5E_MIN_CANTNEXT_MSG      "Can't move to next iterator location"
#define    H5E_MIN_BADSELECT_MSG     "Invalid selection"
#define    H5E_MIN_CANTCOMPARE_MSG   "Can't compare objects"

    /* Property list errors */
#define    H5E_MIN_CANTGET_MSG	"Can't get value"
#define    H5E_MIN_CANTSET_MSG	"Can't set value"
#define    H5E_MIN_DUPCLASS_MSG	"Duplicate class name in parent class"

    /* Parallel MPI errors */
#define    H5E_MIN_MPI_MSG		"Some MPI function failed"
#define    H5E_MIN_MPIERRSTR_MSG     "MPI Error String"

    /* FPHDF5 errors */
#define    H5E_MIN_CANTMAKETREE_MSG "Can't create a binary tree node"
#define    H5E_MIN_CANTRECV_MSG      "Can't receive messages from processes"
#define    H5E_MIN_CANTSENDMDATA_MSG "Can't send metadata message"
#define    H5E_MIN_CANTCHANGE_MSG   "Can't register change with server"
#define    H5E_MIN_CANTALLOC_MSG     "Can't allocate from file"

    /* I/O pipeline errors */
#define    H5E_MIN_NOFILTER_MSG      "Requested filter is not available"
#define    H5E_MIN_CALLBACK_MSG      "Callback failed"
#define    H5E_MIN_CANAPPLY_MSG      "Error from filter \"can apply\" callback"
#define    H5E_MIN_SETLOCAL_MSG      "Error from filter \"set local\" callback"

/*
 * 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, str) H5E_push(NULL, __FILE__, FUNC, __LINE__, H5E_ERR_CLS_g, maj_id, min_id, str)

/*
 * 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, str)  				              \
   HERROR(maj, min, str);						      \
   H5E_dump_api_stack(H5_IS_API(FUNC));

/*
 * 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, str) {				      \
   HCOMMON_ERROR (maj, min, str);					      \
   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, str) {				      \
   HCOMMON_ERROR (maj, min, str);					      \
   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;}

H5_DLL hid_t   H5E_register_class(const char *cls_name, const char *lib_name, 
                                const char *version);
H5_DLL herr_t  H5E_unregister_class(H5E_cls_t *cls);
H5_DLL herr_t  H5E_close_msg(H5E_msg_t *err);
H5_DLL hid_t   H5E_create_msg(hid_t cls_id, H5E_type_t msg_type, const char *msg);
H5_DLL hid_t   H5E_get_current_stack(void);
H5_DLL herr_t  H5E_close_stack(H5E_t *err_stack);
H5_DLL ssize_t H5E_get_class_name(H5E_cls_t *cls, char *name, size_t size);
H5_DLL ssize_t H5E_get_msg(H5E_msg_t *msg_ptr, H5E_type_t *type, char *msg, size_t size);
H5_DLL int     H5E_get_num(H5E_t *err_stack);
H5_DLL herr_t  H5E_set_current_stack(H5E_t *estack);
H5_DLL herr_t  H5E_push(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 *desc);
H5_DLL herr_t  H5E_pop(H5E_t *err_stack, size_t count);
H5_DLL herr_t  H5E_clear(H5E_t *estack);
H5_DLL herr_t  H5E_print(H5E_t *estack, FILE *stream);
H5_DLL herr_t  H5E_walk (H5E_t *estack, H5E_direction_t direction, H5E_walk_t func, 
                             void *client_data);
H5_DLL herr_t  H5E_get_auto(H5E_t *estack, H5E_auto_t *func, void **client_data);
H5_DLL herr_t  H5E_set_auto(H5E_t *estack, H5E_auto_t func, void *client_data);
H5_DLL herr_t  H5E_dump_api_stack(int is_api);

#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, 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

#endif