Grab HDF5 I/O library

saf_grab_hdf5 is a function defined in utils.c.

Synopsis:

hid_t saf_grab_hdf5(SAF_Db *file)

Description: This function is used to grab the HDF5 lower level I/O library to then interact with a file in the database using that library.

Once HDF5 is grabbed for a given file in the database (supplemental or master), all SAF operations on the database are suspended until HDF5 is ungrabbed. Any SAF operation that is attempted involving a database whose lower levels have been grabbed will fail. The lower level interfaces to the database must be ungrabbed before normal SAF operations can resume.

For documentation on the HDF5 API, please see hdf.ncsa.uiuc.edu/HDF5/doc/RM_H5Front.html

Presently, a lower level interface can be grabbed for only one file in the database at a time.

Return Value: (See *Return Values*)

Parallel Notes: This call is collective in the communicator of the database containing the specified file.

See Also: