MPI_Recv_init - Builds a handle for a receive


SYNOPSIS

       C:

            #include <mpi.h>

            int MPI_Recv_init( buf, count, datatype, source,
            tag, comm, request )
            void         *buf;
            int          count;
            MPI_Request  *request;
            MPI_Datatype datatype;
            int          source;
            int          tag;
            MPI_Comm     comm;

       C++:

            #include <mpi.h>

            Prequest Comm::Recv_init(
            void*             buf,
            int               count,
            const Datatype&   datatype,
            int               source,
            int               tag) const

       Fortran:

            INCLUDE "mpif.h" (or USE MPI)

            <type> BUF(*)
            INTEGER count, datatype, source, tag, comm, request, ierror

            CALL MPI_RECV_INIT(buf, count, datatype, source, tag, comm, request, ierror)


STANDARDS

       This release implements the MPI 1.2 standard, as
       documented by the MPI Forum in the spring 1997 release of
       MPI:  A Message Passing Interface Standard.


DESCRIPTION

       The MPI_Recv_init routine builds a handle for a receive
       operation.  This routine accepts the following parameters:

       buf       Specifies the initial address of the receive
                 buffer (choice)

       count     Specifies the number of elements received


       datatype  Specifies the type of each element (handle)

       source    Specifies the rank of source or MPI_ANY_SOURCE
                 (integer)

       tag       Specifies the message tag or MPI_ANY_TAG
                 (integer)

       comm      Specifies the communicator (handle)

       request   Returns the communication request (handle)

       ierror    Specifies the return code value for successful
                 completion, which is in MPI_SUCCESS.
                 MPI_SUCCESS is defined in the mpif.h file.


SEE ALSO

       MPI_Start(3), MPI_Startall(3), MPI_Request_free(3)


Man(1) output converted with man2html