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