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:

unsigned `majnum` | IN: HDF5 library major version number.
unsigned `minnum` | IN: HDF5 library minor version number.
unsigned `relnum` | IN: HDF5 library release number.

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

Fortran90 Interface: h5check_version_f

History:

Release | Change
1.4.5 | Fortran subroutine introduced in this release.
1.8.8 | Fortran updated to Fortran 2003.