MPI_Comm_free

Marks the communicator object for deallocation

Synopsis

#include "mpi.h"
int MPI_Comm_free ( commp )
MPI_Comm *commp;

Input Parameter

comm: communicator to be destroyed (handle)

Null Handles

The MPI 1.1 specification, in the section on opaque objects, explicitly

disallows freeing a null communicator. The text from the standard is

 A null handle argument is an erroneous IN argument in MPI calls, unless an
 exception is explicitly stated in the text that defines the function. Such
 exception is allowed for handles to request objects in Wait and Test calls
 (sections Communication Completion and Multiple Completions ). Otherwise, a
 null handle can only be passed to a function that allocates a new object and
 returns a reference to it in the handle.