/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 * Copyright by the Board of Trustees of the University of Illinois.         *
 * All rights reserved.                                                      *
 *                                                                           *
 * This file is part of HDF5.  The full HDF5 copyright notice, including     *
 * terms governing use, modification, and redistribution, is contained in    *
 * the files COPYING and Copyright.html.  COPYING can be found at the root   *
 * of the source code distribution tree; Copyright.html can be found at the  *
 * root level of an installed copy of the electronic HDF5 document set and   *
 * is linked from the top-level documents page.  It can also be found at     *
 * http://hdf.ncsa.uiuc.edu/HDF5/doc/Copyright.html.  If you do not have     *
 * access to either file, you may request a copy from hdfhelp@ncsa.uiuc.edu. *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */

#ifndef H5FDFPHDF5_H__
#define H5FDFPHDF5_H__

#include "H5FDmpio.h"
#include "H5FDprivate.h"

#ifdef H5_HAVE_PARALLEL
#   define H5FD_FPHDF5      (H5FD_fphdf5_init())
#else
#   define H5FD_FPHDF5      (-1)
#endif  /* H5_HAVE_PARALLEL */

/* Macros */

#ifndef H5_HAVE_FPHDF5

/* If FPHDF5 isn't specified, make this a "FALSE" value */
#define IS_H5FD_FPHDF5(f)   (0)

#else

#define IS_H5FD_FPHDF5(f)   (H5F_get_driver_id(f) == H5FD_FPHDF5)

/* Turn on H5FDfphdf5_debug if H5F_DEBUG is on */
#if defined(H5F_DEBUG) && !defined(H5FDfphdf5_DEBUG)
#   define H5FDfphdf5_DEBUG
#endif  /* H5F_DEBUG && ! H5FDfphdf5_DEBUG */

#define H5FD_FPHDF5_XFER_DUMPING_METADATA   "H5FD_fphdf5_dumping_metadata"
#define H5FD_FPHDF5_XFER_DUMPING_SIZE       sizeof(unsigned)

extern const H5FD_class_t H5FD_fphdf5_g;

/* Function prototypes */
#ifdef __cplusplus
extern "C" {
#endif  /* __cplusplus */

/*
 *==--------------------------------------------------------------------------==
 *                               API Functions
 *==--------------------------------------------------------------------------==
 */
H5_DLL herr_t   H5Pset_dxpl_fphdf5(hid_t dxpl_id, H5FD_mpio_xfer_t xfer_mode);
H5_DLL herr_t   H5Pget_dxpl_fphdf5(hid_t dxpl_id, H5FD_mpio_xfer_t *xfer_mode);
H5_DLL herr_t   H5Pset_fapl_fphdf5(hid_t fapl_id, MPI_Comm comm,
                                   MPI_Comm barrier_comm, MPI_Info info,
                                   unsigned sap_rank);
H5_DLL herr_t   H5Pget_fapl_fphdf5(hid_t fapl_id, MPI_Comm *comm,
                                   MPI_Comm *barrier_comm, MPI_Info *info,
                                   unsigned *sap_rank, unsigned *capt_rank);

/*
 *==--------------------------------------------------------------------------==
 *                         Private Library Functions
 *==--------------------------------------------------------------------------==
 */
H5_DLL hid_t    H5FD_fphdf5_init(void);
H5_DLL MPI_Comm H5FD_fphdf5_communicator(H5FD_t *_file);
H5_DLL MPI_Comm H5FD_fphdf5_barrier_communicator(H5FD_t *_file);
H5_DLL herr_t   H5FD_fphdf5_setup(hid_t dxpl_id, MPI_Datatype btype,
                                  MPI_Datatype ftype, unsigned use_view);
H5_DLL herr_t   H5FD_fphdf5_teardown(hid_t dxpl_id);
H5_DLL int      H5FD_fphdf5_mpi_rank(H5FD_t *_file);
H5_DLL int      H5FD_fphdf5_mpi_size(H5FD_t *_file);
H5_DLL unsigned H5FD_fphdf5_file_id(H5FD_t *_file);
H5_DLL hbool_t  H5FD_fphdf5_is_sap(H5FD_t *_file);

H5_DLL herr_t   H5FD_fphdf5_write_real(H5FD_t *_file, hid_t dxpl_id,
                                       MPI_Offset mpi_off, int size,
                                       const void *buf);

#ifdef __cplusplus
}
#endif  /* __cplusplus */

#endif  /* H5_HAVE_PARALLEL */

#endif  /* H5FDFPHDF5_H__ */