dacs_group_destroy

NAME

dacs_group_destroy - Remove a DaCS group.

SYNOPSIS

DACS_ERR_T dacs_group_destroy ( dacs_group_t *group )

Call parameter  
*group A pointer to the handle of the group to remove.

DESCRIPTION

The dacs_group_destroy service removes the specified group and invalidates the handle. This service may only be called by the owner of the group, and blocks until all members have left the group. If the calling process is the owner of the group and also a member of the group it is implicitly removed from the group when it is destroyed

RETURN VALUE

The dacs_group_destroy service returns an error indicator defined as:
  • DACS_SUCCESS: normal return.
  • DACS_ERR_INVALID_ADDR: the pointer is invalid.
  • DACS_ERR_INVALID_HANDLE: the group handle does not refer to a valid group.
  • DACS_ERR_NOT_OWNER: the caller is not the owner of the group.
  • DACS_ERR_GROUP_OPEN: the group has not been closed.

SEE ALSO

dacs_group_init(3), dacs_group_add_member(3), dacs_group_close(3), dacs_group_accept(3), dacs_group_leave(3), dacs_barrier_wait(3)
Parent topic: Group owner functions