MPI_Rsend függvény

Kész módú küldési műveletet hajt végre, és visszaadja, ha a küldési puffer biztonságosan újra felhasználható.

Szintaxis

int MPIAPI MPI_Rsend(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           int          tag,
           MPI_Comm     comm
);

Paraméterek

• buf [in, nem kötelező]
  Az elküldendő adatokat tartalmazó pufferre mutató mutató.

• Számít
  A puffer elemeinek száma. Ha az üzenet adatrésze üres, állítsa a count paramétert 0-ra.

• Adattípus
  A puffer elemeinek adattípusa.

• dest
  A comm paraméter által megadott célfolyamat rangja a kommunikátorban.

• Tag
  A különböző típusú üzenetek megkülönböztetésére használható üzenetcímke.

• Comm
  A kommunikátor fogantyúja.

Visszatérési érték

Sikeres MPI_SUCCESS ad vissza. Ellenkező esetben a visszatérési érték hibakód.

A Fortranban a visszatérési érték az IERROR paraméterben van tárolva.

Fortran

    MPI_RSEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, DEST, TAG, COMM, IERROR

Megjegyzések

Ez a függvény nem helyi. Ez a függvény azonnal visszaadja, amint a küldési puffer újra felhasználható, és nem függ a megfelelő fogadási művelet állapotától. A teljes küldési művelet sikeres befejezése azonban attól függ, hogy létezik-e egyező fogadási művelet.

Ez a függvény csak akkor hívható meg, ha az egyező fogadási műveletet már közzétette. Ellenkező esetben a függvény hibát ad vissza, és az eredménye nincs meghatározva. Egyes rendszerekben ez a követelmény megszünteti a más módban használt kézfogások egy részét, és javíthatja a teljesítményt a szokásos vagy szinkron küldési műveletekhez képest.

A MPI_Rsend függvény szemantikája megegyezik a MPI_Send és a MPI_Ssend függvényével, de értesíti a rendszert arról, hogy a rendszer már közzétett egy egyező fogadást. Ez az információ némi többletterhelést takaríthat meg. Ezért egy megfelelő programban a kész küldést helyettesítheti egy szabványos küldés, amely nem befolyásolja a program viselkedését a teljesítményen kívül.

Követelmények

Termék	HPC Pack 2012 MS-MPI terjeszthető csomag, HPC Pack 2008 R2 MS-MPI terjeszthető csomag, HPC Pack 2008 MS-MPI újraterjeszthető csomag vagy HPC Pack 2008 ügyfél-segédprogramok
Fejléc	Mpi.h; Mpif.h
Kódtár	Msmpi.lib
DLL	Msmpi.dll

Lásd még

MPI pont–pont függvények

MPI_Send

MPI_Bsend

MPI_Ssend

MPI_Recv