Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5P_GET_FAPL_MPIO

Returns MPI communicator information

Procedure:

H5P_GET_FAPL_MPIO ( fapl_id, comm, info )

Signature:

herr_t H5Pget_fapl_mpio(
                     hid_t fapl_id,
                     MPI_Comm *comm,
                     MPI_Info *info
    )

  

Fortran90 Interface: h5pget_fapl_mpio_f
    
SUBROUTINE h5pget_fapl_mpio_f(prp_id, comm, info, hdferr) 
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: prp_id ! Property list identifier
  INTEGER, INTENT(OUT) :: comm         ! Buffer to return communicator 
  INTEGER, INTENT(IN) :: info          ! Buffer to return info object as
                                       ! defined in MPI_FILE_OPEN of MPI-2
  INTEGER, INTENT(OUT) :: hdferr       ! Error code
                                       ! 0 on success and -1 on failure
END SUBROUTINE h5pget_fapl_mpio_f
    

Parameters:
hid_t fapl_idIN: File access property list identifier
MPI_Comm *comm    OUT: MPI-2 communicator
MPI_Info *infoOUT: MPI-2 Info object

Description:

If the file access property list is set to the H5FD_MPIO driver, H5P_GET_FAPL_MPIO returns duplicates of the stored MPI communicator and Info object through the comm and info pointers, if those values are non-null.

Since the MPI communicator and Info object are duplicates of the stored information, future modifications to the access property list will not affect them. It is the responsibility of the application to free these objects.

Returns:

Returns a non-negative value if successful. Otherwise returns a negative value.

Example:

Coming Soon!

History:
Release    Change
1.4.5Handling of the MPI Communicator and Info object changed at this release. A duplicate of each of these objects is now returned instead of pointers to each object.
1.4.0C function introduced in this release.

--- Last Modified: December 04, 2017 | 08:16 AM