MPI_Intercomm_create - Creates an intercommuncator from
       two intracommunicators


SYNOPSIS

       C:

            #include <mpi.h>

            int MPI_Intercomm_create ( local_comm, local_leader,
            peer_comm, remote_leader, tag, comm_out )
            MPI_Comm  local_comm;
            int       local_leader;
            MPI_Comm  peer_comm;
            int       remote_leader;
            int       tag;
            MPI_Comm *comm_out;

       C++:

            #include <mpi.h>

            Intercomm Intracomm::Create_intercomm(
            int               local_leader,
            const Comm&       peer_comm,
            int               remote_leader,
            int               tag) const

       Fortran:

            INCLUDE "mpif.h" (or USE MPI)

            INTEGER local_comm, local_leader, peer_comm, remote_leader,
            tag, newintercomm, ierror

            Call MPI_INTERCOMM_CREATE(local_comm, local_leader, peer_comm,
            remote_leader, tag, newintercomm, ierror)


STANDARDS

       This release implements the MPI 1.2 standard, as
       documented by the MPI Forum in the spring 1997 release of
       MPI:  A Message Passing Interface Standard.


DESCRIPTION

       The MPI_Intercomm_create routine creates an
       intercommunicator from two intracommunicators.  This
       routine accepts the following parameters:

       local_comm     Specifies a local intracommunicator.

       local_leader   Specifies the rank in the local

                      (often 0).

       peer_comm      Specifies the remote communicator.

       remote_leader  Specifies the rank in the remote
                      communicator (peer_comm) of the leader
                      (often 0).

       tag            Specifies the message tag to use in
                      constructing the intercommunicator.  If
                      multiple MPI_Intercomm_create routines are
                      being called, they should use different
                      tags (more precisely, they should ensure
                      that the local and remote leaders are using
                      different tags for each
                      MPI_intercomm_create routine).

       comm_out       Returns the created intercommunicator.

       ierror         Specifies the return code value for
                      successful completion, which is in
                      MPI_SUCCESS.  MPI_SUCCESS is defined in the
                      mpif.h file.


Man(1) output converted with man2html