Last modified: 18 April 2012
Name: H5Fget_mpi_atomicity
Signature:
herr_t H5Fget_mpi_atomicity( hid_t file_id, hbool_t *flag )

Purpose:
Retrieves the atomicity mode in use.

Description:
H5Fget_mpi_atomicity retrieves the current consistency semantics mode for data access for the file file_id.

Upon successful return, flag will be set to TRUE if file access is set to atomic mode and FALSE if file access is set to nonatomic mode.

Parameters:
hid_t file_id      IN: HDF5 file identifier
hbool_t *flag   OUT: Logical flag for atomicity setting
Valid values are:
  • TRUE    MPI file access is set to atomic mode.
  • FALSE   MPI file access is set to nonatomic mode.
  • Returns:
    Returns a non-negative value if successful; otherwise returns a negative value.

    Fortran90 Interface: h5fget_mpi_atomicity_f
    SUBROUTINE h5fget_mpi_atomicity_f(file_id, flag, hdferr) 
      IMPLICIT NONE
      INTEGER(HID_T), INTENT(IN) :: file_id ! File identifier
      INTEGER(HBOOL_T), INTENT(OUT) :: flag ! Atomicity flag
      INTEGER, INTENT(OUT) :: hdferr        ! Error code:
                                            ! 0 on success, -1 on failure
    END SUBROUTINE h5fget_mpi_atomicity_f 

    See Also:
    Enabling a Strict Consistency Semantics Model in Parallel HDF5

    H5Fset_mpi_atomicity

    History:
    Release     Change
    1.8.9 C function and Fortran subroutine introduced in this release.