Edit

Share via


MPI_Comm_connect function

Make a request to form a new intercommunicator.

Syntax

int MPIAPI MPI_Comm_connect(
  _In_  char     *port_name,
        MPI_Info info,
        int      root,
        MPI_Comm comm,
  _Out_ MPI_Comm *newcomm
);

Parameters

  • port_name [in]
    Network address, used only on root.

  • info
    Implementation-dependent information.

  • root
    Rank in comm of root node.

  • comm
    Intracommunicator over which call is collective.

  • newcomm [out]
    Intercommunicator with server as remote group.

Return value

Returns MPI_SUCCESS on success. Otherwise, the return value is an error code.

In Fortran, the return value is stored in the IERROR parameter.

Fortran

    MPI_COMM_CONNECT(PORT_NAME, INFO, ROOT, COMM, NEWCOMM, IERROR)
        CHARACTER*(*) PORT_NAME
        INTEGER INFO, ROOT, COMM, NEWCOMM, IERROR

Requirements

Product

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package or HPC Pack 2008 Client Utilities

Header

Mpi.h; Mpif.h

Library

Msmpi.lib

DLL

Msmpi.dll

See also

MPI Process Management Functions