MPI_IRSEND, MPI_Irsend

Purpose

Performs a nonblocking ready mode send operation.

C synopsis

#include <mpi.h>
int MPI_Irsend(void* buf,int count,MPI_Datatype datatype,
    int dest,int tag,MPI_Comm comm,MPI_Request *request);

C++ synopsis

#include mpi.h
MPI::Request MPI::Comm::Irsend(const void *buf, int count,
                               const MPI::Datatype& datatype,
                               int dest, int tag) const;

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_IRSEND(CHOICE BUF,INTEGER COUNT,INTEGER DATATYPE,INTEGER DEST,
      INTEGER TAG,INTEGER COMM,INTEGER REQUEST,INTEGER IERROR)

Description

MPI_IRSEND starts a ready mode, nonblocking send operation. The send buffer
may not be modified until the request has been completed by MPI_WAIT,
MPI_TEST, or one of the other MPI wait or test functions.

Parameters

buf
     is the initial address of the send buffer (choice) (IN)
count
     is the number of elements in the send buffer (integer) (IN)
datatype
     is the datatype of each send buffer element (handle) (IN)
dest
     is the rank of the destination task in comm (integer) (IN)
tag
     is the message tag (positive integer) (IN)
comm
     is the communicator (handle) (IN)
request
     is the communication request (handle) (OUT)
IERROR
     is the FORTRAN return code. It is always the last argument.

Notes

See MPI_RSEND for more information.

Errors

Invalid count
     count < 0

Invalid datatype

Type not committed

Invalid destination
     dest < 0 or dest > = groupsize

Invalid tag
     tag < 0

Invalid comm

No receive posted
     error flagged at destination

MPI not initialized

MPI already finalized

Develop mode error if:

Illegal buffer update

Related information

     MPI_RSEND
     MPI_RSEND_INIT
     MPI_WAIT