MPI_Comm_dup függvény

Duplikál egy meglévő kommunikátort a társított kulcsértékekkel. Az egyes kulcsértékek esetében a megfelelő másolási visszahívási függvény határozza meg a kulcshoz társított attribútumértéket az új kommunikátorban. A visszahívás például törölheti az attribútumot az új kommunikátorból.

Szintaxis

int MPIAPI MPI_Comm_dup(
        MPI_Comm comm,
  _Out_ MPI_Comm *newcomm
);

Paraméterek

• Comm
  A megkettőzendő kommunikátor.

• newcomm [out]
  Visszatérés esetén egy leírót tartalmaz egy új kommunikátorhoz. Az új kommunikátor ugyanazokkal a csoportokkal vagy csoportokkal rendelkezik, és a forrásból másolt gyorsítótárazott információkat tartalmaz, de új környezeti információkat tartalmaz.

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 lesz tárolva.

Fortran

    MPI_COMM_DUP(COMM,NEWCOMM,IERROR)
        INTEGER COMM, NEWCOMM, IERROR

Megjegyzések

Ez a függvény duplikált kommunikációs területet hoz létre, amely ugyanazokkal a tulajdonságokkal rendelkezik, mint az eredeti kommunikátor. Ide tartoznak az attribútumok és a topológiák. Ez a függvény akkor is érvényes, ha vannak függőben lévő pont–pont kommunikációk, amelyek a forráskommunikátort is érintik.

A felhasználó meghívhatja a MPI_Comm_dup függvényt a párhuzamos folyamat elején, és később felszabadíthatja a duplikált kommunikátort a MPI_Comm_free függvénnyel. A kommunikátorkezelés egyéb modelljei is lehetségesek.

Ez a függvény az intrakommunikátorokra és az interkommunikátorokra egyaránt vonatkozik.

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 terjeszthető csomag vagy HPC Pack 2008 Client Utilities
Fejléc	Mpi.h; Mpif.h
Kódtár	Msmpi.lib
DLL	Msmpi.dll

Lásd még

MPI Communicator Functions