função MPI_Comm_size

Recupera o número de processos envolvidos em um comunicador ou o número total de processos disponíveis.

Sintaxe

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

Parâmetros

• comm
  O comunicador a ser avaliado. Especifique a constante MPI_COMM_WORLD para recuperar o número total de processos disponíveis.

• size [out]
  No retorno, indica o número de processos no grupo para o comunicador.

Retornar valor

Retorna MPI_SUCCESS em caso de êxito. Caso contrário, o valor retornado será um código de erro.

Em Fortran, o valor retornado é armazenado no parâmetro IERROR .

Fortran

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

Comentários

Essa função permite que o usuário recupere o tamanho do grupo com uma única chamada de função. Caso contrário, seria necessário criar um grupo temporário usando a função MPI_Comm_group , obter o tamanho do grupo usando a função MPI_Group_size e liberar o grupo temporário usando a função MPI_Group_free .

Essa função geralmente é usada com a função MPI_Comm_rank para determinar a quantidade de simultaneidade disponível para uma biblioteca ou programa específico. A função MPI_Comm_rank indica a classificação do processo que a chama no intervalo de 0 a tamanho 1, em que o tamanho é recuperado usando a função MPI_Comm_size .

Observação

Não há uma maneira padrão de alterar o número de processos após a inicialização.

 

Requisitos

Produto	Pacote Redistribuível do HPC Pack 2012 MS-MPI, Pacote Redistribuível HPC Pack 2008 R2 MS-MPI, Pacote Redistribuível do HPC Pack 2008 MS-MPI ou Utilitários de Cliente HPC Pack 2008
parâmetro	Mpi.h; Mpif.h
Biblioteca	Msmpi.lib
DLL	Msmpi.dll

Confira também

Funções do Communicator do MPI

MPI_Comm_rank