MPI_File_get_view - Returns the file view
SYNOPSIS
C:
#include "mpi.h"
int MPI_File_get_view (MPI_File fh, MPI_Offset
disp, MPI_Datatype *etype, MPI_Datatype *filetype,
char *datarep)
Fortran:
INCLUDE "mpif.h" (or USE MPI)
INTEGER fh, etype, filetype, ierror
INTEGER(KIND=MPI_OFFSET_KIND) disp
CALL MPI_FILE_GET_VIEW(fh, disp, etype, filetype,
ierror)
DESCRIPTION
The MPI_File_get_view routine returns the process's view
of the data in the file. The current value of the
displacement is returned in disp. The etype and filetype
are new datatypes with typemaps equal to the typemaps of
the current etype and filetype, respectively.
The data representation is returned in datarep. The user
is responsible for ensuring that datarep is large enough
to hold the returned data representation string. The
length of a data representation string is limited to the
value of MPI_MAX_DATAREP_STRING.
In addition, if a portable datatype was used to set the
current view, the corresponding datatype returned by
MPI_File_get_view is also a portable datatype. If etype or
filetype are derived datatypes, the user is responsible
for freeing them. The returned etype and filetype are both
in a committed state.
The MPI_File_get_view routine accepts the following
arguments:
fh Specifies the file handle (handle)
disp Returns the displacement (nonnegative
integer)
etype Returns the elementary datatype (handle)
datarep Returns the data representation (string)
ierror Specifies the return code value for
successful completion, which is in
MPI_SUCCESS. MPI_SUCCESS is defined in the
mpif.h file.
Notes for Fortran
All MPI objects (for example, MPI_Datatype, MPI_Comm,
MPI_File) are of type INTEGER.
SEE ALSO
MPI_File_open(3), MPI_IO(3)
Man(1) output converted with
man2html