HDF5 FORTRAN Developer's Guide

## H5FDMPIO

[ Top ] [ Modules ]

NAME

      MODULE H5FDMPIO

PURPOSE

      This file contains Fortran interfaces for H5P functions needed by
      parallel MPI programs.

NOTES

                             *** IMPORTANT ***
      If you add a new H5P function you must add the function name to the
      Windows dll file 'hdf5_fortrandll.def' in the fortran/src directory.
      This is needed for Windows based operating systems.

## h5pget_dxpl_mpio_f

[ Top ] [ H5FDMPIO ] [ Subroutines ]

NAME

      h5pget_dxpl_mpio_f

PURPOSE

      Returns the data transfer mode.

INPUTS

      prp_id        - data transfer property list identifier

OUTPUTS

      data_xfer_mode- transfer mode; possible values are:
                         H5FD_MPIO_INDEPENDENT_F
                         H5FD_MPIO_COLLECTIVE_F
      hdferr        - Returns 0 if successful and -1 if fails

AUTHOR

      Elena Pourmal
      November, 2000

SOURCE

      SUBROUTINE h5pget_dxpl_mpio_f(prp_id, data_xfer_mode, hdferr)
        IMPLICIT NONE
        INTEGER(HID_T), INTENT(IN) :: prp_id   ! Property list identifier
        INTEGER, INTENT(OUT) :: data_xfer_mode ! Data transfer mode. Possible values are:
                                               ! H5FD_MPIO_INDEPENDENT_F
                                               ! H5FD_MPIO_COLLECTIVE_F
        INTEGER, INTENT(OUT) :: hdferr         ! Error code

## h5pget_fapl_mpio_f

[ Top ] [ H5FDMPIO ] [ Subroutines ]

NAME

      h5pget_fapl_mpio_f

PURPOSE

      Returns MPI communicator information.

INPUTS

      prp_id        - file access property list identifier

OUTPUTS

      comm          - MPI-2 communicator
      info          - MPI-2 info object
      hdferr        - Returns 0 if successful and -1 if fails

AUTHOR

      Elena Pourmal
      November, 2000

SOURCE

      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(OUT) :: info ! buffer to return info object
                                     ! as defined in MPI_FILE_OPEN of MPI-2
        INTEGER, INTENT(OUT) :: hdferr  ! Error code

## h5pget_fapl_mpiposix_f

[ Top ] [ H5FDMPIO ] [ Subroutines ]

NAME

      h5pget_fapl_mpiposix_f

PURPOSE

      Returns MPI communicator information.

INPUTS

      prp_id        - file access property list identifier

OUTPUTS

      comm          - MPI-2 communicator
      use_gpfs      - flag to use GPFS hints
      hdferr        - Returns 0 if successful and -1 if fails

AUTHOR

      Elena Pourmal
      May 6, 2003

SOURCE

      SUBROUTINE h5pget_fapl_mpiposix_f(prp_id, comm, use_gpfs, hdferr)
        IMPLICIT NONE
        INTEGER(HID_T), INTENT(IN) :: prp_id ! Property list identifier
        INTEGER, INTENT(OUT) :: comm         ! Buffer to return communicator
        LOGICAL, INTENT(OUT) :: use_gpfs
        INTEGER, INTENT(OUT) :: hdferr       ! Error code

## h5pset_dxpl_mpio_f

[ Top ] [ H5FDMPIO ] [ Subroutines ]

NAME

      h5pset_dxpl_mpio_f

PURPOSE

      Sets data transfer mode.

INPUTS

      prp_id         - data transfer property list identifier
      data_xfer_mode - transfer mode; possible values are:
                         H5FD_MPIO_INDEPENDENT_F
                         H5FD_MPIO_COLLECTIVE_F

OUTPUTS

      hdferr        - Returns 0 if successful and -1 if fails

AUTHOR

      Elena Pourmal
      November, 2000

SOURCE

      SUBROUTINE h5pset_dxpl_mpio_f(prp_id, data_xfer_mode, hdferr)
        IMPLICIT NONE
        INTEGER(HID_T), INTENT(IN) :: prp_id  ! Property list identifier
        INTEGER, INTENT(IN) :: data_xfer_mode ! Data transfer mode. Possible values are:
                                              ! H5FD_MPIO_INDEPENDENT_F
                                              ! H5FD_MPIO_COLLECTIVE_F
        INTEGER, INTENT(OUT) :: hdferr        ! Error code

## h5pset_fapl_mpio_f

[ Top ] [ H5FDMPIO ] [ Subroutines ]

NAME

      h5pset_fapl_mpio_f

PURPOSE

      Stores MPI IO communicator information to the file
      access property list.

INPUTS

      prp_id        - file access property list identifier
      comm          - MPI-2 communicator
      info          - MPI-2 info object

OUTPUTS

      hdferr        - Returns 0 if successful and -1 if fails

AUTHOR

      Elena Pourmal
      November, 2000

SOURCE

      SUBROUTINE h5pset_fapl_mpio_f(prp_id, comm, info, hdferr)
        IMPLICIT NONE
        INTEGER(HID_T), INTENT(IN) :: prp_id ! Property list identifier
        INTEGER, INTENT(IN) :: comm ! MPI communicator to be used for file open
                                    ! as defined in MPI_FILE_OPEN of MPI-2
        INTEGER, INTENT(IN) :: info ! MPI info object to be used for file open
                                    ! as defined in MPI_FILE_OPEN of MPI-2
        INTEGER, INTENT(OUT) :: hdferr ! Error code

## h5pset_fapl_mpiposix_f

[ Top ] [ H5FDMPIO ] [ Subroutines ]

NAME

      h5pset_fapl_mpiposix_f

PURPOSE

      Stores MPI IO communicator information to the file
      access property list.

INPUTS

      prp_id        - file access property list identifier
      comm          - MPI-2 communicator
      use_gpfs      - logical flag to use the GPFS hints

OUTPUTS

      hdferr        - Returns 0 if successful and -1 if fails

AUTHOR

      Elena Pourmal
      May 6, 2003

SOURCE

      SUBROUTINE h5pset_fapl_mpiposix_f(prp_id, comm, use_gpfs, hdferr)
        IMPLICIT NONE
        INTEGER(HID_T), INTENT(IN) :: prp_id ! Property list identifier
        INTEGER, INTENT(IN) :: comm ! MPI communicator to be used for file open
                                    ! as defined in MPI_FILE_OPEN of MPI-2
        LOGICAL, INTENT(IN) :: use_gpfs
        INTEGER, INTENT(OUT) :: hdferr  ! Error code