MPI_Rput functie

Artikel
01/16/2024

Op aanvraag gebaseerde RMA-putbewerking.

Syntaxis

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

Parameters

origin_addr [in]
Oorspronkelijk adres van oorsprongbuffer.
origin_count
Aantal vermeldingen in oorsprongbuffer.
origin_datatype
Gegevenstype van elke vermelding in oorsprongbuffer.
target_rank
Rang van doel.
target_disp
Verplaatsing van het begin van het venster naar de doelbuffer.
target_count
Aantal vermeldingen in doelbuffer.
target_datatype
Gegevenstype van elke vermelding in de doelbuffer.
Winnen
Vensterobject dat wordt gebruikt voor communicatie.
aanvraag [uit]
RMA-aanvraag.

Retourwaarde

Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.

In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .

Fortran

    MPI_RPUT(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

Opmerkingen

MPI_Rput is vergelijkbaar met MPI_Put, behalve dat er een communicatieaanvraagobject wordt toegewezen en aan de aanvraaghandgreep (de argumentaanvraag) wordt gekoppeld. De voltooiing van een MPI_Rput bewerking (dat wil gezegd, na de bijbehorende test of wachttijd) geeft aan dat de afzender nu vrij is om de locaties in de oorspronkelijke buffer bij te werken. Het geeft niet aan dat de gegevens beschikbaar zijn in het doelvenster. Als externe voltooiing is vereist, kunt u MPI_Win_flush, MPI_Win_flush_all, MPI_Win_unlock of MPI_Win_unlock_all gebruiken.

Vereisten

Product	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package of HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Bibliotheek	Msmpi.lib
DLL	Msmpi.dll

Zie ook

MPI One-Sided Communications Functions

Delen via