MPI_Comm_dup, fonction

Duplique un communicateur existant avec des valeurs de clé associées. Pour chaque valeur de clé, la fonction de rappel de copie correspondante détermine la valeur d’attribut associée à cette clé dans le nouveau communicateur. Le rappel de copie peut, par exemple, supprimer l’attribut du nouveau communicateur.

Syntaxe

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

Paramètres

• comm
  Communicateur à dupliquer.

• newcomm [out]
  Au retour, contient un handle pour un nouveau communicateur. Le nouveau communicateur a le même groupe ou les mêmes groupes et toutes les informations mises en cache copiées à partir de la source, mais il contient de nouvelles informations de contexte.

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_COMM_DUP(COMM,NEWCOMM,IERROR)
        INTEGER COMM, NEWCOMM, IERROR

Remarques

Cette fonction crée un espace de communication en double qui a les mêmes propriétés que le communicateur d’origine. Cela inclut tous les attributs et topologies. Cette fonction est valide même s’il existe des communications point à point en attente impliquant le communicateur source.

Un utilisateur peut appeler la fonction MPI_Comm_dup au début du processus parallèle et libérer ultérieurement le communicateur en double à l’aide de la fonction MPI_Comm_free . D’autres modèles de gestion des communicateurs sont également possibles.

Cette fonction s’applique aux intracommunicateurs et aux intercommunicateurs.

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 communicator MPI