| MPI_GROUP_FREE(group) | |
| INOUT group | group (handle) |
This operation marks a group object for deallocation. The handle group is set to MPI_GROUP_NULL by the call. Any on-going operation using this group will complete normally.
Advice
to implementors.
One can keep a reference count that is incremented for each call to
MPI_COMM_GROUP, MPI_COMM_CREATE,
MPI_COMM_DUP, MPI_COMM_IDUP, MPI_COMM_DUP_WITH_INFO,
MPI_COMM_IDUP_WITH_INFO, MPI_COMM_SPLIT, MPI_COMM_SPLIT_TYPE,
MPI_COMM_CREATE_GROUP, MPI_COMM_CREATE_FROM_GROUP,
MPI_INTERCOMM_CREATE, and MPI_INTERCOMM_CREATE_FROM_GROUPS, and
decremented for each call to MPI_GROUP_FREE or
MPI_COMM_FREE; the group object is ultimately deallocated when the
reference count drops to zero.
( End of advice to implementors.)