MPI_File_get_view(3)

NAME
     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)

     filetype       Returns the filetype (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)