HDF5
Page tree

Versions Compared

Old Version 8

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

Retrieves the type of I/O that HDF5 actually performed on the last parallel I/O call (not necessarily the type requested)

HTML Wrap
classhdf-rm-content-block

Hdf rm anchor
AnchorNameprocedure

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

H5P_GET_MPIO_ACTUAL_IO_MODE ( dxpl_id, actual_io_mode )

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 H5Pget_mpio_actual_io_mode(
            hid_t dxpl_id,
            H5D_mpio_actual_io_mode_t *actual_io_mode)
  </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: h5pget_mpio_actual_io_mode_f
 
Signature:
  SUBROUTINE h5pget_mpio_actual_io_mode_f(dxpl_id, actual_io_mode, hdferr)
    IMPLICIT NONE
    INTEGER(HID_T), INTENT(IN)  :: dxpl_id
    INTEGER       , INTENT(OUT) :: actual_io_mode
    INTEGER       , INTENT(OUT) :: hdferr

Inputs:
  dxpl_id        - Dataset transfer property list identifier.

Outputs:
  actual_io_mode - The type of I/O performed by this process.
  hdferr         - Returns 0 if successful and -1 if fails.
</code></pre>

Hdf rm anchor
AnchorNameparameters

Parameters:
HTML Wrap
classhdf-rm-section
hid_t dxpl_idIN: Dataset transfer property list identifier
H5D_mpio_actual_io_mode_t * actual_io_modeOUT: The type of I/O performed by this process

Hdf rm anchor
AnchorNamedescription

Motivation:
HTML Wrap
classhdf-rm-section

A user can request collective I/O via a data transfer property list (DXPL) that has been suitably modified with H5P_SET_DXPL_MPIO. However, HDF5 will sometimes ignore this request and perform independent I/O instead. This property allows the user to see what kind of I/O HDF5 actually performed. Used in conjunction with H5P_GET_MPIO_ACTUAL_CHUNK_OPT_MODE, this property allows the user to determine exactly HDF5 did when attempting collective I/O.

Description:
HTML Wrap
classhdf-rm-section

H5P_GET_MPIO_ACTUAL_IO_MODE retrieves the type of I/O performed on the selection of the current process. This property is set after all I/O is completed; if I/O fails, it will not be set.

Valid values returned in actual_io_mode:

H5D_MPIO_NO_COLLECTIVENo collective I/O was performed. Collective I/O was not requested or collective I/O isn't possible on this dataset
(Default)
H5D_MPIO_CHUNK_INDEPENDENTHDF5 performed one the chunk collective optimization schemes and each chunk was accessed independently
H5D_MPIO_CHUNK_COLLECTIVEHDF5 performed one the chunk collective optimization schemes and each chunk was accessed collectively
H5D_MPIO_CHUNK_MIXEDHDF5 performed one the chunk collective optimization schemes and some chunks were accessed independently, some collectively.
H5D_MPIO_CONTIGUOUS_COLLECTIVECollective I/O was performed on a contiguous dataset
Note

All processes do not need to have the same value. For example, if I/O is being performed using the multi chunk optimization scheme, one process's selection may include only chunks accessed collectively, while another may include chunks accessed independently. In this case, the first process will report H5D_MPIO_CHUNK_COLLECTIVE while the second will report H5D_MPIO_CHUNK_INDEPENDENT.

See Also:
HTML Wrap
classhdf-rm-section
Info

H5P_GET_MPIO_NO_COLLECTIVE_CAUSE - Reports whether collective I/O was performed on a call and, if not, the causes that broke collective I/O

H5P_GET_MPIO_ACTUAL_CHUNK_OPT_MODE - Reports type of optimization HDF5 actually attempted

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
HTML Wrap
classhdf-togglebox hdf-c

Bitbucket Server file
repoSlughdf5
branchIdrefs/heads/1.10/master
projectKeyHDFFV
filepathtestpar/t_dset.c
showLineNumberstrue
lineStart3291
progLangplain
lineEnd3291
applicationLink5ac7b370-7412-3c8c-ad20-807a68261336

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

Bitbucket Server file
repoSlughdf5
branchIdrefs/heads/1.10/master
projectKeyHDFFV
filepathfortran/

examples

testpar/

compound

hyper.f90
showLineNumberstrue
lineStart

25

236
progLangplain
lineEnd

35

237
applicationLink5ac7b370-7412-3c8c-ad20-807a68261336

Hdf rm anchor
AnchorNamehistory

History:
HTML Wrap
classhdf-rm-section
Release    Change
1.8.10Fortran subroutine introduced in this release.
1.8.8C 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