MPI_Rget funkce

Operace získání RMA na základě požadavku

Syntaxe

int MPIAPI MPI_Rget(
  _Out_ void         *origin_addr,
        int          origin_count,
        MPI_Datatype origin_datatype,
        int          target_rank,
        MPI_Aint     target_disp,
        int          target_count,
        MPI_Datatype datatype,
        MPI_Win      win,
  _Out_ MPI_Request  *request
);

Parametry

• origin_addr [ven]
  Adresa vyrovnávací paměti, ve které se mají přijímat data.

• origin_count
  Počet položek ve vyrovnávací paměti původu.

• origin_datatype
  Datový typ každé položky ve vyrovnávací paměti původu.

• target_rank
  Pořadí podle cíle.

• target_disp
  Posunutí ze začátku okna na začátek cílové vyrovnávací paměti.

• target_count
  Počet položek v cílové vyrovnávací paměti.

• Datatype
  Datový typ každé položky v cílové vyrovnávací paměti.

• Vyhrát
  Objekt Okna používaný pro komunikaci.

• request [out]
  Žádost o RMA.

Vrácená hodnota

Vrátí MPI_SUCCESS při úspěchu. V opačném případě je návratovou hodnotou kód chyby.

V nástroji Fortran je vrácená hodnota uložena v parametru IERROR .

Fortran

    MPI_RGET(ORIGIN_ADDR, ORIGIN_COUNT, ORIGIN_DATATYPE, TARGET_RANK,
                TARGET_DISP, TARGET_COUNT, TARGET_DATATYPE, WIN, REQUEST, IERROR)
        <type> ORIGIN_ADDR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) TARGET_DISP
        INTEGER ORIGIN_COUNT, ORIGIN_DATATYPE, TARGET_RANK, TARGET_COUNT, TARGET_DATATYPE, WIN, REQUEST, IERROR

Poznámky

MPI_Rget se podobá MPI_Get s tím rozdílem, že přiděluje objekt žádosti o komunikaci a přidruží ho k popisovači požadavku ( požadavek argumentu), který lze použít k čekání nebo testování dokončení. Dokončení operace MPI_Rget znamená, že data jsou k dispozici ve vyrovnávací paměti původu. Pokud origin_addr odkazuje na paměť připojenou k oknem, budou data dostupná v privátní kopii tohoto okna.

Požadavky

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package nebo HPC Pack 2008 Client Utilities
Hlavička	Mpi.h; Mpif.h
Knihovna	Msmpi.lib
DLL	Msmpi.dll

Viz také

Funkce MPI One-Sided Communications