MPI_Comm_size-Funktion

Ruft die Anzahl der an einem Kommunikator beteiligten Prozesse oder die Gesamtzahl der verfügbaren Prozesse ab.

Syntax

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

Parameter

• comm
  Der zu bewertende Kommunikator. Geben Sie die MPI_COMM_WORLD Konstante an, um die Gesamtzahl der verfügbaren Prozesse abzurufen.

• Größe [out]
  Gibt bei der Rückgabe die Anzahl der Prozesse in der Gruppe für den Communicator an.

Rückgabewert

Gibt MPI_SUCCESS nach Erfolg zurück. Andernfalls ist der Rückgabewert ein Fehlercode.

In Fortran wird der Rückgabewert im IERROR-Parameter gespeichert.

Fortran

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

Hinweise

Mit dieser Funktion kann der Benutzer die Gruppengröße mit einem einzelnen Funktionsaufruf abrufen. Andernfalls ist es erforderlich, eine temporäre Gruppe mithilfe der MPI_Comm_group-Funktion zu erstellen, die Größe der Gruppe mithilfe der MPI_Group_size-Funktion abzurufen und dann die temporäre Gruppe mithilfe der MPI_Group_free-Funktion frei zu geben.

Diese Funktion wird häufig mit der MPI_Comm_rank-Funktion verwendet, um den Umfang der Parallelität zu bestimmen, der für eine bestimmte Bibliothek oder ein bestimmtes Programm verfügbar ist. Die MPI_Comm_rank-Funktion gibt den Rang des Prozesses an, der ihn im Bereich von 0 bis Größe-1 aufruft, wobei die Größe mithilfe der MPI_Comm_size-Funktion abgerufen wird.

Hinweis

Es gibt keine Standardmethode, um die Anzahl von Prozessen nach der Initialisierung zu ändern.

 

Anforderungen

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package oder HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Bibliothek	Msmpi.lib
DLL	Msmpi.dll

Weitere Informationen

MPI Communicator-Funktionen

MPI_Comm_rank