MPI_Comm_get_parent(3)

NAME
     MPI_Comm_get_parent - Return the parent intercommunicator of the current
     process

SYNOPSIS
     C:

          #include <mpi.h>

          int MPI_Comm_get_parent( parent)
          MPI_Comm     *parent;


     Fortran:

          INCLUDE "mpif.h" (or USE MPI)

          INTEGER parent, ierror

          CALL MPI_COMM_GET_PARENT(parent, ierror)


DESCRIPTION
     If a process was started with MPI_Comm_spawn or MPI_Comm_spawn_multiple,
     MPI_Comm_get_parent returns the parent intercommunicator of the current
     process.  If the process was not spawned, MPI_Comm_get_parent returns
     MPI_COMM_NULL.

     This routine accepts the following parameters:

     parent    Returns the parent intercommunicator of the current process.  A
               return value of MPI_COMM_NULL indicates the process was not
               spawned.

     ierror    Specifies the return code value for successful completion.

NOTES
     Error codes are the values returned by MPI routines (in C) or in the
     ierror argument (in Fortran).  These can be converted to error classes by
     using the MPI_Error_class(3) routine.

SEE ALSO
     MPI_Comm_spawn(3), MPI_Comm_spawn_multiple(3)

     mpi(1), mpirun(1)