5.3.3. Group Destructors


Up: Group Management Next: Communicator Management Previous: Group Constructors

MPI_GROUP_FREE(group)
[ INOUT group] group (handle)

int MPI_Group_free(MPI_Group *group)

MPI_GROUP_FREE(GROUP, IERROR)
INTEGER GROUP, IERROR

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_CREATE and MPI_COMM_DUP, 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.)



Up: Group Management Next: Communicator Management Previous: Group Constructors


Return to MPI Standard Index
Return to MPI home page