Last modified: 25 October 2011
Name: H5check_version
Signature:
herr_t H5check_version( unsigned majnum, unsigned minnum, unsigned relnum )

Purpose:
Verifies that HDF5 library versions are consistent.

Description:
H5check_version verifies that the version of the HDF5 library with which an application was compiled, as indicated by the passed parameters, matches the version of the HDF5 library against which the application is currently linked.

majnum is the major version number of the HDF library with which the application was compiled, minnum is the minor version number, and relnum is the release number. Consider the following illustration:

An official HDF5 release is labelled as follows:
     HDF5 Release <majnum>.<minnum>.<relnum>
For example, in HDF5 Release 1.8.5:
  • 1 is the major version number, majnum.
  • 8 is the minor version number, minnum.
  • 5 is the release number, relnum.

As stated above, H5check_version first verifies that the version of the HDF5 library with which an application was compiled matches the version of the HDF5 library against which the application is currently linked. If this check fails, H5check_version causes the application to abort (by means of a standard C abort() call) and prints information that is usually useful for debugging. This precaution is is taken to avoid the risks of data corruption or segmentation faults.

The most common cause of this failure is that an application was compiled with one version of HDF5 and is dynamically linked with a different version different version.

If the above test passes, H5check_version proceeds to verify the consistency of additional library version information. This is designed to catch source code inconsistencies that do not normally cause failures; if this check reveals an inconsistency, an informational warning is printed but the application is allowed to run.

Parameters:

Returns:
Returns a non-negative value if successful. Upon failure, this function causes the application to abort.

Fortran90 Interface: h5check_version_f

History: