MPI_Rget, fonction

Article
01/16/2024

Opération d’obtention RMA basée sur la demande.

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
);

Paramètres

origin_addr [out]
Adresse de la mémoire tampon dans laquelle recevoir les données.
origin_count
Nombre d’entrées dans la mémoire tampon d’origine.
origin_datatype
Type de données de chaque entrée dans la mémoire tampon d’origine.
target_rank
Classement de la cible.
target_disp
Déplacement du début de la fenêtre au début de la mémoire tampon cible.
target_count
Nombre d’entrées dans la mémoire tampon cible.
datatype
Type de données de chaque entrée dans la mémoire tampon cible.
win
Objet Window utilisé pour la communication.
request [out]
Demande RMA.

Valeur retournée

Retourne MPI_SUCCESS en cas de réussite. Sinon, la valeur de retour est un code d’erreur.

Dans Fortran, la valeur de retour est stockée dans le paramètre 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

Remarques

MPI_Rget est similaire à MPI_Get, à ceci près qu’elle alloue un objet de demande de communication et l’associe au handle de requête (la demande d’argument) qui peut être utilisé pour attendre ou tester l’achèvement. L’achèvement d’une opération de MPI_Rget indique que les données sont disponibles dans la mémoire tampon d’origine. Si origin_addr pointe vers la mémoire attachée à une fenêtre, les données deviennent disponibles dans la copie privée de cette fenêtre.

Configuration requise

Produit	Package redistribuable MS-MPI HPC Pack 2012, package redistribuable HPC Pack 2008 R2 MS-MPI, package redistribuable MS-MPI HPC Pack 2008 ou utilitaires clients HPC Pack 2008
En-tête	Mpi.h ; Mpif.h
Bibliothèque	Msmpi.lib
DLL	Msmpi.dll

Voir aussi

Fonctions de communication One-Sided MPI

Partager via