HDF5
Page tree

Versions Compared

Old Version 10

changes.mady.by.user Barbara Jones

Saved on

compared with

New Version Current

changes.mady.by.user Barbara Jones

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Content Layer
id1195548671
Content Column
width50.00001%
id1195578110
classrm_pagetree_col mobile-hide
Content Block
id1195578111
 
Content Column
width50.00001%
id1195548673
classhdf-rm-main-column
Content Block
id1195548672

Include Content
render-without-blockstrue
page.rm-navbar
HTML Wrap
classhdf-print-only

Page Title

HTML Wrap
classhdf-rm-summary-block

Hdf rm anchor
AnchorNamesummary

Excerpt

Stores MPI IO communicator information to a file access property list (REMOVED)

HTML Wrap
classhdf-rm-content-block

Hdf rm anchor
AnchorNameprocedure

Warning

FUNCTION REMOVED: The C functions H5P_SET_FAPL_MPIPOSIX and H5P_GET_FAPL_MPIPOSIX and the corresponding Fortran subroutines have been removed from the HDF5 library at Release 1.8.13. They remain available in earlier releases, through HDF5 Release 1.8.12.

All applications used with HDF5 Release 1.8.13 or later and that use MPI I/O should use the functions H5P_SET_FAPL_MPIO and H5P_GET_FAPL_MPIO or the corresponding Fortran subroutines.

While HDF5’s MPI-POSIX driver (H5P_SET_FAPL_MPIPOSIX and H5P_GET_FAPL_MPIPOSIX) once provided performance benefits on some systems, that is no longer the case. HDF5’s MPIO driver (H5P_SET_FAPL_MPIO and H5P_GET_FAPL_MPIO) now provides as good or better performance on all modern systems.

Procedure:
HTML Wrap
classhdf-rm-section
HTML Wrap
classhdf_procedure

H5P_SET_FAPL_MPIPOSIX ( fapl_id, comm, use_gpfs_hints )

 

Hdf rm anchor
AnchorNamesignature

Signature:
HTML Wrap
classhdf-rm-section
HTML Wrap
classhdf-togglebox hdf-c

HTML Add Class
hdf-togglebutton-visible
hdf-togglebutton-visible
selector.hdf-togglebutton.hdf-c

HTML
<pre><code class="language-c">herr_t H5Pset_fapl_mpiposix(
                     hid_t fapl_id,
                     MPI_Comm comm,
                     hbool_t use_gpfs_hints
    )
 
  </code></pre>
HTML Wrap
classhdf-togglebox hdf-fortran hdf-togglebox-hidden

HTML Add Class
hdf-togglebutton-visible
hdf-togglebutton-visible
selector.hdf-togglebutton.hdf-fortran

HTML
<pre><code class="language-fortran">Fortran90 Interface: h5pset_fapl_mpiposix_f
    
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
END SUBROUTINE h5pset_fapl_mpiposix_f
        </code></pre>

Hdf rm anchor
AnchorNameparameters

Parameters:
HTML Wrap
classhdf-rm-section
hid_t fapl_idIN: File access property list identifier
MPI_Comm commIN: MPI-2 communicator
hbool_t use_gpfs_hints    IN: Use of GPFS hints

Hdf rm anchor
AnchorNamedescription

Description:
HTML Wrap
classhdf-rm-section

H5P_SET_FAPL_MPIPOSIX stores the user-supplied MPI IO parameter comm, for communicator, in the file access property list fapl_id. That property list can then be used to create and/or open the file.

H5P_SET_FAPL_MPIPOSIX is available only in the parallel HDF5 library and is not a collective function.

comm is the MPI communicator to be used for file open, as defined in MPI_FILE_OPEN of MPI-2. This function does not create a duplicated communicator. Modifications to comm after this function call returns may have an undetermined effect on the file access property list. Users should not modify the communicator while it is defined in a property list.

use_gpfs_hints specifies whether to attempt to use GPFS hints when accessing this file. A value of TRUE (or 1) indicates that the hints should be used, if possible. A value of FALSE (or 0) indicates that the hints should not be used.

Available GPFS hints are known to the HFD5 library and are not user configurable. They may be used only with GPFS file systems and may improve file access for some applications; the user of a GPFS system is encouraged to experiment by running an application with and without this parameter set.

Note

Raw dataset chunk caching is not currently supported when using this file driver in read/write mode. All calls to H5D_READ and H5D_WRITE will access the disk directly, and H5P_SET_CACHE and H5P_SET_CHUNK_CACHE will have no effect on performance.

Raw dataset chunk caching is supported when this driver is used in read-only mode.

 

Hdf rm anchor
AnchorNamereturns

Returns:
HTML Wrap
classhdf-rm-section

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

Hdf rm anchor
AnchorNameexample

Example:
HTML Wrap
classhdf-rm-section

Coming Soon!

Comment
HTML Wrap
classhdf-togglebox hdf-c

Bitbucket Server file
repoSlughdf5
branchIdrefs/heads/1.10/master
projectKeyHDFFV
filepathexamples/h5_subset.c
showLineNumberstrue
lineStart32
progLangcpp
lineEnd42
applicationLink5ac7b370-7412-3c8c-ad20-807a68261336

HTML Wrap
classhdf-togglebox hdf-fortran hdf-togglebox-hidden

Bitbucket Server file
repoSlughdf5
branchIdrefs/heads/1.10/master
projectKeyHDFFV
filepathfortran/examples/compound.f90
showLineNumberstrue
lineStart25
progLangplain
lineEnd35
applicationLink5ac7b370-7412-3c8c-ad20-807a68261336

Hdf rm anchor
AnchorNamehistory

History:
HTML Wrap
classhdf-rm-section
Release    Change
1.8.13C function and Fortran subroutine removed from HDF5 at this release.
1.6.1Fortran subroutine introduced in this release.
1.6.0use_gpfs_hints parameter added.
1.6.0C function introduced in this release.

The HDF Group

Copyright © 2006
All rights reserved

HDF is a registered trademark of The HDF Group.

Privacy Policy | Terms of Service

Site
Resources
Connect