função MPI_Rget

Artigo
09/28/2023

Operação de obtenção do RMA baseada em pedidos.

Sintaxe

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

Parâmetros

origin_addr [fora]
Endereço da memória intermédia na qual os dados são recebidos.
origin_count
Número de entradas na memória intermédia de origem.
origin_datatype
Tipo de dados de cada entrada na memória intermédia de origem.
target_rank
Classificação do destino.
target_disp
Deslocamento do início da janela para o início da memória intermédia de destino.
target_count
Número de entradas na memória intermédia de destino.
tipo de dados
Tipo de dados de cada entrada na memória intermédia de destino.
ganhar
Objeto de janela utilizado para comunicação.
pedido [fora]
Pedido RMA.

Valor devolvido

Devolve MPI_SUCCESS com êxito. Caso contrário, o valor devolvido é um código de erro.

Em Fortran, o valor devolvido é armazenado no parâmetro 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

Observações

MPI_Rget é semelhante a MPI_Get, exceto que aloca um objeto de pedido de comunicação e associa-o ao identificador do pedido (o pedido de argumento) que pode ser utilizado para aguardar ou testar a conclusão. A conclusão de uma operação MPI_Rget indica que os dados estão disponíveis na memória intermédia de origem. Se origin_addr aponta para a memória anexada a uma janela, os dados ficam disponíveis na cópia privada desta janela.

Requisitos

Produto	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package ou HPC Pack 2008 Client Utilities
Cabeçalho	Mpi.h; Mpif.h
Biblioteca	Msmpi.lib
DLL	Msmpi.dll

Ver também

MPI One-Sided Communications Functions

Partilhar via