Função MPI_Comm_dup

Duplica um comunicador existente com valores de chave associados. Para cada valor de chave, a respectiva função de retorno de chamada de cópia determina o valor do atributo associado a essa chave no novo comunicador. O retorno de chamada de cópia pode, por exemplo, excluir o atributo do novo comunicador.

Sintaxe

int MPIAPI MPI_Comm_dup(
        MPI_Comm comm,
  _Out_ MPI_Comm *newcomm
);

Parâmetros

• comm
  O comunicador a ser duplicado.

• newcomm [out]
  No retorno, contém um identificador para um novo comunicador. O novo comunicador tem o mesmo grupo ou grupo e todas as informações copiadas em cache da origem, mas contém novas informações de contexto.

Retornar valor

Retorna MPI_SUCCESS em caso de êxito. Caso contrário, o valor retornado será um código de erro.

Em Fortran, o valor retornado é armazenado no parâmetro IERROR .

Fortran

    MPI_COMM_DUP(COMM,NEWCOMM,IERROR)
        INTEGER COMM, NEWCOMM, IERROR

Comentários

Essa função cria um espaço de comunicação duplicado que tem as mesmas propriedades que o comunicador original. Isso inclui todos os atributos e topologias. Essa função é válida mesmo se houver comunicações ponto a ponto pendentes que envolvam o comunicador de origem.

Um usuário pode chamar a função MPI_Comm_dup no início do processo paralelo e, posteriormente, liberar o comunicador duplicado usando a função MPI_Comm_free . Outros modelos de gerenciamento de comunicador também são possíveis.

Essa função se aplica a intracomunicadores e intercomunicadores.

Requisitos

Confira também

Funções do Communicator do MPI