MPI_Rget_accumulate-Funktion

Artikel
01/16/2024

Der anforderungsbasierte RMA-Lese-/Änderungs-Schreibvorgang gibt die Daten vor dem Akkumulationsvorgang zurück.

Syntax

int MPIAPI MPI_Rget_accumulate(
  _In_  void         *origin_addr,
        int          origin_count,
        MPI_Datatype origin_datatype,
  _Out_ void         *result_addr,
        int          result_count,
        MPI_Datatype result_datatype,
        int          target_rank,
        MPI_Aint     target_disp,
        int          target_count,
        MPI_Datatype datatype,
        MPI_Op       op,
        MPI_Win      win,
  _Out_ MPI_Request  *request
);

Parameter

origin_addr [in]
Anfängliche Adresse des Puffers
origin_count
Anzahl der Einträge im Puffer
origin_datatype
Datentyp der einzelnen Puffereinträge
result_addr [out]
Erste Adresse des Ergebnispuffers
result_count
Anzahl der Einträge im Ergebnispuffer
result_datatype
Datentyp jedes Eintrags im Ergebnispuffer
target_rank
Rang des Ziels
target_disp
Verschiebung vom Anfang des Fensters zum Anfang des Zielpuffers
target_count
Anzahl der Einträge im Zielpuffer
datatype
Datentyp jedes Eintrags im Zielpuffer
Op
vordefinierter Reduzierungsvorgang
win
window-Objekt
Request [out]
RMA-Anforderung

Rückgabewert

Gibt MPI_SUCCESS nach Erfolg zurück. Andernfalls ist der Rückgabewert ein Fehlercode.

In Fortran wird der Rückgabewert im IERROR-Parameter gespeichert.

Fortran

    MPI_GET_RACCUMULATE(ORIGIN_ADDR, ORIGIN_COUNT, ORIGIN_DATATYPE, RESULT_ADDR, RESULT_COUNT, RESULT_DATATYPE,
                TARGET_RANK, TARGET_DISP, TARGET_COUNT, TARGET_DATATYPE, OP, WIN, REQUEST, IERROR)
        <type> ORIGIN_ADDR(*), RESULT_ADDR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) TARGET_DISP
        INTEGER ORIGIN_COUNT, ORIGIN_DATATYPE, RESULT_COUNT, RESULT_DATATYPE, TARGET_RANK, TARGET_COUNT,
        TARGET_DATATYPE, OP, WIN, REQUEST, IERROR

Hinweise

MPI_Rget_accumulate ähnelt MPI_Get_accumulate, mit der Ausnahme, dass es ein Kommunikationsanforderungsobjekt zuordnet und es dem Anforderungshandle (der Argumentanforderung) zuordnet, das zum Warten oder Testen auf den Abschluss verwendet werden kann. Der Abschluss eines MPI_Rget_accumulate Vorgangs gibt an, dass die Daten im Ergebnispuffer verfügbar sind und der Ursprungspuffer kostenlos aktualisiert werden kann. Es gibt nicht an, dass der Vorgang im Zielfenster abgeschlossen wurde.

Anforderungen

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package oder HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Bibliothek	Msmpi.lib
DLL	Msmpi.dll

Weitere Informationen

MPI One-Sided Communications Functions

Freigeben über