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

Voir aussi

Fonctions communicator MPI

MPI_Comm_rank