MPI_Comm_size función

Recupera el número de procesos implicados en un comunicador o el número total de procesos disponibles.

Sintaxis

int MPIAPI MPI_Comm_size(
        MPI_Comm comm,
  _Out_ int      *size
);

Parámetros

• comm
  Comunicador que se va a evaluar. Especifique la constante MPI_COMM_WORLD para recuperar el número total de procesos disponibles.

• size [out]
  En la devolución, indica el número de procesos del grupo para el comunicador.

Valor devuelto

Devuelve MPI_SUCCESS si se realiza correctamente. De lo contrario, el valor devuelto es un código de error.

En Fortran, el valor devuelto se almacena en el parámetro IERROR .

Fortran

    MPI_COMM_SIZE(COMM,SIZE,IERROR)
        INTEGER COMM, SIZE, IERROR

Comentarios

Esta función permite al usuario recuperar el tamaño del grupo con una sola llamada de función. De lo contrario, sería necesario crear un grupo temporal mediante la función MPI_Comm_group , obtener el tamaño del grupo mediante la función MPI_Group_size y, a continuación, liberar el grupo temporal mediante la función MPI_Group_free .

Esta función se usa a menudo con la función MPI_Comm_rank para determinar la cantidad de simultaneidad que está disponible para una biblioteca o programa específicos. La función MPI_Comm_rank indica el rango del proceso que lo llama en el intervalo de 0 a tamaño-1, donde se recupera el tamaño mediante la función MPI_Comm_size .

Nota

No hay ninguna manera estándar de cambiar el número de procesos después de que se haya realizado la inicialización.

 

Requisitos

Producto	Paquete redistribuible DE HPC Pack 2012 MS-MPI, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Client Utilities
Encabezado	Mpi.h; Mpif.h
Biblioteca	Msmpi.lib
Archivo DLL	Msmpi.dll

Consulte también

Funciones del comunicador MPI

MPI_Comm_rank