Open MPI logo

MPI_File_write_all_end(3) man page (version 1.2.9)

  |   Home   |   Support   |   FAQ   |  

« Return to documentation listing



NAME

       MPI_File_write_all_end - Writes 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_write_all_end(MPI_File fh, void *buf, MPI_Status *status)

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

C++ Syntax

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

       void MPI::File::Write_all_end(const void* buf)

INPUT/OUTPUT PARAMETER

       fh        File handle (handle).

INPUT PARAMETER

       buf       Initial address of buffer (choice).

OUTPUT PARAMETERS

       status    Status object (status).

       IERROR    Fortran only: Error status (integer).

DESCRIPTION

       MPI_File_write_all_end is the ending part of a split collective routine
       that stores the number of elements actually written into the file asso-
       ciated    with   fh   from   the   user's   buffer   buf   in   status.
       MPI_File_write_all_end  blocks  until  the   operation   initiated   by
       MPI_File_write_all_begin  completes.  The  data  is  written into 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
       MPI_File_set_errhandler;      the      predefined     error     handler
       MPI_ERRORS_ARE_FATAL may be used to make I/O errors  fatal.  Note  that
       MPI  does not guarantee that an MPI program can continue past an error.

Open MPI 1.2                    September 2006MPI_File_write_all_end(3OpenMPI)

« Return to documentation listing