MPI_File_get_view(3)MPI_File_get_view(3)NAMEMPI_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)
filetype Returns the filetype (handle)
Page 1
MPI_File_get_view(3)MPI_File_get_view(3)
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 ALSOMPI_File_open(3), MPI_IO(3)
Page 2
