dacs_group_accept

NAME

dacs_group_accept - Accept membership to a DaCS group.

SYNOPSIS

DACS_ERR_T dacs_group_accept ( de_id_t de, dacs_process_id_t pid, dacs_group_t *group )

Call parameters  
de The DE ID of the group owner.
pid The process ID of the group owner.
Return parameter  
*group A pointer to the handle of the group to be filled in.

DESCRIPTION

The dacs_group_accept service accepts membership to a group and returns the group handle. For each dacs_group_accept() call there must be an associated dacs_group_add_member() call by the owner of the group. This service blocks until the caller has been added to the group by the group owner.

RETURN VALUE

The dacs_group_accept service returns an error indicator defined as:
  • DACS_SUCCESS: normal return.
  • DACS_ERR_INVALID_DE: the specified DE is either invalid or not reserved.
  • DACS_ERR_INVALID_PID: the specified pid does not refer to an active process.
  • DACS_ERR_INVALID_ADDR: the pointer is invalid.
  • DACS_ERR_INVALID_TARGET: the operation not allowed for the target process.

SEE ALSO

dacs_group_init(3), dacs_group_add_member(3), dacs_group_close(3), dacs_group_destroy(3), dacs_group_leave(3), dacs_barrier_wait(3)