| MPI_COMM_FREE(comm) | |
| INOUT comm | communicator to be destroyed (handle) |
This collective operation marks the communication object for deallocation. Any operations that use the communicator comm (whether active or inactive at the time of this procedure call) will continue to work; the object is actually deallocated only if there are no other active references to it. The handle is set to MPI_COMM_NULL in the calling MPI process. This call applies to intra- and inter-communicators. The delete callback functions for all cached attributes (see Section Caching) are called in arbitrary order.
Advice
to implementors.
Though collective, it is anticipated that this operation will normally
be implemented to be local, though
a
debugging version of an MPI library might
choose to synchronize.
( End of advice to implementors.)