Open MPI logo

MPI_File_write_ordered_end(3) man page (version 5.0.0rc2)

  |   Home   |   Support   |   FAQ   |  

« Return to documentation listing

Table of Contents

Name

C]MPI_File_write_ordered_endR] - Writes a file at a location specified by a shared file pointer; ending part of a split collective routine (blocking).

Syntax

C Syntax



C]#include <mpi.h>int MPI_File_write_ordered_end(MPI_File fh, const void *buf, MPI_Status *status)R]Fortran Syntax



C]USE MPI! or the older form: INCLUDE [aq]mpif.h[aq]MPI_FILE_WRITE_ORDERED_END(FH, BUF, STATUS, IERROR) <type> BUF(*) INTEGER FH, STATUS(MPI_STATUS_SIZE), IERRORR]Fortran 2008 Syntax



C]USE mpi_f08MPI_File_write_ordered_end(fh, buf, status, ierror) TYPE(MPI_File), INTENT(IN) :: fh TYPE(*), DIMENSION(..), INTENT(IN), ASYNCHRONOUS :: buf TYPE(MPI_Status) :: status INTEGER, OPTIONAL, INTENT(OUT) :: ierrorR]Input/Output Parameter

[bu]
C]fhR] : File handle (handle).

Input Parameter

[bu]
C]bufR] : Initial address of buffer (choice).

Output Parameters

[bu]
C]statusR] : Status object (status).
[bu]
C]IERRORR] : Fortran only: Error status (integer).

Description

C]MPI_File_write_ordered_endR] is the ending part of a split collective routine that must be called by all processes in the communicator group associated with the file handle C]fhR]. C]MPI_File_write_ordered_endR] returns the number of elements written into the file associated with C]fhR] in C]statusR].

Notes

All the nonblocking collective routines for data access are [lq]split[rq] into two routines, each with _begin or _end as a suffix. These split collective routines are subject to the semantic rules described in Section 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.

Before the error value is returned, the current MPI error handler is called. For MPI I/O function errors, the default error handler is set to C]MPI_ERRORS_RETURNR]. The error handler may be changed with C]MPI_File_set_errhandlerR]; the predefined error handler C]MPI_ERRORS_ARE_FATALR] may be used to make I/O errors fatal. Note that MPI does not guarantee that an MPI program can continue past an error.


Table of Contents

« Return to documentation listing