Hilfesystem für den Message Passing Interface Standard MPI

MPI_Recv_init

Syntax:

MPI_Recv_init(buf, count, datatype, source, tag, comm, request)

Input Parameter:

count - Anzahl der Elemente des Empfangspuffers (integer, nichtnegativ)
datatype - Typ der Elemente des Empfangspuffers (handle)
source - Rang des Senders in comm (integer)
tag - message tag zur Unterscheidung verschiedener Nachrichten oder MPI_ANY_TAG (integer);
comm - Kommunikator (handle)

buf - Anfangsadresse des Empfangspuffers
request - Request-Objekt (handle)
Es wird benötigt, um die Empfangsoperation zu starten.

Wichtig: der Aufruf von MPI_Recv_init löst keinerlei Kommunikation aus.

Sinn und Zweck dieser Funktion besteht darin, bei wiederkehrenden Empfangsoperationen mit gleicher Parameterliste Overhead einzusparen. Das eigentliche Empfangen wird mit MPI_Start gestartet.

Aufruf:

#include "mpi.h"

    int           count, source, tag, n, i;
    void          *buf;
    MPI_Datatype  datatype;
    MPI_Comm      comm;
    MPI_Request   request;
    MPI_Status    status;

    ...
    MPI_Recv_init(buf, count, datatype, source, tag, comm, &request);
    for (i=0; i<n; i++) {
	MPI_Start(&request);
        ...
	MPI_Wait(&request, &status);
        ...
    }
    MPI_Request_free(&request);
    ...