Manual Pages for UNIX Darwin command on man MPI_File_iread_at
MyWebUniversity

Manual Pages for UNIX Darwin command on man MPI_File_iread_at

MPIFileireadat(3OpenMPI) MPIFileireadat(3OpenMPI)

NAME

MMPPIIFFiilleeiirreeaaddaatt - Reads a file at an explicitly specified offset

(nonblocking, noncollective). SSYYNNTTAAXX C Syntax

#include

int MPIFileireadat(MPIFile fh, MPIOffset offset, void *buf, int count, MPIDatatype datatype, MPIRequest *request)

Fortran Syntax (see FORTRAN 77 NOTES)

INCLUDE 'mpif.h'

MPIFILEIREADAT(FH, OFFSET, BUF, COUNT, DATATYPE, REQUEST, IERROR)

BUF(*)

INTEGER FH, COUNT, DATATYPE, REQUEST, IERROR

INTEGER(KIND=MPIOFFSETKIND) OFFSET CC++++ SSyynnttaaxx

#include

MPI::Request MPI::File::Ireadat(MPI::Offset offset, void* buf, int count, const MPI::Datatype& datatype) IINNPPUUTT PPAARRAAMMEETTEERRSS fh File handle (handle). offset File offset (integer). count Number of elements in the buffer (integer). datatype Data type of each buffer element (handle). OOUUTTPPUUTT PPAARRAAMMEETTEERRSS buf Initial address of the buffer (choice). request Request object (handle).

IERROR Fortran only: Error status (integer).

DESCRIPTION

MPIFileireadat is the nonblocking version of MPIFilereadat. MPIFileireadat is a nonblocking routine that attempts to read from the file associated with fh at the offset position a total number of count data items having datatype type into the user's buffer buf. The offset is in etype units relative to the current view. That is, holes are not counted when locating an offset. The data is taken out of those parts of the file specified by the current view. MPIFileireadat stores the number of datatype elements actually read in status. All other fields of status are undefined. FFOORRTTRRAANN 7777 NNOOTTEESS The MPI standard prescribes portable Fortran syntax for the OFFSET

argument only for Fortran 90. Sun FORTRAN 77 users may use the non-

portable syntax INTEGER*MPIOFFSETKIND OFFSET where MPIOFFSETKIND is a constant defined in mpif.h and gives the length of the declared integer in bytes. EERRRROORRSS Almost all MPI routines return an error value; C routines as the value

of the function and Fortran routines in the last argument. C++ func-

tions do not return errors. If the default error handler is set to

MPI::ERRORSTHROWEXCEPTIONS, then on error the C++ exception mechanism

will be used to throw an MPI:Exception object. Before the error value is returned, the current MPI error handler is called. For MPI I/O function errors, the default error handler is set

to MPIERRORSRETURN. The error handler may be changed with

MPIFileseterrhandler; the predefined error handler

MPIERRORSAREFATAL may be used to make I/O errors fatal. Note that

MPI does not guarantee that an MPI program can continue past an error. Open MPI 1.2 September 2006 MPIFileireadat(3OpenMPI)




Contact us      |      About us      |      Term of use      |       Copyright © 2000-2019 MyWebUniversity.com ™