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 |