9f2c7fd369
Update
Description:
More changes to the FPHDF5 file driver. Too many to mention here.
Some highlights:
- Addition of lock/unlock methods to the driver, though they
aren't implemented fully just yet.
- Extra query functions to determine various things about the
file. (If this is the captain process, etc)
- Fixes to make things work...
Platforms tested:
Linux
Misc. update:
128 lines
5.3 KiB
C
128 lines
5.3 KiB
C
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* 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 "H5FDpublic.h" /* for the H5FD_t structure */
|
|
|
|
#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)
|
|
|
|
/*
|
|
* For specifying that only the captain is allowed to allocate things at
|
|
* this time.
|
|
*/
|
|
#define H5FD_FPHDF5_CAPTN_ALLOC_ONLY "Only_Captain_Alloc"
|
|
#define H5FD_FPHDF5_CAPTN_ALLOC_SIZE sizeof(unsigned)
|
|
|
|
/*
|
|
* The description of a file belonging to this driver.
|
|
*
|
|
* The FILE_ID field is an SAP defined value. When reading/writing to the
|
|
* SAP, this value should be sent.
|
|
*
|
|
* The EOF field is only used just after the file is opened in order for
|
|
* the library to determine whether the file is empty, truncated, or
|
|
* okay. The FPHDF5 driver doesn't bother to keep it updated since it's
|
|
* an expensive operation.
|
|
*/
|
|
typedef struct H5FD_fphdf5_t {
|
|
H5FD_t pub; /*Public stuff, must be first (ick!) */
|
|
unsigned file_id; /*ID used by the SAP */
|
|
MPI_File f; /*MPIO file handle */
|
|
MPI_Comm comm; /*Communicator */
|
|
MPI_Comm barrier_comm; /*Barrier communicator */
|
|
MPI_Info info; /*File information */
|
|
int mpi_rank; /*This process's rank */
|
|
int mpi_size; /*Total number of processes */
|
|
haddr_t eof; /*End-of-file marker */
|
|
haddr_t eoa; /*End-of-address marker */
|
|
haddr_t last_eoa; /*Last known end-of-address marker */
|
|
} H5FD_fphdf5_t;
|
|
|
|
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 hbool_t H5FD_fphdf5_is_captain(H5FD_t *_file);
|
|
H5_DLL hbool_t H5FD_is_fphdf5_driver(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__ */
|