NAME

       MPI_Comm_get_info - Retrieves active communicator info hints

SYNTAX

C Syntax

       #include <mpi.h>
       int MPI_Comm_get_info(MPI_Comm comm, MPI_Info *info_used)

Fortran Syntax

       INCLUDE 'mpif.h'
       MPI_COMM_GET_INFO(COMM, INFO_USED, IERROR)
            INTEGER   COMM, INFO_USED, IERROR

INPUT PARAMETERS

       comm      Communicator from which to receive active info hints

OUTPUT PARAMETERS

       info_used New info object returned with all active hints on this communicator.

       IERROR    Fortran only: Error status (integer).

DESCRIPTION

       MPI_Comm_get_info  returns  a  new  info  object containing the hints of the communicator associated with
       comm.  The current setting of all hints actually used by the  system  related  to  this  communicator  is
       returned  in info_used.  If no such hints exist, a handle to a newly created info object is returned that
       contains no key/value pair. The user is responsible for freeing info_used via MPI_Info_free.

ERRORS

       Almost all MPI routines return an error value; C routines as  the  value  of  the  function  and  Fortran
       routines in the last argument.

       Before  the  error  value  is  returned,  the current MPI error handler is called. By default, this error
       handler aborts the MPI job, except for I/O function  errors.  The  error  handler  may  be  changed  with
       MPI_Comm_set_errhandler; the predefined error handler MPI_ERRORS_RETURN may be used to cause error values
       to be returned. Note that MPI does not guarantee that an MPI program can continue past an error.

SEE ALSO

       MPI_Comm_get_info, MPI_Info_free