[svn-r7355] Purpose:

    Code cleanup, etc.

Description:
    Previously (in versions prior to 1.7), there were two locations to
modify when an error was added to the library.  Now, with the new error API,
there were four.

Solution:
    Created a single text file (src/H5err.txt) and a perl script (bin/make_err)
which uses the text file to automatically create header files that are included
in appropriate places in the library.
    This means that there is only one file (src/H5err.txt) which needs to be
modified when a new error code is added to the library.  The automatically
generated headers depend on this file and the makefiles will take care of
running the perl script to regenerate them when the text file changes, so no
user action is required when a new error is added.

Platforms tested:
    h5committested

1 files changed, 204 insertions, 0 deletions

diff --git a/src/H5err.txt b/src/H5err.txt
new file mode 100644
index 0000000..58ca59f
--- /dev/null
+++ b/src/H5err.txt
@@ -0,0 +1,204 @@
+# 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.
+#
+
+# This file is used to generate the various headers that are needed for the
+# error API.  The bin/make_err script reads in this file and creates the
+# appropriate files in the src/ directory when the generated headers are out
+# of date with respect to this file.
+#
+# Blank lines and lines beginning with '#' are ignored
+#
+# The format of this file is as follows:
+#  <type>,<major section, if minor type, otherwise omitted>,<name>,<description>
+#
+# For example, the following sample input shows two major errors and two minor
+# errors in each section:
+#
+# MAJOR, H5E_ARGS, Invalid arguments to routine
+# MAJOR, H5E_RESOURCE, Resource unavailable
+#
+# SECTION, ARGS, Argument errors
+# SECTION, RESOURCE, Resource errors
+#
+# MINOR, ARGS, H5E_UNINITIALIZED, Information is uinitialized
+# MINOR, ARGS, H5E_UNSUPPORTED, Feature is unsupported
+# MINOR, RESOURCE, H5E_NOSPACE, No space available for allocation
+# MINOR, RESOURCE, H5E_CANTCOPY, unable to copy object
+#
+# The section information is just used for grouping the information in the
+# files created and can have any value.  They generally correspond to the
+# major errors, but don't have to.  The section definition for each minor error
+# must come before any minor error that uses it.
+#
+# Programmer: Quincey Koziol
+# Creation Date: 2003/08/12
+
+# Major errors
+MAJOR, H5E_ARGS, Invalid arguments to routine
+MAJOR, H5E_RESOURCE, Resource unavailable
+MAJOR, H5E_INTERNAL, Internal error (too specific to document in detail)
+MAJOR, H5E_FILE, File accessability
+MAJOR, H5E_IO, Low-level I/O
+MAJOR, H5E_FUNC, Function entry/exit
+MAJOR, H5E_ATOM, Object atom
+MAJOR, H5E_CACHE, Object cache
+MAJOR, H5E_BTREE, B-Tree node
+MAJOR, H5E_SYM, Symbol table
+MAJOR, H5E_HEAP, Heap
+MAJOR, H5E_OHDR, Object header
+MAJOR, H5E_DATATYPE, Datatype
+MAJOR, H5E_DATASPACE, Dataspace
+MAJOR, H5E_DATASET, Dataset
+MAJOR, H5E_STORAGE, Data storage
+MAJOR, H5E_PLIST, Property lists
+MAJOR, H5E_ATTR, Attribute
+MAJOR, H5E_PLINE, Data filters
+MAJOR, H5E_EFL, External file list
+MAJOR, H5E_REFERENCE, References
+MAJOR, H5E_VFL, Virtual File Layer
+MAJOR, H5E_TBBT, Threaded, Balanced, Binary Trees
+MAJOR, H5E_FPHDF5, Flexible Parallel HDF5
+MAJOR, H5E_TST, Ternary Search Trees
+MAJOR, H5E_RS, Reference Counted Strings
+MAJOR, H5E_ERROR, Error API
+
+# Sections (for grouping minor errors)
+SECTION, ARGS, Argument errors
+SECTION, RESOURCE, Resource errors
+SECTION, FILEACC, File accessability errors
+SECTION, FILE, Generic low-level file I/O errors
+SECTION, FUNC, Function entry/exit interface errors
+SECTION, ATOM, Object atom related errors
+SECTION, CACHE, Cache related errors
+SECTION, BTREE, B-tree related errors
+SECTION, OHDR, Object header related errors
+SECTION, GROUP, Group related errors
+SECTION, TYPECONV, Datatype conversion errors
+SECTION, DSPACE, Dataspace errors
+SECTION, PLIST, Property list errors
+SECTION, MPI, Parallel MPI errors
+SECTION, FPH5, FPHDF5 errors
+SECTION, PIPELINE, I/O pipeline errors
+
+# Minor errors
+
+# Argument errors
+MINOR, ARGS, H5E_UNINITIALIZED, Information is uinitialized
+MINOR, ARGS, H5E_UNSUPPORTED, Feature is unsupported
+MINOR, ARGS, H5E_BADTYPE, Inappropriate type
+MINOR, ARGS, H5E_BADRANGE, Out of range
+MINOR, ARGS, H5E_BADVALUE, Bad value
+
+# Resource errors
+MINOR, RESOURCE, H5E_NOSPACE, No space available for allocation
+MINOR, RESOURCE, H5E_CANTCOPY, Unable to copy object
+MINOR, RESOURCE, H5E_CANTFREE, Unable to free object
+MINOR, RESOURCE, H5E_ALREADYEXISTS, Object already exists
+MINOR, RESOURCE, H5E_CANTLOCK, Unable to lock object
+MINOR, RESOURCE, H5E_CANTUNLOCK, Unable to unlock object
+MINOR, RESOURCE, H5E_CANTGC, Unable to garbage collect
+
+# File accessability errors
+MINOR, FILEACC, H5E_FILEEXISTS, File already exists
+MINOR, FILEACC, H5E_FILEOPEN, File already open
+MINOR, FILEACC, H5E_CANTCREATE, Unable to create file
+MINOR, FILEACC, H5E_CANTOPENFILE, Unable to open file
+MINOR, FILEACC, H5E_CANTCLOSEFILE, Unable to close file
+MINOR, FILEACC, H5E_NOTHDF5, Not an HDF5 file
+MINOR, FILEACC, H5E_BADFILE, Bad file ID accessed
+MINOR, FILEACC, H5E_TRUNCATED, File has been truncated
+MINOR, FILEACC, H5E_MOUNT, File mount error
+
+# Generic low-level file I/O errors
+MINOR, FILE, H5E_SEEKERROR, Seek failed
+MINOR, FILE, H5E_READERROR, Read failed
+MINOR, FILE, H5E_WRITEERROR, Write failed
+MINOR, FILE, H5E_CLOSEERROR, Close failed
+MINOR, FILE, H5E_OVERFLOW, Address overflowed
+MINOR, FILE, H5E_FCNTL, File control (fcntl) failed
+
+# Function entry/exit interface errors
+MINOR, FUNC, H5E_CANTINIT, Unable to initialize object
+MINOR, FUNC, H5E_ALREADYINIT, Object already initialized
+MINOR, FUNC, H5E_CANTRELEASE, Unable to release object
+
+# Object atom related errors
+MINOR, ATOM, H5E_BADATOM, Unable to find atom information (already closed?)
+MINOR, ATOM, H5E_BADGROUP, Unable to find ID group information
+MINOR, ATOM, H5E_CANTREGISTER, Unable to register new atom
+MINOR, ATOM, H5E_CANTINC, Unable to increment reference count
+MINOR, ATOM, H5E_CANTDEC, Unable to decrement reference count
+MINOR, ATOM, H5E_NOIDS, Out of IDs for group
+
+# Cache related errors
+MINOR, CACHE, H5E_CANTFLUSH, Unable to flush data from cache
+MINOR, CACHE, H5E_CANTLOAD, Unable to load metadata into cache
+MINOR, CACHE, H5E_PROTECT, Protected metadata error
+MINOR, CACHE, H5E_NOTCACHED, Metadata not currently cached
+
+# B-tree related errors
+MINOR, BTREE, H5E_NOTFOUND, Object not found
+MINOR, BTREE, H5E_EXISTS, Object already exists
+MINOR, BTREE, H5E_CANTENCODE, Unable to encode value
+MINOR, BTREE, H5E_CANTDECODE, Unable to decode value
+MINOR, BTREE, H5E_CANTSPLIT, Unable to split node
+MINOR, BTREE, H5E_CANTINSERT, Unable to insert object
+MINOR, BTREE, H5E_CANTLIST, Unable to list node
+
+# Object header related errors
+MINOR, OHDR, H5E_LINKCOUNT, Bad object header link count
+MINOR, OHDR, H5E_VERSION, Wrong version number
+MINOR, OHDR, H5E_ALIGNMENT, Alignment error
+MINOR, OHDR, H5E_BADMESG, Unrecognized message
+MINOR, OHDR, H5E_CANTDELETE, Can't delete message
+
+# Group related errors
+MINOR, GROUP, H5E_CANTOPENOBJ, Can't open object
+MINOR, GROUP, H5E_COMPLEN, Name component is too long
+MINOR, GROUP, H5E_CWG, Problem with current working group
+MINOR, GROUP, H5E_LINK, Link count failure
+MINOR, GROUP, H5E_SLINK, Symbolic link error
+
+# Datatype conversion errors
+MINOR, TYPECONV, H5E_CANTCONVERT, Can't convert datatypes
+MINOR, TYPECONV, H5E_BADSIZE, Bad size for object
+
+# Dataspace errors
+MINOR, DSPACE, H5E_CANTCLIP, Can't clip hyperslab region
+MINOR, DSPACE, H5E_CANTCOUNT, Can't count elements
+MINOR, DSPACE, H5E_CANTSELECT, Can't select hyperslab
+MINOR, DSPACE, H5E_CANTNEXT, Can't move to next iterator location
+MINOR, DSPACE, H5E_BADSELECT, Invalid selection
+MINOR, DSPACE, H5E_CANTCOMPARE, Can't compare objects
+
+# Property list errors
+MINOR, PLIST, H5E_CANTGET, Can't get value
+MINOR, PLIST, H5E_CANTSET, Can't set value
+MINOR, PLIST, H5E_DUPCLASS, Duplicate class name in parent class
+
+# Parallel MPI errors
+MINOR, MPI, H5E_MPI, Some MPI function failed
+MINOR, MPI, H5E_MPIERRSTR, MPI Error String
+
+# FPHDF5 errors
+MINOR, FPH5, H5E_CANTMAKETREE, Can't create a binary tree node
+MINOR, FPH5, H5E_CANTRECV, Can't receive messages from processes
+MINOR, FPH5, H5E_CANTSENDMDATA, Can't send metadata message
+MINOR, FPH5, H5E_CANTCHANGE, Can't register change with server
+MINOR, FPH5, H5E_CANTALLOC, Can't allocate from file
+
+# I/O pipeline errors
+MINOR, PIPELINE, H5E_NOFILTER, Requested filter is not available
+MINOR, PIPELINE, H5E_CALLBACK, Callback failed
+MINOR, PIPELINE, H5E_CANAPPLY, Error from filter 'can apply' callback
+MINOR, PIPELINE, H5E_SETLOCAL, Error from filter 'set local' callback