Open MPI logo

MPI_File_read_at_all_end(3) man page (version 1.3.4)

  |   Home   |   Support   |   FAQ   |  

« Return to documentation listing



NAME

       MPI_File_read_at_all_end  -  Reads  a file at explicitly specified off-
       sets; ending part of a split collective routine (blocking).

SYNTAX

       C Syntax
           #include <mpi.h>
           int MPI_File_read_at_all_end(MPI_File fh, void *buf,
            MPI_Status *status)

       Fortran Syntax
           INCLUDE 'mpif.h'
           MPI_FILE_READ_AT_ALL_END(FH, BUF, STATUS, IERROR)
                 <TYPE>         BUF(*)
                 INTEGER        FH, STATUS(MPI_STATUS_SIZE), IERROR

C++ Syntax

       #include <mpi.h>
       void MPI::File::Read_at_all_end(void* buf, MPI::Status& status)

       void MPI::File::Read_at_all_end(void* buf)

INPUT PARAMETER

       fh        File handle (handle).

OUTPUT PARAMETERS

       buf       Initial address of buffer (choice).

       status    Status object (status).

       IERROR    Fortran only: Error status (integer).

DESCRIPTION

       MPI_File_read_at_all_end is a split collective routine that stores  the
       number  of  elements  actually read from the file associated with fh in
       status.  MPI_File_read_at_all_end blocks until the operation  initiated
       by MPI_File_read_at_all_begin completes. The data is taken out of those
       parts of the file specified by the current view. All  other  fields  of
       status are undefined.

NOTES

       All  the  nonblocking  collective  routines for data access are "split"
       into two routines, each with _begin or _end as a  suffix.  These  split
       collective routines are subject to the semantic rules described in Sec-
       tion 9.4.5 of the MPI-2 standard.

ERRORS

       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::ERRORS_THROW_EXCEPTIONS, then on error the C++ exception mechanism

1.3.4                            Nov 11, 2009      MPI_File_read_at_all_end(3)

« Return to documentation listing