MPI_Comm_size, fonction
Récupère le nombre de processus impliqués dans un communicateur, ou le nombre total de processus disponibles.
Syntaxe
int MPIAPI MPI_Comm_size(
MPI_Comm comm,
_Out_ int *size
);
Paramètres
comm
Communicateur à évaluer. Spécifiez la constante MPI_COMM_WORLD pour récupérer le nombre total de processus disponibles.size [out]
Au retour, indique le nombre de processus dans le groupe pour le communicateur.
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_SIZE(COMM,SIZE,IERROR)
INTEGER COMM, SIZE, IERROR
Remarques
Cette fonction permet à l’utilisateur de récupérer la taille du groupe avec un seul appel de fonction. Sinon, il serait nécessaire de créer un groupe temporaire à l’aide de la fonction MPI_Comm_group , d’obtenir la taille du groupe à l’aide de la fonction MPI_Group_size , puis de libérer le groupe temporaire à l’aide de la fonction MPI_Group_free .
Cette fonction est souvent utilisée avec la fonction MPI_Comm_rank pour déterminer la quantité d’accès concurrentiel disponible pour une bibliothèque ou un programme spécifique. La fonction MPI_Comm_rank indique le rang du processus qui l’appelle dans la plage comprise entre 0 et taille 1, où la taille est récupérée à l’aide de la fonction MPI_Comm_size .
Notes
Il n’existe aucun moyen standard de modifier le nombre de processus après l’initialisation.
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 |