Open MPI logo

MPI_File_read_all_end(3) man page (version 1.3.4)

  |   Home   |   Support   |   FAQ   |  

« Return to documentation listing



NAME

       MPI_File_read_all_end  -  Reads a file starting at the locations speci-
       fied by individual file pointers; ending part  of  a  split  collective
       routine (blocking).

SYNTAX

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

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

C++ Syntax

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

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

INPUT/OUTPUT 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_all_end  is  the ending part of a split collective opera-
       tion that stores the number of elements actually  read  from  the  file
       associated  with  fh  (at  the current individual file pointer position
       maintained by the system) into the user's buffer buf  in  status.   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 does not guarantee that an MPI program can continue past an  error.

1.3.4                            Nov 11, 2009         MPI_File_read_all_end(3)

« Return to documentation listing